跳到主要内容

ML302 4G HTTP 通信(停产)

一、本例程实现功能​

Core通过ML302 4G Cat1模块实现HTTP通信：

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

二、 Core提供的HTTP功能介绍​

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

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

三、接线图​

layout

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

四、材料清单​

名称推荐购买链接（或者您可以自己制作）模块/芯片硬件资料下载
ML302模块购买链接（模块型号：ML302-G全网通版，如果不需GPS功能可以不带G，并按照实际需求购买合适的中国移动物联网sim套餐卡，另外根据需求购买4G和GPS天线）下载地址
声明：这里推荐的购买链接仅供参考，您完全可以去其他商家或渠道购买，只要功能相似即可，如果需要更低的成本建议自己开发硬件模块或定制。

product0

五、完整代码​

--配置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）实际接线图如下：

result0

（2）Client端数据接收如下：

result1

六、需注意事项​

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