开发板通过ML302 4G Cat1模块实现HTTP通信

一、本例程实现功能

Ubeeto物联网开发板通过ML302 4G Cat1模块实现HTTP通信：

1、当Core开发板上的BTN1按键按下时向Http Server端发送GET请求。

2、当Core开发板上的BTN2按键按下时向Http Server端发送POST请求。

二、 Ubeeto开发板提供的HTTP功能介绍

ubeeto开发板已将HTTP的操作封装成四个简单的API函数，分别为：LIB_Cat1HttpConfig()，LIB_Cat1HttpGet()，LIB_Cat1HttpPost()，LIB_Cat1HttpQueryBuff()。您只需要调用这四个API即可通过ML302 4G模块远程连接上server端开始Http通信。

LIB_Cat1HttpGet()和LIB_Cat1HttpPost()用于向服务器发送GET和POST请求并缓存服务器的响应数据，而LIB_Cat1HttpQueryBuff()则用来取出刚刚缓存额相应数据。

三、接线图

注意：ML302其他没用的引脚可以不用接。

四、材料清单

名称	推荐购买链接（或者您可以自己制作）	模块/芯片硬件资料下载
ML302模块	购买链接（模块型号：ML302-G全网通版，如果不需GPS功能可以不带G，并按照实际需求购买合适的中国移动物联网sim套餐卡，另外根据需求购买4G和GPS天线）	下载地址（提取码：y8dv）

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

五、完整代码

--配置Core的USB口以虚拟串口模式工作，这样print()输出的内容就可以在电脑串口终端上显示了
LIB_UsbConfig("CDC")
--开启HTTP Client模式，设置Cat1模块占用TX0、RX0、D5、D6引脚
--不开启GPS功能，如果需要使用请在ApiDoc文档中查阅关于LIB_Cat1HttpConfig函数的p10参数详细介绍
LIB_Cat1HttpConfig("UART0","D5","HIGH","D6","HIGH","NONE",0,0,"HTTP","NO_GPS")
--设置按键"BTN1"(占用D10口),"BTN2"(占用D11口)以低电平有效的方式检测按键动作
LIB_ButtonConfig("BTN1","D10","L")
LIB_ButtonConfig("BTN2","D11","L")
--开始大循环
while(GC(1) == true)
do
    --轮询按键事件
    BTN1 = LIB_ButtonQuery("BTN1")
    BTN2 = LIB_ButtonQuery("BTN2")
    --如果按键1短按过
    --注意：下面的过程耗时取决于4G网速，按键按下后可能不会立马有所反应
    if BTN1 == 1 then
        --开始向服务器发送GET请求
        result,code,length = LIB_Cat1HttpGet("http://doc.workerman.net/principle.html")
        if result == 1 then 
            print("LIB_Cat1HttpGet() exec finished")
            --服务器返回Http状态码200，表示OK
            if code == 200 then 
                print(string.format("Server respond ok, respond content len:%d", length))
                --从服务器返回的数据中读取前250字节(每次最多只能读250字节)
                str_len,str = LIB_Cat1HttpQueryBuff(0,250)
                if str_len > 0 then
                    print(str)--打印输出
                end
            else
                print(string.format("Server respond error, respond code:%d", code))
            end
        end
    end
    --如果按键2短按过
    --注意：下面的过程耗时取决于4G网速，按键按下后可能不会立马有所反应
    if BTN2 == 1  then
        --开始向服务器发送POST请求
        result,code,length = LIB_Cat1HttpPost("http://api.heclouds.com:80/devices/588931880/datapoints?type=3", "{\"temperature\":25.0,\"humidity\":70}")
        if result == 1 then
            print("LIB_Cat1HttpPost() exec finished")
            if code == 200 then --服务器返回Http状态码200，表示OK
                print(string.format("Server respond ok, respond content len:%d", length))
            else
                print(string.format("Server respond error, respond code:%d", code))
            end
        end
    end
end

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

代码运行结果

（1）实际接线图如下：

（2）Client端(开发板)数据接收如下：

六、需注意事项

本例程里的GET请求测试，是直接下载网站的网页，这个流量很大，对于流量本身就不多的物联网卡套餐，不适合频繁做这种测试，如果可以最好使用您自己的手机流量套餐sim卡来测试。