ESP32MINI1
Uputstvo za upotrebu
Preliminary v0.1
Espressif Systems
Copyright © 2021
O ovom priručniku
Ovaj korisnički priručnik pokazuje kako započeti s ESP32-MINI-1 modulom.
Ažuriranja dokumenata
Molimo uvijek pogledajte najnoviju verziju na https://www.espressif.com/en/support/download/documents.
Istorija revizija
Za istoriju revizija ovog dokumenta, pogledajte posljednju stranicu.
Obavijest o promjeni dokumentacije
Espressif pruža obavještenja putem e-pošte kako bi klijente obavijestili o promjenama tehničke dokumentacije. Molimo pretplatite se na www.espressif.com/en/subscribe.
Certifikacija
Preuzmite certifikate za Espressif proizvode sa www.espressif.com/en/certificates.
Gotovoview
1.1 Modul Overview
LE MCU modul koji ima bogat skup perifernih uređaja. Ovaj modul je idealan izbor za širok spektar IoT aplikacija, u rasponu od kućne automatizacije, pametne zgrade, potrošačke elektronike do industrijske kontrole, posebno pogodan za aplikacije unutar kompaktnog prostora, kao što su sijalice, prekidači i utičnice. ESP32-MINI-1 je visoko integrisan Wi-Fi+Bluetooth® +Bluetooth® male veličine Ovaj modul dolazi u dvije verzije:
- 85 °C verzija
- 105 °C verzija
Tabela 1. Specifikacije ESP1MINI32
| Kategorije | Predmeti | Specifikacije |
|
Wi-Fi |
Protokoli | 802.11 b/g/n (802.11n do 150 Mbps) |
| A-MPDU i A-MSDU agregacija i 0.4 µs guard interval podrška | ||
| Frekvencijski opseg | 2412 ~ 2484 MHz | |
|
Bluetooth® |
Protokoli | Protokoli v4.2 BR/EDR i Bluetooth® LE specifikacije |
| Radio | Predajnik klase-1, klase-2 i klase-3 | |
| AFH | ||
| Audio | CVSD i SBC | |
|
Hardver |
Interfejsi modula |
SD kartica, UART, SPI, SDIO, I2C, LED PWM, Motor PWM, I2S, infracrveni daljinski upravljač, brojač impulsa, GPIO, senzor na dodir, ADC, DAC, dvožični automobilski interfejs (TWAITM, kompatibilan sa ISO11898-1) |
| Integrisani kristal | 40 MHz kristal | |
| Integrisani SPI blic | 4 MB | |
| operativni voltage/Napajanje | 3.0 V ~ 3.6 V | |
| Radna struja | Prosjek: 80 mA | |
| Minimalna struja koju isporučuje napajanje | 500 mA | |
| Preporučeni raspon radnih temperatura | Verzija za 85 °C: –40 °C ~ +85 °C; Verzija za 105 °C: –40 °C ~ +105 °C | |
| Nivo osjetljivosti na vlagu (MSL) | Nivo 3 |
1.2 Opis pina
ESP32-MINI-1 ima 55 pinova. Pogledajte definicije pinova u tabeli 1-2.
Tabela 1. Definicije pinova
| Ime | br. | Tip | Funkcija |
| GND | 1, 2, 27, 38 ~ 55 | P | Ground |
| 3V3 | 3 | P | Napajanje |
| I36 | 4 | I | GPIO36, ADC1_CH0, RTC_GPIO0 |
| I37 | 5 | I | GPIO37, ADC1_CH1, RTC_GPIO1 |
| I38 | 6 | I | GPIO38, ADC1_CH2, RTC_GPIO2 |
| I39 | 7 | I | GPIO39, ADC1_CH3, RTC_GPIO3 |
|
EN |
8 |
I |
Visoko: omogućava čip Nisko: čip se isključuje Napomena: ne ostavljajte iglu da pluta |
| I34 | 9 | I | GPIO34, ADC1_CH6, RTC_GPIO4 |
| I35 | 10 | I | GPIO35, ADC1_CH7, RTC_GPIO5 |
| IO32 | 11 | I/O | GPIO32, XTAL_32K_P (32.768 kHz ulaz kristalnog oscilatora), ADC1_CH4, TOUCH9, RTC_GPIO9 |
| IO33 | 12 | I/O | GPIO33, XTAL_32K_N (32.768 kHz izlaz kristalnog oscilatora), ADC1_CH5, TOUCH8, RTC_GPIO8 |
| IO25 | 13 | I/O | GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0 |
| IO26 | 14 | I/O | GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1 |
| IO27 | 15 | I/O | GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV |
| IO14 | 16 | I/O | GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2 |
| IO12 | 17 | I/O | GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3 |
| IO13 | 18 | I/O | GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER |
| IO15 | 19 | I/O | GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3 |
| IO2 | 20 | I/O | GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0,
SD_DATA0 |
| IO0 | 21 | I/O | GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK |
| IO4 | 22 | I/O | GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER |
| NC | 23 | – | Nema veze |
| NC | 24 | – | Nema veze |
| IO9 | 25 | I/O | GPIO9, HS1_DATA2, U1RXD, SD_DATA2 |
| IO10 | 26 | I/O | GPIO10, HS1_DATA3, U1TXD, SD_DATA3 |
| NC | 28 | – | Nema veze |
| IO5 | 29 | I/O | GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK |
| IO18 | 30 | I/O | GPIO18, HS1_DATA7, VSPICLK |
| IO23 | 31 | I/O | GPIO23, HS1_STROBE, VSPID |
| IO19 | 32 | I/O | GPIO19, VSPIQ, U0CTS, EMAC_TXD0 |
Nastavak na sljedećoj stranici
Tabela 1 – nastavak sa prethodne stranice
| Ime | br. | Tip | Funkcija |
| IO22 | 33 | I/O | GPIO22, VSPIWP, U0RTS, EMAC_TXD1 |
| IO21 | 34 | I/O | GPIO21, VSPIHD, EMAC_TX_EN |
| RXD0 | 35 | I/O | GPIO3, U0RXD, CLK_OUT2 |
| TXD0 | 36 | I/O | GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2 |
| NC | 37 | – | Nema veze |
¹ Pinovi GPIO6, GPIO7, GPIO8, GPIO11, GPIO16 i GPIO17 na ESP32-U4WDH čipu su povezani na SPI blic integrisan na modulu i nisu izvođeni.
² Za konfiguracije perifernih pinova, pogledajte ESP32 Series Datasheet.
Započnite sa ESP32MINI1
2.1 Šta vam treba
Za razvoj aplikacija za ESP32-MINI-1 modul potrebno vam je:
- 1 x ESP32-MINI-1 modul
- 1 x Espressif RF ploča za testiranje
- 1 x USB-to-Serial ploča
- 1 x mikro-USB kabl
- 1 x PC sa Linuxom
U ovom korisničkom vodiču, operativni sistem Linux uzimamo kao primjerample. Za više informacija o konfiguraciji za Windows i macOS, pogledajte ESP-IDF Vodič za programiranje.
2.2 Povezivanje hardvera
- Zalemite modul ESP32-MINI-1 na ploču za RF testiranje kao što je prikazano na slici 2-1.
- Povežite ploču za RF testiranje na ploču USB-to-Serial preko TXD, RXD i GND.
- Povežite USB-na-serijsku ploču na PC.
- Povežite ploču za RF testiranje na računar ili adapter za napajanje da biste omogućili napajanje od 5 V, preko Micro-USB kabla.
- Tokom preuzimanja, povežite IO0 na GND preko kratkospojnika. Zatim uključite ploču za testiranje.
- Preuzmite firmver u flash. Za detalje pogledajte odjeljke u nastavku.
- Nakon preuzimanja, uklonite kratkospojnik na IO0 i GND.
- Ponovo uključite RF testnu ploču. ESP32-MINI-1 će se prebaciti u radni režim. Čip će čitati programe sa flash memorije nakon inicijalizacije.
Napomena:
IO0 je interno logički visok. Ako je IO0 postavljen na pull-up, bira se način pokretanja. Ako je ovaj pin padajući ili lebdeći lijevo, odabran je način preuzimanja. Za više informacija o ESP32-MINI-1, pogledajte ESP32-MINI-1 Datasheet.
2.3 Postavljanje razvojnog okruženja
Espressif IoT razvojni okvir (skraćeno ESP-IDF) je okvir za razvoj aplikacija zasnovanih na Espressif ESP32. Korisnici mogu razvijati aplikacije sa ESP32 u Windows/Linux/macOS bazirane na ESP-IDF. Ovdje kao primjer uzimamo operativni sistem Linuxample.
2.3.1 Preduvjeti za instaliranje
Za kompajliranje sa ESP-IDF morate nabaviti sljedeće pakete:
- CentOS 7:
sudo yum install git wget flex bison gperf python cmake ninja−build ccache dfu−util - Ubuntu i Debian (jedna naredba se razbija u dva reda):
sudo apt−get install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build-cache libffi −dev libssl −dev dfu−util - luk:
sudo Pacman −S −−potreban gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
Napomena: - Ovaj vodič koristi direktorij ~/esp na Linuxu kao instalacioni folder za ESP-IDF.
- Imajte na umu da ESP-IDF ne podržava razmake u putanjama.
2.3.2 Nabavite ESPIDF
Da biste napravili aplikacije za ESP32-MINI-1 modul, potrebne su vam biblioteke softvera koje nudi Espressif u ESP-IDF spremište.
Da biste dobili ESP-IDF, kreirajte instalacijski direktorij ( ~/esp) za preuzimanje ESP-IDF i klonirajte spremište pomoću 'git clone':
mkdir −p ~/esp
cd ~/esp
git clone −−rekurzivno https://github.com/espressif/esp−idf.git
ESP-IDF će biti preuzet u ~/esp/esp-idf. Konsultujte se ESP-IDF verzije za informacije o tome koju verziju ESP-IDF koristiti u datoj situaciji.
2.3.3 Postavljanje alata
Osim ESP-IDF-a, također morate instalirati alate koje koristi ESP-IDF, kao što su kompajler, debuger,
Python paketi, itd. ESP-IDF pruža skriptu pod nazivom 'install.sh' koja pomaže pri postavljanju alata u jednom potezu.
cd ~/esp/esp-idf
./ instaliraj .sh
2.3.4 Postavljanje varijabli okruženja
Instalirani alati još nisu dodati PATH varijabli okruženja. Da bi alati bili upotrebljivi iz komandne linije, moraju se postaviti neke varijable okruženja. ESP-IDF pruža drugu skriptu 'export.sh' koja to radi. U terminalu na kojem ćete koristiti ESP-IDF pokrenite:
. $HOME/esp/esp-idf/export.sh
Sada je sve spremno, možete izgraditi svoj prvi projekat na ESP32-MINI-1 modulu.
2.4 Kreirajte svoj prvi projekat
2.4.1 Pokrenite projekat
Sada ste spremni da pripremite svoju aplikaciju za ESP32-MINI-1 modul. Možete početi sa get-started/hello_world projekat od examples direktorij u ESP-IDF.
Kopirajte get-started/hello_world u ~/esp direktorij:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .
Postoji niz example projekti u examples direktorij u ESP-IDF. Možete kopirati bilo koji projekat na isti način kao što je gore prikazano i pokrenuti ga. Također je moguća izgradnja exampdatoteke na mjestu, bez prethodnog kopiranja.
2.4.2 Povežite svoj uređaj
Sada povežite svoj ESP32-MINI-1 modul na računar i provjerite ispod kojeg serijskog porta je modul vidljiv. Serijski portovi u Linuxu počinju sa '/dev/tty' u svojim nazivima. Pokrenite naredbu ispod dva puta, prvo sa isključenom pločom, a zatim sa uključenom. Port koji se pojavljuje drugi put je onaj koji vam je potreban:
ls /dev/tty*
Napomena:
Držite ime porta pri ruci jer će vam trebati u sljedećim koracima.
2.4.3 Konfigurirajte
Idite do vašeg 'hello_world' direktorija iz koraka 2.4.1. Pokrenite projekat, postavite ESP32 čip kao cilj i pokrenite
uslužni program za konfiguraciju projekta 'menuconfig'.
cd ~/esp/hello_world
idf .py set−target esp32
idf .py menuconfig
Postavljanje cilja sa 'idf.py set-target esp32' treba uraditi jednom, nakon otvaranja novog projekta. Ako projekt sadrži neke postojeće verzije i konfiguracije, one će biti obrisane i inicijalizirane. Cilj se može sačuvati u varijabli okruženja da se ovaj korak uopće preskoči. Pogledajte Odabir cilja za dodatne informacije.
Ako su prethodni koraci urađeni ispravno, pojavljuje se sljedeći meni:
Boje menija mogu biti različite u vašem terminalu. Izgled možete promijeniti opcijom '–style'. Pokrenite 'idf.py menuconfig –help' za dodatne informacije.
2.4.4 Izgradite projekat
Izgradite projekat pokretanjem:
idf .py build
Ova naredba će kompajlirati aplikaciju i sve ESP-IDF komponente, zatim će generirati pokretački program, particijsku tablicu i binarne datoteke aplikacije.
$ idf .py build
Pokretanje cmake-a u direktoriju /path/to/hello_world/build
Izvršavanje ”cmake −G Ninja −−warn−uninitialized /path/to/hello_world”…
Upozorava na neinicijalizirane vrijednosti.
−− Pronađen Git: /usr/bin/git (pronađena verzija ”2.17.0”)
−− Izgradnja prazne aws_iot komponente zbog konfiguracije
−− Imena komponenti: …
−− Putanja komponenti: …
… (više linija izlaznog sistema za izgradnju) [527/527] Generiranje hello −world.bin esptool .py v2.3.1
Izgradnja projekta završena. Za flešovanje, pokrenite ovu naredbu:
../../../ components/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio
−−flash_size detektuje −−flash_freq 40m 0x10000 build/hello−world.bin build 0x1000 build /bootloader/bootloader. bin 0x8000 build/ partition_table / partition −table.bin ili pokrenite 'idf .py −p PORT flash'
Ako nema grešaka, izrada će se završiti generisanjem binarnog .bin firmvera file.
2.4.5 Flash na uređaj
Flash binarne datoteke koje ste upravo ugradili na svoj ESP32-MINI-1 modul tako što ćete pokrenuti:
idf .py −p PORT [−b BAUD] treperi
Zamijenite PORT imenom serijskog porta vašeg modula iz koraka: Povežite svoj uređaj. Također možete promijeniti brzinu prijenosa flashera zamjenom BAUD brzinom prijenosa koja vam je potrebna. Zadana brzina prijenosa je 460800.
Za više informacija o argumentima idf.py pogledajte idf.py.
Napomena:
Opcija 'flash' automatski gradi i flešuje projekat, tako da pokretanje 'idf.py build' nije potrebno.
Pokretanje esptool.py u direktoriju […]/esp/hello_world
Izvršavanje ”python […]/ esp-idf/components/esptool_py/esptool/esptool.py −b 460800 write_flash
@flash_project_args ”…
esptool .py −b 460800 write_flash −−flash_mode dio −−flash_size detektuje −−flash_freq 40m 0x1000
bootloader/bootloader. bin 0x8000 partition_table / particija −table.bin 0x10000 hello−world.bin
esptool .py v2.3.1
Povezivanje….
Detekcija tipa čipa... ESP32
Čip je ESP32U4WDH (revizija 3)
Karakteristike: WiFi, BT, Single Core
Otpremanje stubića…
Running stub…
Stub trčanje…
Promjena brzine prijenosa na 460800
Promijenjeno.
Konfigurisanje veličine blica…
Auto-detektovana veličina fleša: 4MB
Flash parametri postavljeni na 0x0220
Komprimirano 22992 bajtova na 13019…
Napisano 22992 bajta (13019 komprimovanih) na 0x00001000 za 0.3 sekunde (efikasno 558.9 kbit/s)…
Hash podataka verifikovan.
Komprimirano 3072 bajtova na 82…
Napisano 3072 bajta (82 komprimovanih) na 0x00008000 za 0.0 sekunde (efikasno 5789.3 kbit/s)…
Hash podataka verifikovan.
Komprimirano 136672 bajtova na 67544…
Napisano 136672 bajta (67544 komprimovanih) na 0x00010000 za 1.9 sekunde (efikasno 567.5 kbit/s)…
Hash podataka verifikovan.
Odlazak…
Hard resetovanje preko RTS pina…
Ako sve prođe kako treba, aplikacija “hello_world” počinje da radi nakon što uklonite kratkospojnik na IO0 i GND i ponovo uključite ploču za testiranje.
2.4.6 Monitor
Da biste provjerili da li je “hello_world” zaista pokrenut, otkucajte 'idf.py -p PORT monitor' (ne zaboravite zamijeniti PORT imenom vašeg serijskog porta).
Ova komanda pokreće IDF Monitor aplikaciju:
$ idf .py −p /dev/ttyUSB0 monitor
Pokretanje idf_monitor u direktoriju […]/esp/hello_world/build
Izvršavanje ”python […]/ esp-idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. vilenjak”…
−−− idf_monitor na /dev/ttyUSB0 115200 −−−−−
Prekini: Ctrl+] | Izbornik: Ctrl+T | Pomoć: Ctrl+T praćeno Ctrl+H −−ets
8. jun 2016. 00:22:57
prvi :0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT)
ets 8. jun 2016. 00:22:57…
Nakon što se evidencija pokretanja i dijagnostike pomakne prema gore, trebali biste vidjeti "Zdravo svijete!" odštampa aplikacija.
…
Hello world!
Ponovno pokretanje za 10 sekundi…
Ovo je esp32 čip sa 1 CPU jezgrom, WiFi/BT/BLE, silikonska revizija 3, 4MB eksterni fleš
Ponovno pokretanje za 9 sekundi…
Ponovno pokretanje za 8 sekundi…
Ponovno pokretanje za 7 sekundi…
Za izlazak iz IDF monitora koristite prečicu Ctrl+].
To je sve što vam treba da počnete sa ESP32-MINI-1 modulom! Sada ste spremni da isprobate neki drugi examples u ESP-IDF, ili idite pravo na razvoj vlastitih aplikacija.
Resursi za učenje
3.1 Dokumenti koji se moraju pročitati
Sljedeća veza pruža dokumente koji se odnose na ESP32.
- ESP32 Datasheet
Ovaj dokument pruža uvod u specifikacije ESP32 hardvera, uključujući prekoview,
definicije pinova, opis funkcionalnosti, periferni interfejs, električne karakteristike, itd. - ESP32 ECO V3 Korisničko uputstvo
Ovaj dokument opisuje razlike između V3 i prethodnih ESP32 revizija silikonskih pločica. - ECO i rješenja za greške u ESP32
Ovaj dokument detaljno opisuje hardverske greške i rješenja u ESP32. - ESP-IDF Vodič za programiranje
Sadrži opsežnu dokumentaciju za ESP-IDF u rasponu od hardverskih vodiča do API reference. - ESP32 Tehnički referentni priručnik
Priručnik pruža detaljne informacije o tome kako koristiti ESP32 memoriju i periferne uređaje. - ESP32 hardverski resursi
Zip files uključuju šeme, raspored PCB-a, Gerber i BOM listu ESP32 modula i razvojnih ploča. - ESP32 Smjernice za dizajn hardvera
Smjernice navode preporučene prakse dizajna pri razvoju samostalnih ili dodatnih sistema baziranih na ESP32 seriji proizvoda, uključujući ESP32 čip, ESP32 module i razvojne ploče. - ESP32 AT Set instrukcija i Examples
Ovaj dokument uvodi ESP32 AT komande, objašnjava kako ih koristiti i pruža nprampnekoliko uobičajenih AT naredbi. - Informacije o naručivanju Espressif proizvoda
3.2 Mora imati resurse
Evo resursa koji se moraju imati u vezi sa ESP32.
- ESP32 BBS
Ovo je Inženjerska zajednica (E2E) za ESP32 gdje možete postavljati pitanja, dijeliti znanje, istraživati ideje i pomoći u rješavanju problema s kolegama inženjerima. - ESP32 GitHub
Razvojni projekti ESP32 se slobodno distribuiraju pod Espressifovom MIT licencom na GitHubu. Osnovan je da pomogne programerima da počnu sa ESP32 i podstiču inovacije i rast opšteg znanja o hardveru i softveru koji okružuje ESP32 uređaje. - ESP32 Alati
Ovo je a webstranica na kojoj korisnici mogu preuzeti ESP32 Flash Download Tools i zip file “ESP32 Certifikacija i testiranje”. - ESP-IDF
Ovo webstranica povezuje korisnike sa službenim IoT razvojnim okvirom za ESP32. - ESP32 Resursi
Ovo webstranica pruža veze do svih dostupnih ESP32 dokumenata, SDK-a i alata.
Istorija revizija
| Datum | Verzija | Bilješke o izdanju |
| 2021-01-14 | V0.1 | Preliminarno izdanje |
Odricanje od odgovornosti i Obavijest o autorskim pravima
Informacije u ovom dokumentu, uključujući URL reference, podložne su promjenama bez prethodne najave.
SVE INFORMACIJE TREĆIH LICA U OVOM DOKUMENTU DAJU SE KAKVE JESU BEZ NIKAKVIH GARANCIJA ZA NJEGOVINU AUTENTIČNOST I TAČNOST.
ZA OVAJ DOKUMENT SE NE DAJE NIKAKVA GARANCIJA ZA NJEGOVO PRODAJNOST, NEKRŠENJE PRAVA, PRIKLADNOST ZA BILO KOJU ODREĐENU NAMJENU, NITI JE GARANCIJA KOJA DRUGO PROIZLAZI IZ BILO KAKOG PRIJEDLOGA, SPECIFIKACIJE ILI SAMPLE.
Sva odgovornost, uključujući odgovornost za kršenje vlasničkih prava, u vezi sa korišćenjem informacija u ovom dokumentu se odriče. Ovdje se ne daju nikakve licence izričite ili implicirane, putem estoppela ili na drugi način, za bilo koje pravo intelektualne svojine.
Logo Wi-Fi Alliance Member je zaštitni znak Wi-Fi Alliance. Bluetooth logo je registrovani zaštitni znak kompanije Bluetooth SIG.
Svi trgovački nazivi, zaštitni znaci i registrovani zaštitni znaci spomenuti u ovom dokumentu vlasništvo su njihovih vlasnika i ovime su priznati.
Autorsko pravo © 2021 Espressif Systems (Shanghai) Co., Ltd. Sva prava zadržana.
Espressif Systems
ESP32-MINI-1 Korisnički priručnik (Preliminarni v0.1)
www.espressif.com
Dokumenti / Resursi
 |
ESPRESSIF ESP32-MINI-1 Visoko integrirani Wi-Fi+Bluetooth modul male veličine [pdf] Korisnički priručnik ESP32MINI1, 2AC7Z-ESP32MINI1, 2AC7ZESP32MINI1, ESP32 -MINI -1 Visoko integrirani Wi-Fi Bluetooth modul male veličine, ESP32 -MINI -1, visoko integrirani Wi-Fi Bluetooth modul male veličine |
