forked from platformio/platformio-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
52 changed files
with
2,507 additions
and
204 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,136 @@ | ||
.. Copyright (c) 2014-present PlatformIO <[email protected]> | ||
Licensed under the Apache License, Version 2.0 (the "License"); | ||
you may not use this file except in compliance with the License. | ||
You may obtain a copy of the License at | ||
http://www.apache.org/licenses/LICENSE-2.0 | ||
Unless required by applicable law or agreed to in writing, software | ||
distributed under the License is distributed on an "AS IS" BASIS, | ||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
See the License for the specific language governing permissions and | ||
limitations under the License. | ||
.. _board_nordicnrf52_adafruit_ledglasses_nrf52840: | ||
|
||
Adafruit LED Glasses Driver nRF52840 | ||
==================================== | ||
|
||
.. contents:: | ||
|
||
Hardware | ||
-------- | ||
|
||
Platform :ref:`platform_nordicnrf52`: The nRF52 Series are built for speed to carry out increasingly complex tasks in the shortest possible time and return to sleep, conserving precious battery power. They have a Cortex-M4F processor and are the most capable Bluetooth Smart SoCs on the market. | ||
|
||
.. list-table:: | ||
|
||
* - **Microcontroller** | ||
- NRF52840 | ||
* - **Frequency** | ||
- 64MHz | ||
* - **Flash** | ||
- 796KB | ||
* - **RAM** | ||
- 232KB | ||
* - **Vendor** | ||
- `Adafruit <https://www.adafruit.com/product/5217?utm_source=platformio.org&utm_medium=docs>`__ | ||
|
||
|
||
Configuration | ||
------------- | ||
|
||
Please use ``adafruit_ledglasses_nrf52840`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`: | ||
|
||
.. code-block:: ini | ||
[env:adafruit_ledglasses_nrf52840] | ||
platform = nordicnrf52 | ||
board = adafruit_ledglasses_nrf52840 | ||
You can override default Adafruit LED Glasses Driver nRF52840 settings per build environment using | ||
``board_***`` option, where ``***`` is a JSON object path from | ||
board manifest `adafruit_ledglasses_nrf52840.json <https://github.com/platformio/platform-nordicnrf52/blob/master/boards/adafruit_ledglasses_nrf52840.json>`_. For example, | ||
``board_build.mcu``, ``board_build.f_cpu``, etc. | ||
|
||
.. code-block:: ini | ||
[env:adafruit_ledglasses_nrf52840] | ||
platform = nordicnrf52 | ||
board = adafruit_ledglasses_nrf52840 | ||
; change microcontroller | ||
board_build.mcu = nrf52840 | ||
; change MCU frequency | ||
board_build.f_cpu = 64000000L | ||
Uploading | ||
--------- | ||
Adafruit LED Glasses Driver nRF52840 supports the following uploading protocols: | ||
|
||
* ``blackmagic`` | ||
* ``cmsis-dap`` | ||
* ``jlink`` | ||
* ``nrfjprog`` | ||
* ``nrfutil`` | ||
* ``stlink`` | ||
|
||
Default protocol is ``nrfutil`` | ||
|
||
You can change upload protocol using :ref:`projectconf_upload_protocol` option: | ||
|
||
.. code-block:: ini | ||
[env:adafruit_ledglasses_nrf52840] | ||
platform = nordicnrf52 | ||
board = adafruit_ledglasses_nrf52840 | ||
upload_protocol = nrfutil | ||
Debugging | ||
--------- | ||
|
||
:ref:`piodebug` - "1-click" solution for debugging with a zero configuration. | ||
|
||
.. warning:: | ||
You will need to install debug tool drivers depending on your system. | ||
Please click on compatible debug tool below for the further | ||
instructions and configuration information. | ||
|
||
You can switch between debugging :ref:`debugging_tools` using | ||
:ref:`projectconf_debug_tool` option in :ref:`projectconf`. | ||
|
||
Adafruit LED Glasses Driver nRF52840 does not have on-board debug probe and **IS NOT READY** for debugging. You will need to use/buy one of external probe listed below. | ||
|
||
.. list-table:: | ||
:header-rows: 1 | ||
|
||
* - Compatible Tools | ||
- On-board | ||
- Default | ||
* - :ref:`debugging_tool_blackmagic` | ||
- | ||
- Yes | ||
* - :ref:`debugging_tool_cmsis-dap` | ||
- | ||
- | ||
* - :ref:`debugging_tool_jlink` | ||
- | ||
- | ||
* - :ref:`debugging_tool_stlink` | ||
- | ||
- | ||
|
||
Frameworks | ||
---------- | ||
.. list-table:: | ||
:header-rows: 1 | ||
|
||
* - Name | ||
- Description | ||
|
||
* - :ref:`framework_arduino` | ||
- Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences | ||
|
||
* - :ref:`framework_zephyr` | ||
- The Zephyr Project is a scalable real-time operating system (RTOS) supporting multiple hardware architectures, optimized for resource constrained devices, and built with safety and security in mind |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,130 @@ | ||
.. Copyright (c) 2014-present PlatformIO <[email protected]> | ||
Licensed under the Apache License, Version 2.0 (the "License"); | ||
you may not use this file except in compliance with the License. | ||
You may obtain a copy of the License at | ||
http://www.apache.org/licenses/LICENSE-2.0 | ||
Unless required by applicable law or agreed to in writing, software | ||
distributed under the License is distributed on an "AS IS" BASIS, | ||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
See the License for the specific language governing permissions and | ||
limitations under the License. | ||
.. _board_nordicnrf52_nicla_sense_me: | ||
|
||
Arduino Nicla Sense ME | ||
====================== | ||
|
||
.. contents:: | ||
|
||
Hardware | ||
-------- | ||
|
||
Platform :ref:`platform_nordicnrf52`: The nRF52 Series are built for speed to carry out increasingly complex tasks in the shortest possible time and return to sleep, conserving precious battery power. They have a Cortex-M4F processor and are the most capable Bluetooth Smart SoCs on the market. | ||
|
||
.. list-table:: | ||
|
||
* - **Microcontroller** | ||
- NRF52832 | ||
* - **Frequency** | ||
- 64MHz | ||
* - **Flash** | ||
- 515.25KB | ||
* - **RAM** | ||
- 62.78KB | ||
* - **Vendor** | ||
- `Arduino <https://docs.arduino.cc/hardware/nicla-sense-me?utm_source=platformio.org&utm_medium=docs>`__ | ||
|
||
|
||
Configuration | ||
------------- | ||
|
||
Please use ``nicla_sense_me`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`: | ||
|
||
.. code-block:: ini | ||
[env:nicla_sense_me] | ||
platform = nordicnrf52 | ||
board = nicla_sense_me | ||
You can override default Arduino Nicla Sense ME settings per build environment using | ||
``board_***`` option, where ``***`` is a JSON object path from | ||
board manifest `nicla_sense_me.json <https://github.com/platformio/platform-nordicnrf52/blob/master/boards/nicla_sense_me.json>`_. For example, | ||
``board_build.mcu``, ``board_build.f_cpu``, etc. | ||
|
||
.. code-block:: ini | ||
[env:nicla_sense_me] | ||
platform = nordicnrf52 | ||
board = nicla_sense_me | ||
; change microcontroller | ||
board_build.mcu = nrf52832 | ||
; change MCU frequency | ||
board_build.f_cpu = 64000000L | ||
Uploading | ||
--------- | ||
Arduino Nicla Sense ME supports the following uploading protocols: | ||
|
||
* ``blackmagic`` | ||
* ``cmsis-dap`` | ||
* ``jlink`` | ||
* ``nrfjprog`` | ||
* ``nrfutil`` | ||
* ``sam-ba`` | ||
|
||
Default protocol is ``cmsis-dap`` | ||
|
||
You can change upload protocol using :ref:`projectconf_upload_protocol` option: | ||
|
||
.. code-block:: ini | ||
[env:nicla_sense_me] | ||
platform = nordicnrf52 | ||
board = nicla_sense_me | ||
upload_protocol = cmsis-dap | ||
Debugging | ||
--------- | ||
|
||
:ref:`piodebug` - "1-click" solution for debugging with a zero configuration. | ||
|
||
.. warning:: | ||
You will need to install debug tool drivers depending on your system. | ||
Please click on compatible debug tool below for the further | ||
instructions and configuration information. | ||
|
||
You can switch between debugging :ref:`debugging_tools` using | ||
:ref:`projectconf_debug_tool` option in :ref:`projectconf`. | ||
|
||
Arduino Nicla Sense ME has on-board debug probe and **IS READY** for debugging. You don't need to use/buy external debug probe. | ||
|
||
.. list-table:: | ||
:header-rows: 1 | ||
|
||
* - Compatible Tools | ||
- On-board | ||
- Default | ||
* - :ref:`debugging_tool_blackmagic` | ||
- | ||
- | ||
* - :ref:`debugging_tool_cmsis-dap` | ||
- Yes | ||
- Yes | ||
* - :ref:`debugging_tool_jlink` | ||
- | ||
- | ||
|
||
Frameworks | ||
---------- | ||
.. list-table:: | ||
:header-rows: 1 | ||
|
||
* - Name | ||
- Description | ||
|
||
* - :ref:`framework_arduino` | ||
- Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.