0.1. Postavljanje MicroPythona
Pločica ne pokreće MicroPython odmah nakon vađenja iz kutije. Za razliku od Arduina, gdje kod prevodiš na računalu i gotov program pošalješ pločici, MicroPython je interpreter koji živi na samoj pločici. Zato prije pisanja bilo kakvog koda jednom staviš MicroPython na pločicu, a od tada joj šalješ .py datoteke koje će izvršavati.
Ova stranica vodi te od pločice svježe iz kutije do pločice koja pokreće tvoj kod. Ovo moraš proći samo jednom.
Do kraja ove stranice imat ćeš:
- Driver koji tvoje računalo treba da bi vidjelo pločicu
- Instaliran Thonny, spreman za pisanje i pokretanje koda
- MicroPython firmware na pločici
- Soldered drivere kopirane na pločicu, spremne za Qwiic module
1. Instaliraj USB driver
NULA Mini razgovara s tvojim računalom preko CH340 čipa na pločici, a ni Windows ni macOS ne dolaze s driverom za njega. Bez drivera pločica dobiva napajanje, ali se nikada ne pojavi kao port, pa ništa dalje na ovoj stranici neće raditi.
CH340 drivers
Instalacija drivera na Windowsu, macOS-u i Linuxu, i što učiniti kada pločica i dalje nije prepoznata.
Kada je instaliran, priključi pločicu i potvrdi da se pojavljuje:
| Sustav | Što tražiti |
|---|---|
| Windows | COM port u Device Manageru pod Ports (COM & LPT) |
| macOS | Uređaj imena /dev/cu.wchusbserial... |
| Linux | Uređaj imena /dev/ttyUSB0 |
2. Instaliraj Thonny
Thonny je mali Python editor napravljen upravo za ovaj posao. Može flashati MicroPython na pločicu, uređivati datoteke direktno na njoj i dati ti živi prompt za razgovor s njom, sve bez naredbenog retka.
Download Thonny
Besplatan Python editor za početnike, dostupan za Windows, macOS i Linux.
esptool i mpremote. Te naredbe su navedene uz svaki korak.3. Stavi MicroPython na pločicu
NULA Mini je ESP32-C6 pločica, pa pokreće ESP32_GENERIC_C6 build MicroPythona.
Pomoću Thonnyja
- Spoji pločicu preko USB-C.
- Otvori Tools → Options → Interpreter.
- Postavi interpreter na MicroPython (ESP32).
- Odaberi port svoje pločice iz padajućeg izbornika.
- Klikni Install or update MicroPython na dnu dijaloga.
- U prozoru koji se otvori odaberi ESP32-C6 target i najnoviju ponuđenu verziju, pa klikni Install.
Thonny preuzima firmware i flasha ga za tebe. Kada završi, zatvori dijalog.
Pomoću naredbenog retka
Prvo preuzmi najnoviji stabilni .bin:
MicroPython firmware for ESP32-C6
Službena stranica za preuzimanje. Uzmi najnoviji stabilni build, ne nightly.
pip install esptool
python -m esptool --chip esp32c6 --port COM5 erase_flash
python -m esptool --chip esp32c6 --port COM5 --baud 460800 write_flash 0 ESP32_GENERIC_C6-<version>.bin
Zamijeni COM5 svojim portom, a <version> imenom datoteke koju si preuzeo.
115200.4. Pozdravi se
S instaliranim MicroPythonom pločica ti daje živi prompt koji se zove REPL: upišeš liniju, pločica je odmah izvrši i ispiše odgovor. To je najbrži način da potvrdiš da sve radi.
U Thonnyju pogledaj Shell panel na dnu. Trebao bi vidjeti nešto kao MicroPython v1.x.x on ... nakon čega slijedi >>>. Upiši:
print("Hello from the NULA Mini!")
Pritisni Enter. Pločica to odmah ispisuje natrag.
REPL radi na 115200 bauda, što je zadana vrijednost i u Thonnyju i u mpremote, pa nema se što konfigurirati.
5. Kopiraj Soldered drivere na pločicu
Osam primjera u ovom kitu koristi tri Qwiic modula: 16x2 LCD, ultrazvučni senzor udaljenosti i SHTC3 senzor temperature i vlage. Svaki od njih treba driver, a u MicroPythonu je driver jednostavno .py datoteka koja mora živjeti na pločici.
Driveri se nalaze u lib folderu repozitorija primjera:
| Driver | Koriste ga | Daje |
|---|---|---|
lib/LCD.py | 4.1, 4.2, 7.1, 7.7 | LCD_I2C, 16x2 Qwiic ekran |
lib/SHTC3.py | 5.1, 7.1 | SHTC3, senzor temperature i vlage |
lib/UltrasonicSensor.py | 3.1, 3.2, 7.3 | UltrasonicSensor, senzor udaljenosti |
lib/Qwiic.py | tri drivera iznad | dijeljeni Qwiic helper na kojem se svi grade |
MicroPython traži uvezene module u folderu imena lib na pločici, pa cijeli folder ide na nju kakav je.
Pomoću Thonnyja
- Otvori View → Files ako Files panel već nije prikazan. Ima dvije polovice: tvoje računalo gore, pločica ispod.
- U gornjoj polovici otvori
libfolder repozitorija primjera. - Klikni desnim klikom na
libfolder i odaberi Upload to /.
Pomoću naredbenog retka
pip install mpremote
mpremote connect auto fs cp -r lib :
urequests i ntptime, koje koriste Wi-Fi primjeri, već su ugrađeni u firmware.Sekcije 1, 2 i 6 ne koriste ništa osim ugrađenih modula, pa ako želiš početi odmah, možeš se vratiti na ovaj korak kada dođeš do sekcije 3.
6. Pokreni primjer
Otvori bilo koju .py datoteku primjera u Thonnyju i pritisni Run (zelena tipka za pokretanje). Kod se izvršava na pločici, a njegov ispis pojavljuje se u Shellu.
Iz naredbenog retka:
mpremote connect auto run 1_Basic_Skills/1.1_Hello_World/1.1_Hello_World.py
Da bi se program sam pokrenuo svaki put kad se pločica upali, što je korisno kada je projekt gotov i želiš da radi bez priključenog računala, kopiraj ga na pločicu pod imenom main.py:
mpremote connect auto fs cp 1_Basic_Skills/1.2_LED_blinking/1.2_LED_blinking.py :main.py
main.py pokreće se svaki put kad se pločica napoji. Da ga zaustaviš i vratiš prompt, pritisni Ctrl+C u Shellu.Ako nešto ne radi
| Simptom | Uzrok |
|---|---|
| Nigdje nema porta za odabir | CH340 driver nije instaliran. Vrati se na korak 1. |
ImportError: no module named 'LCD' | lib folder nije kopiran na pločicu, ili je sletio negdje drugdje osim u /lib. Vidi korak 5. |
| Shell ne prikazuje ništa, ili ništa osim šuma | Odabran je pogrešan port, ili ga drži otvorenim drugi program. Zatvori svaki drugi serijski monitor. |
| Kod se izvršava, ali pločica kao da ignorira izmjene | Uredio si kopiju na računalu a pokrenuo kopiju na pločici, ili obrnuto. Pogledaj naslovnu traku u Thonnyju da vidiš koja je datoteka otvorena. |
Dalje
Sve je postavljeno. Idemo na prvi primjer.
1.1. Hello World
Ispiši svoju prvu poruku s pločice na računalo.