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

Ngeunaan Dokumén Ieu

Buku manual ieu nunjukkeun kumaha ngamimitian modul EK057.

Dokumén Apdet
Mangga sok tingal versi panganyarna dina https://www.espressif.com/en/support/download/documents.

Riwayat révisi
Pikeun sajarah révisi dokumén ieu, mangga tingal kaca panungtungan.

Dokuméntasi Robah Bewara
Espressif nyayogikeun béwara email supados para nasabah tetep diropéa ngeunaan parobahan dokuméntasi téknis. Mangga ngalanggan di www.espressif.com/en/subscribe. Catet yén anjeun kedah ngapdet langganan anjeun pikeun nampi béwara ngeunaan produk anyar anu anjeun henteu acan langganan.

Sertifikasi
Unduh sertipikat pikeun produk Espressif tina www.espressif.com/en/certificates.

Bantahan sareng Bewara Hak Cipta
Inpormasi dina dokumén ieu, kalebet URL rujukan, bisa dirobah tanpa aya bewara. DOKUMEN IEU DISAYEUN TANPA HARANSI NAON, KAAsup JAMINAN KOMUNITAS DAGANG, NON-PELANGGARAN, KESESUAIAN PIKEUN TUJUAN TUNGGU, ATAWA JAMINAN NU JADI TIMBUL TINA PROPOSAL, Spésifikna.AMPLE.
Sadaya tanggung jawab, kalebet tanggung jawab pikeun ngalanggar hak proprietary, anu aya hubunganana sareng pamakean inpormasi dina dokumén ieu ditolak. Henteu aya lisénsi anu dinyatakeun atanapi tersirat, ku estoppel atanapi sanés, kana hak cipta intelektual anu dipasihkeun di dieu. Logo Anggota Wi-Fi Alliance mangrupakeun mérek dagang ti Wi-Fi Alliance. Logo Bluetooth mangrupakeun mérek dagang kadaptar ti Bluetooth SIG. Sadaya nami dagang, mérek dagang sareng mérek dagang kadaptar anu disebatkeun dina dokumén ieu mangrupikeun milik anu gaduhna, sareng ku ieu diaku. Hak Cipta © 2020 Espressif Systems (Shanghai) Co., Ltd. Sadaya hak ditangtayungan.

Leuwihview

Modul Leuwihview
EK057 mangrupikeun modul Wi-Fi+Bluetooth®+Bluetooth® LE MCU generik anu kuat anu nargétkeun rupa-rupa aplikasi, mimitian ti jaringan sénsor kakuatan-rendah nepi ka tugas anu paling nuntut, sapertos encoding sora, streaming musik sareng MP3. decoding.
meja 1: EK057 spésifikasi

Kategori	Barang	spésifikasi
Wifi	Protokol	802.11 b/g/n (802.11n nepi ka 150 Mbps)
		A-MPDU jeung A-MSDU aggregation na 0.4 µs hansip rojongan interval
	rentang frékuénsi	2412 ~ 2484 MHz
Bluetooth®	Protokol	Protokol v4.2 BR/EDR sareng Bluetooth® LE spésifikasi- ngilu
	Radio	Kelas-1, kelas-2 jeung kelas-3 pamancar
		AFH
	Audio	CVSD jeung SBC
Hardware	Interfaces modul	UART, SPI, I2C, I2S, GPIO, ADC
	kristal terpadu	40 MHz kristal
	Flash SPI terpadu	8 MB
	Operasi voltage / suplai kakuatan	3.0 V ~ 3.6 V
	Operasi ayeuna	Rata-rata: 80 mA
	Arus minimum dikirimkeun ku kakuatan suplai	500 mA
	Suhu operasi anu disarankeun rentang tangtu	–40 °C ~ +85 °C
	Tingkat sensitipitas kelembaban (MSL)	Tingkat 3

Pin Pedaran
modul ngabogaan 14 pin na 7 titik nguji. Tempo definisi pin dina Tabél 2.

Ngaran	No.	Tipe	Fungsi
IO32	A1	Abdi / O	GPIO32, XTAL_32K_P (32.768 kHz kristal osilator input), ADC1_CH4, TOUCH9, RTC_GPIO9
IO16	A2	Abdi / O	GPIO16, HS1_DATA4, U2RXD, EMAC_CLK_OUT
IO17	A3	Abdi / O	GPIO17, HS1_DATA5, U2TXD, EMAC_CLK_OUT_180
IO5	A4	Abdi / O	GPIO5, VSPICS0, HS1_DATA6, EMAC_RX_CLK
3V3	A5	P	Sasayogian tanaga
GND	A6	P	taneuh

Ngaran	No.	Tipe	Fungsi
GND	A7	P	taneuh
GND	A8	P	taneuh
GND	A9	P	taneuh
IO18	A10	Abdi / O	GPIO18, VSPICLK, HS1_DATA7
IO23	A11	Abdi / O	GPIO23, VSPID, HS1_STROBE
IO19	A12	Abdi / O	GPIO19, VSPIQ, U0CTS, EMAC_TXD0
IO33	A13	Abdi / O	GPIO33, XTAL_32K_N (kaluaran osilator kristal 32.768 kHz), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Luhur: Dina; ngamungkinkeun chip Low: Pareum; kakuatan chip pareum Catetan: Ulah ninggalkeun pin ngambang.
IO14	TP22	Abdi / O	GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
IO15	TP21	Abdi / O	GPIO15, ADC2_CH3, TOUCH3, MTDO, HSPICS0, RTC_GPIO13, HS2_CMD, SD_CMD, EMAC_RXD3
IO13	TP18	Abdi / O	GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
IO12	TP17	Abdi / O	GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
IO0	TP19	Abdi / O	GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
RXD	TP16	Abdi / O	GPIO3, U0RXD, CLK_OUT2
TXD	TP20	Abdi / O	GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2

Ngamimitian dina EK057

Naon nu peryogi
Pikeun ngembangkeun aplikasi pikeun modul EK057 anjeun peryogi:

• 1 x EK057 modul
• 1 x papan uji Espressif RF
• 1 x USB-to-Serial dewan
• 1 x kabel Micro-USB
• 1 x PC ngajalankeun Linux

Dina pituduh pangguna ieu, kami nyandak sistem operasi Linux salaku example. Kanggo inpo nu langkung lengkep ihwal konfigurasi dina Windows sareng macOS, mangga tingal Pituduh Pemrograman ESP-IDF.

Sambungan Hardware

1. Solder modul EK057 ka papan uji RF sapertos anu dipidangkeun dina Gambar 1.
2. Sambungkeun papan uji RF ka papan USB-to-Serial liwat TXD, RXD, sareng GND.
3. Sambungkeun papan USB-to-Serial ka PC.
4. Sambungkeun papan uji RF ka PC atanapi adaptor kakuatan pikeun ngaktifkeun catu daya 5 V, ngalangkungan kabel Micro-USB.
5. Salila ngundeur, sambungkeun IO0 ka GND via jumper a. Teras, hurungkeun "ON" papan uji.
6.  Unduh firmware kana flash. Pikeun detil, tingali bagian di handap.
7. Saatos diunduh, cabut jumper dina IO0 sareng GND.
8. Dayakeun deui papan uji RF. EK057 bakal pindah ka modeu gawé. Chip bakal maca program ti flash kana initialization.

Catetan:
IO0 sacara internal logika luhur. Lamun IO0 disetel ka pull-up, mode Boot dipilih. Lamun pin ieu pull-handap atawa ditinggalkeun ngambang, mode Download dipilih. Kanggo inpo nu langkung lengkep ihwal EK057, mangga tingal Lembar Data EK057.

Nyetél Lingkungan Pangwangunan
Kerangka Pengembangan Espressif IoT (singketna ESP-IDF) mangrupikeun kerangka pikeun ngembangkeun aplikasi dumasar kana ESP32 Espressif. Pamaké tiasa ngembangkeun aplikasi sareng ESP32 dina Windows/Linux/macOS dumasar kana ESP-IDF. Di dieu urang nyandak sistem operasi Linux salaku example.
Pasang Prasyarat
Pikeun compile sareng ESP-IDF anjeun kedah nampi bungkusan ieu:

• CentOS 7:
  sudo yum install git wget flex bison gperf python cmake ninja−build ccache dfu−util
• Ubuntu sareng Debian (hiji paréntah ngabagi dua baris):
  sudo apt−meunang install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build ccache libffi −dev libssl −dev dfu−util
• Lengkungan:
  sudo pacman −S −−diperlukeun gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
• Catetan:
• Pituduh ieu nganggo diréktori ~/esp dina Linux salaku polder pamasangan pikeun ESP-IDF.
• Émut yén ESP-IDF henteu ngadukung rohangan dina jalur.

Kéngingkeun ESP-IDF
Pikeun ngawangun aplikasi pikeun modul EK057, anjeun peryogi perpustakaan parangkat lunak anu disayogikeun ku Espressif dina gudang ESP-IDF.
Pikeun kéngingkeun ESP-IDF, jieun diréktori pamasangan (~/esp) pikeun ngaunduh ESP-IDF sareng clone gudang nganggo 'git clone':

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

ESP-IDF bakal diunduh kana ~/esp/esp-idf. Taroskeun versi ESP-IDF kanggo inpormasi ngeunaan versi ESP-IDF mana anu dianggo dina kaayaan anu tangtu.
Nyetél Pakakas
Salian ti ESP-IDF, anjeun ogé kedah masang alat anu dianggo ku ESP-IDF, sapertos kompiler, debugger, pakét Python, jsb. ESP-IDF nyayogikeun skrip anu namina 'install.sh' pikeun ngabantosan nyetél alat dina hiji lebet.
cd ~/esp/esp−idf

Nyetél Variabel Lingkungan
Parabot anu dipasang henteu acan ditambahkeun kana variabel lingkungan PATH. Pikeun ngajantenkeun alat tiasa dianggo tina garis paréntah, sababaraha variabel lingkungan kedah disetél. ESP-IDF nyayogikeun skrip sanés 'export.sh' anu ngalakukeun éta. Dina terminal dimana anjeun bade nganggo ESP-IDF, ngajalankeun: install .sh. $HOME/esp/esp−idf/export.sh

Ayeuna sagalana geus siap, anjeun tiasa ngawangun proyék munggaran anjeun dina modul EK057.
Jieun Proyék Mimiti Anjeun
Mimitian Proyék
Ayeuna anjeun siap nyiapkeun aplikasi anjeun pikeun modul EK057. Anjeun tiasa mimitian ku ngamimitian / hello_world proyék ti urutampdiréktori les di ESP-IDF.
Salin ngamimitian/hello_world ka ~/esp diréktori:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .

Aya rentang example proyék di exampdiréktori les di ESP-IDF. Anjeun tiasa nyalin proyék naon waé dina cara anu sami sareng anu dipidangkeun di luhur sareng ngajalankeunana. Ieu oge mungkin pikeun ngawangun examples di-tempat, tanpa nyalin aranjeunna munggaran.

Sambungkeun Alat Anjeun
Ayeuna sambungkeun modul EK057 anjeun ka komputer tur pariksa dina naon port serial modul nu katingali. Palabuhan se-rial dina Linux dimimitian ku '/dev/tty' dina namina. Jalankeun paréntah di handap dua kali, kahiji kalayan papan dicabut, teras dicolokkeun. Port anu muncul kadua kalina nyaéta anu anjeun peryogikeun:
ls /dev/tty*

Catetan:
Tetep nami port gunana sabab anjeun peryogi dina léngkah-léngkah salajengna.

Konpigurasikeun
Napigasi ka diréktori 'hello_world' anjeun tina Lengkah 2.4.1. Mimitian Proyék, setel chip ESP32 salaku udagan sareng jalankeun utilitas konfigurasi proyék 'menu config'.

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

Netepkeun udagan sareng 'idf.py set-target esp32' kedah dilakukeun sakali, saatos muka proyék énggal. Upami proyék éta ngandung sababaraha wangunan sareng konfigurasi anu tos aya, aranjeunna bakal diberesihan sareng diinisialisasi. Target tiasa disimpen dina variabel lingkungan pikeun ngalangkungan léngkah ieu. Tempo Milih Target pikeun émbaran tambahan. Upami léngkah-léngkah saacanna parantos leres, ménu di handap ieu némbongan:

Gambar 2: Konfigurasi Proyék - Jandéla Imah
Warna ménu tiasa bénten dina terminal anjeun. Anjeun tiasa ngarobih penampilan kalayan pilihan '--style'. Mangga ngajalankeun 'idf.py menuconfig --help'pikeun informasi salajengna.
Ngawangun Proyék
Ngawangun proyék ku ngajalankeun:
idf .py ngawangun

Paréntah ieu bakal nyusun aplikasi sareng sadaya komponén ESP-IDF, teras bakal ngahasilkeun bootloader, tabel partisi, sareng binari aplikasi.

• $ idf .py ngawangun
• Ngajalankeun cmake dina diréktori /path/to/hello_world/build
• Ngaéksekusi "cmake −G Ninja −−warn−uninitialized /path/to/hello_world"... Warn ngeunaan nilai uninitialized .
• Kapanggih Git: /usr/bin/git (kapanggih versi "2.17.0")
• Ngawangun komponén aws_iot kosong kusabab konfigurasi
• Ngaran komponén:…
• Jalur komponén:…
• (langkung seueur garis kaluaran sistem ngawangun)
• [527/527] Ngahasilkeun halo −world.bin
• esptool .py v2.3.1
  Proyék ngawangun réngsé. Pikeun flash, jalankeun paréntah ieu:
• komponén/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio−−flash_size ngadeteksi −−flash_freq 40m 0x10000 build.0x1000 build/binXNUMX−
• ngawangun / bootloader / bootloader. bin 0x8000 ngawangun / partition_table / partisi −table.bin
• atawa ngajalankeun 'idf .py −p PORT flash'

Mun euweuh kasalahan, ngawangun bakal rengse ku generating firmware binér .bin file.
Flash kana Alat
Flash binér nu karék diwangun kana modul EK057 anjeun ku ngajalankeun:
idf .py −p PORT [−b BAUD] flash

Ganti PORT sareng nami port serial modul anjeun tina Lengkah: Sambungkeun Alat anjeun. Anjeun oge bisa ngarobah laju baud flasher ku ngaganti BAUD kalawan laju baud nu peryogi. Laju baud standar nyaéta 460800. Kanggo inpo nu langkung lengkep ihwal argumen idf.py, tingali idf.py.

Catetan:
Pilihan 'flash' otomatis ngawangun sareng kedip-kedip proyek, janten ngajalankeun 'idf.py build' henteu diperyogikeun.

• Ngajalankeun esptool.py dina diréktori [...]/ esp/hello_world
• Ngalaksanakeun "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 ngadeteksi −−flash_flash 40m 0x1000
• bootloader / bootloader. bin 0x8000 partition_table / partisi −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
  Nyambung….
• Ngadeteksi jinis chip ... ESP32 Chip nyaéta ESP32D0WDQ6 (révisi 1)
• Fitur: WiFi, BT, Dual Core Uploading stub…
• Rintisan ngajalankeun…
• Stub ngajalankeun…
• Ngarobah laju baud ka 460800 Robah.
• Sistem Espressif
• Ngonpigurasikeun ukuran lampu kilat…
• Ukuran Flash anu dideteksi otomatis: 4MB
• Params flash disetel ka 0x0220
• Dikomprés 22992 bait ka 13019…
• Nulis 22992 bait (13019 dikomprés) dina 0x00001000 dina 0.3 detik (epektip 558.9 kbit/s)… Hash data diverifikasi.
• Dikomprés 3072 bait ka 82…
• Nulis 3072 bait (82 dikomprés) dina 0x00008000 dina 0.0 detik (epektip 5789.3 kbit/s)… Hash data diverifikasi.
• Dikomprés 136672 bait ka 67544…
• Nulis 136672 bait (67544 dikomprés) dina 0x00010000 dina 1.9 detik (epektip 567.5 kbit/s)… Hash data diverifikasi.

Ninggalkeun…
Hard reset via RTS pin…

Lamun sagalana mana ogé, aplikasi "hello_world" dimimitian ngajalankeun sanggeus anjeun nyabut jumper on IO0 na GND, sarta ulang kakuatan nepi dewan nguji.
Ngawaskeun
Pikeun pariksa naha "hello_world" leres-leres jalan, ketik 'idf.py -p PORT monitor' (Ulah hilap ngagentos PORT sareng nami port serial anjeun).
Paréntah ieu ngaluncurkeun aplikasi IDF Monitor:

• $ idf .py −p /dev/ttyUSB0 monitor
• Ngajalankeun idf_monitor dina diréktori [...]/ esp/hello_world/build
• Ngalaksanakeun ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. elf…−−− idf_monitor dina /dev/ttyUSB0 115200 −−−
• Kaluar: Ctrl+] | Menu: Ctrl+T | Pitulung: Ctrl + T dituturkeun ku Ctrl + H
• ets Jun 8 2016 00:22:57
• kahiji: 0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT)
• ets Jun 8 2016 00:22:57

Saatos ngamimitian sareng log diagnostik ngagulung ka luhur, anjeun kedah ningali "Halo dunya!" dicitak kaluar ku aplikasi.

• Halo Dunya!
• Mimitian deui dina 10 detik…
• Ieu mangrupikeun chip esp32 sareng 2 inti CPU, WiFi / BT / BLE, révisi silikon 1, lampu kilat éksternal 2MB Dibalikan deui dina 9 detik ...
• Mimitian deui dina 8 detik…
• Mimitian deui dina 7 detik…

Éta sadayana anu anjeun peryogikeun pikeun ngamimitian modul EK057! Ayeuna anjeun siap nyobian sababaraha ex séjénamples di ESP-IDF, atawa buka katuhu pikeun ngembangkeun aplikasi Anjeun sorangan.

Sumber Diajar

Dokumén Wajib Dibaca
Link di handap nyadiakeun dokumén patali ESP32.

Dokumén / Sumberdaya

Espressif Systems EK057 Wi-Fi jeung Bluetooth Internet of Things Module [pdf] Manual pamaké EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Wi-Fi sareng Bluetooth Internet of Things Module, Wi-Fi sareng Bluetooth Internet of Things Module

Rujukan

• Manual pamaké