前言

提示：本文檔為ESP32教程系列，旨在為客戶進(jìn)行ESP32系列芯片開發(fā)提供環(huán)境搭建、工程示例演示等方面的參考文檔及視頻演示，降低ESP32系列芯片、模組開發(fā)的入門難度。

ESP32教程系列文檔主要參考于樂鑫官網(wǎng)提供的ESP32入門教程：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html。

1. 工具鏈設(shè)置

1.1安裝git

1.1.1.下載

git下載地址：https://git-scm.com/downloads

1.1.2 安裝

（1）下載

（2）設(shè)置安裝路徑

（3）一直NEXT，直至完成安裝

1.2 安裝python（版本3.5以上）

1.2.1 下載

python下載地址：https://www.python.org/downloads/

1.2.2 安裝

（1）下載

（2）安裝

1.3 獲取ESP-IDF

方式一：在文件夾下打開git，使用下方命令下載esp-idf（下載的esp-idf位置在當(dāng)前文件夾）：

git clone -b release/v4.3 --recursive

https://github.com.cnpmjs.org/espressif/esp-idf.git （注：-b

release/v4.3表示當(dāng)前下載版本為release/4.3,需要下載其它版本或版本介紹請(qǐng)移至樂鑫官網(wǎng)查看具體介紹：

? ?出現(xiàn)如下錯(cuò)誤：

進(jìn)入esp-idf目錄下執(zhí)行：git submodule update --init --recursive

方式二：前往樂鑫官網(wǎng)下載esp-idf壓縮包，解壓后改名為esp-idf,下載地址：

https://www.espressif.com/zh-hans/support/download/sdks-demos?keys=&field_type_tid%5B%5D=13

1.4 安裝Java（Java 11及以上）

1.4.1 下載

Java下載地址：https://www.oracle.com/java/technologies/javase-downloads.html

1.4.2 安裝

一直下一步，直至安裝完成。

1.5 安裝Eclipse

1.5.1 下載

Eclipse下載地址：https://www.eclipse.org/downloads/

1.5.2 安裝

（1）選擇C++

（2）選擇Java路徑

（3）啟動(dòng)Eclipse

1.6 構(gòu)建esp-idf環(huán)境

1.6.1 安裝ESP-IDF插件

（1）選擇help -> Install New Software

（2）在彈出的頁面單擊add…，輸入：

Name:Espressif IDF Plugin for Eclipse

Location:https://dl.espressif.com/dl/idf-eclipse-plugin/updates/latest/

（3）從列表中選擇并繼續(xù)安裝Espressif IDF（可只選擇以下三項(xiàng)）

（4）等待安裝完成

注意：一定要等待安裝完成，時(shí)間可能較久，如果網(wǎng)絡(luò)不好進(jìn)度條卡住可以按照上述步驟重新執(zhí)行一遍。中間可能出現(xiàn)警告，可以不用管，選擇繼續(xù)安裝。

（5）重啟Eclipse，出現(xiàn)如下圖標(biāo)說明插件安裝完成。

1.6.2 安裝ESP-IDF工具

（1）選擇help -> ESP-IDF Tools Manager -> Install Tools

（2）提供文件路徑

（3）等待安裝完成

（4）重置菜單Window > Perspective > Reset Perspective…

（5）出現(xiàn)新選項(xiàng)：File -> New -> Espressif IDF Project

2 .運(yùn)行hello_world示例

2.1 新建工程

（1）提供工程名稱

（2）選擇工程模板

（3）工程創(chuàng)建成功

（代碼顯示的錯(cuò)誤不用理會(huì)，構(gòu)建工程后會(huì)消失）

2.2 工程配置

（1）配置編譯目標(biāo)

（2）選擇ESP Target

（3）設(shè)置IDF目標(biāo)和端口號(hào)（本次示例使用的是ESP32-C3）

2.3 編譯工程

（1）點(diǎn)擊小錘子進(jìn)行編譯或點(diǎn)擊開始進(jìn)行編譯與燒錄

（2）開始編譯、燒錄

燒錄成功！

2.4 監(jiān)視工程

（1）啟動(dòng)監(jiān)視終端，配置端口號(hào)

（2）查看打印信息

成功打印hello_world.

2.5 查看程序大小分析

（1）右鍵單擊項(xiàng)目，選擇ESP-IDF: Application Size Analysis

（2）查看應(yīng)用大小分析

3. 后 記

3.1 注意事項(xiàng)

git版本沒有具體要求

python版本應(yīng)為3.5以上（建議3.8或3.9）

Java版本應(yīng)為Java11以上

建議先下載好4.3版本（最新版）的esp-idf

ESP-IDF插件安裝失敗可以重新執(zhí)行步驟1.6

記得進(jìn)行一次菜單重置，否則大概率看不見Espressif IDF Project選項(xiàng)

3.2 相關(guān)建議

和教程二（Linux）及教程四（Windows）所提供的esp-idf環(huán)境構(gòu)建方法相比，Eclipse在工程編譯速度方面明顯較為緩慢，但其工具鏈設(shè)置較為簡單且不易出錯(cuò)，界面化的操作對(duì)于不習(xí)慣命令控制的開發(fā)者較為友好，可對(duì)程序大小進(jìn)行分析的功能則是其獨(dú)特優(yōu)勢(shì)，對(duì)編譯速度不敏感或喜歡界面操作開發(fā)的開發(fā)者可選擇此方式進(jìn)行ESP32開發(fā)。

檔僅對(duì)Eclipse進(jìn)行ESP32開發(fā)的基礎(chǔ)功能進(jìn)行探討，未對(duì)Eclipse的其它功能進(jìn)行深入研究，想要對(duì)Eclipse功能進(jìn)行深入了解的開發(fā)者可前往樂鑫官網(wǎng)自行查看相關(guān)文檔。

啟明云端

深圳市啟明云端科技有限公司（簡稱“啟明云端”）是國內(nèi)領(lǐng)先的物聯(lián)網(wǎng)通訊產(chǎn)品和整體解決方案提供商，為全球企業(yè)客戶提供無線通訊產(chǎn)品及場景智能化服務(wù)。

公司作為Espressif（樂鑫科技）大中華區(qū)合作伙伴，Sigmastar（晨星）A級(jí)方案商；得天獨(dú)厚的上游芯片廠商資源及嚴(yán)格的質(zhì)量控制體系為公司發(fā)展提供強(qiáng)大的實(shí)力保證，總能在第一時(shí)間為客戶帶來極具競爭力的產(chǎn)品。

公司主要提供物聯(lián)網(wǎng)無線通訊芯片、模組、人機(jī)界面（HMI）、人工智能及工業(yè)控制嵌入式產(chǎn)品等，方案已服務(wù)全球超過1000+企業(yè)，特別是在智能家電、智能家居、智慧工業(yè)、醫(yī)療、農(nóng)業(yè)監(jiān)測等領(lǐng)域積累了豐富的產(chǎn)品和項(xiàng)目經(jīng)驗(yàn)。