Espressif Systems EK057 Wi-Fi in Bluetooth modul interneta stvari

O tem dokumentu

Ta uporabniški priročnik prikazuje, kako začeti uporabljati modul EK057.

Posodobitve dokumentov
Vedno glejte najnovejšo različico na https://www.espressif.com/en/support/download/documents.

Zgodovina revizij
Za zgodovino revizij tega dokumenta glejte zadnjo stran.

Obvestilo o spremembi dokumentacije
Espressif zagotavlja e-poštna obvestila, da stranke obveščajo o spremembah tehnične dokumentacije. Naročite se na www.espressif.com/en/subscribe. Upoštevajte, da morate posodobiti svojo naročnino, če želite prejemati obvestila o novih izdelkih, na katere trenutno niste naročeni.

Certificiranje
Prenesite certifikate za izdelke Espressif iz www.espressif.com/en/certificates.

Izjava o omejitvi odgovornosti in obvestilo o avtorskih pravicah
Informacije v tem dokumentu, vključno z URL reference, se lahko spremenijo brez predhodnega obvestila. TA DOKUMENT JE ZAGOTOVLJEN KAKŠEN JE, BREZ KAKRŠNIH KOLI GARANCIJ, VKLJUČNO VKLJUČNO Z KAKRŠNO koli GARANCIJO ZA PRODAJNOST, NEKRŠITEV, PRIMERNOST ZA KAKRŠNE koli POSEBNE NAMENE ALI KAKRŠNE koli JAMSTVE, KI DRUGIH IZSTAJAAMPLE.
Zavrnjena je vsaka odgovornost, vključno z odgovornostjo za kršitev kakršnih koli lastniških pravic, v zvezi z uporabo informacij v tem dokumentu. Tukaj niso podeljene nobene izrecne ali implicitne licence, z ustavitvijo ali kako drugače, za katere koli pravice intelektualne lastnine. Logotip Wi-Fi Alliance Member je blagovna znamka Wi-Fi Alliance. Logotip Bluetooth je registrirana blagovna znamka Bluetooth SIG. Vsa trgovska imena, blagovne znamke in registrirane blagovne znamke, omenjene v tem dokumentu, so last njihovih lastnikov in so s tem priznane. Avtorske pravice © 2020 Espressif Systems (Shanghai) Co., Ltd. Vse pravice pridržane.

konecview

Modul je končanview
EK057 je zmogljiv, generični Wi-Fi+Bluetooth®+Bluetooth® LE MCU modul, ki je namenjen najrazličnejšim aplikacijam, od senzorskih omrežij z nizko porabo energije do najzahtevnejših nalog, kot so glasovno kodiranje, pretakanje glasbe in MP3 dekodiranje.
Tabela 1: Specifikacije EK057

kategorije	Predmeti	Specifikacije
Wi-Fi	Protokoli	802.11 b/g/n (802.11n do 150 Mbps)
		A-MPDU in A-MSDU združevanje in 0.4 µs stražar intervalna podpora
	Frekvenčno območje	2412 ~ 2484 MHz
Bluetooth®	Protokoli	Specifični protokoli v4.2 BR/EDR in Bluetooth® LE cije
	Radio	Oddajnik razreda 1, razreda 2 in razreda 3
		AFH
	Avdio	CVSD in SBC
Strojna oprema	Vmesniki modulov	UART, SPI, I2C, I2S, GPIO, ADC
	Integriran kristal	40 MHz kristal
	Vgrajena bliskavica SPI	8 MB
	Delovna zvezatage/Napajanje	3.0 V ~ 3.6 V
	Obratovalni tok	Povprečje: 80 mA
	Najmanjši tok, ki ga oddaja moč ponudba	500 mA
	Priporočena delovna tempera- razpon ture	–40 °C ~ +85 °C
	Stopnja občutljivosti na vlago (MSL)	3. stopnja

Pin Opis
Modul ima 14 pinov in 7 testnih točk. Oglejte si definicije zatičev v tabeli 2.

Ime	št.	Vrsta	funkcija
IO32	A1	I/O	GPIO32, XTAL_32K_P (32.768 kHz vhod kristalnega oscilatorja), ADC1_CH4, DOTIK9, 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	Tla

Ime	št.	Vrsta	funkcija
GND	A7	P	Tla
GND	A8	P	Tla
GND	A9	P	Tla
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 (izhod kristalnega oscilatorja 32.768 kHz), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Visoko: Vklopljeno; omogoči čip Low: Off; čip se izklopi Opomba: Žebljička ne pustite lebdeti.
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

Začnite uporabljati EK057

Kaj potrebujete
Za razvoj aplikacij za modul EK057 potrebujete:

• 1 x EK057 modul
• 1 x Espressif RF testna plošča
• 1 x USB-to-Serial plošča
• 1 x mikro-USB kabel
• 1 x osebni računalnik z operacijskim sistemom Linux

V tem uporabniškem priročniku jemljemo operacijski sistem Linux kot primerample. Za več informacij o konfiguraciji v sistemu Windows in macOS si oglejte Vodnik za programiranje ESP-IDF.

Povezava strojne opreme

1. Spajajte modul EK057 na ploščo za testiranje RF, kot je prikazano na sliki 1.
2. Povežite ploščo za testiranje RF na ploščo USB-to-Serial prek TXD, RXD in GND.
3. Povežite ploščo USB-to-Serial z računalnikom.
4. Povežite ploščo za testiranje RF na osebni računalnik ali napajalnik, da omogočite 5 V napajanje prek kabla Micro-USB.
5. Med prenosom povežite IO0 z GND prek mostička. Nato vklopite testno ploščo.
6.  Prenesite vdelano programsko opremo v flash. Za podrobnosti glejte spodnje razdelke.
7. Po prenosu odstranite mostiček na IO0 in GND.
8. Ponovno vklopite RF testno ploščo. EK057 bo preklopil v delovni način. Čip bo po inicializaciji prebral programe iz bliskavice.

Opomba:
IO0 je interno logično visok. Če je IO0 nastavljen na pull-up, je izbran način zagona. Če je ta žebljiček spusten navzdol ali levo plava, je izbran način prenosa. Za več informacij o EK057 glejte podatkovni list EK057.

Nastavite razvojno okolje
Razvojni okvir Espressif IoT (na kratko ESP-IDF) je okvir za razvoj aplikacij, ki temelji na Espressif ESP32. Uporabniki lahko razvijajo aplikacije z ESP32 v sistemu Windows/Linux/macOS na podlagi ESP-IDF. Tu vzamemo operacijski sistem Linux kot example.
Namestite Predpogoji
Za prevajanje z ESP-IDF morate pridobiti naslednje pakete:

• CentOS 7:
  sudo yum namestite git wget flex bison gperf python cmake ninja-build ccache dfu-util
• Ubuntu in Debian (en ukaz je razdeljen na dve vrstici):
  sudo apt-get install git wget flex bison gperf python python-pip python-setuptools cmake ninja -build ccache libffi -dev libssl -dev dfu-util
• Arch:
  sudo pacman −S −−potreben gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
• Opomba:
• Ta priročnik uporablja imenik ~/esp v Linuxu kot namestitveno mapo za ESP-IDF.
• Upoštevajte, da ESP-IDF ne podpira presledkov v poteh.

Pridobite ESP-IDF
Za izdelavo aplikacij za modul EK057 potrebujete programske knjižnice, ki jih nudi Espressif v repozitoriju ESP-IDF.
Če želite dobiti ESP-IDF, ustvarite namestitveni imenik (~/esp), v katerega naložite ESP-IDF in klonirajte repozitorij z 'git clone':

• mkdir −p ~/esp
• cd ~/esp
• git klon −−rekurzivni https://github.com/espressif/esp−idf. git

ESP-IDF bo prenesen v ~/esp/esp-idf. Oglejte si različice ESP-IDF za informacije o tem, katero različico ESP-IDF uporabiti v dani situaciji.
Nastavite orodja
Poleg ESP-IDF morate namestiti tudi orodja, ki jih uporablja ESP-IDF, kot so prevajalnik, razhroščevalnik, paketi Python itd. ESP-IDF ponuja skript z imenom 'install.sh' za pomoč pri nastavitvi orodij v enem zamahu.
cd ~/esp/esp-idf

Nastavite spremenljivke okolja
Nameščena orodja še niso dodana spremenljivki okolja PATH. Da bi bila orodja uporabna iz ukazne vrstice, je treba nastaviti nekatere spremenljivke okolja. ESP-IDF nudi drug skript 'export.sh', ki to naredi. V terminalu, kjer boste uporabljali ESP-IDF, zaženite: install .sh. $HOME/esp/esp−idf/export.sh

Zdaj je vse pripravljeno, lahko zgradite svoj prvi projekt na modulu EK057.
Ustvarite svoj prvi projekt
Začnite projekt
Zdaj ste pripravljeni na pripravo vaše aplikacije za modul EK057. Začnete lahko s projektom get-started/hello_world iz examples imenik v ESP-IDF.
Kopirajte get-started/hello_world v imenik ~/esp:
cd ~/esp
cp −r $IDF_PATH/examples/get-started/hello_world .

Obstaja vrsta example projekti v examples imenik v ESP-IDF. Vsak projekt lahko kopirate na enak način, kot je predstavljen zgoraj, in ga zaženete. Možna je tudi izgradnja example na mestu, ne da bi jih prej kopirali.

Povežite svojo napravo
Zdaj povežite svoj modul EK057 z računalnikom in preverite, pod katerim serijskim priključkom je modul viden. Serijska vrata v Linuxu se v imenu začnejo z '/dev/tty'. Dvakrat zaženite spodnji ukaz, najprej z odklopljeno ploščo, nato pa s priključeno. Vrata, ki se prikažejo drugič, so tista, ki jih potrebujete:
ls /dev/tty*

Opomba:
Ime vrat imejte pri roki, saj ga boste potrebovali v naslednjih korakih.

Konfiguriraj
Od koraka 2.4.1 se pomaknite do imenika 'hello_world'. Začnite projekt, nastavite čip ESP32 kot cilj in zaženite pripomoček za konfiguracijo projekta 'menu config'.

• cd ~/esp/hello_world
• IDF .py set-target esp32
• IDF .py menuconfig

Nastavitev cilja z 'idf.py set-target esp32' je treba izvesti enkrat, po odprtju novega projekta. Če projekt vsebuje nekatere obstoječe zgradbe in konfiguracijo, bodo počiščene in inicializirane. Cilj lahko shranite v spremenljivko okolja, da ta korak sploh preskočite. Za dodatne informacije glejte Izbira cilja. Če so bili prejšnji koraki izvedeni pravilno, se prikaže naslednji meni:

Slika 2: Konfiguracija projekta – Domače okno
Barve menija so lahko drugačne v vašem terminalu. Videz lahko spremenite z možnostjo '--style'. Za dodatne informacije zaženite 'idf.py menuconfig --help'.
Zgradite projekt
Zgradite projekt tako, da zaženete:
idf .py gradnjo

Ta ukaz bo prevedel aplikacijo in vse komponente ESP-IDF, nato bo ustvaril zagonski nalagalnik, tabelo particij in binarne datoteke aplikacije.

• $ idf .py build
• Zagon cmake v imeniku /path/to/hello_world/build
• Izvajanje ”cmake −G Ninja −−warn-uninitialized /path/to/hello_world”… Opozorilo o neinicializiranih vrednostih.
• Najden Git: /usr/bin/git (najdena različica ”2.17.0”)
• Gradnja prazne komponente aws_iot zaradi konfiguracije
• Imena komponent: …
• Poti komponent: …
• (več vrstic izhoda sistema za gradnjo)
• [527/527] Ustvarjanje hello −world.bin
• esptool .py v2.3.1
  Izgradnja projekta končana. Za bliskavico zaženite ta ukaz:
• components/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio−−flash_size detect −−flash_freq 40m 0x10000 build/hello−world.bin build 0x1000
• build/bootloader/bootloader. bin 0x8000 build/ partition_table / partition −table.bin
• ali zaženite 'idf .py −p PORT flash'

Če ni napak, se bo gradnja končala z generiranjem binarne vdelane programske opreme .bin file.
Flash na napravo
Utripajte binarne datoteke, ki ste jih pravkar vgradili v svoj modul EK057, tako da zaženete:
idf .py −p PORT [−b BAUD] flash

Zamenjajte PORT z imenom serijskih vrat vašega modula iz koraka: Povežite svojo napravo. Hitrost prenosa flasherja lahko spremenite tudi tako, da zamenjate BAUD s hitrostjo prenosa, ki jo potrebujete. Privzeta hitrost prenosa je 460800. Za več informacij o argumentih idf.py glejte idf.py.

Opomba:
Možnost 'flash' samodejno zgradi in utripa projekt, zato izvajanje 'idf.py build' ni potrebno.

• Zagon esptool.py v imeniku […]/esp/hello_world
• Izvajanje ”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 detect −−flash_freq 40m 0x1000
• zagonski nalagalnik/zagonski nalagalnik. bin 0x8000 partition_table / partition −table.bin 0x10000 hello-world.bin esptool .py v2.3.1
  Povezovanje ….
• Zaznavanje vrste čipa … Čip ESP32 je ESP32D0WDQ6 (revizija 1)
• Funkcije: WiFi, BT, Dual Core Uploading škrbina …
• Teče škrbina …
• Teče škrbina …
• Spreminjanje hitrosti prenosa na 460800 Spremenjeno.
• Espressif sistemi
• Konfiguriranje velikosti bliskavice …
• Samodejno zaznana velikost Flasha: 4 MB
• Parametri Flash so nastavljeni na 0x0220
• Stisnjeno 22992 bajtov na 13019…
• Zapisal 22992 bajtov (13019 stisnjenih) pri 0x00001000 v 0.3 sekunde (efektivno 558.9 kbit/s)… Zgoščenost podatkov je preverjena.
• Stisnjeno 3072 bajtov na 82…
• Zapisal 3072 bajtov (82 stisnjenih) pri 0x00008000 v 0.0 sekunde (efektivno 5789.3 kbit/s)… Zgoščenost podatkov je preverjena.
• Stisnjeno 136672 bajtov na 67544…
• Zapisal 136672 bajtov (67544 stisnjenih) pri 0x00010000 v 1.9 sekunde (efektivno 567.5 kbit/s)… Zgoščenost podatkov je preverjena.

Odhod …
Trda ponastavitev prek PIN-a RTS…

Če gre vse v redu, se aplikacija "hello_world" začne izvajati, ko odstranite mostiček na IO0 in GND ter ponovno vklopite testno ploščo.
Monitor
Če želite preveriti, ali se “hello_world” res izvaja, vnesite 'idf.py -p PORT monitor' (ne pozabite zamenjati PORT z imenom serijskih vrat).
Ta ukaz zažene aplikacijo IDF Monitor:

• $ idf .py −p /dev/ttyUSB0 monitor
• Izvajanje idf_monitorja v imeniku […]/esp/hello_world/build
• Izvajanje ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. elf ”…−−− idf_monitor na /dev/ttyUSB0 115200 −−−
• Končaj: Ctrl+] | Meni: Ctrl+T | Pomoč: Ctrl+T, ki ji sledi Ctrl+H
• ets 8. junij 2016 00:22:57
• prvi: 0x1 (POWERON_RESET), zagon: 0x13 (SPI_FAST_FLASH_BOOT)
• ets 8. junij 2016 00:22:57

Ko se dnevniki zagona in diagnostike pomaknejo navzgor, bi morali videti »Pozdravljeni svet!« natisnjeno z aplikacijo.

• Pozdravljen svet!
• Ponovni zagon čez 10 sekund …
• To je čip esp32 z 2 jedroma CPE, WiFi/BT/BLE, silicijevo revizijo 1, 2 MB zunanjega bliskavica. Ponovni zagon v 9 sekundah …
• Ponovni zagon čez 8 sekund …
• Ponovni zagon čez 7 sekund …

To je vse, kar potrebujete za začetek uporabe modula EK057! Zdaj ste pripravljeni poskusiti z drugim bivšimamples v ESP-IDF ali pojdite naravnost na razvoj lastnih aplikacij.

Učni viri

Dokumenti, ki jih morate prebrati
Na naslednji povezavi so dokumenti, povezani z ESP32.

Dokumenti / Viri

Espressif Systems EK057 Wi-Fi in Bluetooth modul interneta stvari [pdfUporabniški priročnik EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi in Bluetooth modul interneta stvari, Wi-Fi in Bluetooth modul interneta stvari

Reference

• Uporabniški priročnik