Модуль Інтэрнэту рэчаў Espressif Systems EK057 Wi-Fi і Bluetooth

Аб гэтым дакуменце

У гэтым інструкцыі паказана, як пачаць працу з модулем EK057.

Абнаўленні дакументаў
Калі ласка, заўсёды звяртайцеся да апошняй версіі https://www.espressif.com/en/support/download/documents.

Гісторыя версій
Гісторыя пераглядаў гэтага дакумента глядзіце на апошняй старонцы.

Паведамленне аб змене дакументацыі
Espressif дае апавяшчэнні па электроннай пошце, каб трымаць кліентаў у курсе змяненняў у тэхнічнай дакументацыі. Калі ласка, падпішыцеся на www.espressif.com/en/subscribe. Звярніце ўвагу, што вам трэба абнавіць падпіску, каб атрымліваць апавяшчэнні аб новых прадуктах, на якія вы зараз не падпісаны.

Атэстацыя
Спампаваць сертыфікаты на прадукцыю Espressif з www.espressif.com/en/certificates.

Адмова ад адказнасці і апавяшчэнне аб аўтарскіх правах
Інфармацыя ў гэтым дакуменце, у тым ліку URL спасылкі, могуць быць зменены без папярэдняга паведамлення. ГЭТЫ ДАКУМЕНТ ПРАСТАЎЛЯЕЦЦА ЯК ЁСЦЬ БЕЗ НІЯКІХ ГАРАНТЫЙ, УТЛЮЧАючы ЛЮБЫЯ ГАРАНТЫІ ПРАДЫЖНАСЦІ, НЕПАРУШЭННЯ, ПРЫДАТНАСЦІ ДЛЯ ЛЮБЫХ ПЭТНЫХ МЭТАХ АБО ЛЮБЫХ ГАРАНТЫЙ, КАЛІ ІНШЫХ ГАРАНТЫЙ, КАЛІ ІНШЫЯAMPLE.
Адмаўляецца ад любой адказнасці, у тым ліку за парушэнне правоў уласнасці, звязанай з выкарыстаннем інфармацыі ў гэтым дакуменце. Тут не прадастаўляюцца ліцэнзіі, відавочныя або падразумелыя, шляхам estoppel або іншым чынам, на якія-небудзь правы інтэлектуальнай уласнасці. Лагатып Wi-Fi Alliance Member з'яўляецца гандлёвай маркай Wi-Fi Alliance. Лагатып Bluetooth з'яўляецца зарэгістраванай гандлёвай маркай Bluetooth SIG. Усе гандлёвыя назвы, гандлёвыя маркі і зарэгістраваныя гандлёвыя маркі, згаданыя ў гэтым дакуменце, з'яўляюцца ўласнасцю іх адпаведных уладальнікаў і гэтым пацвярджаюцца. Аўтарскае права © 2020 Espressif Systems (Shanghai) Co., Ltd. Усе правы абаронены.

Скончанаview

Модуль скончаныview
EK057 - гэта магутны агульны модуль Wi-Fi+Bluetooth®+Bluetooth® LE MCU, які арыентаваны на шырокі спектр прыкладанняў, пачынаючы ад сетак з маламагутнымі датчыкамі да самых патрабавальных задач, такіх як кадаванне голасу, струменевае перадача музыкі і MP3 расшыфроўка.
Табліца 1: Тэхнічныя характарыстыкі EK057

Катэгорыі	Прадметы	Тэхнічныя характарыстыкі
Wi-Fi	Пратаколы	802.11 b/g/n (802.11n да 150 Мбіт/с)
		A-MPDU і A-MSDU агрэгацыі і 0.4 µахоўнік інтэрвальная падтрымка
	Дыяпазон частот	2412 ~ 2484 МГц
Bluetooth	Пратаколы	Спецыфікацыі пратаколаў v4.2 BR/EDR і Bluetooth® LE ных
	радыё	Перадатчык класа 1, класа 2 і класа 3
		AFH
	Аўдыё	CVSD і SBC
Абсталяванне	Інтэрфейсы модуляў	UART, SPI, I2C, I2S, GPIO, АЦП
	Убудаваны крышталь	Крышталь 40 МГц
	Убудаваная ўспышка SPI	8 Мб
	Працоўны выпtage / Блок харчавання	3.0 В ~ 3.6 В
	Працоўны ток	У сярэднім: 80 мА
	Мінімальны ток, які падаецца магутнасцю пастаўкі	500 мА
	Рэкамендаваны працоўны тэмпературны рэжым туры дыяпазон	–40 °C ~ +85 °C
	Узровень адчувальнасці да вільгаці (MSL)	Узровень 3

Pin Апісанне
Модуль мае 14 кантактаў і 7 кропак тэставання. Глядзіце азначэнні штыфтоў у табліцы 2.

Імя	няма	Тып	Функцыя
IO32	A1	Увод-вывад	GPIO32, XTAL_32K_P (32.768 кГц уваход крышталічнага генератара), ADC1_CH4, TOUCH9, RTC_GPIO9
IO16	A2	Увод-вывад	GPIO16, HS1_DATA4, U2RXD, EMAC_CLK_OUT
IO17	A3	Увод-вывад	GPIO17, HS1_DATA5, U2TXD, EMAC_CLK_OUT_180
IO5	A4	Увод-вывад	GPIO5, VSPICS0, HS1_DATA6, EMAC_RX_CLK
3V3	A5	P	Блок харчавання
GND	A6	P	зямля

Імя	няма	Тып	Функцыя
GND	A7	P	зямля
GND	A8	P	зямля
GND	A9	P	зямля
IO18	A10	Увод-вывад	GPIO18, VSPICLK, HS1_DATA7
IO23	A11	Увод-вывад	GPIO23, VSPID, HS1_STROBE
IO19	A12	Увод-вывад	GPIO19, VSPIQ, U0CTS, EMAC_TXD0
IO33	A13	Увод-вывад	GPIO33, XTAL_32K_N (32.768 кГц выхад крышталічнага генератара), ADC1_CH5, TOUCH8, RTC_GPIO8
EN	A14	I	Высокая: уключана; дазваляе чып Low: Off; чып адключаецца Заўвага: не пакідайце шпільку плаваючай.
IO14	TP22	Увод-вывад	GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
IO15	TP21	Увод-вывад	GPIO15, ADC2_CH3, TOUCH3, MTDO, HSPICS0, RTC_GPIO13, HS2_CMD, SD_CMD, EMAC_RXD3
IO13	TP18	Увод-вывад	GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
IO12	TP17	Увод-вывад	GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
IO0	TP19	Увод-вывад	GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
RXD	TP16	Увод-вывад	GPIO3, U0RXD, CLK_OUT2
TXD	TP20	Увод-вывад	GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2

Пачаць працу з EK057

Што вам трэба
Для распрацоўкі прыкладанняў для модуля EK057 вам трэба:

• 1 х модуль EK057
• 1 х тэставая плата Espressif RF
• 1 плата USB-to-Serial
• 1 х кабель Micro-USB
• 1 х ПК пад кіраваннем Linux

У гэтым кіраўніцтве карыстальніка мы бярэм аперацыйную сістэму Linux як былыampле. Для атрымання дадатковай інфармацыі аб канфігурацыі ў Windows і macOS, калі ласка, звярніцеся да кіраўніцтва па праграмаванні ESP-IDF.

Апаратнае падключэнне

1. Прыліце модуль EK057 да платы тэсціравання RF, як паказана на малюнку 1.
2. Падключыце плату тэсціравання RF да платы USB-to-Serial праз TXD, RXD і GND.
3. Падключыце плату USB-to-Serial да ПК.
4. Падключыце плату тэсціравання RF да ПК або адаптара сілкавання, каб уключыць харчаванне 5 У, праз кабель Micro-USB.
5. Падчас загрузкі падключыце IO0 да GND праз перамычку. Затым уключыце тэставую дошку.
6.  Спампаваць прашыўку на флэшку. Для атрымання падрабязнай інфармацыі глядзіце раздзелы ніжэй.
7. Пасля загрузкі выдаліце ​​перамычку на IO0 і GND.
8. Зноў уключыце плату тэсціравання RF. EK057 пяройдзе ў працоўны рэжым. Пры ініцыялізацыі чып будзе чытаць праграмы з флэшкі.

Заўвага:
IO0 з'яўляецца ўнутранай логікай высокай. Калі IO0 усталяваны ў рэжым падцягвання, выбіраецца рэжым загрузкі. Калі гэты шпілька выпадае або плавае злева, абраны рэжым загрузкі. Для атрымання дадатковай інфармацыі аб EK057, калі ласка, звярніцеся да EK057 Datasheet.

Наладзьце асяроддзе распрацоўкі
Espressif IoT Development Framework (скарочана ESP-IDF) - гэта база для распрацоўкі прыкладанняў на аснове Espressif ESP32. Карыстальнікі могуць распрацоўваць прыкладання з ESP32 у Windows/Linux/macOS на аснове ESP-IDF. Тут мы бярэм аперацыйную сістэму Linux у якасці былогаampле.
Ўстаноўка Неабходныя ўмовы
Для кампіляцыі з ESP-IDF вам трэба атрымаць наступныя пакеты:

• CentOS 7:
  sudo yum ўсталяваць git wget flex bison gperf python cmake ninja-build ccache dfu-util
• Ubuntu і Debian (адна каманда разбіваецца на два радкі):
  sudo apt-get install git wget flex bison gperf python python-pip python-setuptools cmake ninja -build ccache libffi -dev libssl -dev dfu-util
• Арка:
  sudo pacman −S −−патрэбны gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
• Заўвага:
• Гэта кіраўніцтва выкарыстоўвае каталог ~/esp на Linux у якасці тэчкі ўстаноўкі для ESP-IDF.
• Майце на ўвазе, што ESP-IDF не падтрымлівае прабелы ў шляхах.

Атрымаць ESP-IDF
Для стварэння прыкладанняў для модуля EK057 вам патрэбныя праграмныя бібліятэкі, якія прадстаўляюцца Espressif у рэпазітары ESP-IDF.
Каб атрымаць ESP-IDF, стварыце каталог ўстаноўкі (~/esp) для загрузкі ESP-IDF і кланіруйце рэпазітар з дапамогай 'git clone':

• mkdir -p ~/esp
• cd ~/асабліва
• git клон −−рэкурсіўны https://github.com/espressif/esp−idf. git

ESP-IDF будзе загружаны ў ~/esp/esp-idf. Звярніцеся да версій ESP-IDF для атрымання інфармацыі аб тым, якую версію ESP-IDF выкарыстоўваць у дадзенай сітуацыі.
Наладзіць Інструменты
Акрамя ESP-IDF, вам таксама трэба ўсталяваць інструменты, якія выкарыстоўваюцца ESP-IDF, такія як кампілятар, адладчык, пакеты Python і г.д. ESP-IDF забяспечвае скрыпт з імем 'install.sh', каб дапамагчы наладзіць інструменты на адным дыханні.
cd ~/esp/esp-idf

Наладзьце зменныя асяроддзя
Усталяваныя інструменты яшчэ не дададзены ў зменную асяроддзя PATH. Каб інструменты можна было выкарыстоўваць з каманднага радка, трэба ўсталяваць некаторыя зменныя асяроддзя. ESP-IDF забяспечвае іншы скрыпт «export.sh», які робіць гэта. У тэрмінале, дзе вы збіраецеся выкарыстоўваць ESP-IDF, запусціце: install .sh. $HOME/esp/esp-idf/export.sh

Цяпер усё гатова, вы можаце пабудаваць свой першы праект на модулі EK057.
Стварыце свой першы праект
Пачатак праекта
Цяпер вы гатовыя падрыхтаваць заяўку для модуля EK057. Вы можаце пачаць з праекта get-started/hello_world ад былогаampкаталог les у ESP-IDF.
Скапіруйце get-started/hello_world у каталог ~/esp:
cd ~/асабліва
cp -r $IDF_PATH/examples/get−started/hello_world .

Існуе шэраг эксample праекты ў эксampкаталог les у ESP-IDF. Вы можаце скапіяваць любы праект такім жа спосабам, як пададзены вышэй, і запусціць яго. Таксама можна пабудаваць эксampфайлы на месцы, не капіруючы іх папярэдне.

Падключыце прыладу
Цяпер падключыце ваш модуль EK057 да кампутара і праверце, пад якім паслядоўным портам бачны модуль. Паслядоўныя парты ў Linux пачынаюцца з '/dev/tty' ў сваіх назвах. Выканайце каманду ніжэй два разы, спачатку з адключанай платай, затым з падключанай. Порт, які з'явіцца ў другі раз, - гэта той, які вам патрэбны:
ls /dev/tty*

Заўвага:
Трымайце імя порта пад рукой, бо яно вам спатрэбіцца ў наступных кроках.

Наладзіць
Перайдзіце ў свой каталог 'hello_world' з кроку 2.4.1. Запусціце праект, усталюйце чып ESP32 у якасці мэты і запусціце ўтыліту канфігурацыі праекта 'menu config'.

• CD ~/esp/hello_world
• IDF .py задае-цэль esp32
• IDF .py menuconfig

Устанаўленне мэты з дапамогай 'idf.py set-target esp32' павінна быць зроблена адзін раз, пасля адкрыцця новага праекта. Калі праект утрымлівае некаторыя існуючыя зборкі і канфігурацыі, яны будуць ачышчаны і ініцыялізаваны. Мэта можа быць захавана ў зменнай асяроддзя, каб наогул прапусціць гэты крок. Дадатковую інфармацыю глядзіце ў раздзеле Выбар мэты. Калі папярэднія крокі былі выкананы правільна, з'явіцца наступнае меню:

Малюнак 2: Канфігурацыя праекта - хатняе акно
Колеры меню могуць адрознівацца ў вашым тэрмінале. Вы можаце змяніць знешні выгляд з дапамогай опцыі '--style'. Калі ласка, запусціце «idf.py menuconfig --help» для атрымання дадатковай інфармацыі.
Стварыце праект
Стварыце праект, запусціўшы:
Зборка idf .py

Гэтая каманда кампілюе прыкладанне і ўсе кампаненты ESP-IDF, затым згенеруе загрузнік, табліцу раздзелаў і двайковыя файлы прыкладання.

• $ idf .py зборка
• Запуск cmake у каталогу /path/to/hello_world/build
• Выкананне ”cmake −G Ninja −−warn−uninitialized /path/to/hello_world”… Папярэджваць аб неініцыялізаваных значэннях.
• Знойдзена Git: /usr/bin/git (знойдзеная версія «2.17.0»)
• Стварэнне пустога кампанента aws_iot з-за канфігурацыі
• Назвы кампанентаў:…
• Шляхі кампанентаў: …
• (больш радкоў вываду сістэмы зборкі)
• [527/527] Стварэнне hello −world.bin
• esptool .py v2.3.1
  Будаўніцтва праекта завершана. Каб флэш, запусціце гэтую каманду:
• компоненты/esptool_py/esptool/esptool.py −p (PORT) −b 921600 write_flash −−flash_mode dio−−flash_size вызначыць −−flash_freq 40m 0x10000 build/hello−world.bin build 0x1000
• зборка / загрузнік / загрузнік. bin 0x8000 build/ partition_table / partition −table.bin
• або запусціце 'idf .py -p PORT flash'

Калі памылак няма, зборка завершыцца генерацыяй бінарнага .bin прашыўкі file.
Адразу на прыладзе
Прашывайце двайковыя файлы, якія вы толькі што ўбудавалі ў свой модуль EK057, запусціўшы:
idf .py -p PORT [-b BAUD] flash

Заменіце PORT імем паслядоўнага порта вашага модуля з кроку: падключыце прыладу. Вы таксама можаце змяніць хуткасць перадачы флэшкі, замяніўшы BAUD на патрэбную вам хуткасць перадачы. Хуткасць перадачы па змаўчанні складае 460800. Для атрымання дадатковай інфармацыі аб аргументах idf.py глядзіце idf.py.

Заўвага:
Параметр «flash» аўтаматычна стварае і мігае праект, таму запускаць «idf.py build» не патрабуецца.

• Запуск esptool.py у каталогу […]/esp/hello_world
• Выкананне ”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 detection −−flash_freq 40m 0x1000
• загрузнік / загрузнік. bin 0x8000 partition_table / partition −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
  Падключэнне….
• Выяўленне тыпу чыпа ... Чып ESP32 - гэта ESP32D0WDQ6 (версія 1)
• Асаблівасці: Wi-Fi, BT, двух'ядравая заглушка для загрузкі ...
• Бягучая заглушка…
• Заглушка працуе…
• Зменена хуткасць перадачы на ​​460800.
• Сістэмы Espressif
• Налада памеру ўспышкі…
• Памер аўтаматычнага выяўлення флэш-памяці: 4 МБ
• Параметры флэш-памяці ўстаноўлены на 0x0220
• Сціснуты 22992 байт да 13019...
• Запісаў 22992 байт (13019 сціснутых) пры 0x00001000 за 0.3 секунды (эфектыўная 558.9 кбіт/с)... Хэш дадзеных правераны.
• Сціснуты 3072 байт да 82...
• Запісаў 3072 байт (82 сціснутых) пры 0x00008000 за 0.0 секунды (эфектыўная 5789.3 кбіт/с)... Хэш дадзеных правераны.
• Сціснуты 136672 байт да 67544...
• Запісаў 136672 байт (67544 сціснутых) пры 0x00010000 за 1.9 секунды (эфектыўная 567.5 кбіт/с)... Хэш дадзеных правераны.

Пакідаючы…
Жорсткі скід праз пін-код RTS...

Калі ўсё ідзе добра, праграма «hello_world» пачынае працаваць пасля таго, як вы выдаліце ​​перамычку на IO0 і GND і паўторна ўключыце тэставую плату.
Манітор
Каб праверыць, ці сапраўды «hello_world» працуе, увядзіце «idf.py -p PORT monitor» (не забудзьцеся замяніць PORT на імя вашага паслядоўнага порта).
Гэтая каманда запускае прыкладанне IDF Monitor:

• $ idf .py -p /dev/ttyUSB0 манітор
• Запуск idf_monitor у каталогу […]/esp/hello_world/build
• Выкананне ”python […]/ esp-idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. elf ”…−−− idf_monitor на /dev/ttyUSB0 115200 −−−
• Выйсці: Ctrl+] | Меню: Ctrl+T | Даведка: Ctrl+T з наступным Ctrl+H
• ets 8 чэрвеня 2016 00:22:57
• першы :0x1 ​​(POWERON_RESET), загрузка: 0x13 (SPI_FAST_FLASH_BOOT)
• ets 8 чэрвеня 2016 00:22:57

Пасля пракруткі журналаў запуску і дыягностыкі ўверх вы павінны ўбачыць «Прывітанне, свет!» раздрукаваны ў дадатку.

• Прывітанне свет!
• Перазапуск праз 10 секунд...
• Гэта чып esp32 з 2 ядрамі працэсара, WiFi/BT/BLE, крэмніевая версія 1, 2 МБ вонкавая ўспышка Перазапуск праз 9 секунд ...
• Перазапуск праз 8 секунд...
• Перазапуск праз 7 секунд...

Вось і ўсё, што вам трэба, каб пачаць працу з модулем EK057! Цяпер вы гатовыя паспрабаваць іншы былыamples у ESP-IDF, або перайдзіце адразу да распрацоўкі ўласных прыкладанняў.

Навучальныя рэсурсы

Абавязковыя дакументы
Па наступнай спасылцы прадстаўлены дакументы, звязаныя з ESP32.

Дакументы / Рэсурсы

Модуль Інтэрнэту рэчаў Espressif Systems EK057 Wi-Fi і Bluetooth [pdfКіраўніцтва карыстальніка EK057, 2AC7Z-EK057, 2AC7ZEK057, EK057 Модуль Інтэрнэту рэчаў Wi-Fi і Bluetooth, модуль Інтэрнэту рэчаў Wi-Fi і Bluetooth

Спасылкі

• Кіраўніцтва карыстальніка