Arduino source code that accompanies First Look at the Seeed Studio XIAO ESP32C6.
The XIAO ESP32C6 is a recent addition to the Seeed Studio XIAO series of diminutive development boards. It is based on the Espressif ESP32-C6 SoC which is the second Espressif microcontroller based on a RISC-V core.
The current Espressif 32 platform (version 6.7.0 dated May 14, 2024) in PlatformIO (PIO) is based on version 2.0.16 of the ESP32 Arduino core. Consequently it does not support the XIAO ESP32C6 (see Add board support for Seeed XIAO ESP32C6). For that reason, these sketches cannot be compiled in PIO. Nevertheless the directory structure and file names are such that it will be easy to include PlatformIO when it takes on version 3.0 of the ESP32 Arduino core.
The latest version of the Arduino IDE can be obtained for Windows, Linux and macOS in the Downloads page from Arduino.
Install the latest Espressif ESP32 Arduino core.
-
Add https://espressif.github.io/arduino-esp32/package_esp32_index.json in the Additional Boards Manager URLS in the Preferences window in the IDE.
-
Install platform
esp32by Espressif version 3.0.2 or newer with the Boards Manager
Select the XIAO_ESP32C6 board in the Tools menu of the IDE when compiling a project.
Arduino sketches must have an .ino file name extension and must be contained in a directory that has the same name as the Arduino sketch (excluding the extension). Consequently the 01_pin_names project contains a directory named pin_names that in turn contains the Arduino sketch pin_names.ino. That sketch is basically empty as it is a long comment only. This is not a problem because the Arduino IDE will import all source files found in the sketch directory. The actual code is in main.cpp which is the default name of a PlatformIO project.
| Project | NB | Purpose |
|---|---|---|
| 01_pin_names | 1,2 | Shows the content of pins_arduino.h |
| 02_blink_pulse_led | 2 | Using digitalRead, digitalWrite, analogWrite (PWM) |
| 03_scan_wifi | 2,3 | WiFiScan example from the esp32-arduino core |
| 04_wifi_blackhole | 4 | Looks at Wi-Fi station connect times |
| 05_wifi_tx_power | 2,4 | Wi-Fi TX power vs connect time |
| 06_async_web_led | 1,2,4,5 | Toggles the built-in LED on and off with a Web interface |
| 07_ble_led | 1,2 | Toggles the built-in LED on and off with a Bluetooth LE app |
| 08_zigbee_switch | 6 | Modified Zigbee_Light_Switch example from the esp32-arduino core |
| 09_zigbee_bulb | 6 | Modified Zigbee_Light_Bulb example from the esp32-arduino core |
| 10_deep_sleep_tmr | Deep sleep with timed wake up | |
| 11_deep_sleep_io | 7 | Deep sleep with wake up on I/O event |
| 12_xiao32c6_antenna | Examines the I/O configuration for the antenna RF switch | |
| 13_wifi_uptime | 5 | Comparing Wi-Fi connectivity across boards |
NB:
- Similar to sketch in xiao_esp32c3_sketches
- Similar to sketch in supermini_esp32c3_sketches
- Released under the GNU LESSER GENERAL PUBLIC LICENSE.
- Create a
secret.hfile with the correct Wi-Fi credentials using thesecrets.h.templateas a model. - Need to install two libraries. The details are in libraries/README.md.
- Added support for some XIAO ESP32C6 features. Released under the Apache License, Version 2.0 .
- Requires an external pull up resistor.
Flash the Zigbee_Light_Switch firmware on one XIAO ESP32C6 and the Zigbee_Light_Bulb firmware on a second XIAO ESP32C6. The boot button on the first board will toggle the yellow LED on/off on the second board.
The Zigbee_Light_Bulb board will pair with a Zigbee2MQTT coordinator although it is not supported by the latter.
With the August 6, 2024 correction that enables the RF switch and properly selects an antenna, it is no longer necessary to reduce the link quality threshold in the Zigbee_Light_Bulb sketch. Nevertheless, the LQI_THRESHOLD macro remains in the code.
See First Look at the Seeed Studio XIAO ESP32C6 for some details about these programs.
| Date | |
|---|---|
| 2024-08-12 | Added Wi-Fi uptime test |
| 2024-08-09 | Corrected and completed RF switch and antenna selection fix |
| 2024-08-09 | Made the project self-contained by adding private copies of required libraries. |
| 2024-08-06 | Fixed RF switch enable and antenna selection for ESP32 Arduino 3.0.2 and up |
| 2024-08-05 | Investigation of I/O ports controlling the antenna RF switch |
| 2024-08-04 | New pin definitions added in ESP32 Arduino 3.0.4 |
| 2024-07-18 | Add board pinout |
| 2024-07-09 | Included use of the Serial peripheral in deep sleep examples |
| 2024-07-08 | Added deep sleep examples |
| 2024-07-07 | Added support for an external antenna (for XIAO ESP32C6) in Zigbee examples |
| 2024-07-01 | Set LQI threshold only when LQI_THRESHOLD macro is defined in the Zigbee Bulb example |
| 2024-06-29 | Improved ble_led |
| 2024-06-28 | Added ble_led sketch based on BLE libraries |
| 2024-06-27 | Added async web led sketch and libraries directory |
| 2024-06-26 | Added Zigbee Light Switch and Bulb sketches |
| 2024-06-25 | Updated after version 3.0.2 of esp32 core released |
| 2024-06-24 | Initial version |
Copyright 2024, Michel Deslierres. No rights reserved.
While the copyright pertaining to included libraries must be respected, all the code by Michel Deslierres in this repository is in the public domain. In those jurisdictions where this may be a problem, the BSD Zero Clause License applies.