本案例使用C1-P02开发板实现的与手机终端的双向短信通信,无需复杂的电路搭建,不用懂深奥的协议。只要你有 SIM 卡和开发板,跟着步骤走,一杯咖啡的时间就能搞定双向短信测试。
别被“物联网通信”这种大词吓到。本案例只需实现两个功能:
- 发:让手里的 C1-P02 开发板给你的手机发一条短信。
- 收:你给开发板回一条短信,看它能不能在电脑屏幕上“复述”出来。
核心技能:学会调用QuecPython的 SMS 模块,这是一些远程通知类项目(比如温度报警、门磁提醒)的基础。
工欲善其事,必先利其器。部分硬件可在移远官方商城购买,开工前请核对以下清单:
| 类别 | 名称 | 实物图 | 购买方式 | |
|---|---|---|---|---|
| 核心板 | C1-P02 开发板 | 确认开发板搭载的具体模组型号。 | ![]() |
点此购买 |
| 通信卡 | SIM 卡 | 必须能发短信 (有些物联卡只能上网) | ![]() |
自行准备 |
| 配件 | LTE天线 (4GFPC天线YF0022AA) | 必须拧在标有 LTE 的接口上,拧反了或没拧紧可能出现没信号的情况。 |
![]() |
点此购买 |
| 连接线 | USB 数据线(一端Type-C) | 确保是数据线,不是只能充电的线。 | ![]() |
自行准备 |
所有软件请在QuecPython官方下载专区获取,严禁混用型号。
| 名称 | 作用 | 注意事项 |
|---|---|---|
| QuecPython 驱动 | 建立电脑与板子的通信桥梁 | 型号必须严格匹配开发板搭载的模组型号。 |
| QuecPython 固件 | 开发板运行代码的环境 | 尾缀必须一致。例如模组型号含 CNLE,固件也必须选 ...CNLE 版本。 |
| QPYcom 工具 | 代码烧录与调试终端 | 官方集成开发环境,无需额外配置。 |
注意事项:解压固件和代码的文件夹路径中,绝对不能包含任何中文字符或空格!
错误示范:D:\我的下载\新建文件夹\firmware 正确示范:D:\dev\firmware
- 将 SIM 卡芯片朝下插入卡槽,听到“咔哒”声表示到位。
- 将 LTE 天线按紧在开发板的
LTE接口。 - 通过 USB 线将开发板连接至电脑。
- 打开 QPYcom 工具。
- 选择正确的 COM 端口 (通常显示为 REAL PORT或NAME PORT)。
- 选择 模组型号对应版本 的固件文件,点击“烧录”。
- 等待进度条走完,弹出“Download Success”窗口即可。
软件烧录的详细步骤点此跳转
代码结构并不复杂,主要分为接收和发送接口
send_sms为封装好的发送短信接口,使用QuecPython的sms.sendTextMsg接口,接口详情参考。
def send_sms(phone, msg):
"""发送短信(中文默认UCS2编码)"""
sms_log.info("发送短信到 {}:{}".format(phone, msg))
ret = sms.sendTextMsg(phone, msg, "UCS2")
if ret == 0:
sms_log.info("短信发送成功!")
else:
sms_log.info("发送失败,错误码:{}".format(ret))接收短信使用回调触发方式,收到新短信时回调函数触发,在回调函数里我们使用 sms.searchTextMsg 读取短信内容,接口详情参考。
# 初始化:注册接收短信回调
def sms_receive_callback(args):
"""收到新短信自动触发"""
sim_id, sms_index, _ = args
# 读取短信内容
content = sms.searchTextMsg(sms_index)
if content != -1:
sender, msg, _ = content
sms_log.info("收到短信:发件人[{}],内容:{}".format(sender, msg))
# 注册接收回调
sms.setCallback(sms_receive_callback)现象 A:日志报错,或者手机死活收不到短信
- 急救方案:
- 摸一下天线,是不是松了?是不是拧错接口了?
- 把 SIM 卡拔出来插手机里,确认能正常收发短信,且没欠费。
- 检查代码里的手机号有没有多写空格或少写数字。
现象 B:QPYcom 找不到端口,或者显示灰色
- 急救方案:
- 驱动可能下错了或者没装好!重新下载安装模组的专用驱动**,安装时记得**右键-以管理员身份运行。
- 换个 USB 口,或者换根数据线试试(有些线只能充电)。
搞定短信收发,你就解锁了“远程通知”技能树! 接下来可以试试:
- 温度报警器:温度超过 30 度,自动发短信给你。
- 门禁通知:有人按门铃,发短信提醒你。
觉得对您有所帮助?别忘了给仓库点个 Star ⭐️








