Schnellstart
Der schnellste erste Erfolg mit diesem Board ist, die RGB-LED zum Leuchten zu bringen. Wählen Sie unten Ihre Umgebung: Jeder Tab installiert die Werkzeuge, lädt ein Programm hoch, das die LED blinken lässt, und zeigt, was Sie sehen sollten.
- Arduino
- MicroPython
- ESP-IDF
1. Plattform installieren
Installieren Sie die Arduino IDE von arduino.cc und öffnen Sie sie anschließend.
2. Board-Definitionen installieren
Das Board läuft mit dem Arduino-Core von Espressif für den ESP32. Öffnen Sie in der Arduino IDE das Fenster „Preferences" und tragen Sie diese URL in das Feld Additional Board Manager URLs ein:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Öffnen Sie dann den Boards Manager über das Menü Tools > Board und installieren Sie die Plattform esp32.
3. Board auswählen
Der ESP32-Core hat für dieses Board noch keinen eigenen Eintrag. Verwenden Sie daher den generischen Eintrag für den Chip:
- Verbinden Sie das Board mit dem USB-C-Kabel mit Ihrem Computer.
- Wählen Sie Tools > Board > esp32 > ESP32S3 Dev Module.
- Stellen Sie Tools > Flash Size auf 8MB (64Mb) und Tools > PSRAM auf OPI PSRAM. Das entspricht den 8 MB Flash und 8 MB Octal-PSRAM des Moduls.
- Wählen Sie unter Tools > Port den seriellen Port des Boards.
Zwischen dem USB-C-Connector und dem ESP32-S3 sitzt ein CH340K-Chip (ein USB-zu-seriell-Wandler). Ihr Computer benötigt daher den CH340-Driver, um den Port zu erkennen. Lassen Sie Tools > USB CDC On Boot auf dem Standardwert Disabled: Serial verwendet dann UART0, und dort ist der CH340K angeschlossen.
4. Erstes Programm hochladen
Die RGB-LED des Boards ist eine WS2812B, eine adressierbare LED, die Farbdaten über einen einzigen Pin erhält statt eines einfachen Ein/Aus-Pegels. Sie sitzt an GPIO6 und wird von der Funktion rgbLedWrite() des Cores angesteuert. Dieser Sketch lässt sie einmal pro Sekunde weiß blinken, was der schnellste Weg ist, um zu sehen, dass der Upload funktioniert hat.
// Blink the onboard WS2812B RGB LED (next to the IO6 label): 0.5 s on, 0.5 s off.
// The generic ESP32S3 Dev Module defines RGB_BUILTIN as GPIO48,
// so the pin is set here to this board's LED pin.
const uint8_t RGB_LED_PIN = 6;
void setup()
{
}
void loop()
{
rgbLedWrite(RGB_LED_PIN, 64, 64, 64); // LED on, white at a quarter of full brightness
delay(500);
rgbLedWrite(RGB_LED_PIN, 0, 0, 0); // LED off
delay(500);
}
rgbLedWrite(pin, red, green, blue) wird mit dem ESP32-Board-Paket mitgeliefert. Gleiche Werte für Rot, Grün und Blau ergeben Weiß, und alle drei auf 0 schalten die LED aus.
5. Was Sie erwartet
Klicken Sie in der Arduino IDE auf Upload. Das Board verfügt über automatischen Reset, der Upload startet also, ohne dass Sie eine Taste drücken müssen. Der Sketch gibt nichts im Serial Monitor aus; das Ergebnis sehen Sie auf dem Board. Die RGB-LED neben der Beschriftung IO6, direkt über den Tasten USER und RESET, leuchtet eine halbe Sekunde lang weiß und ist dann eine halbe Sekunde lang aus.
6. Fehlerbehebung
Wenn das Board nicht erkannt wird oder der Upload fehlschlägt, lesen Sie weiter unter Fehlerbehebung.
1. Plattform installieren
MicroPython wird mit dem Programm esptool.py auf das Board gebracht, das Sie in der esptool-Dokumentation von Espressif finden. Unter Windows heißt das installierte Programm möglicherweise esptool statt esptool.py.
esptool benötigt Python 3.10 oder neuer. Die Installationsanleitung installiert mit pip die neueste stabile Version:
pip install esptool
Falls dies bei Ihrer Python-Installation einen Fehler ergibt, versuchen Sie python -m pip install esptool oder pip3 install esptool.
2. Firmware installieren
Das Modul des Boards hat 8 MB Octal-PSRAM, daher benötigt es die Firmware ESP32_GENERIC_S3 mit Octal-SPIRAM-Unterstützung (die Variante SPIRAM_OCT). Laden Sie die neueste .bin-Datei von der Download-Seite für ESP32_GENERIC_S3 herunter.
Verbinden Sie das Board mit dem USB-C-Kabel. Wenn Sie MicroPython zum ersten Mal auf das Board bringen, löschen Sie zuerst den gesamten Flash:
esptool.py erase_flash
Spielen Sie anschließend die Firmware ab Adresse 0 auf das Board auf:
esptool.py --baud 460800 write_flash 0 ESP32_BOARD_NAME-DATE-VERSION.bin
Ersetzen Sie ESP32_BOARD_NAME-DATE-VERSION.bin durch die heruntergeladene .bin-Datei. Wenn das Flashen beginnt und dann mittendrin fehlschlägt, entfernen Sie die Option --baud 460800, um mit der langsameren Standardgeschwindigkeit zu flashen.
3. Board und Port auswählen
esptool.py versucht, den seriellen Port des Boards selbst zu finden. Schlägt das fehl oder sind mehrere Espressif-Boards angeschlossen, geben Sie den Port mit --port an:
esptool.py --port PORTNAME erase_flash
esptool.py --port PORTNAME --baud 460800 write_flash 0 ESP32_BOARD_NAME-DATE-VERSION.bin
Unter Linux lautet der Portname meist ähnlich wie /dev/ttyUSB oder /dev/ttyACM0, auf einem Mac /dev/cu.usbmodem01 und unter Windows COM4.
Der MicroPython-Prompt (die REPL) liegt auf UART0, der mit einem USB-seriell-Wandler verbunden sein kann, oder auf dem im Chip integrierten USB. Bei diesem Board führt UART0 zum USB-seriell-Chip CH340K am USB-C-Connector. Öffnen Sie den seriellen Port des Boards in einem Terminalprogramm mit 115200 Baud.
4. Erstes Programm hochladen
Die RGB-LED an GPIO6 ist eine WS2812B, daher steuert MicroPython sie mit dem Modul neopixel an und nicht mit einem einfachen Pin. Drücken Sie am Prompt Ctrl-E, um den Paste-Modus aufzurufen, fügen Sie das Programm ein und drücken Sie dann Ctrl-D, um es auszuführen.
# Blink the onboard RGB LED on GPIO6: 0.5 s on, 0.5 s off.
from machine import Pin
from neopixel import NeoPixel
import time
led = NeoPixel(Pin(6, Pin.OUT), 1) # one WS2812B LED on GPIO6
while True:
led[0] = (64, 64, 64) # equal red, green and blue: white
led.write()
time.sleep(0.5)
led[0] = (0, 0, 0) # off
led.write()
time.sleep(0.5)
NeoPixel(pin, n) erzeugt einen Driver für n LEDs an diesem Pin. Das Setzen von led[0] speichert eine Farbe als Rot-, Grün- und Blauwerte, und write() sendet sie an die LED.
5. Was Sie erwartet
Die RGB-LED blinkt einmal pro Sekunde weiß. Das Programm gibt nichts aus. Die RGB-LED neben der Beschriftung IO6, direkt über den Tasten USER und RESET, leuchtet eine halbe Sekunde lang weiß und ist dann eine halbe Sekunde lang aus.
6. Fehlerbehebung
Wenn die REPL nicht reagiert oder das Flashen der Firmware fehlschlägt, lesen Sie weiter unter Fehlerbehebung.
1. Plattform installieren
Installieren Sie ESP-IDF v6.1 anhand der Get-Started-Anleitung von Espressif für den ESP32-S3. Sie enthält je eine Seite für Windows, Linux und macOS.
2. Ziel festlegen
Kopieren Sie das Blink-Beispiel von ESP-IDF in Ihren Arbeitsordner, wechseln Sie hinein und legen Sie den Chip fest:
cd ~/esp
cp -r $IDF_PATH/examples/get-started/blink .
cd ~/esp/blink
idf.py set-target esp32s3
3. Projekt konfigurieren
Öffnen Sie das Konfigurationsmenü:
idf.py menuconfig
Stellen Sie unter Example Configuration Folgendes ein:
- Blink LED type auf LED strip, da die LED des Boards eine adressierbare WS2812B ist;
- Blink GPIO number auf
6.
Lassen Sie Blink period in ms auf dem Standardwert 1000. Speichern Sie und verlassen Sie das Menü.
4. Erstes Programm bauen und flashen
Verbinden Sie das Board mit dem USB-C-Kabel und führen Sie dann Build, Flash und das Öffnen des Monitors in einem Befehl aus. Ersetzen Sie PORT durch den seriellen Port des Boards.
idf.py -p PORT flash monitor
5. Was Sie erwartet
Der Monitor setzt das Board zurück und gibt sein Start-up-Log aus, danach die Ausgabe des Programms. Die ersten Zeilen dieser Ausgabe sehen Sie unten; solange das Programm läuft, kommt jede Sekunde eine neue Zeile hinzu. Drücken Sie Ctrl+], um den Monitor zu verlassen. Die RGB-LED neben der Beschriftung IO6 leuchtet eine Sekunde lang weiß und bleibt dann eine Sekunde lang aus.I (315) example: Example configured to blink addressable LED!
I (325) example: Turning the LED OFF!
I (1325) example: Turning the LED ON!
I (2325) example: Turning the LED OFF!
I (3325) example: Turning the LED ON!
6. Fehlerbehebung
Wenn das Projekt nicht gebaut oder geflasht werden kann, lesen Sie weiter unter Fehlerbehebung.