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

本指南教你如何用 Air724 開發(fā)板，使用 sms 功能，并通過日志觀察實驗結(jié)果。

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

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

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

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

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

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

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 卡

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

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

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

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

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

使用說明參考：

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 下載固件和腳本到開發(fā)板中

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

點擊項目管理測試選項。

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

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

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

點擊下載底層和腳本，下載完成如下圖所示。

三、代碼示例介紹

3.1 API 說明

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ù)，填入對方手機(jī)號和消息內(nèi)容即可。

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

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

3.3 main.lua 代碼

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

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

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

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

4.2 功能調(diào)試

發(fā)送短信息

收到短信息

五、常見問題

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

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

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

支持，電信 sim 卡必須開通 VOLTE 功能。

5.3 是否支持彩信功能

不支持。

5.4 如何開通 VOLTE 功能？

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

如何開通 VOLTE 功能，有如下幾種方式：

 登錄運(yùn)營商手機(jī)端 app 開通

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

 撥打運(yùn)營商客服電話開通