大家好，今天一起来学习使用合宙低功耗4G模组Air780E发送SMS短消息：
一、SMS简介
SMS（短消息服务，ShortMessageService）功能主要用于在蜂窝网络中传输短消息。
移动，联通卡不需开通VOLTE可以支持短信功能。
在4G网络中，短信可以在数据传输的同时进行，不会因数据业务占用网络资源而被延迟或阻塞。
在Air780E模块中，当收到新短信后，MAIN_RI变为低电平，持续120ms，再变为高电平。可根据这个引脚来判断是否有新短信。
二、演示功能概述
本demo演示了sms功能。
三、准备硬件环境
3.1 Air780E开发板一套，包括天线、USB数据线
此核心板的详细使用说明参考：Air780E产品手册中的《开发板Core_Air780E使用说明V1.0.5.pdf》，核心板使用过程中遇到任何问题，可以直接参考这份使用说明pdf文档。
https://docs.openluat.com/air780e/product/
3.2 数据通信线
typec接口USB数据线即可。
3.3 开通短信功能的SIM卡
Air780E不支持电信卡的短信功能！
如果是联通卡或者移动卡,均可收取短信,但实名制的卡才能发送短信。
如果是专网卡，请参考专网卡配置指南：（暂时相关文章还没出，后续补充）
四、准备软件环境
4.1 基本的下载调试工具
使用说明参考：
Luatools下载和详细使用：
https://docs.openluat.com/Luatools/
五、sms功能软硬件资料
本文通过demo演示来说明本章节内容的基本用法。
5.1 源码和工具
- Air780E模块使用固件：SDK&Demo-合宙文档中心，本demo使用的固件版本是：LuatOS-SoC_V1112_EC618_FULL.soc
- 本教程使用的demo：
https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/sms - 将固件和脚本烧录到模块中，使用说明参考：Luatools下载和详细使用
- 源码和固件已打包，如下所示：点我,下载完整压缩文件包
5.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 | 传入是函数就能成功,无返回值 |
六、代码示例介绍
6.1 发送短信
6.1.1 demo介绍
只需要调用sms.send()函数，填入对方手机号和消息内容即可。
通过设置回调函数。或者订阅发送完成的系统消息，来进行发送完成的处理。
本demo的效果是给服务商发短信消息，查询话费信息。
6.1.2 将程序烧录到开发板
参考：将固件和脚本烧录到模块中：Luatools下载和使用教程-合宙模组资料中心。
七、功能验证
成功发送短信。
八、总结
本示例介绍了如何发送短消息服务。
九、常见问题
9.1 物联网卡支持短信功能吗？
一般来说，物联网卡是不支持短信功能的，具体需要咨询物联网卡供应商。
9.2 支持移动、电信，联通卡的短信功能吗？
Air780E不支持电信卡的短信功能!!
如果是联通卡或者移动卡,均可收取短信,但实名制的卡才能发送短信。
9.3 是否支持彩信功能
不支持。
