mirror of
https://github.com/apache/nuttx.git
synced 2026-05-31 14:27:37 +08:00
Documentation: Add Seeed Studio XIAO ESP32C3 Board
This commit adds the documentation for the Seeed Studio XIAO ESP32C3 board. It includes examples for GPIOs, Wifi and BT. Signed-off-by: Rodrigo Sim rcsim10@gmail.com
This commit is contained in:
Rodrigo Sim
Xiang Xiao
@@ -0,0 +1,237 @@
|
|||||||
|
=========================
|
||||||
|
Seeed Studio XIAO ESP32C3
|
||||||
|
=========================
|
||||||
|
|
||||||
|
The `Seeed Studio XIAO ESP32C3 <https://wiki.seeedstudio.com/xiao_esp32c3_getting_started/>`_ is a general purpose board supplied by
|
||||||
|
Seeed Studio and it is compatible with the Espressif ESP32C3 ecosystem, sharing the same MCU as ESP32-C3-DevKitC.
|
||||||
|
|
||||||
|
.. figure:: xiao-esp32c3.jpg
|
||||||
|
:align: center
|
||||||
|
|
||||||
|
Features
|
||||||
|
========
|
||||||
|
|
||||||
|
* 32bit RISC-V single core processor that operates at up to 160 MHz
|
||||||
|
* 400KB of SRAM, and 4MB of on-board flash memory
|
||||||
|
* USB Type-C interface
|
||||||
|
* Wireless: Complete 2.4GHz Wi-Fi subsystem;
|
||||||
|
* BLE: Bluetooth 5.0, Bluetooth mesh
|
||||||
|
* 1x UART, 1x I2C, 1x SPI,11x GPIO(PWM), 4x ADC
|
||||||
|
* 1 RESET button, 1 BOOT button
|
||||||
|
|
||||||
|
NSH Console
|
||||||
|
===========
|
||||||
|
|
||||||
|
The NuttShell (NSH) console is available over USB using the CDC/ACM
|
||||||
|
serial interface. To access the console, connect via a terminal emulator
|
||||||
|
at 115200 baud, 8 data bits, no parity, and 1 stop bit (115200-8N1).
|
||||||
|
|
||||||
|
|
||||||
|
Buttons
|
||||||
|
=======
|
||||||
|
|
||||||
|
The RESET and BOOT buttons can be used to enter "Bootloader" mode by
|
||||||
|
press and hold the BOOT key while powering up and then press the RESET key once.
|
||||||
|
|
||||||
|
Pin Mapping
|
||||||
|
===========
|
||||||
|
Pads numbered anticlockwise from USB connector.
|
||||||
|
|
||||||
|
===== ========== ==========
|
||||||
|
Pad Signal Notes
|
||||||
|
===== ========== ==========
|
||||||
|
0 GPIO02 D0/A0
|
||||||
|
1 GPIO03 D1/A1
|
||||||
|
2 GPIO04 D2/A2
|
||||||
|
3 GPIO05 D3/A3
|
||||||
|
4 GPIO06 D4/SDA
|
||||||
|
5 GPIO07 D5/SCL
|
||||||
|
6 GPIO21 D6/Default TX for UART0 serial console
|
||||||
|
7 GPIO20 D7/Default RX for UART0 serial console
|
||||||
|
8 GPIO08 D8/SCK
|
||||||
|
9 GPIO09 D9/MISO
|
||||||
|
10 GPIO10 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. 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-esp32c3:usbnsh
|
||||||
|
$ make V=1
|
||||||
|
|
||||||
|
2. Connect the Seeed Studio XIAO ESP32C3, and enter "Bootloader" mode,
|
||||||
|
then, flash the ``nuttx.hex`` file using ``esptool``:
|
||||||
|
(https://docs.espressif.com/projects/esptool/en/latest/esp32/)
|
||||||
|
|
||||||
|
Example command:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
make flash ESPTOOL_PORT=/dev/ttyACM0 ESPTOOL_BINDIR=./
|
||||||
|
|
||||||
|
|
||||||
|
Configurations
|
||||||
|
==============
|
||||||
|
|
||||||
|
nsh
|
||||||
|
---
|
||||||
|
|
||||||
|
Basic NuttShell configuration using serial (console enabled in UART0, exposed via
|
||||||
|
pins D6/TX and D7/RX, at 115200 bps).
|
||||||
|
|
||||||
|
usbnsh
|
||||||
|
------
|
||||||
|
Basic NuttShell configuration using CDC/ACM serial (console enabled in USB Port,
|
||||||
|
at 115200 bps).
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
NuttShell (NSH) NuttX-12.8.0
|
||||||
|
nsh> uname -a
|
||||||
|
NuttX 12.8.0 2c845426da-dirty Apr 6 2025 22:53:57 xtensa esp32c3-xiao
|
||||||
|
|
||||||
|
|
||||||
|
gpio
|
||||||
|
----
|
||||||
|
This configuration enabled NuttShell via USB and enabled gpio example.
|
||||||
|
|
||||||
|
Testing gpios:
|
||||||
|
|
||||||
|
======== ====== ==========
|
||||||
|
PIN/GPIO Mode Device
|
||||||
|
======== ====== ==========
|
||||||
|
D0/GPIO2 Output /dev/gpio0
|
||||||
|
D1/GPIO3 Input /dev/gpio1
|
||||||
|
======== ====== ==========
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
nsh> gpio -o 1 /dev/gpio0
|
||||||
|
Driver: /dev/gpio0
|
||||||
|
Output pin: Value=1
|
||||||
|
Writing: Value=1
|
||||||
|
Verify: Value=1
|
||||||
|
nsh>
|
||||||
|
nsh> gpio -o 0 /dev/gpio0
|
||||||
|
Driver: /dev/gpio0
|
||||||
|
Output pin: Value=1
|
||||||
|
Writing: Value=0
|
||||||
|
Verify: Value=0
|
||||||
|
nsh> gpio -w 1 /dev/gpio1
|
||||||
|
Driver: /dev/gpio1
|
||||||
|
Interrupt pin: Value=0
|
||||||
|
Verify: Value=1
|
||||||
|
|
||||||
|
wifi
|
||||||
|
----
|
||||||
|
This configuration enables a wlan network interface that can be configured and initialized
|
||||||
|
using below commands::
|
||||||
|
|
||||||
|
nsh> ifup wlan0
|
||||||
|
nsh> wapi psk wlan0 mypasswd 3
|
||||||
|
nsh> wapi essid wlan0 myssid 1
|
||||||
|
nsh> renew wlan0
|
||||||
|
|
||||||
|
In this case a connection to AP with SSID ``myssid`` is done, using ``mypasswd`` as
|
||||||
|
password. IP address is obtained via DHCP using ``renew`` command. You can check
|
||||||
|
the result by running ``ifconfig`` afterwards.
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
NuttShell (NSH) NuttX-12.8.0
|
||||||
|
nsh> uname -a
|
||||||
|
NuttX 12.9.0 6b4bc72626-dirty Apr 26 2025 17:40:37 risc-v esp32c3-xiao
|
||||||
|
nsh> ?
|
||||||
|
help usage: help [-v] [<cmd>]
|
||||||
|
|
||||||
|
. cp expr pkill pwd uname
|
||||||
|
[ cmp false ls rm umount
|
||||||
|
? dirname fdinfo mkdir rmdir unset
|
||||||
|
alias date free mkrd set uptime
|
||||||
|
unalias df help mount sleep usleep
|
||||||
|
arp dmesg hexdump mv source watch
|
||||||
|
basename echo ifconfig nslookup test xd
|
||||||
|
break env ifdown pidof time wait
|
||||||
|
cat exec ifup printf true
|
||||||
|
cd exit kill ps truncate
|
||||||
|
|
||||||
|
Builtin Apps:
|
||||||
|
dd getprime ostest rand sh
|
||||||
|
dumpstack nsh ping renew wapi
|
||||||
|
nsh> wapi psk wlan0 nuttxpwd 3
|
||||||
|
nsh> wapi essid wlan0 nuttxnw 1
|
||||||
|
nsh> renew wlan0
|
||||||
|
nsh> ifconfig
|
||||||
|
wlan0 Link encap:Ethernet HWaddr a0:85:e3:0e:4a:30 at RUNNING mtu 576
|
||||||
|
inet addr:192.168.59.144 DRaddr:192.168.59.134 Mask:255.255.255.0
|
||||||
|
|
||||||
|
nsh> ping 8.8.8.8
|
||||||
|
PING 8.8.8.8 56 bytes of data
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=0 time=50.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=1 time=40.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=2 time=30.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=3 time=60.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=4 time=100.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=5 time=100.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=6 time=140.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=7 time=40.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=8 time=50.0 ms
|
||||||
|
56 bytes from 8.8.8.8: icmp_seq=9 time=30.0 ms
|
||||||
|
10 packets transmitted, 10 received, 0% packet loss, time 10100 ms
|
||||||
|
rtt min/avg/max/mdev = 30.000/64.000/140.000/34.985 ms
|
||||||
|
nsh> nslookup google.com
|
||||||
|
Host: google.com Addr: 142.251.128.238
|
||||||
|
nsh> nslookup nuttx.apache.org
|
||||||
|
Host: nuttx.apache.org Addr: 151.101.2.132
|
||||||
|
nsh>
|
||||||
|
|
||||||
|
ble
|
||||||
|
---
|
||||||
|
This configuration is used to enable the Bluetooth Low Energy (BLE) of
|
||||||
|
ESP32-C3 chip.
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
NuttShell (NSH) NuttX-12.8.0
|
||||||
|
nsh> bt bnep0 scan start
|
||||||
|
nsh> bt bnep0 scan stop
|
||||||
|
nsh> bt bnep0 scan get
|
||||||
|
Scan result:
|
||||||
|
1. addr: a0:46:5a:22:ea:c4 type: 0
|
||||||
|
rssi: -92
|
||||||
|
response type: 0
|
||||||
|
advertiser data: 02 01 02 19 16 f1 fc 04 f9 6e e8 58 e6 33 58 26 c5 4b bd 91 1c e0 4f b2 d9 51 455
|
||||||
|
2. addr: a0:46:5a:22:ea:c4 type: 0
|
||||||
|
rssi: -91
|
||||||
|
response type: 0
|
||||||
|
advertiser data: 02 01 02 19 16 f1 fc 04 f9 6e e8 58 e6 33 58 26 c5 4b bd 91 1c e0 4f b2 d9 51 455
|
||||||
|
3. addr: a0:46:5a:22:ea:c4 type: 0
|
||||||
|
rssi: -100
|
||||||
|
response type: 0
|
||||||
|
advertiser data: 02 01 02 19 16 f1 fc 04 f9 6e e8 58 e6 33 58 26 c5 4b bd 91 1c e0 4f b2 d9 51 455
|
||||||
|
4. addr: a0:46:5a:22:ea:c4 type: 0
|
||||||
|
rssi: -100
|
||||||
|
response type: 4
|
||||||
|
advertiser data:
|
||||||
|
5. addr: a0:46:5a:22:ea:c4 type: 0
|
||||||
|
rssi: -97
|
||||||
|
response type: 0
|
||||||
|
advertiser data: 02 01 02 19 16 f1 fc 04 f9 6e e8 58 e6 33 58 26
|
||||||
|
|
||||||
|
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 70 KiB |
Reference in New Issue
Block a user