博客
告別代碼堆砌！LuatIO可視化工具讓GPIO配置“所見即所得”
||
傳統GPIO配置需耗費大量時間編寫與調試代碼？LuatIO可視化工具徹底打破這一局限。其獨創的可視化編輯界面，支持開發者以“拖拽+參數配置”的方式直接構建硬件控制邏輯，實時預覽配置效果。無需深入底層細節，即可快速實現引腳功能映射，顯著加速智能硬件原型開發速度。
本文以Air780EPM為例，分享LuatIO工具相關內容。
最新資料詳見：http://docs.openluat.com/air780epm/common/luatio/
Air780EPM共有38個GPIO，這38個GPIO又可以復用為各種各樣的功能，如上表所示。
比如PIN66：
什么時候用作I2C0_SDA？
什么時候用作I2C1_SDA？
什么時候用作GPIO19？
什么時候用作PWM1？
默認功能是什么？
如何進行初始化配置？
如何在初始化之后進行動態的配置？
……
LuatOS之前的做法是：通過mcu.altfun()函數進行配置，這個函數非常晦澀難懂，因為不僅要涉及到Air780EPM所使用主芯片對應的PAD 腳，還要知曉該PAD腳所需配置復用功能的AltFunc順序號，對初學者非常不友好。
基于此，我們設計了可視化GPIO配置工具—— LuatIO由此工具生成對應的"pins_$model.json"文件，結合API庫函數pins動態配置，最后以腳本的形式下載到模組中，即可完成該模組型號的GPIO復用配置。
二、如何使用LuatIO配置GPIO
GPIO配置的全過程，我們分為四部分進行說明：
目前單獨的LuatIO工具只是階段性的存在，后續會集成到LuaTools中，一個工具入口即可完成盡可能多的功能。
1）下載安裝LuatIO工具
最新LuatIO工具下載鏈接：http://docs.openluat.com/air780epm/common/luatio/
注意：LuatIO工具僅支持Win10及之上Windows操作系統。
2）LuatIO界面說明
如上截圖，其中：
左側為GPIO復用功能配置選擇欄，空白框內可以寫該管腳相應的注釋說明；
右側為Air780EPM的管腳排列圖，其中淡綠色部分為可以配置的GPIO管腳。
以Air780EPM開發板V1.3為例，根據其硬件實際使用情況配置后的截圖如下：
2.2 生成pins_Air780EPM.json文件
1）點擊保存：
2）命名"pins_Air780EPM"：
注意事項：
文件名必須嚴格遵守pins_$model.json格式：pins_Air780EPM；
Air780EPM中的“Air”為大小寫組合，“EPM”必須為大寫。
生成的pins_Air780EPM.json文件截圖如下：
2.3 API庫函數pins動態配置
請使用LuatIO可視化工具進行配置，你通常不需要使用這個功能；
本庫的API屬于高級用法，僅動態配置管腳時使用（LuatIO本來已經初始化好了，但在代碼運行過程中需要對某個或某些GPIO的復用功能進行動態調整）；
pins是LuatOS核心庫，在腳本代碼中不需要require，可以直接使用。
關于pins的詳細說明參見：http://docs.openluat.com/air780epm/luatos/api/core/pins/
2.4 將pins_Air780EPM.json下載到模組
本小節我們只針對不需要“API庫函數pins動態配置”的情況進行演示；即便需要的情況下，pins的使用方法跟其它API核心庫函數沒有區別。
1）以Air780EPM開發板V1.3出廠固件為例：
最新固件下載詳見：https://gitee.com/openLuat/LuatOS-Air780EPM/tree/master/demo
2）pins_Air780EPM保存在json文件夾內：
3）下載到Air780EPM開發板V1.3中：
3.1 Lua代碼中，需要聲明調用pins_Air780EPM.json文件嗎？
回答：不需要。更詳細的說明，參見資料中心函數描述。
pins.loadjson(path)函數詳見：http://docs.openluat.com/air780epm/luatos/api/core/pins/
注意：LuatIO工具(pins_$model.json)和API函數pins都支持主推型號，老型號都不再支持。
回答：不可以了。
Air780EPM底層固件從V2005開始，將只支持pins_Air780EPM.json 一種GPIO復用功能配置方式，之前的mcu.altfun()方式將不再繼續支持！遇到動態配置的情況，可以結合API庫函數pins進行操作。
也就是說，如果您使用Air780EPM底層固件V2004或之前的版本已經量產出貨，后續您因某種原因需要遠程升級基于V2005及其后續底層固件版本的軟件時——您的腳本文件也需要通過pins_Air780EPM.json的方式，重新對GPIO復用功能進行配置，原來的mcu.altfun()配置方式將會失效。
回答：在整理了。mcu.altfun()的API庫函數說明已經從Docs上撤掉，但確實還有非常多的其它文檔說明仍然“保留”，我們可能要花一段時間才能完全"清除"。
回答：一定會的。目前單獨的LuatIO工具只是階段性的存在，很快就會集成到LuaTools中，大家通過一個工具入口即可完成盡可能多的功能。
回答：可以運行，會以Air780EPM各GPIO的默認功能執行；如果所引用的GPIO復用功能跟默認功能不一致，代碼就會無法執行。
今天的內容就分享到這里了~
