本系列旨在交流 ESP32-S3 硬件開(kāi)發(fā)環(huán)境的搭建，通過(guò)一些基本的示例來(lái)展示怎么用 ESP-IDF (Espressif IoT Development Framework) 來(lái)安裝、配置環(huán)境，并編譯、下載固件至 BPI-Leaf-S3 開(kāi)發(fā)板等步驟。如果有什么沒(méi)提到或者有問(wèn)題的，歡迎各位留言交流。

原文鏈接:?https://qubot.org/2023/03/22/build-a-new-esp-idf-project-for-bananapi-bpi-leaf-s3/
作者：Qubot

一、前言#

上一篇文章介紹了ESP-IDF的安裝，這一篇文章來(lái)創(chuàng)建一個(gè)IDF項(xiàng)目，并將它下載到我們的Leaf-S3上。

二、安裝前的準(zhǔn)備#

2.1.?必備硬件#

• BPI-Leaf-S3開(kāi)發(fā)板：購(gòu)買(mǎi)鏈接（其他ESP32-S3板子也可以）、

  
  

• USB 數(shù)據(jù)線 (USB-A 轉(zhuǎn) Type-C)

• 電腦（Windows、Linux 或 macOS都可以）

2.2.?必備軟件#

• 安裝好的ESP-IDF環(huán)境，安裝方法可以參考這里

• VS Code

三、新建項(xiàng)目#

首先是打開(kāi)VSCode，Ctrl+Shift+P打開(kāi)Command palette，輸入ESP-IDF: New roject并選擇第一個(gè)選項(xiàng)。

然后選擇項(xiàng)目名稱，路徑，板子的版型以及串口號(hào)，需要注意的是，如果你是第一次使用BPI-Leaf-S3，你需要按住boot鍵后復(fù)位，進(jìn)入到下載模式，選擇完畢后，點(diǎn)擊左下角的Choose Template按鍵.

接下來(lái)就是根據(jù)模板創(chuàng)建項(xiàng)目，左上角選擇ESP-IDF,然后選擇get-start下面的hello_world(也可以選其他的，根據(jù)你的需求)，最后點(diǎn)擊右邊上面的使用start下面的hello_world模板創(chuàng)建項(xiàng)目。

然后左下角會(huì)彈出窗口，項(xiàng)目已經(jīng)創(chuàng)建好，問(wèn)是否在新窗口打開(kāi)項(xiàng)目，這里點(diǎn)yes。

這時(shí)VSCode會(huì)打開(kāi)一個(gè)新窗口，之前的那個(gè)窗口就可以關(guān)閉了，看到新窗口中左邊目錄的main->main.c，雙擊打開(kāi)，這個(gè)就是我們的主程序了。

四、下載代碼#

項(xiàng)目創(chuàng)建完成之后，將代碼輸進(jìn)去，這只是一個(gè)輸出Hello World的代碼，其中\(zhòng)n是換行

#include <stdio.h>

void app_main(void){

? printf("Hello World \n");

}

由于我們的板子是8M的flash，所以需要配置一下Flash的大小，點(diǎn)一下左下角的齒輪按鈕（nemuconfig），等一下之后會(huì)出現(xiàn)一個(gè)窗口，在上面的搜索框輸入flash，找到Flash size，選擇8MB，點(diǎn)擊保存之后關(guān)掉窗口即可。

配置好了之后，看一下左下角這些按鍵，左下角有一堆按鈕，其中第一個(gè)為選擇串口（就是選擇你開(kāi)發(fā)板的COM口），第二個(gè)是選擇版型（ESP32/ESP32-S2/ESP32-S3等等），第三個(gè)是打開(kāi)新的IDF項(xiàng)目，第四個(gè)是menuconfig配置，第五個(gè)是清除所有緩存（中間文件之類(lèi)的？），第六個(gè)是build整個(gè)項(xiàng)目，第七個(gè)是選擇燒錄方式（jtag，串口，dfu），第八個(gè)是燒錄鍵，第九個(gè)是打開(kāi)串口監(jiān)視器，第十個(gè)是build并燒錄，打開(kāi)串口監(jiān)視器，第十一個(gè)是打開(kāi)IDF的終端（如果你習(xí)慣了命令的話，可以在這里輸入命令執(zhí)行），第十二個(gè)好像是可以自定義按鈕？執(zhí)行自定義任務(wù)。

熟悉完按鍵就能編譯下載了，點(diǎn)擊左下角第六個(gè)build按鈕開(kāi)始編譯，編譯結(jié)束之后，點(diǎn)擊flash按鈕，等顯示Hard resetting via RTS pin...的時(shí)候就說(shuō)明下載完成了，這時(shí)候需要按一下板子的復(fù)位鍵。

復(fù)位完成之后，點(diǎn)擊左下角的monitor按鍵，這時(shí)會(huì)出現(xiàn)一堆輸出信息，可以看到最下面有一段Hello world，這就說(shuō)明下載完成了，代碼開(kāi)始運(yùn)行。

五、總結(jié)#

這一步我們熟悉了如何將程序下載到板子上面，運(yùn)行了最簡(jiǎn)單的Hello World程序，整體上沒(méi)有什么大的難點(diǎn)，主要是BPI-Leaf-S3用的是原生USB，需要手動(dòng)進(jìn)到下載模式，等第一次燒錄完IDF代碼后，后面就不用進(jìn)下載模式了。