You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by "rcsim (via GitHub)" <gi...@apache.org> on 2025/02/10 02:26:02 UTC
[PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
rcsim opened a new pull request, #15798:
URL: https://github.com/apache/nuttx/pull/15798
## Summary
This PR adds support to to Seeed XIAO nRF52840 Board. There are 4 initial configurations:
- nsh: Basic NuttXShell configuration (console enabled in UART0, at 115200 bps).
- usbnsh: Basic NuttXShell configuration using CDC/ACM serial (console enabled in USB Port, at 115200 bps).
- leds: This configuration enabled NuttXShell via USB and enabled leds example.
- gpio: This configuration enabled NuttXShell via USB and enabled gpio example
## Impact
Users will be able to use NuttX on Seeed XIAO nRF52840 Board.
## Testing
Build one of the available configurations and access NuttX Shell:
```
make distclean
/tools/configure.sh xiao-nrf52840:usbnsh
make -j
```
Access NuttX Shell:
```
NuttShell (NSH) NuttX-12.8.0
nsh>
nsh> uname -a
NuttX 12.8.0 34bcb280f7 Feb 9 2025 23:09:07 arm xiao-nrf52840
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "lupyuen (via GitHub)" <gi...@apache.org>.
lupyuen commented on code in PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#discussion_r1948328255
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
+
+===== =====
+Color Pin
+===== =====
+RED P0.26
+GREEN P0.30
+BLUE P0.6
+===== =====
+
+Buttons
+=======
+
+The Reset button can be used to enter bootloader mode by rapidly clicking
+it twice. Then, it will enumerate as a storage device to a computer
+connected via USB. Saving a .UF2 file to this device will replace
+the Flash ROM contents on the nRF52840.
+
+
+Pin Mapping
+===========
+Pads numbered anticlockwise from USB connector.
+
+===== ========== ==========
+Pad Signal Notes
+===== ========== ==========
+0 P0.02 D0/A0
+1 P0.03 D1/A1
+2 P0.28 D2/A2
+3 P0.29 D3/A3
+4 P0.04 D4/SDA
+5 P0.05 D5/SCL
+6 P1.11 Default TX for UART0 serial console
+7 P1.12 Default RX for UART0 serial console
+8 P1.13 D8/SCK
+9 P1.14 D9/MISO
+10 P1.15 D10/MOSI
+11 3V3 Power output to peripherals
+12 Ground
+13 VIN +5V Supply to board
+===== ========== ==========
+
+Power Supply
+============
+The working voltage of the MCU is 3.3V. Voltage input connected to
+general I/O pins may cause chip damage if it’s higher than 3.3V.
+
+Installation
+============
+
+1. Download UF2 Tools:
+
+.. code-block:: console
+
+ $ git clone https://github.com/microsoft/uf2.git
+
+2. Configure and build NuttX:
+
+.. code-block:: console
+
+ $ git clone https://github.com/apache/nuttx.git nuttx
+ $ git clone https://github.com/apache/nuttx-apps.git apps
+ $ cd nuttx
+ $ make distclean
+ $ ./tools/configure.sh xiao-nrf52840:nsh
+ $ make V=1
+
+3. Convert nuttx.hex to UF2 format using U2F Tools:
+
+.. code-block:: console
+
+ $ python3 uf2/utils/uf2conv.py -c -f 0xADA52840 -i nuttx.hex -o nuttx.uf2
+
+4. Connect the Seeed Studio XIAO nRF52840, and enter bootloader mode by rapidly
+clicking it twice. The board will be detected as a USB Mass Storage Device.
+Then copy “nuttx.uf2” into the device.
+
+6. To access the console, TX and RX pins must be connected to the
+ device such as USB-serial converter.
+
+Configurations
+==============
+
+nsh
+---
+Basic NuttXShell configuration (console enabled in UART0, at 115200 bps).
Review Comment:
```suggestion
Basic NuttShell configuration (console enabled in UART0, at 115200 bps).
```
##########
boards/Kconfig:
##########
@@ -1221,6 +1221,13 @@ config ARCH_BOARD_NRF52840_DONGLE
---help---
This option selects the Nordic nRF52840 Dongle (PCA10059)
+config ARCH_BOARD_XIAO_NRF52840
+ bool "Seeed Xiao nRF52840 )"
Review Comment:
```suggestion
bool "Seeed Xiao nRF52840"
```
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
Review Comment:
```suggestion
The RGB LED is connected as follows:
```
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
+
+===== =====
+Color Pin
+===== =====
+RED P0.26
+GREEN P0.30
+BLUE P0.6
+===== =====
+
+Buttons
+=======
+
+The Reset button can be used to enter bootloader mode by rapidly clicking
+it twice. Then, it will enumerate as a storage device to a computer
+connected via USB. Saving a .UF2 file to this device will replace
+the Flash ROM contents on the nRF52840.
+
+
+Pin Mapping
+===========
+Pads numbered anticlockwise from USB connector.
+
+===== ========== ==========
+Pad Signal Notes
+===== ========== ==========
+0 P0.02 D0/A0
+1 P0.03 D1/A1
+2 P0.28 D2/A2
+3 P0.29 D3/A3
+4 P0.04 D4/SDA
+5 P0.05 D5/SCL
+6 P1.11 Default TX for UART0 serial console
+7 P1.12 Default RX for UART0 serial console
+8 P1.13 D8/SCK
+9 P1.14 D9/MISO
+10 P1.15 D10/MOSI
+11 3V3 Power output to peripherals
+12 Ground
+13 VIN +5V Supply to board
+===== ========== ==========
+
+Power Supply
+============
+The working voltage of the MCU is 3.3V. Voltage input connected to
+general I/O pins may cause chip damage if it’s higher than 3.3V.
+
+Installation
+============
+
+1. Download UF2 Tools:
+
+.. code-block:: console
+
+ $ git clone https://github.com/microsoft/uf2.git
+
+2. Configure and build NuttX:
+
+.. code-block:: console
+
+ $ git clone https://github.com/apache/nuttx.git nuttx
+ $ git clone https://github.com/apache/nuttx-apps.git apps
+ $ cd nuttx
+ $ make distclean
+ $ ./tools/configure.sh xiao-nrf52840:nsh
+ $ make V=1
+
+3. Convert nuttx.hex to UF2 format using U2F Tools:
+
+.. code-block:: console
+
+ $ python3 uf2/utils/uf2conv.py -c -f 0xADA52840 -i nuttx.hex -o nuttx.uf2
+
+4. Connect the Seeed Studio XIAO nRF52840, and enter bootloader mode by rapidly
+clicking it twice. The board will be detected as a USB Mass Storage Device.
+Then copy “nuttx.uf2” into the device.
+
+6. To access the console, TX and RX pins must be connected to the
+ device such as USB-serial converter.
+
+Configurations
+==============
+
+nsh
+---
+Basic NuttXShell configuration (console enabled in UART0, at 115200 bps).
+
+usbnsh
+------
+Basic NuttXShell configuration using CDC/ACM serial (console enabled in USB Port,
Review Comment:
```suggestion
Basic NuttShell configuration using CDC/ACM serial (console enabled in USB Port,
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#issuecomment-2648531468
> @rcsim could you merge `leds` defconfig and `gpio` defconfig into one config called `jumbo`? this way we limit the CI usage a bit, and the nrf52840 has enough flash to fit everything in a single configuration
Yes, I did that now. Thanks
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on code in PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#discussion_r1949362870
##########
boards/Kconfig:
##########
@@ -1221,6 +1221,13 @@ config ARCH_BOARD_NRF52840_DONGLE
---help---
This option selects the Nordic nRF52840 Dongle (PCA10059)
+config ARCH_BOARD_XIAO_NRF52840
+ bool "Seeed Xiao nRF52840 )"
Review Comment:
Thanks, this has been fixed.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on code in PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#discussion_r1949355506
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
Review Comment:
Hi @lupyuen , I've fixed that, but I will submit the documentation using a different PR as @jerpelea requested.
Thanks
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#issuecomment-2648634052
> > please move documentation to a separate PR
>
> Sure, I will create a new PR with Documentation only. Thanks.
Done: https://github.com/apache/nuttx/pull/15803
Thanks!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "nuttxpr (via GitHub)" <gi...@apache.org>.
nuttxpr commented on PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#issuecomment-2646788330
[**\[Experimental Bot, please feedback here\]**](https://github.com/search?q=repo%3Aapache%2Fnuttx+13552&type=issues)
Yes, this PR appears to meet the basic NuttX requirements, but it could be improved with more detail. Here's a breakdown of what's good and what's missing:
**Strengths:**
* **Clear Summary:** The summary explains the "what" (adding XIAO nRF52840 support) and the "how" (four initial configurations).
* **User Impact is Addressed:** The impact section mentions the new ability to use NuttX on the board.
* **Testing Instructions Provided:** Clear steps for building and accessing the shell are given.
* **Testing Output Shown:** Example output from `uname -a` verifies basic functionality.
**Weaknesses & Missing Information:**
* **Missing "Why":** The summary doesn't explain *why* this change is necessary. Is there a demand for this board? Does it offer unique capabilities?
* **Functional Change Detail:** The summary mentions configurations but lacks specifics about code changes. Which files were modified? Were new drivers or board-specific logic added?
* **Incomplete Impact Assessment:** The impact section is too brief. Consider these points:
* **Build Impact:** Did adding this board require changes to the build system (e.g., new Kconfig options, board directory structure)?
* **Hardware Impact:** Specify the architecture (ARM Cortex-M4) and any board-specific hardware used (e.g., UART, USB peripheral).
* **Documentation Impact:** Does this PR include updates to the documentation (e.g., board configuration instructions)? If not, it should.
* **Other Impacts:** The remaining impact categories (security, compatibility, etc.) are simply omitted. Even if the answer is "NO," explicitly state it for each.
* **Insufficient Testing:** The testing section only demonstrates basic shell access. More comprehensive testing is needed to validate the different configurations (nsh, usbnsh, leds, gpio). Show output from the `leds` and `gpio` examples. Test different peripherals. Consider testing on multiple build hosts if feasible.
* **Missing "Before" Logs:** The template requests "Testing logs before change," which are absent. While not always strictly necessary for new board support, it's good practice to show that the board *didn't* work before your changes. Even a simple build failure log would suffice.
**Recommendations for Improvement:**
1. **Expand the Summary:** Explain the motivation for adding support for this board.
2. **Detail Code Changes:** Be more specific about the files modified and the code added.
3. **Complete the Impact Assessment:** Address *all* impact categories, even if the answer is "NO." Provide specifics for "YES" answers.
4. **Enhance Testing:** Provide testing output for all configurations, demonstrating the functionality of the `leds` and `gpio` examples. Test other peripherals if applicable. If possible, test on different build hosts.
5. **Include "Before" Logs:** Even a simple build failure log demonstrating that the board wasn't previously supported would be helpful.
By addressing these points, the PR will be significantly stronger and more likely to be accepted.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "acassis (via GitHub)" <gi...@apache.org>.
acassis merged PR #15798:
URL: https://github.com/apache/nuttx/pull/15798
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#issuecomment-2648533851
> please move documentation to a separate PR
Sure, I will create a new PR with Documentation only. Thanks.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "raiden00pl (via GitHub)" <gi...@apache.org>.
raiden00pl commented on PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#issuecomment-2647145308
@rcsim could you merge `leds` defconfig and `gpio` defconfig into one config called `jumbo`? this way we limit the CI usage a bit, and the nrf52840 has enough flash to fit everything in a single configuration
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on code in PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#discussion_r1949357916
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
+
+===== =====
+Color Pin
+===== =====
+RED P0.26
+GREEN P0.30
+BLUE P0.6
+===== =====
+
+Buttons
+=======
+
+The Reset button can be used to enter bootloader mode by rapidly clicking
+it twice. Then, it will enumerate as a storage device to a computer
+connected via USB. Saving a .UF2 file to this device will replace
+the Flash ROM contents on the nRF52840.
+
+
+Pin Mapping
+===========
+Pads numbered anticlockwise from USB connector.
+
+===== ========== ==========
+Pad Signal Notes
+===== ========== ==========
+0 P0.02 D0/A0
+1 P0.03 D1/A1
+2 P0.28 D2/A2
+3 P0.29 D3/A3
+4 P0.04 D4/SDA
+5 P0.05 D5/SCL
+6 P1.11 Default TX for UART0 serial console
+7 P1.12 Default RX for UART0 serial console
+8 P1.13 D8/SCK
+9 P1.14 D9/MISO
+10 P1.15 D10/MOSI
+11 3V3 Power output to peripherals
+12 Ground
+13 VIN +5V Supply to board
+===== ========== ==========
+
+Power Supply
+============
+The working voltage of the MCU is 3.3V. Voltage input connected to
+general I/O pins may cause chip damage if it’s higher than 3.3V.
+
+Installation
+============
+
+1. Download UF2 Tools:
+
+.. code-block:: console
+
+ $ git clone https://github.com/microsoft/uf2.git
+
+2. Configure and build NuttX:
+
+.. code-block:: console
+
+ $ git clone https://github.com/apache/nuttx.git nuttx
+ $ git clone https://github.com/apache/nuttx-apps.git apps
+ $ cd nuttx
+ $ make distclean
+ $ ./tools/configure.sh xiao-nrf52840:nsh
+ $ make V=1
+
+3. Convert nuttx.hex to UF2 format using U2F Tools:
+
+.. code-block:: console
+
+ $ python3 uf2/utils/uf2conv.py -c -f 0xADA52840 -i nuttx.hex -o nuttx.uf2
+
+4. Connect the Seeed Studio XIAO nRF52840, and enter bootloader mode by rapidly
+clicking it twice. The board will be detected as a USB Mass Storage Device.
+Then copy “nuttx.uf2” into the device.
+
+6. To access the console, TX and RX pins must be connected to the
+ device such as USB-serial converter.
+
+Configurations
+==============
+
+nsh
+---
+Basic NuttXShell configuration (console enabled in UART0, at 115200 bps).
+
+usbnsh
+------
+Basic NuttXShell configuration using CDC/ACM serial (console enabled in USB Port,
Review Comment:
Same here.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] boards/arm Add support to Seeed Xiao nRF52840 Board [nuttx]
Posted by "rcsim (via GitHub)" <gi...@apache.org>.
rcsim commented on code in PR #15798:
URL: https://github.com/apache/nuttx/pull/15798#discussion_r1949357549
##########
Documentation/platforms/arm/nrf52/boards/xiao-nrf52840/index.rst:
##########
@@ -0,0 +1,178 @@
+=============
+XIAO nRF52840
+=============
+
+The `Seeed Studio XIAO nRF52840 <https://wiki.seeedstudio.com/XIAO_BLE/>`_ is a general purpose board supplied by
+Seeed Studio and it is compatible with the Nordic nRF52840 ecosystem as they share the same MCU.
+
+.. figure:: xiao-nrf52840.jpg
+ :align: center
+
+Features
+========
+
+* Nordic nRF52840, ARM® Cortex®-M4 32-bit processor with FPU, 64 MHz
+* 256 KB RAM,1MB Flash 2MB onboard Flash
+* Bluetooth 5.0/BLE/NFC
+* 1xUART, 1xI2C, 1xSPI, 1xNFC, 1xSWD, 11xGPIO(PWM)
+* USB Type-C interface
+* 1 RGB LED, 1 charge LED
+* 1 RESET button
+
+Serial Console
+==============
+
+By default, a serial console appears on pins 6 (TX P1.11) and pin 7
+(RX P1.12). This console runs a 115200-8N1.
+The board can be configured to use the USB connection as the serial console.
+
+User LED
+========
+
+The RBG LED is connected as follows:
+
+===== =====
+Color Pin
+===== =====
+RED P0.26
+GREEN P0.30
+BLUE P0.6
+===== =====
+
+Buttons
+=======
+
+The Reset button can be used to enter bootloader mode by rapidly clicking
+it twice. Then, it will enumerate as a storage device to a computer
+connected via USB. Saving a .UF2 file to this device will replace
+the Flash ROM contents on the nRF52840.
+
+
+Pin Mapping
+===========
+Pads numbered anticlockwise from USB connector.
+
+===== ========== ==========
+Pad Signal Notes
+===== ========== ==========
+0 P0.02 D0/A0
+1 P0.03 D1/A1
+2 P0.28 D2/A2
+3 P0.29 D3/A3
+4 P0.04 D4/SDA
+5 P0.05 D5/SCL
+6 P1.11 Default TX for UART0 serial console
+7 P1.12 Default RX for UART0 serial console
+8 P1.13 D8/SCK
+9 P1.14 D9/MISO
+10 P1.15 D10/MOSI
+11 3V3 Power output to peripherals
+12 Ground
+13 VIN +5V Supply to board
+===== ========== ==========
+
+Power Supply
+============
+The working voltage of the MCU is 3.3V. Voltage input connected to
+general I/O pins may cause chip damage if it’s higher than 3.3V.
+
+Installation
+============
+
+1. Download UF2 Tools:
+
+.. code-block:: console
+
+ $ git clone https://github.com/microsoft/uf2.git
+
+2. Configure and build NuttX:
+
+.. code-block:: console
+
+ $ git clone https://github.com/apache/nuttx.git nuttx
+ $ git clone https://github.com/apache/nuttx-apps.git apps
+ $ cd nuttx
+ $ make distclean
+ $ ./tools/configure.sh xiao-nrf52840:nsh
+ $ make V=1
+
+3. Convert nuttx.hex to UF2 format using U2F Tools:
+
+.. code-block:: console
+
+ $ python3 uf2/utils/uf2conv.py -c -f 0xADA52840 -i nuttx.hex -o nuttx.uf2
+
+4. Connect the Seeed Studio XIAO nRF52840, and enter bootloader mode by rapidly
+clicking it twice. The board will be detected as a USB Mass Storage Device.
+Then copy “nuttx.uf2” into the device.
+
+6. To access the console, TX and RX pins must be connected to the
+ device such as USB-serial converter.
+
+Configurations
+==============
+
+nsh
+---
+Basic NuttXShell configuration (console enabled in UART0, at 115200 bps).
Review Comment:
Same here.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org