Quick Start
Plug the board in over USB-C and follow the tab for your platform to upload a first program that blinks the green WIFI ON LED. Once that works, the library pages show how to read aircraft from the onboard TT-SC1 receiver.
- Arduino
- MicroPython
1. Install the platform
Espressif's Arduino core needs Arduino IDE 1.8 or later. Download the current version from the Arduino software page.
2. Install the board definitions
Install the Arduino core for ESP32 with the Boards Manager, following Espressif's installation guide:
-
Start Arduino and open the Preferences window.
-
Enter this stable release link into the Additional Board Manager URLs field:
https://espressif.github.io/arduino-esp32/package_esp32_index.json -
Open Boards Manager from the Tools > Board menu and install the esp32 platform.
The board's USB-C port goes through a CH340K USB-to-serial chip. When you plug the board in, wait for its driver to install, or install the CH340 driver yourself if your computer does not find one.
3. Select the board
Select ESP32S3 Dev Module from the Tools > Board menu, then select the serial port the board is attached to.
4. Upload your first program
This sketch blinks the onboard LED, marked WIFI ON on the board, once a second. That is the quickest way to see that the upload worked.
// Blink the onboard LED (marked WIFI ON): 0.5 s on, 0.5 s off.
const int LED_PIN = 16;
void setup()
{
pinMode(LED_PIN, OUTPUT);
}
void loop()
{
digitalWrite(LED_PIN, HIGH); // LED on
delay(500);
digitalWrite(LED_PIN, LOW); // LED off
delay(500);
}
5. What to expect
Compile and upload the sketch. When the upload finishes, the board runs it. The green WIFI ON LED, in the column of four status LEDs between the two
Qwiic connectors, blinks once a second.
Next, install the library and read your first aircraft reports on Read aircraft reports.
6. Troubleshooting
If the board is not detected or the upload fails, continue with Troubleshooting.
1. Install the platform
MicroPython's download page programs the board with Espressif's
esptool, which the
esptool documentation
covers. The download page calls the program esptool.py; current esptool
releases install it as esptool, and the commands below use that name.
esptool is installed separately from mpremote. Its installation page installs the latest stable release with pip:
pip install esptool
To work with the board afterwards, install mpremote, MicroPython's
command-line tool, with pip:
pip install --user mpremote
2. Install the firmware
On MicroPython's ESP32-S3 download page, download the .bin file from
Firmware (Support for Octal-SPIRAM). This board's ESP32-S3-WROOM-1-N8R8
module has octal SPI PSRAM, and the page says to use that variant on a board
with Octal SPIRAM.
If you are putting MicroPython on the board for the first time, first erase the entire flash:
esptool erase-flash
Then deploy the firmware to the board, starting at address 0. Replace
ESP32_BOARD_NAME-DATE-VERSION.bin with the .bin file you downloaded:
esptool --baud 460800 write-flash 0 ESP32_BOARD_NAME-DATE-VERSION.bin
esptool tries to find the board's serial port by itself. If that fails, or
there might be more than one Espressif-based device attached to your computer,
pass the port with the --port option, for example:
esptool --port PORTNAME erase-flash
On Windows the port name is usually similar to COM4. If flashing starts and
then fails partway through, try removing the --baud 460800 option.
3. Select the board and port
The MicroPython firmware for this chip gives its prompt (the REPL) on the
ESP32-S3's UART0 at 115200 baud, and on this board UART0 goes to the USB-C
port through the CH340K. Run mpremote with no arguments: it connects to the
first available USB serial device and gives you the REPL.
mpremote
4. Upload your first program
This program blinks the onboard LED, marked WIFI ON on the board, once a
second. Save it to a file on your computer, then run it on the board with
mpremote run <file.py>, putting your file's name in place of <file.py>.
# Blink the onboard LED (marked WIFI ON): 0.5 s on, 0.5 s off.
from machine import Pin
import time
led = Pin(16, Pin.OUT)
while True:
led.value(1) # LED on
time.sleep(0.5)
led.value(0) # LED off
time.sleep(0.5)
5. What to expect
The green WIFI ON LED, in the column of four status LEDs between the two
Qwiic connectors, blinks once a second.mpremote run runs the file straight from the board's RAM, without copying it
to the board's filesystem.
Next, install the module and read your first aircraft reports on MicroPython Library.
6. Troubleshooting
If the REPL does not respond or firmware flashing fails, continue with Troubleshooting.