在使用 LuatIO 進(jìn)行嵌入式應(yīng)用開發(fā)時，合理配置 GPIO 的復(fù)用功能是實(shí)現(xiàn)外設(shè)控制的前提。本文全面解析 GPIO 引腳由普通 IO 轉(zhuǎn)換為復(fù)用功能引腳的初始化流程，包括時鐘使能、模式選擇、速度設(shè)置與函數(shù)調(diào)用順序，提供結(jié)構(gòu)化配置思路與最佳實(shí)踐建議。

LuatIO工具可以將模塊內(nèi)多個引腳同時支持的一個功能指定給配置的引腳使用，方便進(jìn)行管腳復(fù)用配置操作，目前的主流型號都可以用此工具進(jìn)行配置。

一、LuatIO工具在LuaTools的入口

LuatIO工具現(xiàn)已集成在LuaTools中，截圖說明如下；

1. LuaTools如何初次下載LuatIO或者升級LuatIO版本？

2. LuatIO在LuaTools中的入口在哪里？

二、GPIO 配置

GPIO 配置的全過程，我們分為三部分進(jìn)行說明，分別是：

1、LuatIO 可視化 GPIO 復(fù)用功能配置工具；

2、由 LuatIO 生成 pins_$model.json 文件；

3、API 庫函數(shù) pins 動態(tài)配置；

4、通過 LuaTools 將 pins_$model.json 文件下載到模組中；

1，LuatIO 工具

注意：LuatIO工具僅支持Win10及之上Windows操作系統(tǒng)。

LuatIO工具使用； 目前LuatIO工具已集成在luatools中，可以在項(xiàng)目管理界面打開：

LuatIO 界面截圖如下：

其中：

左側(cè)為 GPIO 復(fù)用功能配置選擇欄，空白框內(nèi)可以寫該管腳相應(yīng)的注釋說明；

右側(cè)為 Air780EPM 的管腳排列圖，其中淡綠色部分為可以配置的 GPIO 管腳；

以 Air780EPM 開發(fā)板 V1.3 為例，根據(jù)其硬件實(shí)際使用情況配置后的截圖如下：

2，生成 pins_$model.json 文件

生成對應(yīng)型號的json文件分為以下幾步

1.打開LuatIO配置工具。

2.點(diǎn)擊型號選擇

3.配置自己需要復(fù)用的管腳

4.配置完成后管腳處會顯示對應(yīng)功能，右側(cè)俯視圖對應(yīng)管腳顯示會變暗，下方會顯示對應(yīng)功能。

5.點(diǎn)擊保存即可

生成.josn配置文件最新固件兼容三種命名,以Air780EPM為例：

pins_Air780EPM.json

pins_AIR780EPM.json

pins_air780epm.json

2.1，生成 pins_Air8000A.json 文件

1.點(diǎn)擊“保存”；

2.命名"pins_Air8000A"；

說明：

（1）文件名必須嚴(yán)格遵守 pins_$model.json 格式：pins_Air8000A；

（2）pins_Air8000A.json 截圖如下：

2.2，生成 pins_Air780EPM.json 文件

1.點(diǎn)擊"保存"；

2.命名"pins_Air780EPM"；

說明：

（1）文件名必須嚴(yán)格遵守 pins_$model.json 格式：pins_Air780EPM；

（2）pins_Air780EPM.json 截圖如下：

2.3，生成 pins_air8101.json 文件

1.點(diǎn)擊"保存"；

2.命名"pins_air8101.json"；

說明：

（1）文件名必須嚴(yán)格遵守 pins_$model.json 格式：pins_air8101.json；

（2）pins_air8101.json 截圖如下：

3，API 庫函數(shù) pins 動態(tài)配置

首先，請使用 LuatIO 的可視化工具進(jìn)行配置，如果不需要io復(fù)用功能通常用不到pins這個功能；

其次，本庫的 API 屬于高級用法, 僅動態(tài)配置管腳時使用(LuatIO 本來已經(jīng)初始化好了，但在代碼運(yùn)行過程中需要對某個或某些 GPIO 的復(fù)用功能進(jìn)行動態(tài)調(diào)整)；

再次，pins 是 LuatOS 核心庫，在腳本代碼中不需要 require，可以直接使用；

pins.setup(pin, func)

在 pins_$model.json 文件初始化之后，再一次或多次指定某個或多個管腳的功能變化；

說明！此功能是為了動態(tài)修改管腳復(fù)用，99% 的用戶可能不會用到本 API；

4，將 pins_$model.json 下載到模組

首先，本小節(jié)我們只針對不需要"API 庫函數(shù) pins 動態(tài)配置"的情況進(jìn)行演示；

其次，即便需要"API 庫函數(shù) pins 動態(tài)配置"的情況，pins 的使用方法跟其它 API 核心庫函數(shù)沒有區(qū)別。

4.1，將 pins_Air8000A.json 下載到模組

1.以 Air8000A V2008固件為例；

截圖如下：

2.pins_Air8000A 保存在 json 文件夾內(nèi)；

3.下載到 Air8000A 中；

4.2，將 pins_Air780EPM.json 下載到模組

1.以 Air780EPM 開發(fā)板 V1.3 出廠固件為例；

截圖如下：

2.pins_Air780EPM 保存在 json 文件夾內(nèi)；

3.下載到 Air780EPM 開發(fā)板 V1.3 中；

4.3，將 pins_air8101.json 下載到模組

1.以 Air8101 核心板為例，選擇最新的固件；

2.將pins_air8101.json引腳配置文件增加到腳本和資源列表；

3.將pins_air8101.json 同代碼一起下載到 Air8101 核心板中；

三，其它說明

1. Lua 代碼中，需要聲明調(diào)用 pins_Air780EPM.json 文件嗎？

答案：

不需要；

2. 只有 Air780EPM 支持 pins_Air780EPM.json 和 API 庫函數(shù) pins 搭配的配置方式嗎？

回答：

不是的；

注意！LuatIO 工具(pins_$model.json)和 API 函數(shù) pins 都支持主推型號，老型號都不再支持。

3. 雖然該工具很方便，但我已經(jīng)習(xí)慣了 mcu.altfun()函數(shù)配置，還可以繼續(xù)使用嗎？

回答：

不可以了；

Air780EPM 底層固件從 V2006 開始，將只支持 pins_Air780EPM.json 一種 GPIO 復(fù)用功能配置方式，之前的 mcu.altfun()方式將不再繼續(xù)支持！遇到動態(tài)配置的情況，可以結(jié)合 API 庫函數(shù) pins 進(jìn)行操作。

也就是說，如果您使用 Air780EPM 底層固件 V2005 或之前的版本已經(jīng)量產(chǎn)出貨，后續(xù)您因某種原因需要遠(yuǎn)程升級基于 V2006 及其后續(xù)底層固件版本的軟件時，您的腳本文件也需要通過 pins_Air780EPM.json 的方式重新對 GPIO 復(fù)用功能進(jìn)行配置，原來的 mcu.altfun()配置方式將會失效。

4. 為什么我在Docs 文檔網(wǎng)站里還經(jīng)?？吹疥P(guān)于 mcu.altfun()函數(shù)的出現(xiàn)？

回答：

在整理了；

mcu.altfun()的 API 庫函數(shù)說明已經(jīng)從 Docs 上撤掉，但確實(shí)還有非常多的其它文檔說明仍然"保留"，我們可能要花一段時間才能完全"清除"；

5. 如果未進(jìn)行pins_Air780EPM.json的配置，代碼可以運(yùn)行嗎？

回答：

可以運(yùn)行；

會以Air780EPM各GPIO的默認(rèn)功能執(zhí)行；

如果所引用的GPIO復(fù)用功能跟默認(rèn)功能不一致，代碼就會無法執(zhí)行。

6. 模組的demo和json文件需要分開燒錄嗎？

回答：

不用分開燒錄，在項(xiàng)目管理界面添加自己的demo和配置好的文件后燒錄一次即可。

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇