NBIOT M5311 UDP 通信

一、本例程实现功能

Core通过M5311 NB-IOT模块和指定的UDP对端，Core每5秒向UDP对端发送一个数据包(5字节)，并接收UDP对端发来的数据。

二、 Core提供的UDP功能介绍

Core已将UDP的操作封装成三个简单的API函数，分别为：LIB_NbUdpConfig()，LIB_NbUdpRecv()，LIB_NbUdpSend()。您只需要调用这三个API即可将NB-IOT模块远程和UDP对端收发数据。并且Core会自动处理通信中的异常情况并尝试重新恢复通信（比如网络异常等），您无需考虑这些复杂的情况即可实现NBIOT模块长期稳定的在线通讯。

三、接线图

四、材料清单

名称	推荐购买链接（或者您可以自己制作）	模块/芯片硬件资料下载
M5311模块	请自行某宝搜索M5311	下载地址

声明：这里推荐的购买链接仅供参考，您完全可以去其他商家或渠道购买，只要功能相似即可，如果需要更低的成本建议自己开发硬件模块或定制。

五、完整代码

Core通过M5311 NB-IOT模块和指定的服务器建立UDP连接，Core每5秒向服务器发送一个数据包(5字节)，服务器每2秒钟向Core发送一个数据包(5字节)。

--配置USB以虚拟串口模式工作，这样调用print()函数就会在电脑串口终端打印输出
LIB_UsbConfig("CDC")
--使能系统10毫秒定时器开始工作
LIB_10msTimerConfig("ENABLE")
--设置m5311 NB模块占用TX0、RX0、D5、D6引脚，Udp 模式
--Udp对端IP:"103.46.128.49" 端口号:28438
--心跳包间隔时间0秒(不使用心跳机制)。如果需要使用请在ApiDoc文档中查阅关于LIB_NbUdpConfig函数的p8参数详细介绍
LIB_NbUdpConfig("UART0","D5","HIGH","D6","HIGH","103.46.128.49",28438,0)
--变量初始化
cnt_10ms = 0
cnt1_10ms = 0
send_tab = {0x01,0x02,0x03,0x04,0x05} --需要发送给server端的数据
--定义10ms中断回调函数
function LIB_10msTimerCallback()
    cnt_10ms = cnt_10ms + 1
	cnt1_10ms = cnt1_10ms + 1
end
--开始大循环
while(GC(1) == true)
do
    --查询是否收到UDP对端发来的数据，如果收到就print输出收到的数据
    recv_flag,recv_tab = LIB_NbUdpRecv()
    if recv_flag == 1 then
        print(string.format("UDPt receive %d bytes", #recv_tab))
        for k,v in ipairs(recv_tab) do
            print(k,v)
        end
    end
    --每5秒发送一包数据给UDP对端
    if cnt_10ms >= 500 then  --5000ms
        cnt_10ms = 0
        LIB_NbUdpSend(send_tab)
    end
	--每12秒打印一次NBIOT模组信息(包含sim卡)
	--注意：这里只是为了演示，实际应用中您可以根据您的需求查询即可，不需要一直查询
    if cnt1_10ms >= 1200 then  --12000ms
        cnt1_10ms = 0
        State,IMEI,IMSI,ICCID,RSSI = LIB_NbStatusQuery()
		print(string.format("module state: %s", State))
		print(string.format("module IMEI: %s", IMEI))
		print(string.format("module IMSI: %s", IMSI))
		print(string.format("module ICCID: %s", ICCID))
		print(string.format("module RSSI: %d dBM", RSSI))
    end
end

如果感兴趣，上面代码中出现的LIB开头的库函数可以在 API文档 中通过Ctrl+F查询。