Brzi početak
Najbrži prvi uspjeh na ovoj pločici jest paljenje njezine RGB LED diode. Odaberite svoje okruženje u nastavku: svaka kartica instalira alate, učitava program koji treperi LED diodom i prikazuje što biste trebali vidjeti.
- Arduino
- MicroPython
- ESP-IDF
1. Instalirajte platformu
Instalirajte Arduino IDE s arduino.cc, a zatim ga otvorite.
2. Instalirajte definicije pločice
Pločica radi na Espressifovoj Arduino jezgri za ESP32. U Arduino IDE-u otvorite prozor Preferences i u polje Additional Board Manager URLs unesite ovaj URL:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Zatim iz izbornika Tools > Board otvorite Boards Manager i instalirajte platformu esp32.
3. Odaberite pločicu
ESP32 jezgra za ovu pločicu još nema vlastiti unos, pa upotrijebite generički unos za njezin čip:
- Povežite pločicu s računalom USB-C kabelom.
- Odaberite Tools > Board > esp32 > ESP32S3 Dev Module.
- Postavite Tools > Flash Size na 8MB (64Mb) i Tools > PSRAM na OPI PSRAM. Te vrijednosti odgovaraju modulu s 8 MB flasha i 8 MB oktalnog PSRAM-a.
- Odaberite serijski port pločice pod Tools > Port.
Između USB-C konektora i ESP32-S3 nalazi se čip CH340K (USB-serijski pretvornik), pa vaše računalo treba upravljački program CH340 da bi vidjelo port. Postavku Tools > USB CDC On Boot ostavite na zadanoj vrijednosti, Disabled: Serial tada koristi UART0, a na njega je spojen CH340K.
4. Učitajte svoj prvi program
RGB LED dioda na pločici je WS2812B, adresabilna LED dioda koja boju prima na jednom pinu, a ne kao običnu razinu uključeno/isključeno. Nalazi se na GPIO6, a upravlja se funkcijom rgbLedWrite() iz jezgre. Ova skica jednom u sekundi bijelo zatreperi LED diodom, što je najbrži način da provjerite je li učitavanje uspjelo.
// 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) dolazi uz paket pločica za ESP32. Jednake vrijednosti crvene, zelene i plave daju bijelu boju, a sve tri na 0 gase LED diodu.
5. Što očekivati
Kliknite Upload u Arduino IDE-u. Pločica ima automatski reset, pa učitavanje počinje bez pritiskanja tipke. Skica ne ispisuje ništa u Serial Monitor; rezultat se vidi na pločici. RGB LED dioda pokraj oznake IO6, odmah iznad tipki USER i RESET, svijetli bijelo pola sekunde, a zatim je pola sekunde ugašena.
6. Otklanjanje poteškoća
Ako pločica nije prepoznata ili učitavanje ne uspije, nastavite na Otklanjanje poteškoća.
1. Instalirajte platformu
MicroPython se na pločicu učitava programom esptool.py, koji možete pronaći u Espressifovoj dokumentaciji za esptool. Na Windowsu se instalirani program može zvati esptool umjesto esptool.py.
esptool zahtijeva Python 3.10 ili noviji. Njegov vodič za instalaciju pomoću pipa instalira najnovije stabilno izdanje:
pip install esptool
Ako to na vašoj instalaciji Pythona javi grešku, pokušajte s python -m pip install esptool ili pip3 install esptool.
2. Instalirajte firmware
Modul pločice ima 8 MB oktalnog PSRAM-a, pa mu treba firmware ESP32_GENERIC_S3 s podrškom za Octal-SPIRAM (varijanta SPIRAM_OCT). Preuzmite njegovu najnoviju .bin datoteku sa stranice za preuzimanje ESP32_GENERIC_S3.
Povežite pločicu USB-C kabelom. Ako MicroPython na pločicu stavljate prvi put, najprije obrišite cijeli flash:
esptool.py erase_flash
Zatim učitajte firmware na pločicu, počevši od adrese 0:
esptool.py --baud 460800 write_flash 0 ESP32_BOARD_NAME-DATE-VERSION.bin
Zamijenite ESP32_BOARD_NAME-DATE-VERSION.bin datotekom .bin koju ste preuzeli. Ako flashanje krene, a zatim zakaže usred postupka, uklonite opciju --baud 460800 kako biste flashali zadanom, sporijom brzinom.
3. Odaberite pločicu i port
esptool.py sam pokušava pronaći serijski port pločice. Ako to ne uspije ili je spojeno više Espressifovih pločica, port zadajte opcijom --port:
esptool.py --port PORTNAME erase_flash
esptool.py --port PORTNAME --baud 460800 write_flash 0 ESP32_BOARD_NAME-DATE-VERSION.bin
Na Linuxu je naziv porta obično nalik na /dev/ttyUSB ili /dev/ttyACM0, na Macu /dev/cu.usbmodem01, a na Windowsu COM4.
MicroPython prompt (REPL) nalazi se na UART0, koji može biti spojen na USB-serijski pretvornik, ili na ugrađenom USB-u čipa. Na ovoj pločici UART0 ide na čip CH340K (USB-serijski pretvornik) na USB-C konektoru. Otvorite serijski port pločice u terminalskom programu pri 115200 baud.
4. Učitajte svoj prvi program
RGB LED dioda na GPIO6 je WS2812B, pa njome MicroPython upravlja modulom neopixel, a ne običnim Pin. Na promptu pritisnite Ctrl-E za ulazak u način lijepljenja (paste mode), zalijepite program, a zatim pritisnite Ctrl-D da ga pokrenete.
# 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) stvara upravljački program za n LED dioda na tom pinu. Postavljanjem led[0] sprema se boja kao vrijednosti crvene, zelene i plave, a write() je šalje na LED diodu.
5. Što očekivati
RGB LED dioda treperi bijelo jednom u sekundi. Program ne ispisuje ništa. RGB LED dioda pokraj oznake IO6, odmah iznad tipki USER i RESET, svijetli bijelo pola sekunde, a zatim je pola sekunde ugašena.
6. Otklanjanje poteškoća
Ako REPL ne odgovara ili flashanje firmwarea ne uspije, nastavite na Otklanjanje poteškoća.
1. Instalirajte platformu
Instalirajte ESP-IDF v6.1 prema Espressifovu vodiču Get Started za ESP32-S3. Ima zasebnu stranicu za Windows, Linux i macOS.
2. Postavite ciljni čip
Kopirajte ESP-IDF-ov primjer blink u svoju radnu mapu, uđite u njega i postavite čip:
cd ~/esp
cp -r $IDF_PATH/examples/get-started/blink .
cd ~/esp/blink
idf.py set-target esp32s3
3. Konfigurirajte projekt
Otvorite izbornik konfiguracije:
idf.py menuconfig
Pod Example Configuration postavite:
- Blink LED type na LED strip, jer je LED dioda na pločici adresabilna WS2812B;
- Blink GPIO number na
6.
Blink period in ms ostavite na zadanoj vrijednosti, 1000. Spremite i izađite iz izbornika.
4. Izgradite i učitajte svoj prvi program
Povežite pločicu USB-C kabelom, a zatim jednom naredbom izgradite program, učitajte ga i otvorite monitor. Zamijenite PORT serijskim portom pločice.
idf.py -p PORT flash monitor
5. Što očekivati
Monitor resetira pločicu i ispisuje njezin zapis pokretanja, a zatim
ispis programa. Prvi retci tog ispisa nalaze se u nastavku, a novi redak
slijedi svake sekunde dok program radi. Pritisnite Ctrl+] za izlaz iz monitora. RGB LED dioda pokraj oznake IO6 svijetli bijelo jednu sekundu, a zatim je jednu sekundu ugašena.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. Otklanjanje poteškoća
Ako se projekt ne izgradi ili se ne učita na pločicu, nastavite na Otklanjanje poteškoća.