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

Tungkol sa Dokumentong Ito

Ipinapakita ng user manual na ito kung paano magsimula sa EK057 module.

Mga Update sa Dokumento
Mangyaring palaging sumangguni sa pinakabagong bersyon sa https://www.espressif.com/en/support/download/documents.

Kasaysayan ng Pagbabago
Para sa kasaysayan ng rebisyon ng dokumentong ito, mangyaring sumangguni sa huling pahina.

Notification ng Pagbabago ng Dokumentasyon
Nagbibigay ang Espressif ng mga notification sa email para panatilihing updated ang mga customer sa mga pagbabago sa teknikal na dokumentasyon. Mangyaring mag-subscribe sa www.espressif.com/en/subscribe. Tandaan na kailangan mong i-update ang iyong subscription upang makatanggap ng mga notification ng mga bagong produkto na hindi ka kasalukuyang naka-subscribe.

Sertipikasyon
Mag-download ng mga sertipiko para sa mga produktong Espressif mula sa www.espressif.com/en/certificates.

Disclaimer at Paunawa sa Copyright
Ang impormasyon sa dokumentong ito, kasama ang URL mga sanggunian, ay maaaring magbago nang walang abiso. ANG DOKUMENTONG ITO AY IBINIGAY NA WALANG WARRANTY ANUMANG ANO MAN, KASAMA ANG ANUMANG WARRANTY NG MERCHANTABILITY, NON-INFRINGEMENT, FITNESS PARA SA ANUMANG PARTIKULAR NA LAYUNIN, O ANUMANG WARRANTY NA MAGMUMULA SA ANUMANG PROPOSASYON O ESPESPISYO.AMPLE.
Ang lahat ng pananagutan, kabilang ang pananagutan para sa paglabag sa anumang mga karapatan sa pagmamay-ari, na may kaugnayan sa paggamit ng impormasyon sa dokumentong ito ay tinatanggihan. Walang mga lisensyang ipinahayag o ipinahiwatig, sa pamamagitan ng estoppel o kung hindi man, sa anumang mga karapatan sa intelektwal na ari-arian ang ibinibigay dito. Ang logo ng Miyembro ng Wi-Fi Alliance ay isang trademark ng Wi-Fi Alliance. Ang Bluetooth logo ay isang rehistradong trademark ng Bluetooth SIG. Ang lahat ng mga trade name, trademark at rehistradong trademark na binanggit sa dokumentong ito ay pag-aari ng kani-kanilang mga may-ari, at sa pamamagitan nito ay kinikilala. Copyright © 2020 Espressif Systems (Shanghai) Co., Ltd. Lahat ng karapatan ay nakalaan.

Tapos naview

Tapos na ang Moduleview
Ang EK057 ay isang makapangyarihang, generic na Wi-Fi+Bluetooth®+Bluetooth® LE MCU module na nagta-target ng malawak na iba't ibang mga application, mula sa mababang-power na sensor network hanggang sa pinakamahirap na gawain, gaya ng voice encoding, music streaming at MP3 decoding.
Talahanayan 1: Mga Detalye ng EK057

Mga kategorya	Mga bagay	Mga pagtutukoy
Wi-Fi	Mga protocol	802.11 b/g/n (802.11n hanggang 150 Mbps)
		A-MPDU at A-MSDU aggregation at 0.4 µs bantay suporta sa pagitan
	Saklaw ng dalas	2412 ~ ​​2484 MHz
Bluetooth®	Mga protocol	Protocols v4.2 BR/EDR at Bluetooth® LE specifica- tions
	Radyo	Class-1, class-2 at class-3 transmitter
		AFH
	Audio	CVSD at SBC
Hardware	Mga interface ng module	UART, SPI, I2C, I2S, GPIO, ADC
	Pinagsamang kristal	40 MHz na kristal
	Pinagsamang flash ng SPI	8 MB
	Operating voltage/Suplay ng kuryente	3.0 V ~ 3.6 V
	Kasalukuyang tumatakbo	Average: 80 mA
	Pinakamababang kasalukuyang inihatid ng kapangyarihan panustos	500 mA
	Inirerekumendang operating tempera- saklaw ng ture	–40 °C ~ +85 °C
	Moisture sensitivity level (MSL)	Antas 3

Paglalarawan ng Pin
Ang module ay may 14 na pin at 7 pagsubok na puntos. Tingnan ang mga kahulugan ng pin sa Talahanayan 2.

Pangalan	Hindi.	Uri	Function
IO32	A1	I/O	GPIO32, XTAL_32K_P (32.768 kHz crystal oscillator input), 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	Power supply
GND	A6	P	Lupa

Pangalan	Hindi.	Uri	Function
GND	A7	P	Lupa
GND	A8	P	Lupa
GND	A9	P	Lupa
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 crystal oscillator output), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Mataas: Naka-on; pinapagana ang chip Low: Off; ang chip powers off Tandaan: Huwag iwanan ang pin na lumulutang.
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

Magsimula sa EK057

Ang Kailangan Mo
Upang bumuo ng mga aplikasyon para sa EK057 module kailangan mo:

• 1 x EK057 module
• 1 x Espressif RF testing board
• 1 x USB-to-Serial board
• 1 x Micro-USB cable
• 1 x PC na nagpapatakbo ng Linux

Sa gabay sa gumagamit na ito, kinukuha namin ang Linux operating system bilang example. Para sa higit pang impormasyon tungkol sa configuration sa Windows at macOS, mangyaring sumangguni sa ESP-IDF Programming Guide.

Koneksyon ng Hardware

1. Ihinang ang EK057 module sa RF testing board tulad ng ipinapakita sa Figure 1.
2. Ikonekta ang RF testing board sa USB-to-Serial board sa pamamagitan ng TXD, RXD, at GND.
3. Ikonekta ang USB-to-Serial board sa PC.
4. Ikonekta ang RF testing board sa PC o isang power adapter para paganahin ang 5 V power supply, sa pamamagitan ng Micro-USB cable.
5. Sa panahon ng pag-download, ikonekta ang IO0 sa GND sa pamamagitan ng isang jumper. Pagkatapos, i-"ON" ang testing board.
6.  I-download ang firmware sa flash. Para sa mga detalye, tingnan ang mga seksyon sa ibaba.
7. Pagkatapos ng pag-download, alisin ang jumper sa IO0 at GND.
8. Paganahin muli ang RF testing board. Lilipat ang EK057 sa working mode. Ang chip ay magbabasa ng mga programa mula sa flash sa pagsisimula.

Tandaan:
Ang IO0 ay mataas ang panloob na lohika. Kung nakatakda ang IO0 sa pull-up, pipiliin ang Boot mode. Kung pull-down o kaliwang lumulutang ang pin na ito, pipiliin ang Download mode. Para sa karagdagang impormasyon sa EK057, mangyaring sumangguni sa EK057 Datasheet.

I-set up ang Development Environment
Ang Espressif IoT Development Framework (ESP-IDF para sa maikli) ay isang framework para sa pagbuo ng mga application batay sa ESP32 ESPRESsif. Ang mga gumagamit ay maaaring bumuo ng mga application na may ESP32 sa Windows/Linux/macOS batay sa ESP-IDF. Dito kinukuha namin ang Linux operating system bilang example.
I-install ang Mga Kinakailangan
Upang mag-compile sa ESP-IDF kailangan mong makuha ang mga sumusunod na pakete:

• CentOS 7:
  sudo yum install git wget flex bison gperf python cmake ninja−build ccache dfu−util
• Ubuntu at Debian (isang utos ay nahahati sa dalawang linya):
  sudo apt−get install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build ccache libffi −dev libssl −dev dfu−util
• arko:
  sudo pacman −S −−needed gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
• Tandaan:
• Ginagamit ng gabay na ito ang direktoryo ~/esp sa Linux bilang folder ng pag-install para sa ESP-IDF.
• Tandaan na hindi sinusuportahan ng ESP-IDF ang mga espasyo sa mga path.

Kumuha ng ESP-IDF
Upang bumuo ng mga aplikasyon para sa EK057 module, kailangan mo ang mga software library na ibinigay ng Espressif sa ESP-IDF repository.
Upang makakuha ng ESP-IDF, lumikha ng isang direktoryo ng pag-install (~/esp) upang i-download ang ESP-IDF at i-clone ang repositoryo gamit ang 'git clone':

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

Ang ESP-IDF ay mada-download sa ~/esp/esp-idf. Kumonsulta sa Mga Bersyon ng ESP-IDF para sa impormasyon tungkol sa kung aling bersyon ng ESP-IDF ang gagamitin sa isang partikular na sitwasyon.
I-set up ang Tools
Bukod sa ESP-IDF, kailangan mo ring i-install ang mga tool na ginagamit ng ESP-IDF, tulad ng compiler, debugger, Python packages, atbp. Nagbibigay ang ESP-IDF ng script na pinangalanang 'install.sh' upang makatulong sa pag-set up ng mga tool sa isang lakad.
cd ~/esp/esp−idf

I-set up ang Mga Variable ng Environment
Ang mga naka-install na tool ay hindi pa naidagdag sa PATH environment variable. Upang gawing magagamit ang mga tool mula sa command line, dapat itakda ang ilang variable ng kapaligiran. Nagbibigay ang ESP-IDF ng isa pang script na 'export.sh' na gumagawa nito. Sa terminal kung saan mo gagamitin ang ESP-IDF, patakbuhin ang: install .sh. $HOME/esp/esp−idf/export.sh

Ngayon handa na ang lahat, maaari kang bumuo ng iyong unang proyekto sa EK057 module.
Lumikha ng Iyong Unang Proyekto
Magsimula ng isang Proyekto
Ngayon ay handa ka nang ihanda ang iyong aplikasyon para sa EK057 module. Maaari kang magsimula sa get-started/hello_world project mula sa examples directory sa ESP-IDF.
Kopyahin ang get-started/hello_world sa ~/esp directory:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .

Mayroong isang hanay ng mga example projects sa examples directory sa ESP-IDF. Maaari mong kopyahin ang anumang proyekto sa parehong paraan tulad ng ipinakita sa itaas at patakbuhin ito. Posible ring bumuo ng examples in-place, nang hindi kinokopya muna ang mga ito.

Ikonekta ang Iyong Device
Ngayon ikonekta ang iyong EK057 module sa computer at tingnan sa ilalim kung anong serial port ang makikita sa module. Ang mga se-rial port sa Linux ay nagsisimula sa '/dev/tty' sa kanilang mga pangalan. Patakbuhin ang command sa ibaba ng dalawang beses, una nang naka-unplug ang board, pagkatapos ay naka-plug in. Ang port na lalabas sa pangalawang pagkakataon ay ang kailangan mo:
ls /dev/tty*

Tandaan:
Panatilihing madaling gamitin ang pangalan ng port dahil kakailanganin mo ito sa mga susunod na hakbang.

I-configure
Mag-navigate sa iyong 'hello_world' na direktoryo mula sa Hakbang 2.4.1. Magsimula ng Proyekto, itakda ang ESP32 chip bilang target at patakbuhin ang 'menu config' ng utility sa pagsasaayos ng proyekto.

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

Ang pagtatakda ng target gamit ang 'idf.py set-target esp32' ay dapat gawin nang isang beses, pagkatapos magbukas ng bagong proyekto. Kung naglalaman ang proyekto ng ilang umiiral nang build at configuration, iki-clear ang mga ito at masisimulan. Maaaring i-save ang target sa environment variable upang laktawan ang hakbang na ito. Tingnan ang Pagpili ng Target para sa karagdagang impormasyon. Kung nagawa nang tama ang mga nakaraang hakbang, lilitaw ang sumusunod na menu:

Figure 2: Configuration ng Proyekto – Home Window
Maaaring iba ang mga kulay ng menu sa iyong terminal. Maaari mong baguhin ang hitsura gamit ang opsyong '--style'. Mangyaring patakbuhin ang 'idf.py menuconfig --help'para sa karagdagang impormasyon.
Buuin ang Proyekto
Buuin ang proyekto sa pamamagitan ng pagpapatakbo:
idf .py build

Isasama ng command na ito ang application at lahat ng bahagi ng ESP-IDF, pagkatapos ay bubuo ito ng bootloader, partition table, at mga binary ng application.

• $ idf .py build
• Pagpapatakbo ng cmake sa direktoryo /path/to/hello_world/build
• Isinasagawa ang ”cmake −G Ninja −−warn−uninitialized /path/to/hello_world”… Magbabala tungkol sa mga hindi nasimulang value .
• Natagpuan ang Git: /usr/bin/git (nahanap na bersyon ”2.17.0”)
• Bumuo ng walang laman na bahagi ng aws_iot dahil sa configuration
• Mga pangalan ng sangkap:…
• Mga path ng bahagi:…
• (higit pang mga linya ng output ng build system)
• [527/527] Bumubuo ng hello −world.bin
• esptool .py v2.3.1
  Nakumpleto ang pagbuo ng proyekto. Upang mag-flash , patakbuhin ang command na ito:
• component/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio−−flash_size detect −−flash_freq 40m 0x10000 build.0 build/hello−1000
• build/bootloader/bootloader. bin 0x8000 build/ partition_table / partition −table.bin
• o patakbuhin ang 'idf .py −p PORT flash'

Kung walang mga error, matatapos ang build sa pamamagitan ng pagbuo ng firmware binary .bin file.
Flash sa Device
I-flash ang mga binary na kakagawa mo lang sa iyong EK057 module sa pamamagitan ng pagpapatakbo:
idf .py −p PORT [−b BAUD] flash

Palitan ang PORT ng serial port name ng iyong module mula sa Hakbang: Ikonekta ang Iyong Device. Maaari mo ring baguhin ang flasher baud rate sa pamamagitan ng pagpapalit sa BAUD ng baud rate na kailangan mo. Ang default na baud rate ay 460800. Para sa higit pang impormasyon sa mga argumento ng idf.py, tingnan ang idf.py.

Tandaan:
Ang opsyon na 'flash' ay awtomatikong bumubuo at nagpapa-flash ng proyekto, kaya ang pagpapatakbo ng 'idf.py build' ay hindi kinakailangan.

• Pagpapatakbo ng esptool.py sa direktoryo […]/ esp/hello_world
• Isinasagawa ang ”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 / partition −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
  Kumokonekta….
• Ang pagtukoy sa uri ng chip … Ang ESP32 Chip ay ESP32D0WDQ6 (rebisyon 1)
• Mga Tampok : WiFi, BT, Dual Core Uploading stub …
• Running stub…
• Stub na tumatakbo…
• Binago ang baud rate sa 460800 Binago.
• Mga Sistema ng Espressif
• Kino-configure ang laki ng flash…
• Awtomatikong natukoy na laki ng Flash : 4MB
• Ang mga flash param ay nakatakda sa 0x0220
• Na-compress ang 22992 bytes hanggang 13019…
• Nagsulat ng 22992 bytes (13019 compressed) sa 0x00001000 sa loob ng 0.3 segundo (epektibong 558.9 kbit/s )… Na-verify ang hash ng data .
• Na-compress ang 3072 bytes hanggang 82…
• Nagsulat ng 3072 bytes (82 compressed) sa 0x00008000 sa loob ng 0.0 segundo (epektibong 5789.3 kbit/s )… Na-verify ang hash ng data .
• Na-compress ang 136672 bytes hanggang 67544…
• Nagsulat ng 136672 bytes (67544 compressed) sa 0x00010000 sa loob ng 1.9 segundo (epektibong 567.5 kbit/s )… Na-verify ang hash ng data .

Aalis…
Hard reset sa pamamagitan ng RTS pin...

Kung magiging maayos ang lahat, magsisimulang tumakbo ang application na "hello_world" pagkatapos mong alisin ang jumper sa IO0 at GND, at muling paganahin ang testing board.
Subaybayan
Upang tingnan kung talagang tumatakbo ang "hello_world", i-type ang 'idf.py -p PORT monitor' (Huwag kalimutang palitan ang PORT ng iyong serial port name).
Inilunsad ng command na ito ang application ng IDF Monitor:

• $ idf .py −p /dev/ttyUSB0 monitor
• Pagpapatakbo ng idf_monitor sa direktoryo […]/ esp/hello_world/build
• Isinasagawa ang ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. duwende…−−− idf_monitor sa /dev/ttyUSB0 115200 −−−
• Umalis: Ctrl+] | Menu: Ctrl+T | Tulong: Ctrl+T na sinusundan ng Ctrl+H
• at Hun 8 2016 00:22:57
• una :0x1 ​​(POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
• at Hun 8 2016 00:22:57

Pagkatapos mag-scroll pataas ng mga startup at diagnostic log, dapat mong makita ang "Hello world!" naka-print sa pamamagitan ng application.

• Hello mundo!
• Magsisimula muli sa loob ng 10 segundo…
• Ito ay esp32 chip na may 2 CPU core, WiFi/BT/BLE, silicon revision 1, 2MB external flash Restarting sa 9 segundo …
• Magsisimula muli sa loob ng 8 segundo…
• Magsisimula muli sa loob ng 7 segundo…

Iyon lang ang kailangan mo para makapagsimula sa EK057 module! Ngayon ay handa ka nang sumubok ng ibang examples sa ESP-IDF, o pumunta mismo sa pagbuo ng sarili mong mga application.

Mga Mapagkukunan ng Pag-aaral

Mga Dokumentong Dapat Basahin
Ang sumusunod na link ay nagbibigay ng mga dokumentong nauugnay sa ESP32.

Mga Dokumento / Mga Mapagkukunan

Espressif Systems EK057 Wi-Fi at Bluetooth Internet of Things Module [pdf] User Manual EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi at Bluetooth Internet of Things Module, Wi-Fi at Bluetooth Internet of Things Module

Mga sanggunian

• User Manual