面對硬件接口配置的瑣碎工作，LuatIO提供全新解決方案——可視化編輯器將引腳管理變?yōu)椤八娂此谩?，實時模擬與錯誤提示功能確保零失誤，開發(fā)速度直線飆升！

本文以Air780EPM為例，分享LuatIO工具相關內(nèi)容。

最新資料詳見：http://docs.openluat.com/air780epm/common/luatio/

一、 LuatIO工具

Air780EPM共有38個GPIO，這38個GPIO又可以復用為各種各樣的功能，如上表所示。

比如PIN66：

什么時候用作I2C0_SDA？

什么時候用作I2C1_SDA？

什么時候用作GPIO19？

什么時候用作PWM1？

默認功能是什么？

如何進行初始化配置？

如何在初始化之后進行動態(tài)的配置？

……

LuatOS之前的做法是：通過mcu.altfun()函數(shù)進行配置，這個函數(shù)非?；逎y懂，因為不僅要涉及到Air780EPM所使用主芯片對應的PAD 腳，還要知曉該PAD腳所需配置復用功能的AltFunc順序號，對初學者非常不友好。

基于此，我們設計了可視化GPIO配置工具——LuatIO由此工具生成對應的"pins_$model.json"文件，結合API庫函數(shù)pins動態(tài)配置，最后以腳本的形式下載到模組中，即可完成該模組型號的GPIO復用配置。

二、如何使用LuatIO配置GPIO

GPIO配置的全過程，我們分為四部分進行說明：

2.1 LuatIO可視化GPIO配置工具

目前單獨的LuatIO工具只是階段性的存在，后續(xù)會集成到LuaTools中，一個工具入口即可完成盡可能多的功能。

1）下載安裝LuatIO工具

最新LuatIO工具下載鏈接：http://docs.openluat.com/air780epm/common/luatio/

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

2）LuatIO界面說明

如上截圖，其中：

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

右側為Air780EPM的管腳排列圖，其中淡綠色部分為可以配置的GPIO管腳。

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

2.2 生成pins_Air780EPM.json文件

1）點擊保存：

2）命名"pins_Air780EPM"：

注意事項：

文件名必須嚴格遵守pins_$model.json格式：pins_Air780EPM；

Air780EPM中的“Air”為大小寫組合，“EPM”必須為大寫。

生成的pins_Air780EPM.json文件截圖如下：

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

請使用LuatIO可視化工具進行配置，你通常不需要使用這個功能；

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

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

關于pins的詳細說明參見：http://docs.openluat.com/air780epm/luatos/api/core/pins/

2.4 將pins_Air780EPM.json下載到模組

本小節(jié)我們只針對不需要“API庫函數(shù)pins動態(tài)配置”的情況進行演示；即便需要的情況下，pins的使用方法跟其它API核心庫函數(shù)沒有區(qū)別。

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

最新固件下載詳見：https://gitee.com/openLuat/LuatOS-Air780EPM/tree/master/demo

2）pins_Air780EPM保存在json文件夾內(nèi)：

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

三、其他相關說明

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

回答：不需要。更詳細的說明，參見資料中心函數(shù)描述。

pins.loadjson(path)函數(shù)詳見：http://docs.openluat.com/air780epm/luatos/api/core/pins/

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

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

回答：不可以了。

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

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

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

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

3.4 LuatIO功能將來會集成到LuaTools中嗎？

回答：一定會的。目前單獨的LuatIO工具只是階段性的存在，很快就會集成到LuaTools中，大家通過一個工具入口即可完成盡可能多的功能。

3.5 如果未進行pins_Air780EPM.json的配置，代碼可以運行嗎？

回答：可以運行，會以Air780EPM各GPIO的默認功能執(zhí)行；如果所引用的GPIO復用功能跟默認功能不一致，代碼就會無法執(zhí)行。

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

審核編輯 黃宇