Espressif SystemsEK057Wi-FiおよびBluetoothモノのインターネットモジュールユーザーマニュアル

コンテンツ 隠れる

1 Espressif SystemsEK057Wi-FiおよびBluetoothモノのインターネットモジュール

2 この文書について

Espressif SystemsEK057Wi-FiおよびBluetoothモノのインターネットモジュール

この文書について

このユーザーマニュアルは、EK057モジュールの使用を開始する方法を示しています。

ドキュメントの更新
常に最新バージョンを参照してください https://www.espressif.com/en/support/download/documents.

改訂履歴
このドキュメントの改訂履歴については、最後のページを参照してください。

ドキュメント変更通知
Espressifは、技術文書の変更について顧客に最新の情報を提供するための電子メール通知を提供します。で購読してください www.espressif.com/en/subscribe。現在サブスクライブしていない新製品の通知を受け取るには、サブスクリプションを更新する必要があることに注意してください。

認証
Espressif製品の証明書をからダウンロードする www.espressif.com/en/certificates。

免責事項と著作権表示
このドキュメントの情報には、 URL 参照は、予告なしに変更される場合があります。このドキュメントは、商品性、非侵害、特定の目的への適合性、またはその他の提案、仕様、またはSに起因する保証を含め、いかなる保証もなしに提供されます。AMPLE.
この文書の情報の使用に関連する、所有権の侵害に対する責任を含むすべての責任は否認されます。禁反言またはその他の方法で、知的財産権に対する明示的または黙示的なライセンスは、ここでは付与されません。 Wi-Fi Allianceメンバーのロゴは、Wi-FiAllianceの商標です。 BluetoothロゴはBluetoothSIGの登録商標です。本書に記載されているすべての商号、商標、および登録商標は、それぞれの所有者に帰属し、これにより承認されます。 Copyright©2020EspressifSystems（Shanghai）Co.、Ltd.無断複写・転載を禁じます。

以上view

モジュールオーバーview
EK057は、強力で汎用的なWi-Fi +Bluetooth®+Bluetooth®LEMCUモジュールであり、低電力センサーネットワークから、音声エンコーディング、音楽ストリーミング、MP3などの最も要求の厳しいタスクに至るまで、さまざまなアプリケーションを対象としています。デコード。
表1：EK057の仕様

カテゴリー	アイテム	仕様
Wi-Fi	プロトコル	802.11 b / g / n（802.11n最大150 Mbps）
	プロトコル	A-MPDUおよびA-MSDUアグリゲーションと0.4 µガードインターバルサポート
	周波数範囲	2412〜2484 MHz
Bluetooth®対応	プロトコル	プロトコルv4.2BR/EDRおよびBluetooth®LE固有- ン
	無線	クラス1、クラス2、クラス3の送信機
	無線	AFH
	オーディオ	CVSDおよびSBC
ハードウェア	モジュールインターフェース	UART、SPI、I2C、I2S、GPIO、ADC
	一体型クリスタル	40MHz水晶
	統合SPIフラッシュ	8MB
	営業巻tage /電源	3.0V～3.6V
	動作電流	平均：80 mA
	電力によって供給される最小電流供給	500mA
	推奨動作温度- 範囲	–40°C〜 + 85°C
	水分感度レベル（MSL）	レベル3

ピンの説明
モジュールには14個のピンと7個のテストポイントがあります。表2のピン定義を参照してください。

名前	いいえ。	タイプ	関数
IO32	A1	入出力	GPIO32、XTAL_32K_P（32.768 kHz水晶発振器入力）、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	電源
グランド	A6	P	地面

名前	いいえ。	タイプ	関数
グランド	A7	P	地面
グランド	A8	P	地面
グランド	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 kHz水晶発振器出力）、 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
送信	TP20	入出力	GPIO1、U0TXD、CLK_OUT3、EMAC_RXD2

EK057で始めましょう

必要なもの
EK057モジュールのアプリケーションを開発するには、次のものが必要です。

1xEK057モジュール
1 x EspressifRFテストボード
1 xUSB-シリアルボード
1 xマイクロUSBケーブル
Linuxを実行している1台のPC

このユーザーガイドでは、Linuxオペレーティングシステムを例として取り上げますampル。 WindowsおよびmacOSでの構成の詳細については、ESP-IDFプログラミングガイドを参照してください。

ハードウェア接続

図057に示すように、EK1モジュールをRFテストボードにはんだ付けします。
RXテストボードをTXD、RXD、およびGNDを介してUSB-シリアルボードに接続します。

USB-シリアルボードをPCに接続します。
Micro-USBケーブルを介して、RFテストボードをPCまたは電源アダプタに接続し、5V電源を有効にします。
ダウンロード中に、ジャンパーを介してIO0をGNDに接続します。次に、テストボードを「オン」にします。

ファームウェアをフラッシュにダウンロードします。詳細については、以下のセクションを参照してください。
ダウンロード後、IO0とGNDのジャンパーを取り外します。
RFテストボードの電源を再度入れます。 EK057は動作モードに切り替わります。チップは、初期化時にフラッシュからプログラムを読み取ります。

注記：
IO0は内部的にロジックハイです。 IO0がプルアップに設定されている場合、ブートモードが選択されます。このピンがプルダウンまたはフローティングのままの場合、ダウンロードモードが選択されます。 EK057の詳細については、EK057データセットを参照してください。

開発環境のセットアップ
Espressif IoT開発フレームワーク（略してESP-IDF）は、EspressifESP32に基づくアプリケーションを開発するためのフレームワークです。ユーザーは、ESP-IDFに基づいてWindows / Linux / macOSでESP32を使用してアプリケーションを開発できます。ここでは、Linuxオペレーティングシステムを例として取り上げますampル。
インストールの前提条件
ESP-IDFでコンパイルするには、次のパッケージを入手する必要があります。

CentOS 7：
sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfu-util
UbuntuとDebian（XNUMXつのコマンドがXNUMX行に分割されます）：
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
注記：
このガイドでは、Linux上のディレクトリ〜/ espをESP-IDFのインストールフォルダとして使用します。

ESP-IDFはパス内のスペースをサポートしていないことに注意してください。

ESP-IDFを入手する
EK057モジュールのアプリケーションを構築するには、ESP-IDFリポジトリでEspressifが提供するソフトウェアライブラリが必要です。
ESP-IDFを取得するには、インストールディレクトリ（〜/ esp）を作成してESP-IDFをダウンロードし、「gitclone」を使用してリポジトリのクローンを作成します。

mkdir −p〜/ esp
cd〜 / esp
git clone ---recursivehttps://github.com/espressif/esp-idf。ギット

ESP-IDFは〜/ esp / esp-idfにダウンロードされます。特定の状況で使用するESP-IDFバージョンについては、ESP-IDFバージョンを参照してください。
ツールの設定
ESP-IDFとは別に、コンパイラ、デバッガー、Pythonパッケージなど、ESP-IDFで使用されるツールもインストールする必要があります。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プロジェクトから始めることができますampESP-IDFのlesディレクトリ。
get-started / hello_worldを〜/ espディレクトリにコピーします。
cd〜 / esp
cp −r $ IDF_PATH / examples / get-started/hello_world。

元の範囲がありますamp元のルプロジェクトampESP-IDFのlesディレクトリ。上記と同じ方法で任意のプロジェクトをコピーして実行できます。 exを構築することも可能ですamp最初にコピーせずに、インプレースでファイルします。

デバイスを接続する
次に、EK057モジュールをコンピューターに接続し、モジュールが表示されているシリアルポートを確認します。 Linuxのシリアルポートは、名前が「/ dev/tty」で始まります。以下のコマンドをXNUMX回実行します。最初はボードを取り外し、次にプラグを差し込んだ状態です。XNUMX回目に表示されるポートは、必要なポートです。
ls / dev / tty *

注記：
次の手順で必要になるため、ポート名を手元に置いておきます。

設定
手順2.4.1から「hello_world」ディレクトリに移動します。プロジェクトを開始し、ESP32チップをターゲットとして設定し、プロジェクト構成ユーティリティの「menuconfig」を実行します。

cd〜 / esp / hello_world
IDF .py set-target esp32
IDF .py メニュー構成

'idf.py set-target esp32'を使用したターゲットの設定は、新しいプロジェクトを開いた後にXNUMX回実行する必要があります。プロジェクトに既存のビルドと構成が含まれている場合、それらはクリアされて初期化されます。このステップをまったくスキップするために、ターゲットを環境変数に保存することができます。詳細については、ターゲットの選択を参照してください。前の手順が正しく実行されている場合は、次のメニューが表示されます。

図2：プロジェクト構成–ホームウィンドウ
メニューの色は、端末によって異なる場合があります。オプション'--style'を使用して外観を変更できます。詳細については、「idf.pymenuconfig--help」を実行してください。
プロジェクトを構築する
次のコマンドを実行してプロジェクトをビルドします。
idf.pyビルド

このコマンドは、アプリケーションとすべてのESP-IDFコンポーネントをコンパイルしてから、ブートローダー、パーティションテーブル、およびアプリケーションバイナリを生成します。

$idf.pyビルド
ディレクトリ/ path / to / hello_world / buildでcmakeを実行しています
” 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
プロジェクトのビルドが完了しました。フラッシュするには、次のコマンドを実行します。
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
ビルド/ブートローダー/ブートローダー。 bin 0x8000 build / partition_table / partition −table.bin
または'idf.py −pPORTflash'を実行します

エラーがない場合、ビルドはファームウェアバイナリ.binを生成して終了します file.
デバイスにフラッシュする
次のコマンドを実行して、EK057モジュールに構築したばかりのバイナリをフラッシュします。
idf .py −p PORT [−bBAUD]フラッシュ

手順：デバイスを接続して、PORTをモジュールのシリアルポート名に置き換えます。 BAUDを必要なボーレートに置き換えることで、フラッシャーのボーレートを変更することもできます。デフォルトのボーレートは460800です。idf.py引数の詳細については、idf.pyを参照してください。

注記：
オプション「flash」はプロジェクトを自動的にビルドしてフラッシュするため、「idf.pybuild」を実行する必要はありません。

ディレクトリ[…]/esp/hello_worldでesptool.pyを実行します
”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
ブートローダー/ブートローダー。 bin 0x8000 partition_table / partition −table.bin 0x10000 hello−world.bin esptool .py v2.3.1
接続中…。
チップタイプの検出…ESP32チップはESP32D0WDQ6（リビジョン1）
機能：WiFi、BT、デュアルコアアップロードスタブ…
実行中のスタブ…
スタブランニング…
ボーレートを460800に変更しました。
エスプレシフシステムズ
フラッシュサイズの設定…
自動検出されたフラッシュサイズ：4MB
0x0220に設定されたフラッシュパラメータ
22992バイトを13019に圧縮…
22992秒で13019x0で00001000バイト（0.3圧縮）を書き込みました（有効558.9 kbit / s）…データのハッシュが検証されました。
3072バイトを82に圧縮…
3072秒で82x0で00008000バイト（0.0圧縮）を書き込みました（有効5789.3 kbit / s）…データのハッシュが検証されました。
136672バイトを67544に圧縮…
136672秒で67544x0で00010000バイト（1.9圧縮）を書き込みました（有効567.5 kbit / s）…データのハッシュが検証されました。

去る…
RTSピンを介したハードリセット…

すべてがうまくいけば、IO0とGNDのジャンパーを取り外し、テストボードの電源を入れ直した後、「hello_world」アプリケーションの実行が開始されます。
モニター
「hello_world」が実際に実行されているかどうかを確認するには、「idf.py -p PORTmonitor」と入力します（PORTをシリアルポート名に置き換えることを忘れないでください）。
このコマンドは、IDFモニターアプリケーションを起動します。

$ idf .py −p / dev/ttyUSB0モニター
ディレクトリ[…]/esp / hello_world/buildでidf_monitorを実行しています
”python[…]/esp−idf / tools / idf_monitor.py −b115200[…]/esp / hello_world / build / hello −worldを実行しています。 elf”…−−− idf_monitor on / dev / ttyUSB0 115200 −−−
終了：Ctrl +] | メニュー：Ctrl + T | ヘルプ：Ctrl+Tの後にCtrl+H

ets 8年2016月00日22:57:XNUMX
rst：0x1（POWERON_RESET）、boot：0x13（SPI_FAST_FLASH_BOOT）
ets 8年2016月00日22:57:XNUMX

起動ログと診断ログが上にスクロールすると、「Helloworld！」と表示されます。アプリケーションによって印刷されます。

こんにちは世界！
10秒で再起動…
これは、32つのCPUコア、WiFi / BT / BLE、シリコンリビジョン2、1MBの外部フラッシュを備えたesp2チップです。9秒で再起動します…
8秒で再起動…
7秒で再起動…

EK057モジュールを使い始めるために必要なのはこれだけです！これで、他の元を試す準備ができましたampESP-IDFでファイルを作成するか、独自のアプリケーションの開発に進んでください。

学習リソース

必読のドキュメント
次のリンクは、ESP32に関連するドキュメントを提供します。

ドキュメント / リソース

Espressif SystemsEK057Wi-FiおよびBluetoothモノのインターネットモジュール [pdf] ユーザーマニュアル
EK057、2AC7Z-EK057、2AC7ZEK057、EK057 Wi-FiおよびBluetoothモノのインターネットモジュール、Wi-FiおよびBluetoothモノのインターネットモジュール

参考文献

ユーザーマニュアル