零基础开发NBIOT

前语

shineblink core 开发板（简称Core）的库函数支撑NBIOT通讯功用，所以只用几行代码即可完成基于M5311 NB模块的联网通讯（TCP, UDP, MQTT）功用。这儿咱们首要介绍经过TCP完成联网通讯的功用，更多关于TCP, UDP, MQTT通讯请前往shineblink.com 了解。

一、本例程完成功用

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

二、 Core供给的TCP功用介绍

Core已将TCP的操作封装成三个简略的API函数，分别为：LIB_NbTcpConfig()，LIB_NbTcpRecv()，LIB_NbTcpSend()。您只需求调用这三个API即可将NB-IOT模块长途衔接上server端开始收发数据。并且Core会主动处理通讯中的反常状况并尝试重新恢复通讯（比如和server的tcp衔接反常断开，网络反常等），您无需考虑这些复杂的状况即可完成NBIOT模块长时间稳定的在线通讯。

三、接线图

四、材料清单

声明：这儿引荐的商家和Core没有任何合作关系，您完全能够去其他商家或途径购买，只要功用类似即可。

五、完整代码

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

--配置USB以虚拟串口形式作业，这样调用print()函数就会在电脑串口终端打印输出
LIB_UsbConfig("CDC")
--使能体系10毫秒定时器开始作业
LIB_10msTimerConfig("ENABLE")
--设置m5311 NB模块占用TX0、RX0、D5、D6引脚，TCP Client形式
--tcp服务器IP:"103.46.128.49" 端口号:28438
--心跳包间隔时间0秒(不使用心跳机制)。假如需求使用请在ApiDoc文档中查阅关于LIB_NbTcpConfig函数的p8参数具体介绍
LIB_NbTcpConfig("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
--查询是否收到server下发的数据，假如收到就print输出收到的数据
recv_flag,recv_tab = LIB_NbTcpRecv()
if recv_flag == 1 then
print(string.format("tcp client receive %d bytes", #recv_tab))
for k,v in ipairs(recv_tab) do
print(k,v)
end
end
--每5秒发送一包数据给server
if cnt_10ms >= 500 then  --5000ms
cnt_10ms = 0
LIB_NbTcpSend(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查询。

代码运转成果

假如您没有自己的独立服务器IP地址的话，咱们能够在自己的电脑上本地运转一个TCP服务器，然后借助花生壳内网穿透工具赋予本地TCP服务器一个可长途访问的公有IP地址和端口号，内网穿透的具体方法鄙人一章节中咱们会介绍。搭建好内网穿透环境后，咱们就能够在自己的电脑(192.168.1.100：5678)上运转《网络调试助手》软件来模拟Tcp 服务器端进行调试。