Espressif Systems EK057 Wi-Fi og Bluetooth Internet of Things Module

Um þetta skjal

Þessi notendahandbók sýnir hvernig á að byrja með EK057 einingunni.

Skjalauppfærslur
Vinsamlegast vísaðu alltaf til nýjustu útgáfu á https://www.espressif.com/en/support/download/documents.

Endurskoðunarsaga
Fyrir endurskoðunarferil þessa skjals, vinsamlegast vísa til síðustu síðu.

Tilkynning um breytingar á skjölum
Espressif veitir tölvupósttilkynningar til að halda viðskiptavinum uppfærðum um breytingar á tækniskjölum. Vinsamlegast skráðu þig á www.espressif.com/en/subscribe. Athugaðu að þú þarft að uppfæra áskriftina þína til að fá tilkynningar um nýjar vörur sem þú ert ekki áskrifandi að.

Vottun
Sækja vottorð fyrir Espressif vörur frá www.espressif.com/en/certificates.

Fyrirvari og höfundarréttartilkynning
Upplýsingar í þessu skjali, þ.m.t. URL tilvísanir, geta breyst án fyrirvara. ÞETTA SKJÁL ER LEVANDI EINS OG ER ÁN EKKRA ÁBYRGÐA, Þ.M.A. ÁBYRGÐ UM SÖLJUNARHÆTTI, EKKI BROT, HÆFNI Í EINHVER SÉRSTÖKNUM TILGANGI EÐA ÁBYRGÐ SEM ER AÐ SEM KOMA ÚT AF EINHVERJAR TILLAGNINGU, EÐA.AMPLE.
Öll ábyrgð, þar með talið ábyrgð á broti á eignarrétti, sem tengist notkun upplýsinga í þessu skjali er afsalað. Engin leyfi, beint eða gefið í skyn, með stöðvun eða á annan hátt, á neinum hugverkaréttindum eru veitt hér. Logo Wi-Fi Alliance Member er vörumerki Wi-Fi Alliance. Bluetooth-merkið er skráð vörumerki Bluetooth SIG. Öll vöruheiti, vörumerki og skráð vörumerki sem nefnd eru í þessu skjali eru eign viðkomandi eigenda og eru hér með viðurkennd. Höfundarréttur © 2020 Espressif Systems (Shanghai) Co., Ltd. Allur réttur áskilinn.

Yfirview

Module lokiðview
EK057 er öflug, almenn Wi-Fi+Bluetooth®+Bluetooth® LE MCU eining sem miðar á fjölbreytt úrval af forritum, allt frá orkulítil skynjaranetum til krefjandi verkefna, svo sem raddkóðun, tónlistarstraums og MP3. umskráningu.
Tafla 1: EK057 Tæknilýsing

Flokkar	Atriði	Tæknilýsing
Wi-Fi	Bókanir	802.11 b/g/n (802.11n allt að 150 Mbps)
		A-MPDU og A-MSDU samsöfnun og 0.4 µs vörður millibilsstuðningur
	Tíðnisvið	2412 ~ 2484 MHz
Bluetooth®	Bókanir	Samskiptareglur v4.2 BR/EDR og Bluetooth® LE forskrift- tions
	Útvarp	Class-1, Class-2 og Class-3 sendir
		AFH
	Hljóð	CVSD og SBC
Vélbúnaður	Einingaviðmót	UART, SPI, I2C, I2S, GPIO, ADC
	Innbyggður kristal	40 MHz kristal
	Innbyggt SPI flass	8 MB
	Starfsemi binditage/aflgjafi	3.0 V ~ 3.6 V
	Rekstrarstraumur	Meðaltal: 80 mA
	Lágmarksstraumur afhentur með afli framboð	500 mA
	Ráðlagður rekstrarhiti- túrsvið	–40 °C ~ +85 °C
	Rakaviðkvæmni (MSL)	Stig 3

Pinnalýsing
Einingin hefur 14 pinna og 7 prófunarpunkta. Sjá skilgreiningar pinna í töflu 2.

Nafn	Nei.	Tegund	Virka
IO32	A1	I/O	GPIO32, XTAL_32K_P (32.768 kHz kristalsveifluinntak), 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	Aflgjafi
GND	A6	P	Jarðvegur

Nafn	Nei.	Tegund	Virka
GND	A7	P	Jarðvegur
GND	A8	P	Jarðvegur
GND	A9	P	Jarðvegur
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 kristalsveifluúttak), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Hár: Á; gerir flís kleift. Lágt: Slökkt; flísinn slekkur á sér Athugið: Ekki skilja pinna eftir fljótandi.
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

Byrjaðu á EK057

Það sem þú þarft
Til að þróa forrit fyrir EK057 mát þarftu:

• 1 x EK057 eining
• 1 x Espressif RF prófunarborð
• 1 x USB-to-Serial borð
• 1 x ör-USB snúru
• 1 x PC með Linux

Í þessari notendahandbók tökum við Linux stýrikerfi sem fyrrverandiample. Fyrir frekari upplýsingar um uppsetninguna á Windows og macOS, vinsamlegast skoðaðu ESP-IDF forritunarleiðbeiningar.

Vélbúnaðartenging

1. Lóðaðu EK057 eininguna við RF prófunarborðið eins og sýnt er á mynd 1.
2. Tengdu RF prófunarborðið við USB-til-raðborðið með TXD, RXD og GND.
3. Tengdu USB-to-Serial borðið við tölvuna.
4. Tengdu RF prófunartöfluna við tölvuna eða straumbreyti til að virkja 5 V aflgjafa með Micro-USB snúru.
5. Meðan á niðurhali stendur skaltu tengja IO0 við GND í gegnum jumper. Kveiktu síðan á „ON“ á prófunarborðinu.
6.  Sækja vélbúnaðar í flash. Fyrir frekari upplýsingar, sjá kaflana hér að neðan.
7. Eftir niðurhal skaltu fjarlægja jumper á IO0 og GND.
8. Kveiktu aftur á RF prófunartöflunni. EK057 mun skipta yfir í vinnuham. Kubburinn mun lesa forrit úr flash við frumstillingu.

Athugið:
IO0 er innbyrðis rökfræði hátt. Ef IO0 er stillt á að draga upp er ræsistillingin valin. Ef þessi pinna er dreginn niður eða vinstri fljótandi er niðurhalsstillingin valin. Fyrir frekari upplýsingar um EK057, vinsamlegast skoðaðu EK057 gagnablað.

Settu upp þróunarumhverfi
Espressif IoT Development Framework (ESP-IDF í stuttu máli) er rammi til að þróa forrit byggð á Espressif ESP32. Notendur geta þróað forrit með ESP32 í Windows/Linux/macOS byggt á ESP-IDF. Hér tökum við Linux stýrikerfi sem fyrrverandiample.
Setjið Forkröfur
Til að setja saman með ESP-IDF þarftu að fá eftirfarandi pakka:

• CentOS 7:
  sudo yum setja upp git wget flex bison gperf python cmake ninja−build ccache dfu−util
• Ubuntu og Debian (ein skipun skiptist í tvær línur):
  sudo apt−get install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build ccache libffi −dev libssl −dev dfu−util
• Bogi:
  sudo pacman −S −−þarf gcc git gera flex bison gperf python−pip cmake ninja ccache dfu−util
• Athugið:
• Þessi handbók notar möppuna ~/esp á Linux sem uppsetningarmöppu fyrir ESP-IDF.
• Hafðu í huga að ESP-IDF styður ekki rými á slóðum.

Sæktu ESP-IDF
Til að búa til forrit fyrir EK057 einingu þarftu hugbúnaðarsöfnin sem Espressif býður upp á í ESP-IDF geymslunni.
Til að fá ESP-IDF, búðu til uppsetningarskrá (~/esp) til að hlaða niður ESP-IDF í og ​​klónaðu geymsluna með 'git clone':

• mkdir −p ~/esp
• geisladisk ~/esp
• git klón - endurkvæmt https://github.com/espressif/esp-idf. git

ESP-IDF verður hlaðið niður í ~/esp/esp-idf. Hafðu samband við ESP-IDF útgáfur til að fá upplýsingar um hvaða ESP-IDF útgáfu á að nota í tilteknum aðstæðum.
Settu upp Verkfæri
Fyrir utan ESP-IDF þarftu líka að setja upp verkfærin sem ESP-IDF notar, eins og þýðanda, aflúsara, Python pakka, osfrv. ESP-IDF býður upp á skriftu sem heitir 'install.sh' til að hjálpa til við að setja upp verkfærin í einu lagi.
cd ~/esp/esp−idf

Settu upp umhverfisbreytur
Uppsettu verkfærunum er ekki enn bætt við PATH umhverfisbreytuna. Til að gera verkfærin nothæf frá skipanalínunni verður að stilla nokkrar umhverfisbreytur. ESP-IDF veitir annað handrit 'export.sh' sem gerir það. Í flugstöðinni þar sem þú ætlar að nota ESP-IDF skaltu keyra: install .sh. $HOME/esp/esp−idf/export.sh

Nú er allt tilbúið, þú getur byggt þitt fyrsta verkefni á EK057 einingunni.
Búðu til fyrsta verkefnið þitt
Byrjaðu verkefni
Nú ertu tilbúinn að undirbúa umsókn þína fyrir EK057 eininguna. Þú getur byrjað með get-started/hello_world verkefnið frá fyrrverandiamples skrá í ESP-IDF.
Afritaðu get-started/hello_world í ~/esp möppuna:
geisladisk ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .

Það er úrval af tdample verkefni í fyrrvamples skrá í ESP-IDF. Þú getur afritað hvaða verkefni sem er á sama hátt og sýnt er hér að ofan og keyrt það. Einnig er hægt að byggja tdamplesin á sínum stað, án þess að afrita þau fyrst.

Tengdu tækið þitt
Tengdu nú EK057 eininguna þína við tölvuna og athugaðu undir hvaða raðtengi einingin sést. Se-rial tengi í Linux byrja á '/dev/tty' í nöfnum þeirra. Keyrðu skipunina hér að neðan tvisvar sinnum, fyrst með töfluna ótengda, síðan með tengja. Gáttin sem birtist í seinna skiptið er sú sem þú þarft:
ls /dev/tty*

Athugið:
Hafðu gáttarheitið við höndina þar sem þú þarft það í næstu skrefum.

Stilla
Farðu í 'hello_world' möppuna þína frá skrefi 2.4.1. Byrjaðu verkefni, stilltu ESP32 flís sem miða og keyrðu verkstillingarforritið 'menu config'.

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

Að stilla markið með 'idf.py set-target esp32' ætti að gera einu sinni, eftir að nýtt verkefni hefur verið opnað. Ef verkefnið inniheldur nokkrar núverandi byggingar og stillingar verða þær hreinsaðar og frumstilltar. Markmiðið gæti verið vistað í umhverfisbreytu til að sleppa þessu skrefi yfirleitt. Sjá Val á miði fyrir frekari upplýsingar. Ef fyrri skref hafa verið gerð rétt birtist eftirfarandi valmynd:

Mynd 2: Verkefnastilling – Heimagluggi
Litir valmyndarinnar gætu verið mismunandi í flugstöðinni þinni. Þú getur breytt útlitinu með valkostinum '--style'. Vinsamlegast keyrðu 'idf.py menuconfig --help' fyrir frekari upplýsingar.
Byggja verkefnið
Byggðu verkefnið með því að keyra:
idf .py smíða

Þessi skipun mun setja saman forritið og alla ESP-IDF íhluti, síðan mun hún búa til ræsiforritið, skiptingartöfluna og tvíþætti forritsins.

• $ idf .py smíð
• Keyrir cmake í möppunni /path/to/hello_world/build
• Keyrir ”cmake −G Ninja −−warn−uninitialized /path/to/hello_world”... Varað við óinitialized gildi.
• Fann Git: /usr/bin/git (fann útgáfa ”2.17.0”)
• Byggja tóman aws_iot íhlut vegna uppsetningar
• Heiti íhluta: …
• Íhlutaleiðir: …
• (fleiri línur af byggingarkerfisúttak)
• [527/527] Búa til halló −world.bin
• esptool .py v2.3.1
  Verkefnasmíði lokið. Til að blikka skaltu keyra þessa skipun:
• 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
• eða keyrðu ' idf .py −p PORT flash'

Ef það eru engar villur lýkur smíðinni með því að búa til fastbúnaðar tvíundir .bin file.
Flassið á tækið
Flassaðu tvöfaldana sem þú byggðir inn á EK057 eininguna þína með því að keyra:
idf .py −p PORT [−b BAUD] flass

Skiptu um PORT með raðtengisheiti einingarinnar þinnar úr skrefi: Tengdu tækið þitt. Þú getur líka breytt flutningshraða blikksins með því að skipta út BAUD fyrir flutningshraðann sem þú þarft. Sjálfgefið flutningshlutfall er 460800. Fyrir frekari upplýsingar um idf.py rök, sjá idf.py.

Athugið:
Valmöguleikinn 'flash' byggir sjálfkrafa upp og blikkar verkefnið, svo að keyra 'idf.py build' er ekki nauðsynlegt.

• Keyrir esptool.py í möppunni […]/ esp/hello_world
• Keyrir ”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
• bootloader/bootloader. bin 0x8000 partition_table / skipting −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
  Tengist….
• Greinir flísartegund … ESP32 flís er ESP32D0WDQ6 (útgáfa 1)
• Eiginleikar: WiFi, BT, Dual Core Upphleðslustubbur …
• Hlaupandi stubbur…
• Stubbur í gangi…
• Breytir flutningshraða í 460800 Breytt.
• Espressif kerfi
• Stillir flassstærð …
• Sjálfvirkt greind Flash stærð: 4MB
• Flash breytur stilltar á 0x0220
• Þjappað 22992 bæti í 13019...
• Skrifaði 22992 bæti (13019 þjappað) á 0x00001000 á 0.3 sekúndum (virkt 558.9 kbit/s )… Hash gagna staðfest .
• Þjappað 3072 bæti í 82...
• Skrifaði 3072 bæti (82 þjappað) á 0x00008000 á 0.0 sekúndum (virkt 5789.3 kbit/s )… Hash gagna staðfest .
• Þjappað 136672 bæti í 67544...
• Skrifaði 136672 bæti (67544 þjappað) á 0x00010000 á 1.9 sekúndum (virkt 567.5 kbit/s )… Hash gagna staðfest .

Farið…
Hörð endurstilling með RTS pinna...

Ef allt gengur vel byrjar „hello_world“ forritið að keyra eftir að þú fjarlægir jumperinn á IO0 og GND og kveikir aftur á prófunarborðinu.
Fylgjast með
Til að athuga hvort „hello_world“ sé örugglega í gangi skaltu slá inn 'idf.py -p PORT monitor' (Ekki gleyma að skipta um PORT fyrir raðtengisnafnið þitt).
Þessi skipun ræsir IDF Monitor forritið:

• $ idf .py −p /dev/ttyUSB0 skjár
• Keyrir idf_monitor í möppunni […]/ esp/hello_world/build
• Keyrir ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. álfur ”…−−− idf_monitor á /dev/ttyUSB0 115200 −−−
• Hætta: Ctrl+] | Valmynd: Ctrl+T | Hjálp: Ctrl+T og síðan Ctrl+H
• ets 8. júní 2016 00:22:57
• fyrst :0x1 ​​(POWERON_RESET), boot:0x13 (SPI_FAST_FLASH_BOOT)
• ets 8. júní 2016 00:22:57

Eftir ræsingu og greiningarskrár skrunaðu upp ættirðu að sjá „Halló heimur!“ prentað út af umsókninni.

• Halló heimur!
• Endurræsir eftir 10 sekúndur…
• Þetta er esp32 flís með 2 CPU kjarna, WiFi/BT/BLE, sílikon endurskoðun 1, 2MB ytra flass Endurræsir eftir 9 sekúndur …
• Endurræsir eftir 8 sekúndur…
• Endurræsir eftir 7 sekúndur…

Það er allt sem þú þarft til að byrja með EK057 mát! Nú ertu tilbúinn til að prófa annað fyrrverandiamples í ESP-IDF, eða farðu beint í að þróa eigin forrit.

Námsefni

Verður að lesa skjöl
Eftirfarandi hlekkur veitir skjöl sem tengjast ESP32.

Skjöl / auðlindir

Espressif Systems EK057 Wi-Fi og Bluetooth Internet of Things Module [pdfNotendahandbók EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi og Bluetooth Internet of Things Module, Wi-Fi og Bluetooth Internet of Things Module

Heimildir

• Notendahandbók