Air724UG模組軟件指南：短消息(sms)

本指南教你如何用 Air724 開(kāi)發(fā)板，使用 sms 功能，并通過(guò)日志觀察實(shí)驗(yàn)結(jié)果。

對(duì)于僅支持4G網(wǎng)絡(luò)的Cat.1模塊Air724UG而言，移動(dòng)、聯(lián)通卡不需開(kāi)通VOLTE可以支持短信功能，電信卡只有SIM卡開(kāi)通VOLTE功能才能使用短信功能?？梢酝ㄟ^(guò)登錄運(yùn)營(yíng)商 APP、登錄運(yùn)營(yíng)商網(wǎng)站、或者撥打運(yùn)營(yíng)商客服電話，確認(rèn)開(kāi)通 VOLTE功能。

一、準(zhǔn)備硬件環(huán)境

1.1 開(kāi)發(fā)板準(zhǔn)備

使用 EVB_Air724 開(kāi)發(fā)板，如下圖所示：

此開(kāi)發(fā)板的詳細(xì)使用說(shuō)明參考：
https://docs.openluat.com/air724ug/product/
 

Air724UG 產(chǎn)品手冊(cè) 中的《EVB_Air724UG_AXX 開(kāi)發(fā)板使用說(shuō)明》，寫(xiě)這篇文章時(shí)最新版本的使用說(shuō)明為：《EVB_Air724UG_A14 開(kāi)發(fā)板使用說(shuō)明》；開(kāi)發(fā)板使用過(guò)程中遇到任何問(wèn)題，可以直接參考這份使用說(shuō)明文檔。

api文檔：
https://doc.openluat.com/wiki/21?wiki_page_id=2068

1.2 數(shù)據(jù)通信線

USB 數(shù)據(jù)線一根（micro USB）。

1.3 PC 電腦

WIN7 以及以上版本的 WINDOWS 系統(tǒng)。

1.4 SIM 卡

中國(guó)大陸環(huán)境下，可以上網(wǎng)的SIM卡。一般來(lái)說(shuō)，使用移動(dòng)、電信、聯(lián)通的物聯(lián)網(wǎng)卡或者手機(jī)卡都行。

1.5 組裝硬件環(huán)境

USB 數(shù)據(jù)線插入 USB 口，另一端與電腦相連，撥碼開(kāi)關(guān)全部撥到 ON，串口切換開(kāi)關(guān)選擇 UART1,USB 供電的 4V 對(duì)應(yīng)開(kāi)關(guān)撥至 ON 檔，SIM 卡放到 SIM 卡槽中鎖緊，如下圖所示。

二、準(zhǔn)備軟件環(huán)境

2.1 下載調(diào)試工具

使用說(shuō)明參考：

Luatools 下載和詳細(xì)使用：
https://docs.openluat.com/Luatools/

2.2 源碼及固件

1、底層 core 下載

下載底層固件，并解壓

鏈接：
https://docs.openluat.com/air724ug/luatos/firmware/

如下圖所示，紅框的是我們要使用到的。

2、本教程使用的 demo：
https://gitee.com/openLuat/LuatOS-Air724UG/tree/master/script_LuaTask/demo/sms

2.3 下載固件和腳本到開(kāi)發(fā)板中

打開(kāi) Luatools，開(kāi)發(fā)板上電開(kāi)機(jī)，如開(kāi)機(jī)成功 Luatools 會(huì)打印如下信息。

點(diǎn)擊項(xiàng)目管理測(cè)試選項(xiàng)。

進(jìn)入管理界面，如下圖所示。

點(diǎn)擊選擇文件，選擇底層固件，我的文件放在 D:luatOSAir724 路徑中

點(diǎn)擊增加腳本或資源文件，選擇 之前下載的程序源碼，如下圖所示。

點(diǎn)擊下載底層和腳本，下載完成如下圖所示。

三、代碼示例介紹

3.1 API 說(shuō)明

sms.send(phone, msg, auto_phone_fix)

作用：發(fā)送短信

參數(shù)：

返回值：

sms.setNewSmsCb(func)

作用：設(shè)置新 SMS 的回調(diào)函數(shù)

參數(shù)：

返回值：

3.2 testSms.lua 代碼

只需要調(diào)用 sms.send()函數(shù)，填入對(duì)方手機(jī)號(hào)和消息內(nèi)容即可。

通過(guò)設(shè)置回調(diào)函數(shù)?；蛘哂嗛啺l(fā)送完成的系統(tǒng)消息，來(lái)進(jìn)行發(fā)送完成的處理。

本 demo 的效果是給服務(wù)商發(fā)短信消息，查詢?cè)捹M(fèi)信息，收到返回的短信息打印日志。

3.3 main.lua 代碼

本代碼為主程序腳本，系統(tǒng)啟動(dòng)后首先會(huì)對(duì) 4G 網(wǎng)絡(luò)進(jìn)行配置，等待網(wǎng)絡(luò)連接成功，然后加載測(cè)試模塊。

四、開(kāi)機(jī)調(diào)試

4.1 開(kāi)發(fā)板開(kāi)機(jī)

連接好硬件并下載固件后，啟動(dòng) Luatools 軟件，系統(tǒng)運(yùn)行信息將顯示在界面中。紅框中為開(kāi)發(fā)板連接到 PC 機(jī)后正常打印的信息，如下圖所示。

4.2 功能調(diào)試

發(fā)送短信息

收到短信息

五、常見(jiàn)問(wèn)題

5.1 物聯(lián)網(wǎng)卡支持短信功能嗎？

一般來(lái)說(shuō)，物聯(lián)網(wǎng)卡是不支持短信功能的，具體需要咨詢物聯(lián)網(wǎng)卡供應(yīng)商。

5.2 支持移動(dòng)、電信，聯(lián)通卡的短信功能嗎？

支持，電信 sim 卡必須開(kāi)通 VOLTE 功能。

5.3 是否支持彩信功能

不支持。

5.4 如何開(kāi)通 VOLTE 功能？

對(duì)于僅支持 4G 網(wǎng)絡(luò) 的 CAT1 模塊（Air720UG、Air724UG）而言，移動(dòng)，聯(lián)通卡不需開(kāi)通 VOLTE 可以支持短信功能，電信卡只有 sim 卡開(kāi)通 VOLTE 功能才能使用短信功能。

如何開(kāi)通 VOLTE 功能，有如下幾種方式：

 登錄運(yùn)營(yíng)商手機(jī)端 app 開(kāi)通

 登錄運(yùn)營(yíng)商官網(wǎng)開(kāi)通

 撥打運(yùn)營(yíng)商客服電話開(kāi)通