零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1【入門(mén)篇】——工程文件架構(gòu)

AiPi-Eyes-S1是安信可開(kāi)源團(tuán)隊(duì)專(zhuān)門(mén)為Ai-M61-32S設(shè)計(jì)的一款開(kāi)發(fā)板，支持WiFi6、BLE5.3。所搭載的Ai-M61-32S 模組具有豐富的外設(shè)接口，具體包括 DVP、MJPEG、Dispaly、AudioCodec、USB2.0、SDU、以太網(wǎng) (EMAC)、SD/MMC(SDH)、SPI、UART、I2C、I2S、PWM、GPDAC、GPADC、ACOMP 和 GPIO 等。

AiPi-Eyes-S1集成了SPI屏幕接口，DVP攝像頭接口，外置ES8388音頻編解碼芯片以及預(yù)留TF卡座，并且引出USB接口，可接入U(xiǎn)SB攝像頭。

從零開(kāi)始學(xué)習(xí)小安派：

1、零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1【入門(mén)篇】——初識(shí)小安派-Eyes-S1

2、零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1【入門(mén)篇】——安裝VMware與Ubuntu

3、入門(mén)篇：零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1——新建工程并燒錄調(diào)試

4、零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1入門(mén)篇——Win下SSH連接Linux

5、零基礎(chǔ)開(kāi)發(fā)小安派-Eyes-S1【入門(mén)篇】——Samba共享文件夾

新建的工程包含多個(gè)文件和文件夾，作為初學(xué)者第一次接觸，下面淺聊一下我對(duì)工程文件的了解，若有不對(duì)的地方請(qǐng)大家多多指正。

一、build 文件夾

該文件夾是編譯后生成的 bin 文件存儲(chǔ)的地方，如本工程文件的文件名作為 Helloworld，編譯后的 bin 文件也是以工程名 + 芯片命名。

生成的 bin 文件存儲(chǔ)在 build/build_out 下，可以看見(jiàn)有多個(gè)類(lèi)似的文件，這里我們燒錄取 bin 文件，這里可以看到在 hellowworld 工程編譯生成的 bin 文件命名為 helloworld_bl616.bin，因?yàn)?bl616 和 bl618 的芯片其實(shí)在軟件上的區(qū)分很小，他們通用同一個(gè) SDK，在硬件上的區(qū)分在于 616 的 IO 口數(shù)量不如 618，由于使用同一套 SDK，所以 bl616 和 618 的固件是可以通用的，這里無(wú)需過(guò)多計(jì)較區(qū)別。

注意，這里的 bin 文件在博流的燒錄工具上并不是合成的 bin 文件，這里對(duì)應(yīng)的 bin 文件是圖中的 firmware 目錄下的 bin 文件，還需要其他的如 boot2 等文件，那么問(wèn)題來(lái)了，使用 Single Download Options 燒錄的合成 bin 文件在哪里，其實(shí)是在 SDK 中，具體的路徑為：

aithinker_Ai-M6X_SDK/tools/bflb_tools/bouffalo_flash_cube/chips/bl616/img_create/whole_flash_data.bin

如果需要使用 Windows 下的燒錄工具燒錄 bin 文件，選擇這個(gè)路徑下的 whole_flash_data.bin 即可。

二、CMakeLists.txt

CMake 是一個(gè)跨平臺(tái)、開(kāi)源的構(gòu)建系統(tǒng)，它可以幫助我們管理好工程里的軟件架構(gòu)。CMakeLists.txt 文件相當(dāng)于執(zhí)行的列表，它可以調(diào)用其他的.h 頭文件和.so/.a 庫(kù)文件，生成 Makefile，將.cpp/.c/.cc 文件編譯成可執(zhí)行文件或新的庫(kù)文件。我們從簡(jiǎn)單的 helloworld 工程學(xué)習(xí)，先打開(kāi) CMakeLists.txt 查看里面的語(yǔ)句。

BouffaloSDK 中封裝了以下函數(shù)接口，基本滿(mǎn)足常用場(chǎng)景使用。

三、flash_prog_cfg.ini

BouffaloSDK 采用新的 flash tool（bouffalo_flash_cube），并且燒錄依賴(lài) flash prog cfg.ini 文件。我們的燒錄命令 make flash 就是依賴(lài)這個(gè)文件執(zhí)行的。它也有自己的語(yǔ)法。

正常使用只需要?jiǎng)?chuàng)建一個(gè) KEY，例如 [FW]，并且填寫(xiě) filedir 和 address 就可以使用了。

其中 filedir 的填寫(xiě)方式有以下幾種：

• bin 文件全路徑 + bin 文件名稱(chēng)
• bin 文件相對(duì)路徑 + bin 文件名稱(chēng)
• bin 文件名稱(chēng)添加 _$(CHIPNAME) 后綴可以自動(dòng)識(shí)別成不同芯片（僅在 bin 文件名稱(chēng)前綴不同的時(shí)候使用）
• bin 文件名稱(chēng)添加 * 通配符，可以自動(dòng)補(bǔ)全 bin 文件名稱(chēng)（僅在 bin 文件名稱(chēng)前綴不同的時(shí)候使用）

1.模組作為 MCU（不使用無(wú)線(xiàn)功能）

只需要和 helloworld 工程一樣修改 filedir 的文件名即可。

[cfg]

# 0: no erase, 1:programmed section erase, 2: chip erase

erase = 1

# skip mode set first para is skip addr, second para is skip len, multi-segment region with ; separated

skip_mode = 0x0, 0x0

# 0: not use isp mode, #1: isp mode

boot2_isp_mode = 0

[FW]

filedir = ./build/build_out/xxx*_$(CHIPNAME).bin

address = 0x0000

2.模組作為 IOT（開(kāi)啟無(wú)線(xiàn)功能）

[cfg]

# 0: no erase, 1:programmed section erase, 2: chip erase

erase = 1

# skip mode set first para is skip addr, second para is skip len, multi-segment region with ; separated

skip_mode = 0x0, 0x0

# 0: not use isp mode, #1: isp mode

boot2_isp_mode = 0

[boot2]

filedir = ./build/build_out/boot2_*.bin

address = 0x000000

[partition]

filedir = ./build/build_out/partition*.bin

address = 0xE000

[FW]

filedir = ./build/build_out/xxx*_$(CHIPNAME).bin

address = 0x10000

[mfg]

filedir = ./build/build_out/mfg*.bin

address = 0x210000

- cfg 表示燒錄時(shí)的一些配置，正常不需要改動(dòng)

- FW 要燒錄的應(yīng)用固件，必須使用 FW 名稱(chēng)。

filedir 表示應(yīng)用固件所在相對(duì)路徑，正常來(lái)說(shuō)是編譯完后放在 build/build_out 目錄。_$(CHIPNAME).bin 用于區(qū)分不同芯片。xxx 表示應(yīng)用固件名稱(chēng)，與 CMakeLists.txt 中 project(xxx) 中名稱(chēng)一致。

address 由 partition_xxx.toml 指定

- boot2 要燒錄的 boot2 固件，必須使用 boot2 名稱(chēng)。

filedir 表示 boot2 固件所在相對(duì)路徑，正常來(lái)說(shuō)是編譯完后放在 build/build_out 目錄。自動(dòng)從 bsp/board/board_name/config 目錄拷貝。

address 必須使用 0 地址

- partition 要燒錄的 partition 固件，必須使用 partition 名稱(chēng)。

filedir 表示 partition 固件所在相對(duì)路徑，正常來(lái)說(shuō)是編譯完后放在 build/build_out 目錄。自動(dòng)從 bsp/board/board_name/config 目錄 partition_xxx.toml 轉(zhuǎn)換成 bin 文件并拷貝。

address 由 partition_xxx.toml 指定

- mfg 要燒錄的 mfg 固件，必須使用 mfg 名稱(chēng)。mfg 可選，可以不燒錄

filedir 表示 mfg 固件所在相對(duì)路徑，正常來(lái)說(shuō)是編譯完后放在 build/build_out 目錄。自動(dòng)從 bsp/board/board_name/config 目錄拷貝。

address 由 partition_xxx.toml 指定

（備注：如果使用了 partition，address 可以使用 @partition 代替絕對(duì)地址，@partition 將會(huì)自動(dòng)從 partition_xxx.toml 找到對(duì)應(yīng)的地址）

3.多個(gè)運(yùn)行固化燒錄

禁止使用通配符 * 以及 _$(CHIPNAME) 前綴，因?yàn)?bin 文件名稱(chēng)前綴相同。

[cfg]

# 0: no erase, 1:programmed section erase, 2: chip erase

erase = 1

# skip mode set first para is skip addr, second para is skip len, multi-segment region with ; separated

skip_mode = 0x0, 0x0

# 0: not use isp mode, #1: isp mode

boot2_isp_mode = 0

[FW1]

filedir = ./build/build_out/xxx0.bin

address = 0x00000

[FW2]

filedir = ./build/build_out/xxx1.bin

address = 0x10000

[FW3]

filedir = ./build/build_out/xxx2.bin

address = 0x20000

四、main.c

main.c，主程序運(yùn)行的文件。

五、Makefile

編譯的文件，其指定了一系列以賴(lài)關(guān)系和依賴(lài)規(guī)則。指定哪些文件需要先編譯，哪些文件需要后編譯，哪些文件需要重新編譯，可以實(shí)現(xiàn)自動(dòng)化編譯，一旦寫(xiě)好，只需要一個(gè) make 命令，整個(gè)工程完全自動(dòng)編譯，極大的提高了軟件開(kāi)發(fā)的效率。

目前來(lái)說(shuō)只需要修改第二行 BL_SDK_BASE ?= $(SDK_DEMO_PATH)/../aithinker_Ai-M6X_SDK 的編譯路徑設(shè)置即可。

六、proj.conf

前面在 CMakeLists.txt 中提到的組件的使用，當(dāng)我們需要使用各種組件或開(kāi)啟一些配置功能時(shí)，需要進(jìn)入這個(gè)文件中添加。

舉例：需要添加 SD 卡，或者 LVGL。需要在 proj.conf 中

set(CONFIG_FATFS 1)
set(CONFIG_LVGL 1)

七、README.md

README 相當(dāng)于一個(gè)說(shuō)明書(shū)，由工程的管理者進(jìn)行編寫(xiě)，包括該工程一些簡(jiǎn)介，使用方法，注意事項(xiàng)等等。

md 文件后綴的格式并不是什么高大上的文件，只是一種編輯的語(yǔ)法，可以使用記事本打開(kāi)，也可以在 VS 中安裝 Markdown Preview 插件。

這樣查看 README 時(shí)可以右鍵點(diǎn)擊 MPE：打開(kāi)側(cè)邊預(yù)覽，可以方便我們查看 README。