ESP32MINI1
使用者手冊
初步 v0.1
樂鑫系統
版權所有 © 2021
關於本手冊
本用戶手冊介紹瞭如何開始使用 ESP32-MINI-1 模塊。
文件更新
請始終參考最新版本 https://www.espressif.com/en/support/download/documents.
修訂歷史
有關本文檔的修訂歷史，請參閱最後一頁。
文件變更通知
樂鑫提供電子郵件通知，讓客戶及時了解技術文檔的更改。 請訂閱 www.espressif.com/zh/subscribe.
認證
下載 Espressif 產品的證書： www.espressif.com/en/certificates.
超過view
1.1 模塊結束view
具有豐富外設的 LE MCU 模塊。 該模塊是各種物聯網應用的理想選擇，從家庭自動化、智能建築、消費電子到工業控制，尤其適用於緊湊空間內的應用，例如燈泡、開關和插座。 ESP32-MINI-1是一款高度集成的小型Wi-Fi+Bluetooth ® +Bluetooth ® 該模塊有兩個版本：
- 85°C 版本
- 105°C 版本
表 1. ESP1MINI32 規格
| 類別 | 專案 | 規格 |
|
無線上網 |
協定 | 802.11 b/g/n（802.11n 高達 150 Mbps） |
| A-MPDU 和 A-MSDU 聚合和 0.4 µs 保護間隔支持 | ||
| 頻率範圍 | 2412〜2484 MHz | |
|
藍牙® |
協定 | 協議 v4.2 BR/EDR 和藍牙® LE 規格 |
| 收音機 | 1 類、2 類和 3 類發射器 | |
| AFH | ||
| 聲音的 | CVSD 和 SBC | |
|
硬體 |
模塊接口 |
SD卡、UART、SPI、SDIO、I2C、LED PWM、電機PWM、I2S、紅外遙控器、脈衝計數器、GPIO、觸摸傳感器、ADC、DAC、兩線汽車接口（TWAITM, 兼容 ISO11898-1) |
| 集成水晶 | 40 MHz 晶體 | |
| 集成 SPI 閃存 | 4MB | |
| 操作量tage/電源 | 3.0V～3.6V | |
| 工作電流 | 平均：80毫安 | |
| 電源提供的最小電流 | 500毫安 | |
| 推薦工作溫度範圍 | 85 °C 版本：–40 °C ~ +85 °C； 105 °C 版本：–40 °C ~ +105 °C | |
| 濕度敏感度 (MSL) | 3級 |
1.2 引腳說明
ESP32-MINI-1 有 55 個引腳。 請參見表 1-2 中的引腳定義。
表 1. 引腳定義
| 姓名 | 不。 | 類型 | 功能 |
| 接地 | 1、2、27、38~55 | P | 地面 |
| 3V3 | 3 | P | 電源 |
| I36 | 4 | I | GPIO36、ADC1_CH0、RTC_GPIO0 |
| I37 | 5 | I | GPIO37、ADC1_CH1、RTC_GPIO1 |
| I38 | 6 | I | GPIO38、ADC1_CH2、RTC_GPIO2 |
| I39 | 7 | I | GPIO39、ADC1_CH3、RTC_GPIO3 |
|
EN |
8 |
I |
高：芯片使能 低：芯片斷電 筆記： 不要讓引腳懸空 |
| I34 | 9 | I | GPIO34、ADC1_CH6、RTC_GPIO4 |
| I35 | 10 | I | GPIO35、ADC1_CH7、RTC_GPIO5 |
| IO32 | 11 | 輸入/輸出 | GPIO32、XTAL_32K_P（32.768 kHz 晶振輸入）、ADC1_CH4、TOUCH9、RTC_GPIO9 |
| IO33 | 12 | 輸入/輸出 | GPIO33、XTAL_32K_N（32.768 kHz晶振輸出）、ADC1_CH5、TOUCH8、RTC_GPIO8 |
| IO25 | 13 | 輸入/輸出 | GPIO25、DAC_1、ADC2_CH8、RTC_GPIO6、EMAC_RXD0 |
| IO26 | 14 | 輸入/輸出 | GPIO26、DAC_2、ADC2_CH9、RTC_GPIO7、EMAC_RXD1 |
| IO27 | 15 | 輸入/輸出 | GPIO27、ADC2_CH7、TOUCH7、RTC_GPIO17、EMAC_RX_DV |
| IO14 | 16 | 輸入/輸出 | GPIO14、ADC2_CH6、TOUCH6、RTC_GPIO16、MTMS、HSPICLK、HS2_CLK、SD_CLK、EMAC_TXD2 |
| IO12 | 17 | 輸入/輸出 | GPIO12、ADC2_CH5、TOUCH5、RTC_GPIO15、MTDI、HSPIQ、HS2_DATA2、SD_DATA2、EMAC_TXD3 |
| IO13 | 18 | 輸入/輸出 | GPIO13、ADC2_CH4、TOUCH4、RTC_GPIO14、MTCK、HSPID、HS2_DATA3、SD_DATA3、EMAC_RX_ER |
| IO15 | 19 | 輸入/輸出 | GPIO15、ADC2_CH3、TOUCH3、RTC_GPIO13、MTDO、HSPICS0、HS2_CMD、SD_CMD、EMAC_RXD3 |
| IO2 | 20 | 輸入/輸出 | GPIO2、ADC2_CH2、TOUCH2、RTC_GPIO12、HSPIWP、HS2_DATA0、
SD數據0 |
| IO0 | 21 | 輸入/輸出 | GPIO0、ADC2_CH1、TOUCH1、RTC_GPIO11、CLK_OUT1、EMAC_TX_CLK |
| IO4 | 22 | 輸入/輸出 | GPIO4、ADC2_CH0、TOUCH0、RTC_GPIO10、HSPIHD、HS2_DATA1、SD_DATA1、EMAC_TX_ER |
| NC | 23 | – | 沒有連接 |
| NC | 24 | – | 沒有連接 |
| IO9 | 25 | 輸入/輸出 | GPIO9、HS1_DATA2、U1RXD、SD_DATA2 |
| IO10 | 26 | 輸入/輸出 | GPIO10、HS1_DATA3、U1TXD、SD_DATA3 |
| NC | 28 | – | 沒有連接 |
| IO5 | 29 | 輸入/輸出 | GPIO5、HS1_DATA6、VSPICS0、EMAC_RX_CLK |
| IO18 | 30 | 輸入/輸出 | GPIO18、HS1_DATA7、VSPICLK |
| IO23 | 31 | 輸入/輸出 | GPIO23、HS1_STROBE、VSPID |
| IO19 | 32 | 輸入/輸出 | GPIO19、VSPIQ、U0CTS、EMAC_TXD0 |
下頁續
表 1 – 接上頁
| 姓名 | 不。 | 類型 | 功能 |
| IO22 | 33 | 輸入/輸出 | GPIO22、VSPIWP、U0RTS、EMAC_TXD1 |
| IO21 | 34 | 輸入/輸出 | GPIO21、VSPIHD、EMAC_TX_EN |
| 接收端0 | 35 | 輸入/輸出 | GPIO3、U0RXD、CLK_OUT2 |
| 發送端0 | 36 | 輸入/輸出 | GPIO1、U0TXD、CLK_OUT3、EMAC_RXD2 |
| NC | 37 | – | 沒有連接 |
¹ ESP6-U7WDH 芯片上的 GPIO8、GPIO11、GPIO16、GPIO17、GPIO32、GPIO4 引腳與模塊集成的 SPI flash 相連，不引出。
² 外設管腳配置請參考 ESP32 系列數據表.
開始使用 ESP32MINI1
2.1 你需要什麼
要為 ESP32-MINI-1 模塊開發應用程序，您需要：
- 1 x ESP32-MINI-1 模塊
- 1 x 樂鑫射頻測試板
- 1 x USB 轉串口板
- 1 x 微型 USB 數據線
- 1 台運行 Linux 的 PC
在本用戶指南中，我們以 Linux 操作系統為例amp樂。 有關 Windows 和 macOS 上的配置的更多信息，請參閱 ESP-IDF 編程指南。
2.2 硬件連接
- 將 ESP32-MINI-1 模塊焊接到射頻測試板上，如圖 2-1 所示。
- 通過 TXD、RXD 和 GND 將 RF 測試板連接到 USB 轉串口板。
- 將 USB 轉串口板連接到 PC。
- 通過 Micro-USB 電纜將射頻測試板連接到 PC 或電源適配器以啟用 5 V 電源。
- 在下載過程中，通過跳線將 IO0 連接到 GND。 然後，打開測試板。
- 將固件下載到閃存中。 有關詳細信息，請參閱以下部分。
- 下載後，將 IO0 和 GND 上的跳線去掉。
- 再次啟動射頻測試板。 ESP32-MINI-1 將切換到工作模式。 芯片在初始化時會從 flash 中讀取程序。
筆記：
IO0 內部為邏輯高電平。 如果 IO0 設置為上拉，則選擇 Boot 模式。 如果此引腳為下拉或懸空，則選擇下載模式。 有關 ESP32-MINI-1 的更多信息，請參閱 ESP32-MINI-1 Datasheet。
2.3 搭建開發環境
樂鑫物聯網開發框架（簡稱 ESP-IDF）是基於樂鑫 ESP32 開發應用程序的框架。 用戶可以在基於 ESP-IDF 的 Windows/Linux/macOS 中使用 ESP32 開發應用程序。 這裡我們以 Linux 操作系統為例amp勒。
2.3.1 安裝先決條件
要使用 ESP-IDF 進行編譯，您需要獲取以下軟件包：
- CentOS 7：
sudo yum install 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-cache 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 不支持路徑中的空格。
2.3.2 獲取 ESPIDF
要為 ESP32-MINI-1 模塊構建應用程序，您需要樂鑫提供的軟件庫 ESP-IDF 存儲庫.
要獲取 ESP-IDF，請創建一個安裝目錄 (~/esp) 以將 ESP-IDF 下載到並使用“git clone”克隆存儲庫：
mkdir -p ~/esp
光盤 ~/esp
git clone --遞歸 https://github.com/espressif/esp−idf.git
ESP-IDF 將被下載到 ~/esp/esp-idf。 諮詢 ESP-IDF 版本 有關在給定情況下使用哪個 ESP-IDF 版本的信息。
2.3.3 設置工具
除了 ESP-IDF，您還需要安裝 ESP-IDF 使用的工具，例如編譯器、調試器、
Python 包等。ESP-IDF 提供了一個名為“install.sh”的腳本來幫助一次性設置工具。
cd ~/esp/esp-idf
./ 安裝 .sh
2.3.4 設置環境變量
安裝的工具尚未添加到 PATH 環境變量中。 為了使這些工具可以從命令行使用，必須設置一些環境變量。 ESP-IDF 提供了另一個腳本“export.sh”來執行此操作。 在您要使用 ESP-IDF 的終端中，運行：
. $HOME/esp/esp-idf/export.sh
現在一切準備就緒，您可以在 ESP32-MINI-1 模塊上構建您的第一個項目。
2.4 創建你的第一個項目
2.4.1 啟動項目
現在您已準備好為 ESP32-MINI-1 模塊準備應用程序。 你可以從 入門/hello_world 來自前任的項目ampESP-IDF 中的 .les 目錄。
將 get-started/hello_world 複製到 ~/esp 目錄：
光盤 ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world 。
有一系列 examp項目 在前ampESP-IDF 中的 .les 目錄。 您可以以與上述相同的方式複制任何項目並運行它。 也可以構建 examp就地文件，而不是先複製它們。
2.4.2 連接您的設備
現在將您的 ESP32-MINI-1 模塊連接到計算機並檢查模塊在哪個串口下可見。 Linux 中的串行端口名稱中以“/dev/tty”開頭。 運行以下命令兩次，首先拔下電路板，然後插入電源。第二次出現的端口就是您需要的端口：
ls /dev/tty*
筆記：
將端口名稱放在手邊，因為您將在接下來的步驟中使用它。
2.4.3 配置
從步驟 2.4.1 導航到您的“hello_world”目錄。 啟動一個項目，將 ESP32 芯片設置為目標，然後運行
項目配置實用程序“menuconfig”。
cd ~/esp/你好世界
idf .py set-target esp32
idf .py 菜單配置
在打開一個新項目後，應該使用 'idf.py set-target esp32' 設置目標一次。 如果項目包含一些現有的構建和配置，它們將被清除和初始化。 目標可以保存在環境變量中以完全跳過這一步。 有關其他信息，請參閱選擇目標。
如果前面的步驟已正確完成，則會出現以下菜單：
菜單的顏色在您的終端中可能會有所不同。 您可以使用選項“–style”更改外觀。 請運行“idf.py menuconfig –help”以獲取更多信息。
2.4.4 構建項目
通過運行構建項目：
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 檢測 −−flash_freq 40m 0x10000 build/hello−world.bin build 0x1000 build/bootloader/bootloader。 bin 0x8000 build/ partition_table / partition -table.bin 或運行'idf .py -p PORT flash'
如果沒有錯誤，構建將通過生成固件二進製文件 .bin 來完成 file.
2.4.5 刷入設備
通過運行以下命令將您剛剛構建到 ESP32-MINI-1 模塊的二進製文件刷入：
idf .py -p 端口 [-b 波特率] 閃存
將 PORT 替換為來自步驟：連接您的設備的模塊的串行端口名稱。 您還可以通過將 BAUD 替換為您需要的波特率來更改閃光燈波特率。 默認波特率為 460800。
有關 idf.py 參數的更多信息，請參閱 idf.py。
筆記：
選項“flash”會自動構建並刷新項目，因此不需要運行“idf.py build”。
在目錄 […]/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 檢測 −−flash_freq 40m 0x1000
引導加載程序/引導加載程序。 bin 0x8000 partition_table / 分區-table.bin 0x10000 hello-world.bin
esptool.py v2.3.1 版本
連接……
檢測芯片類型…ESP32
芯片為 ESP32U4WDH（修訂版 3）
特點：WiFi、BT、單核
正在上傳存根…
運行存根…
存根運行…
將波特率更改為 460800
改變了。
配置閃存大小…
自動檢測到的閃存大小：4MB
Flash 參數設置為 0x0220
將 22992 字節壓縮為 13019…
在 22992 秒內（有效 13019 kbit/s）在 0x00001000 處寫入了 0.3 字節（558.9 壓縮）……
已驗證數據的哈希值。
將 3072 字節壓縮為 82…
在 3072 秒內（有效 82 kbit/s）在 0x00008000 處寫入了 0.0 字節（5789.3 壓縮）……
已驗證數據的哈希值。
將 136672 字節壓縮為 67544…
在 136672 秒內（有效 67544 kbit/s）在 0x00010000 處寫入了 1.9 字節（567.5 壓縮）……
已驗證數據的哈希值。
離開…
通過 RTS 引腳硬復位…
如果一切順利，在您移除 IO0 和 GND 上的跳線後，“hello_world”應用程序開始運行，並重新啟動測試板。
2.4.6監視器
要檢查“hello_world”是否確實在運行，請輸入“idf.py -p PORT monitor”（不要忘記將 PORT 替換為您的串行端口名稱）。
此命令啟動 IDF Monitor 應用程序：
$ idf .py -p /dev/ttyUSB0 監視器
在目錄 […]/esp/hello_world/build 中運行 idf_monitor
執行“python [...]/esp-idf/tools/idf_monitor.py -b 115200 [...]/esp/hello_world/build/hello -world。 精靈“……
----- /dev/ttyUSB0 115200 上的 idf_monitor ---------
退出：Ctrl+] | 菜單：Ctrl+T | 幫助：Ctrl+T 後跟 Ctrl+H −−ets
8 年 2016 月 00 日 22:57:XNUMX
第一次：0x1（POWERON_RESET），啟動：0x13（SPI_FAST_FLASH_BOOT）
等 8 年 2016 月 00 日 22:57:XNUMX…
啟動和診斷日誌向上滾動後，您應該會看到“Hello world！” 由應用程序打印出來。
…
你好世界！
10 秒後重啟……
這是具有 32 個 CPU 內核、WiFi/BT/BLE、矽版本 1、3MB 外部閃存的 esp4 芯片
9 秒後重啟……
8 秒後重啟……
7 秒後重啟……
要退出 IDF 監視器，請使用快捷鍵 Ctrl+]。
這就是您開始使用 ESP32-MINI-1 模塊所需的全部內容！ 現在你準備好嘗試其他的了 examp萊斯 在 ESP-IDF 中，或直接開發自己的應用程序。
學習資源
3.1 必讀文件
以下鏈接提供了與 ESP32 相關的文檔。
- ESP32 數據表
本文檔介紹了 ESP32 硬件的規格，包括超過view,
引腳定義、功能描述、外設接口、電氣特性等。 - ESP32 ECO V3 用戶指南
本文檔描述了 V3 和之前的 ESP32 矽晶圓版本之間的差異。 - ESP32 中錯誤的 ECO 和解決方法
本文檔詳細介紹了 ESP32 中的硬件勘誤表和解決方法。 - ESP-IDF 編程指南
它包含大量的 ESP-IDF 文檔，從硬件指南到 API 參考。 - ESP32 技術參考手冊
該手冊提供了有關如何使用 ESP32 內存和外圍設備的詳細信息。 - ESP32 硬件資源
拉鍊 files包括ESP32模塊和開發板的原理圖、PCB佈局、Gerber和BOM列表。 - ESP32 硬件設計指南
該指南概述了基於 ESP32 系列產品（包括 ESP32 芯片、ESP32 模塊和開發板）開發獨立或附加系統時推薦的設計實踐。 - ESP32 AT 指令集和 Examp萊斯
本文檔介紹了 ESP32 AT 命令，解釋瞭如何使用它們，並提供了 examp幾個通用 AT 命令的文件。 - 樂鑫產品訂購信息
3.2 必備資源
這裡是 ESP32 相關的必備資源。
- ESP32 論壇
這是 ESP2 的工程師對工程師 (E32E) 社區，您可以在其中發布問題、分享知識、探索想法並幫助與其他工程師一起解決問題。 - ESP32 GitHub
ESP32 開發項目在 Espressif 的 MIT 許可下在 GitHub 上免費分發。 它旨在幫助開發人員開始使用 ESP32，促進創新和增長有關 ESP32 設備周圍硬件和軟件的一般知識。 - ESP32 工具
這是一個 web用戶可以下載 ESP32 Flash 下載工具和 zip 的頁面 file 《ESP32認證與測試》.. - 靜電除塵器
這 web頁面將用戶鏈接到 ESP32 的官方 IoT 開發框架。 - ESP32 資源
這 web頁面提供了所有可用 ESP32 文檔、SDK 和工具的鏈接。
修訂歷史
| 日期 | 版本 | 發行說明 |
| 2021-01-14 | V0.1 | 初步發布 |
免責聲明和版權聲明
本文檔中的信息，包括 URL 參考，如有更改，恕不另行通知。
本文檔中的所有第三方信息均按原樣提供，不保證其真實性和準確性。
不對本文檔的適銷性、非侵權性、任何特定用途的適用性提供任何保證，也不提供因任何提議、規範或 S 引起的任何其他保證AMPLE。
不承擔與使用本文檔中的信息有關的所有責任，包括侵犯任何所有權的責任。 此處未通過禁止反言或其他方式明示或暗示任何知識產權的許可。
Wi-Fi 聯盟成員標誌是 Wi-Fi 聯盟的商標。 藍牙標誌是藍牙 SIG 的註冊商標。
本文檔中提及的所有商品名稱、商標和註冊商標均為其各自所有者的財產，特此聲明。
版權所有 © 2021 樂鑫系統（上海）有限公司。保留所有權利。
樂鑫系統
ESP32-MINI-1 用戶手冊（初級 v0.1）
樂鑫網
文件/資源
 |
ESPRESSIF ESP32-MINI-1 高集成小尺寸 Wi-Fi+藍牙模塊 [pdf] 使用者手冊 ESP32MINI1、2AC7Z-ESP32MINI1、2AC7ZESP32MINI1、ESP32 -MINI -1 高整合式小型 Wi-Fi 藍牙模組、ESP32 -MINI -1 高整合式小型 Wi-Fi 藍牙模組 |
