Initialize ESP32-S3 smoke-test project cycling the RGB led.

2026-08-21 11:51:56 +02:00
commit 0ce360da20
10 changed files with 227 additions and 0 deletions
@@ -0,0 +1,37 @@
+# ESP32 Serial Swiss Army Knife
+
+Universal wireless serial adaptor firmware for the ESP32-S3.
+
+## Initial hardware target
+
+- ESP32-S3-DevKitC-1
+- ESP32-S3-WROOM-1-N16R8 module
+- 16 MB flash
+- 8 MB octal PSRAM
+
+The initial smoke-test firmware continuously sweeps the onboard addressable RGB LED through the color wheel at reduced brightness. The official ESP32-S3-DevKitC-1 v1.0 uses GPIO48 for the LED data signal, while official v1.1 boards use GPIO38. Compatible boards and clones may vary.
+
+## Build
+
+```sh
+pio run
+```
+
+## Upload and monitor
+
+Connect the board's USB-to-UART port, then run:
+
+```sh
+pio run --target upload
+pio device monitor
+```
+
+The application logs its startup, detected PSRAM size, and configured RGB LED GPIO at 115200 baud. Expected output includes:
+
+```text
+ESP32-S3 build-chain smoke test started
+PSRAM initialized: 8388608 bytes
+Sweeping the onboard RGB LED on GPIO48
+```
+
+If the firmware runs but the RGB LED remains dark, verify the board revision. The project defaults to GPIO48, commonly used by DevKitC-compatible boards and official v1.0 boards. For an official v1.1 board—or another board wired that way—change `RGB_LED_GPIO` in `platformio.ini` from `48` to `38`, rebuild, and upload again.