Skip to content

flash.md

Latest commit

 

History

History
59 lines (40 loc) · 2.86 KB

flash.md

File metadata and controls

59 lines (40 loc) · 2.86 KB
Raw

Flash firmware

Flash after wiring, before assembly. Overview order: getting-started.md. Centering (Move all to 90°) happens on this desk harness; do not finish the Wi-Fi wizard until assembly.md §20.

Firmware is Arduino on PlatformIO (pioarduino / Arduino-ESP32 3.x). Board and baud live in platformio.ini.

Physical module is a Waveshare ESP32-C3-Zero. PlatformIO board = esp32-c3-devkitm-1 is a build target name, not a different board.

Install and connect

  1. Install PlatformIO Core (or the PlatformIO IDE extension).
  2. Use a USB-C data cable. Charge-only cables fail upload and serial.
  3. Connect the board over USB (Adafruit 5993 data lines when the harness is wired; onboard USB-C on a bare C3-Zero also works for this step).

Build, upload, serial

From the project root:

pio run                 # build
pio run -t upload       # flash firmware + LittleFS
pio device monitor      # serial (115200)

After firmware upload, a post-script also uploads LittleFS (scripts/upload_fs_after_upload.py) so WAV assets (welcome, bell, and friends) land on the board. If animations move but stay silent, run pio run -t uploadfs once.

Several serial ports:

pio device list
pio run -t upload --upload-port <PORT>
pio device monitor --port <PORT>

<PORT> is the name pio device list prints for the board, and it is platform-specific: COM4 on Windows, /dev/cu.usbmodemXXXX or /dev/cu.usbserial-XXXX on macOS, /dev/ttyACM0 or /dev/ttyUSB0 on Linux. Pick the entry whose hardware ID shows Espressif's VID:PID=303A:1001 (the ESP32-C3's native USB) or your board's USB-serial bridge — pio device list also lists Bluetooth serial ports, which are not the board.

Done when

Firmware + LittleFS uploaded, and:

  • Serial shows a normal boot (TINY ENGINEER … PCA9685 found … no hang)
  • Onboard RGB is dim green during init (not a repeating red blink)
  • One servo moves: join setup AP TinyEngineer-XXXX, open http://192.168.4.1/config, press Move all to 90° (or POST /test/servo)

Fatal init hangs and blinks the RGB red. Count flashes before the long gap:

Blinks Meaning
1 PCA9685 not found on I2C 0x40 — wiring / address
2 MAX98357A / I2S init failed

Details: hardware/testing.md — boot-failure blink codes.

Stop here. Do not complete the setup wizard (home Wi-Fi, ranges, OLED, LED, speaker) until the robot is assembled — assembly.md §20. Then return to getting-started and assemble.