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

Mahitungod Niini nga Dokumento

Kini nga manwal sa paggamit nagpakita kon unsaon pagsugod sa EK057 module.

Mga Update sa Dokumento
Palihog tan-awa kanunay ang pinakabag-o nga bersyon sa https://www.espressif.com/en/support/download/documents.

Kasaysayan sa Pagbag-o
Para sa kasaysayan sa rebisyon niini nga dokumento, palihog tan-awa ang kataposang panid.

Pagpahibalo sa Pagbag-o sa Dokumentasyon
Naghatag ang Espressif og mga pahibalo sa email aron mapadayon ang pag-update sa mga kostumer sa mga pagbag-o sa teknikal nga dokumentasyon. Palihug subscribe sa www.espressif.com/en/subscribe. Timan-i nga kinahanglan nimo nga i-update ang imong suskrisyon aron makadawat mga notipikasyon sa mga bag-ong produkto nga wala ka karon naka-subscribe.

Sertipikasyon
Pag-download sa mga sertipiko alang sa mga produkto sa Espressif gikan sa www.espressif.com/en/certificates.

Disclaimer ug Copyright Notice
Ang kasayuran niini nga dokumento, lakip ang URL mga pakisayran, mahimong usbon nga walay pahibalo. KINI NGA DOKUMENTO GIHATAG NGA WALAY WARRANTY BISAN BISAN BISAN UNSANG WARRANTY, LAKIP ANG UNSANG WARRANTY OF MERCHANTABILITY, NON-INFRINGEMENT, FITNESS FOR ANY PARTIKULAR NA KATUYOAN, O BISAN UNSANG WARRANTY NGA MATUWANG SA BISAN UNSANG PROPOSASYON O ESPESPISYO.AMPLE.
Ang tanan nga tulubagon, lakip na ang tulubagon sa paglapas sa bisan unsang proprietary rights, nga may kalabutan sa paggamit sa impormasyon niini nga dokumento gisalikway. Wala’y mga lisensya nga gipahayag o gipasabut, pinaagi sa estoppel o kung dili, sa bisan unsang mga katungod sa intelektwal nga kabtangan ang gihatag dinhi. Ang logo sa Miyembro sa Wi-Fi Alliance kay usa ka marka sa Wi-Fi Alliance. Ang Bluetooth logo kay rehistrado nga marka sa Bluetooth SIG. Ang tanan nga mga ngalan sa pamatigayon, mga marka sa pamatigayon ug mga rehistradong marka sa pamatigayon nga gihisgutan niini nga dokumento mga kabtangan sa ilang mga tag-iya, ug pinaagi niini giila. Copyright © 2020 Espressif Systems (Shanghai) Co., Ltd. Tanang katungod gigahin.

Tapos naview

Nahuman ang Moduleview
Ang EK057 usa ka gamhanan, generic nga Wi-Fi+Bluetooth®+Bluetooth® LE MCU module nga nagpunting sa usa ka halapad nga lainlain nga aplikasyon, gikan sa mga low-power sensor network hangtod sa labing lisud nga mga buluhaton, sama sa voice encoding, music streaming ug MP3 pag-decode.
Talaan 1: EK057 Mga Detalye

Mga kategoriya	Mga butang	Mga detalye
Wi-Fi	Mga protocol	802.11 b/g/n (802.11n hangtod sa 150 Mbps)
		A-MPDU ug A-MSDU aggregation ug 0.4 µs bantay suporta sa agwat
	Sakup sa frequency	2412 ~ ​​2484 MHz
Bluetooth®	Mga protocol	Protocols v4.2 BR/EDR ug Bluetooth® LE specifica- sibuyas
	Radyo	Class-1, class-2 ug class-3 transmitter
		AFH
	Audio	CVSD ug SBC
Hardware	Mga interface sa module	UART, SPI, I2C, I2S, GPIO, ADC
	Nahiusa nga kristal	40 MHz nga kristal
	Nahiusa nga SPI flash	8 MB
	Ang operating voltage/Suplay sa kuryente	3.0 V ~ 3.6 V
	Naglihok nga kasamtangan	Average: 80 mA
	Minimum nga kasamtangan nga gihatag pinaagi sa gahum suplay	500 mA
	Girekomenda nga operating temperatura- gilangkuban sa ture	–40 °C ~ +85 °C
	Ang lebel sa pagkasensitibo sa kaumog (MSL)	Level 3

Deskripsyon sa Pin
Ang module adunay 14 pins ug 7 testing points. Tan-awa ang mga kahulugan sa pin sa Talaan 2.

Ngalan	Dili.	Type	Kalihokan
IO32	A1	I/O	GPIO32, XTAL_32K_P (32.768 kHz crystal oscillator input), ADC1_CH4, HIPIT9, 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	suplay sa kuryente
GND	A6	P	Yuta

Ngalan	Dili.	Type	Kalihokan
GND	A7	P	Yuta
GND	A8	P	Yuta
GND	A9	P	Yuta
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 kristal oscillator output), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Taas: Sa; makapahimo sa chip Low: Off; ang chip gipalong Pahinumdom: Ayaw ibilin ang pin nga naglutaw.
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

Pagsugod sa EK057

Unsa ang Imong Gikinahanglan
Aron makahimo og mga aplikasyon alang sa EK057 module kinahanglan nimo:

• 1 x EK057 nga module
• 1 x Espressif RF testing board
• 1 x USB-to-Serial board
• 1 x Micro-USB cable
• 1 x PC nga nagdagan sa Linux

Niini nga giya sa tiggamit, among gikuha ang Linux operating system isip example. Para sa dugang nga impormasyon bahin sa configuration sa Windows ug macOS, palihog tan-awa ang ESP-IDF Programming Guide.

Koneksyon sa Hardware

1. Solder ang EK057 module sa RF testing board sama sa gipakita sa Figure 1.
2. Ikonektar ang RF testing board sa USB-to-Serial board pinaagi sa TXD, RXD, ug GND.
3. Ikonektar ang USB-to-Serial board sa PC.
4. Ikonektar ang RF testing board sa PC o sa usa ka power adapter aron makahimo sa 5 V power supply, pinaagi sa Micro-USB cable.
5. Atol sa pag-download, ikonektar ang IO0 sa GND pinaagi sa usa ka jumper. Dayon, i-"ON" ang testing board.
6.  Pag-download sa firmware sa flash. Para sa mga detalye, tan-awa ang mga seksyon sa ubos.
7. Human sa pag-download, kuhaa ang jumper sa IO0 ug GND.
8. Pakusog pag-usab ang RF testing board. Ang EK057 mobalhin sa working mode. Ang chip magbasa sa mga programa gikan sa flash sa pagsugod.

Mubo nga sulat:
Ang IO0 kay taas nga logic sa sulod. Kung ang IO0 gitakda sa pagbitad, ang Boot mode gipili. Kung kini nga pin kay pull-down o wala nga naglutaw, ang Download mode gipili. Para sa dugang nga impormasyon sa EK057, palihog tan-awa ang EK057 Datasheet.

Ibutang ang Development Environment
Ang Espressif IoT Development Framework (ESP-IDF alang sa mubo) usa ka balangkas alang sa pagpalambo sa mga aplikasyon base sa ESP32. Ang mga tiggamit makahimo og mga aplikasyon nga adunay ESP32 sa Windows/Linux/macOS base sa ESP-IDF. Dinhi among gikuha ang Linux operating system isip example.
Pag-instalar sa mga gikinahanglan
Sa pag-compile sa ESP-IDF kinahanglan nimo nga makuha ang mosunod nga mga pakete:

• CentOS 7:
  sudo yum install git wget flex bison gperf python cmake ninja−build ccache dfu−util
• Ubuntu ug Debian (usa ka command nabuak sa duha ka 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 −−kinahanglan gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
• Mubo nga sulat:
• Kini nga giya naggamit sa direktoryo ~/esp sa Linux isip folder sa pag-install para sa ESP-IDF.
• Hinumdomi nga ang ESP-IDF wala nagsuporta sa mga luna sa mga agianan.

Kuhaa ang ESP-IDF
Para magtukod ug mga aplikasyon para sa EK057 module, kinahanglan nimo ang software libraries nga gihatag ni Espressif sa ESP-IDF repository.
Aron makuha ang ESP-IDF, paghimo usa ka direktoryo sa pag-install (~/esp) aron ma-download ang ESP-IDF ug i-clone ang repository gamit ang 'git clone':

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

Ang ESP-IDF ma-download sa ~/esp/esp-idf. Konsultaha ang ESP-IDF Bersyon alang sa impormasyon mahitungod sa ESP-IDF nga bersyon sa paggamit sa usa ka gihatag nga sitwasyon.
I-set up ang Tools
Gawas sa ESP-IDF, kinahanglan nimo nga i-install ang mga himan nga gigamit sa ESP-IDF, sama sa compiler, debugger, Python packages, ug uban pa. sa usa ka lakaw.
cd ~/esp/esp−idf

I-set up ang Environment Variables
Ang na-install nga mga himan wala pa idugang sa PATH environment variable. Aron mahimo ang mga himan nga magamit gikan sa command line, ang pipila ka mga variable sa palibot kinahanglan nga itakda. Ang ESP-IDF naghatag ug laing script nga 'export.sh' nga naghimo niana. Sa terminal diin imong gamiton ang ESP-IDF, run: install .sh. $HOME/esp/esp−idf/export.sh

Karon andam na ang tanan, mahimo nimong tukuron ang imong una nga proyekto sa EK057 module.
Paghimo sa Imong Unang Proyekto
Pagsugod sa usa ka Proyekto
Karon andam ka na sa pag-andam sa imong aplikasyon alang sa EK057 module. Makasugod ka sa get-start/hello_world nga proyekto gikan sa examples nga direktoryo sa ESP-IDF.
Kopyaha ang pagsugod/hello_world sa ~/esp nga direktoryo:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .

Naay range sa example projects sa examples nga direktoryo sa ESP-IDF. Mahimo nimong kopyahon ang bisan unsang proyekto sa parehas nga paagi sama sa gipresentar sa ibabaw ug ipadagan kini. Posible usab nga magtukod og examples in-place, nga walay pagkopya una niini.

Ikonektar ang Imong Device
Karon ikonektar ang imong EK057 module sa kompyuter ug susiha ubos sa unsa nga serial port ang module makita. Ang mga se-rial port sa Linux nagsugod sa '/dev/tty' sa ilang mga ngalan. Pagdalagan ang command sa ubos sa duha ka beses, una uban sa board nga gi-unplug, dayon uban sa plugged in. Ang port nga makita sa ikaduhang higayon mao ang imong gikinahanglan:
ls /dev/tty*

Mubo nga sulat:
Ipadayon ang ngalan sa pantalan kay kinahanglan nimo kini sa sunod nga mga lakang.

I-configure
Pagdala ngadto sa imong 'hello_world' nga direktoryo gikan sa Lakang 2.4.1. Pagsugod sa usa ka Proyekto, ibutang ang ESP32 chip isip target ug padagana ang project configuration utility 'menu config'.

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

Ang pagbutang sa target gamit ang 'idf.py set-target esp32' kinahanglan buhaton kausa, pagkahuman sa pag-abli sa usa ka bag-ong proyekto. Kung ang proyekto adunay pipila ka mga kasamtangan nga pagtukod ug pag-configure, kini malimpyohan ug masugdan. Ang target mahimong ma-save sa environment variable aron malaktawan kini nga lakang. Tan-awa ang Pagpili sa Target para sa dugang nga impormasyon. Kung ang nangaging mga lakang nahimo sa husto, ang mosunod nga menu makita:

Figure 2: Configuration sa Proyekto – Window sa Panimalay
Ang mga kolor sa menu mahimong lahi sa imong terminal. Mahimo nimong usbon ang hitsura gamit ang opsyon nga '--style'. Palihug pagdagan 'idf.py menuconfig --help'para sa dugang nga impormasyon.
Pagtukod sa Proyekto
Pagtukod sa proyekto pinaagi sa pagpadagan:
idf .py pagtukod

Kini nga mando mag-compile sa aplikasyon ug sa tanan nga mga sangkap sa ESP-IDF, unya kini makamugna sa bootloader, partition table, ug mga binary sa aplikasyon.

• $ idf .py pagtukod
• Pagpadagan sa cmake sa direktoryo /path/to/hello_world/build
• Nagpatuman sa "cmake −G Ninja −−warning−uninitialized /path/to/hello_world”… Pasidaan mahitungod sa wala pa nasugdan nga mga bili .
• Nakit-an ang Git: /usr/bin/git (nakaplagan nga bersyon "2.17.0")
• Pagtukod og walay sulod nga aws_iot component tungod sa configuration
• Ngalan sa Component:…
• Mga agianan sa sangkap:…
• (daghang linya sa output sa sistema sa pagtukod)
• [527/527] Paghimo og hello −world.bin
• esptool .py v2.3.1
  Kompleto ang pagtukod sa proyekto. Aron mag-flash, padagana kini nga sugo:
• components/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio−−flash_size detect −−flash_freq 40m 0x10000 build.0x build/bin1000−XNUMX
• pagtukod/bootloader/bootloader. bin 0x8000 build/ partition_table / partition −table.bin
• o pagdagan 'idf .py −p PORT flash'

Kung walay mga sayup, ang pagtukod mahuman pinaagi sa pagmugna sa firmware binary .bin file.
Flash sa Device
I-flash ang mga binary nga bag-o lang nimong gitukod sa imong EK057 module pinaagi sa pagpadagan:
idf .py −p PORT [−b BAUD] flash

Ilisan ang PORT sa serial port name sa imong module gikan sa Lakang: Ikonektar ang Imong Device. Mahimo usab nimo usbon ang flasher baud rate pinaagi sa pag-ilis sa BAUD sa baud rate nga imong gikinahanglan. Ang default baud rate kay 460800. Para sa dugang nga impormasyon sa idf.py arguments, tan-awa ang idf.py.

Mubo nga sulat:
Ang kapilian nga 'flash' awtomatik nga nagtukod ug nag-flash sa proyekto, busa ang pagpadagan sa 'idf.py build' dili kinahanglan.

• Pagpadagan sa esptool.py sa direktoryo […]/ esp/hello_world
• Nagpatuman sa "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
  Nagdugtong….
• Ang pag-ila sa tipo sa chip ... ESP32 Chip mao ang ESP32D0WDQ6 (rebisyon 1)
• Mga Feature: WiFi, BT, Dual Core Uploading stub…
• Nagdagan nga stub…
• Nagdagan nga stub…
• Pag-usab sa baud rate sa 460800 Gibag-o.
• Mga Sistema sa Espressif
• Pag-configure sa gidak-on sa flash…
• Awtomatikong namatikdan nga gidak-on sa Flash: 4MB
• Flash params gitakda sa 0x0220
• Gi-compress ang 22992 bytes hangtod sa 13019…
• Nagsulat 22992 bytes (13019 compressed) sa 0x00001000 sa 0.3 segundos (epektibo 558.9 kbit/s)… Hash sa data napamatud-an.
• Gi-compress ang 3072 bytes hangtod sa 82…
• Nagsulat 3072 bytes (82 compressed) sa 0x00008000 sa 0.0 segundos (epektibo 5789.3 kbit/s)… Hash sa data napamatud-an.
• Gi-compress ang 136672 bytes hangtod sa 67544…
• Nagsulat 136672 bytes (67544 compressed) sa 0x00010000 sa 1.9 segundos (epektibo 567.5 kbit/s)… Hash sa data napamatud-an.

Pagbiya…
Lisud nga pag-reset pinaagi sa RTS pin…

Kung maayo ang tanan, ang "hello_world" nga aplikasyon magsugod sa pagdagan pagkahuman nimo tangtangon ang jumper sa IO0 ug GND, ug i-power up ang testing board.
Monitor
Aron masusi kung ang "hello_world" tinuod nga nagdagan, i-type ang 'idf.py -p PORT monitor' (Ayaw kalimti ang pag-ilis sa PORT sa imong serial port nga ngalan).
Kini nga sugo naglansad sa aplikasyon sa IDF Monitor:

• $ idf .py −p /dev/ttyUSB0 monitor
• Pagpadagan sa idf_monitor sa direktoryo […]/ esp/hello_world/build
• Nagpatuman sa ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. elf…−−− idf_monitor sa /dev/ttyUSB0 115200 −−−
• Hunong: Ctrl+] | Menu: Ctrl+T | Tabang: Ctrl+T gisundan sa Ctrl+H
• ug Hun 8 2016 00:22:57
• una: 0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT)
• ug Hun 8 2016 00:22:57

Pagkahuman sa pagsugod ug pag-scroll sa mga log sa diagnostic, kinahanglan nimo nga makita ang "Hello world!" giimprinta pinaagi sa aplikasyon.

• Hello kalibutan!
• Pagsugod pag-usab sa 10 segundos…
• Kini ang esp32 chip nga adunay 2 CPU cores, WiFi/BT/BLE, silicon revision 1, 2MB external flash Pag-restart sa 9 segundos…
• Pagsugod pag-usab sa 8 segundos…
• Pagsugod pag-usab sa 7 segundos…

Mao ra kana ang kinahanglan nimo aron makasugod sa EK057 module! Karon andam ka na nga mosulay sa ubang mga examples sa ESP-IDF, o adto mismo sa paghimo sa imong kaugalingong mga aplikasyon.

Mga Kapanguhaan sa Pagkat-on

Kinahanglang Basahon nga mga Dokumento
Ang mosunod nga link naghatag og mga dokumento nga may kalabutan sa ESP32.

Mga Dokumento / Mga Kapanguhaan

Espressif Systems EK057 Wi-Fi ug Bluetooth Internet of Things Module [pdf] Manwal sa Gumagamit EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi ug Bluetooth Internet of Things Module, Wi-Fi ug Bluetooth Internet of Things Module

Mga pakisayran

• Manwal sa Gumagamit