今天一起來學習使用合宙低功耗4G模組Air780E傳送SMS短訊息:
一、SMS簡介
SMS(短訊息服務,ShortMessageService)功能主要用於在蜂窩網路中傳輸短訊息。
在4G網路中,簡訊可以在資料傳輸的同時進行,不會因資料業務佔用網路資源而被延遲或阻塞。
在Air780E模組中,當收到新簡訊後,MAIN_RI變為低電平,持續120ms,再變為高電平。可根據這個引腳來判斷是否有新簡訊。
移動,聯通卡不需開通VOLTE可以支援簡訊功能。
二、準備硬體環境
2.1 Air780E開發板一套,包括天線、USB資料
2.2 資料通訊線
typec介面USB資料線即可。
2.3 開通簡訊功能的SIM卡
Air780E不支援電信卡的簡訊功能!
如果是聯通卡或者移動卡,均可收取簡訊,但實名制的卡才能傳送簡訊。
如果是專網路卡,請參考專網路卡配置指南:(暫時相關文章還沒出,後續補充)
三、準備軟體環境
3.1 基本的下載除錯工具
下載Luatools
四、sms功能軟硬體資料
本文透過demo演示來說明本章節內容的基本用法。
4.1 原始碼和工具
-
Air780E模組使用韌體:SDK&Demo-合宙文件中心,本demo使用的韌體版本是:LuatOS-SoC_V1112_EC618_FULL.soc
-
本教程使用的demo:
https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/sms -
將韌體和指令碼燒錄到模組中,使用說明參考:Luatools下載和詳細使用
-
原始碼和韌體已打包,如下所示:點我,下載完整壓縮檔案包
4.2 本demo使用api簡介
sms.send(phone,msg,auto_phone_fix)
作用:傳送簡訊
引數:
傳入值型別 | 解釋 |
string |
電話號碼,必填 |
string |
簡訊內容,必填 |
bool |
是否自動處理電話號號碼的格式, |
返回值:
返回值型別 | 解釋 |
bool/nil |
成功返回true,否則返回false或nil |
sms.setNewSmsCb(func)
作用:設定新SMS的回撥函式
引數:
傳入值型別 | 解釋 |
function |
回撥函式,3個引數,num,txt,metas |
返回值:
返回值型別 | 解釋 |
nil |
傳入是函式就能成功,無返回值 |
五、程式碼示例介紹
5.1 傳送簡訊
5.1.1 demo介紹
只需要呼叫sms.send()函式,填入對方手機號和訊息內容即可。
透過設定回撥函式。或者訂閱傳送完成的系統訊息,來進行傳送完成的處理。
本demo的效果是給服務商發簡訊訊息,查詢話費資訊。
5.1.2 將程式燒錄到開發板
參考:將韌體和指令碼燒錄到模組中:Luatools下載和使用教程-合宙模組資料中心。
六、功能驗證
成功傳送簡訊。
七、常見問題
7.1 物聯網路卡支援簡訊功能嗎?
一般來說,物聯網路卡是不支援簡訊功能的,具體需要諮詢物聯網路卡供應商。
7.2 支援移動、電信,聯通卡的簡訊功能嗎?
Air780E不支援電信卡的簡訊功能!!
如果是聯通卡或者移動卡,均可收取簡訊,但實名制的卡才能傳送簡訊。
7.3 是否支援彩信功能
不支援。