Espressif Systems EK057 Wi-Fi i Bluetooth modul za internet stvari

O ovom dokumentu

Ovaj korisnički priručnik pokazuje kako započeti s EK057 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. Imajte na umu da morate ažurirati svoju pretplatu da biste primali obavijesti o novim proizvodima na koje trenutno niste pretplaćeni.

Certifikacija
Preuzmite certifikate za Espressif proizvode sa www.espressif.com/en/certificates.

Odricanje od odgovornosti i Obavijest o autorskim pravima
Informacije u ovom dokumentu, uključujući URL reference, podložna je promjenama bez prethodne najave. OVAJ DOKUMENT SE DAJE KAKAV JESTE, BEZ IKAKVIH GARANCIJA, UKLJUČUJUĆI BILO KOJU GARANCIJU O PRODAJNOSTI, NEKRŠENJU PRAVA, PRIKLADNOSTI ZA BILO KOJU ODREĐENU NAMJENU ILI BILO KAKVU GARANCIJU KOJA DRUGO PROIZLAZIAMPLE.
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 žigovi koji se spominju u ovom dokumentu vlasništvo su njihovih vlasnika i ovime su priznati. Autorsko pravo © 2020 Espressif Systems (Shanghai) Co., Ltd. Sva prava zadržana.

Gotovoview

Modul je gotovview
EK057 je moćan, generički Wi-Fi+Bluetooth®+Bluetooth® LE MCU modul koji cilja na širok spektar aplikacija, u rasponu od senzorskih mreža male snage do najzahtjevnijih zadataka, kao što su kodiranje glasa, streaming muzike i MP3 dekodiranje.
Tabela 1: Specifikacije EK057

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 intervalna podrška
	Frekvencijski opseg	2412 ~ ​​2484 MHz
Bluetooth®	Protokoli	Protokoli v4.2 BR/EDR i Bluetooth® LE specifikacije- tions
	Radio	Predajnik klase-1, klase-2 i klase-3
		AFH
	Audio	CVSD i SBC
Hardver	Interfejsi modula	UART, SPI, I2C, I2S, GPIO, ADC
	Integrisani kristal	40 MHz kristal
	Integrisani SPI blic	8 MB
	operativni voltage/Napajanje	3.0 V ~ 3.6 V
	Radna struja	Prosjek: 80 mA
	Minimalna struja koju isporučuje struja snabdevanje	500 mA
	Preporučena radna tempera- raspon ture	–40 °C ~ +85 °C
	Nivo osjetljivosti na vlagu (MSL)	Nivo 3

Pin Description
Modul ima 14 pinova i 7 tačaka za testiranje. Pogledajte definicije pinova u tabeli 2.

Ime	br.	Tip	Funkcija
IO32	A1	I/O	GPIO32, XTAL_32K_P (32.768 kHz ulaz kristalnog oscilatora), ADC1_CH4, TOUCH9, RTC_GPIO9
IO16	A2	I/O	GPIO16, HS1_DATA4, U2RXD, EMAC_CLK_OUT
IO17	A3	I/O	GPIO17, HS1_DATA5, U2TXD, EMAC_CLK_OUT_180
IO5	A4	I/O	GPIO5, VSPICS0, HS1_DATA6, EMAC_RX_CLK
3V3	A5	P	Napajanje
GND	A6	P	Ground

Ime	br.	Tip	Funkcija
GND	A7	P	Ground
GND	A8	P	Ground
GND	A9	P	Ground
IO18	A10	I/O	GPIO18, VSPICLK, HS1_DATA7
IO23	A11	I/O	GPIO23, VSPID, HS1_STROBE
IO19	A12	I/O	GPIO19, VSPIQ, U0CTS, EMAC_TXD0
IO33	A13	I/O	GPIO33, XTAL_32K_N (32.768 kHz izlaz kristalnog oscilatora), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	High: On; omogućava čip Low: Off; čip se isključuje Napomena: Ne ostavljajte iglu da pluta.
IO14	TP22	I/O	GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
IO15	TP21	I/O	GPIO15, ADC2_CH3, TOUCH3, MTDO, HSPICS0, RTC_GPIO13, HS2_CMD, SD_CMD, EMAC_RXD3
IO13	TP18	I/O	GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
IO12	TP17	I/O	GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
IO0	TP19	I/O	GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
RXD	TP16	I/O	GPIO3, U0RXD, CLK_OUT2
TXD	TP20	I/O	GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2

Započnite sa EK057

Šta Vam treba
Za razvoj aplikacija za EK057 modul potrebno vam je:

• 1 x EK057 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 Vodič za programiranje ESP-IDF.

Hardverska veza

1. Zalemite modul EK057 na ploču za RF testiranje kao što je prikazano na slici 1.
2. Povežite ploču za RF testiranje na ploču USB-to-Serial preko TXD, RXD i GND.
3. Povežite USB-na-serijsku ploču na PC.
4. 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.
5. Tokom preuzimanja, povežite IO0 na GND preko kratkospojnika. Zatim uključite ploču za testiranje.
6.  Preuzmite firmver u flash. Za detalje pogledajte odjeljke u nastavku.
7. Nakon preuzimanja, uklonite kratkospojnik na IO0 i GND.
8. Ponovo uključite RF testnu ploču. EK057 ć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 EK057, pogledajte EK057 Datasheet.

Postavite razvojno okruženje
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.
Instalirajte preduvjete
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 ccache 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.

Nabavite ESP-IDF
Da biste napravili aplikacije za EK057 modul, potrebne su vam softverske biblioteke koje Espressif obezbeđuje u ESP-IDF repozitorijumu.
Da biste dobili ESP-IDF, kreirajte instalacijski direktorij (~/esp) za preuzimanje ESP-IDF i klonirajte spremište sa '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 ESP-IDF verzije za informacije o tome koju verziju ESP-IDF koristiti u datoj situaciji.
Postavite alate
Osim ESP-IDF-a, također morate instalirati alate koje koristi ESP-IDF, kao što su kompajler, debuger, Python paketi, itd. ESP-IDF obezbjeđuje skriptu pod nazivom 'install.sh' koja pomaže pri postavljanju alata u jednom potezu.
cd ~/esp/esp-idf

Postavite varijable 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: install .sh. $HOME/esp/esp-idf/export.sh

Sada je sve spremno, možete napraviti svoj prvi projekat na modulu EK057.
Kreirajte svoj prvi projekat
Pokrenite projekat
Sada ste spremni da pripremite svoju aplikaciju za EK057 modul. Možete započeti s projektom get-started/hello_world 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 projekte 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.

Povežite svoj uređaj
Sada povežite svoj EK057 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.

Konfiguriši
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 'menu config'.

• 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, oni će biti obrisani i inicijalizirani. Cilj se može sačuvati u varijablu 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:

Slika 2: Konfiguracija projekta – Početni prozor
Boje menija mogu biti različite u vašem terminalu. Izgled možete promijeniti opcijom '--style'. Pokrenite 'idf.py menuconfig --help' za dodatne informacije.
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
• Nazivi komponenti:…
• Putevi komponenti:…
• (više linija izlaznog sistema za izgradnju)
• [527/527] Generiranje hello −world.bin
• esptool .py v2.3.1
  Izrada projekta završena. Za flešovanje, pokrenite ovu naredbu:
• komponente/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.
Flash na uređaj
Flash binarne datoteke koje ste upravo ugradili na svoj EK057 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 / partition −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
  Povezivanje….
• Detekcija tipa čipa… ESP32 Čip je ESP32D0WDQ6 (revizija 1)
• Karakteristike: WiFi, BT, Dual Core Uploading stub…
• Running stub…
• Stub trčanje…
• Promjena brzine prijenosa na 460800 Promijenjena.
• Espressif Systems
• Konfigurisanje veličine blica…
• Automatski otkrivena veličina flash memorije: 4MB
• Flash parametri postavljeni na 0x0220
• Komprimirano 22992 bajtova na 13019…
• Napisano 22992 bajta (13019 komprimovano) na 0x00001000 za 0.3 sekunde (efikasna 558.9 kbit/s)… Hash podataka verifikovan.
• Komprimirano 3072 bajtova na 82…
• Napisano 3072 bajta (82 komprimovano) na 0x00008000 za 0.0 sekunde (efikasna 5789.3 kbit/s)… Hash podataka verifikovan.
• Komprimirano 136672 bajtova na 67544…
• Napisano 136672 bajta (67544 komprimovano) na 0x00010000 za 1.9 sekunde (efikasna 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.
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. elf ”…−−− 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 2 CPU jezgra, WiFi/BT/BLE, silikonska revizija 1, 2MB eksterni fleš Restartovanje za 9 sekundi…
• Ponovno pokretanje za 8 sekundi…
• Ponovno pokretanje za 7 sekundi…

To je sve što vam treba da započnete sa EK057 modulom! Sada ste spremni da isprobate nekog drugog bivšegamples u ESP-IDF, ili idite pravo na razvoj vlastitih aplikacija.

Resursi za učenje

Dokumenti koji se moraju pročitati
Sljedeća veza pruža dokumente koji se odnose na ESP32.

Dokumenti / Resursi

Espressif Systems EK057 Wi-Fi i Bluetooth modul za internet stvari [pdf] Korisnički priručnik EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi i Bluetooth modul za internet stvari, Wi-Fi i Bluetooth modul za internet stvari

Reference

• Uputstvo za upotrebu