Air780EP-AT开发-HTTP应用指南

已于 2024-07-22 14:49:47 修改
阅读量387 收藏 6
点赞数 14
文章标签： http 合宙
于 2024-07-22 14:29:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_54248548/article/details/140608993
版权

简介

概述

4G模块支持HTTP和HTTPS协议， HTTP应用的基本流程如下：

 1、激活PDP（参考：http://oldask.openluat.com/article/937）

 2、初始化HTTP服务

 3、设置HTTP会话参数

 4、如果要支持SSL，配置SSL参数

 5、如果使用POST命令，输入POST数据

 6、发起HTTP请求

 7、收到HTTP应答，读取应答数据

 8、终止HTTP服务

 第1步出现异常后：首先需要排查http连接和请求参数是否正常，通过postman是否可以请求成功，模块上网是否正常（AT+CEREG?）

 第2步到第5步，只要输入格式正确，基本不会出问题；如果出错，可以跳过，直接处理第6步的异常

 第6步和第7步出现异常后：终止HTTP服务，有选择性的去激活PDP；然后再有选择性的激活PDP，从第2步开始重新执行

材料准备

  • [EVB_Air780EP]开发板一套，包括天线SIM卡
  • USB线
  • PC电脑
  • 串口调试工具（如果没有准备，推荐可以使用llcom，下载地址：https://llcom.papapoi.com）
  • AT固件获取：https://gitee.com/openLuat/airm2m-ec718-at/releases ，进页面按下Ctrl+F 搜索 AirM2M_780EP_LTE_AT 即可找到780EP模块所使用的AT固件，推荐选用该固件名称后面数字版本号最高的最新relase版本进行调试。
  • 当前文档示例使用AirM2M_780EP_V1007_LTE_AT版本固件（除780EP模块不能烧录，但可以在上面AT固件获取连接获取到其他模块型号的AT固件。）

在这里插入图片描述

HTTP GET请求示例

具体指令和参数使用说明，可参考AT指令手册

AT+CPIN?

+CPIN: READY    //查询sim卡是否正常

OK

AT+CGATT?

+CGATT: 1        //查询是否附着上数据网络，如果返回+CGATT: 0表示未附着上

OK

AT+SAPBR=3,1,"CONTYPE","GPRS"

OK

AT+SAPBR=3,1,"APN",""    //设置APN，此处""表示使用从网络端自动获取到的APN

OK

AT+SAPBR=1,1             //发起激活PDP的请求

OK

AT+SAPBR=2,1             //注意：此命令仅仅查询PDP地址，可以不执行

+SAPBR: 1,1,"10.159.1.145"    //请求到的PDP地址

OK

AT+HTTPINIT

OK

AT+HTTPPARA="CID",1

OK

AT+HTTPPARA="URL","airtest.openluat.com"

OK

AT+HTTPACTION=0		// GET请求

OK

+HTTPACTION: 0,200,285

AT+HTTPREAD

+HTTPREAD: 285

<!DOCTYPE html>
<html lang="en">


<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    Hello
</body>

</html>
OK

在这个过程中，注意事项如下：

1、发送AT+HTTPACTION命令后，收到OK仅仅表示4G模块开始处理这条命令，并不表示请求发送成功，收到了应答；只有收到+HTTPACTION: n,statusCode,len才表示请求结束，statusCode表示应答成功，其余都表示应答失败
2、HTTP应答数据的缓冲区大小为4KB，如果返回的http body数据超过了这个大小，则需要断点下载，可以使用AT+HTTPPARA命令，通过设置BREAK和BREAKEND参数来实现

2、HTTP被动断开示例
发送AT+HTTPACTION命令，和服务器建立了http连接后，如果连接异常被动断开，会输出+HTTPACTION: ,,提示

3、PDP被动去激活示例
先来看下PDP被动去激活时的AT命令处理序列，如果不理解AT命令含义，请自行参考AT手册。

+PDP DEACT // 出现PDP去激活的URC上报，后面如果没做任何处理，接着做http请求会失败，可以按照下方的建议处理。

应对处理每次结束都需要重新走一遍HTTP请求流程

第一种方法：

AT+CIPSHUT // 关闭移动场景

第二种方法：

AT+CIPSHUT // 关闭移动场景

AT+CGDCONT=5,“IP”,“”//请填写实际APN

AT+CGACT=1,5

第三种方法：

AT+CFUN=0 // 进入飞行模式

AT+CFUN=1 // 退出飞行模式

第四种方法：

AT+RESET // 重启模块

参考下发流程中收到"+SAPBR 1: DEACT"错误提示，表示PDP被动去激活，为异常处理的触发点。

AT+HTTPINIT

OK

AT+HTTPPARA="CID",1

OK

AT+HTTPPARA="URL","www.baidu.com"

OK

AT+HTTPACTION=0			// 传入0为GET请求

OK 

+SAPBR 1: DEACT       	// 此处PDP被动去激活

+HTTPACTION: 0,601,0

AT+HTTPTERM

OK                     	// 此处无论返回OK、ERROR还是CME ERROR，都直接跳过，不用做正确性判断

AT+SAPBR=0,1

+CME ERROR: 3         	// 此处无论返回OK、ERROR还是CME ERROR，都直接跳过，不用做正确性判断

--------------------

下方进行异常处理
AT+CIPSHUT				// 关闭移动场景

OK

AT+CGDCONT=5,"IP",""	// 请填写实际APN 

OK

AT+CGACT=1,5			// 激活PDP

OK

AT+HTTPINIT

OK

AT+HTTPPARA="CID",1

OK

AT+HTTPPARA="URL","airtest.openluat.com"

OK

AT+HTTPACTION=0

OK

+HTTPACTION: 0,200,285

HTTP POST请求示例

POST请求流程与GET流程基本一致，只有AT+HTTPACTION指令参数要从AT+HTTPACTION=0变为AT+HTTPACTION=1

具体指令和参数使用说明，可参考AT指令手册

AT+CPIN?

+CPIN: READY    //查询sim卡是否正常

OK

AT+CGATT?

+CGATT: 1        //查询是否附着上数据网络，如果返回+CGATT: 0表示未附着上

OK

AT+SAPBR=3,1,"CONTYPE","GPRS"

OK

AT+SAPBR=3,1,"APN",""    //设置APN，此处""表示使用从网络端自动获取到的APN

OK

AT+SAPBR=1,1             //发起激活PDP的请求

OK

AT+SAPBR=2,1             //注意：此命令仅仅查询PDP地址，可以不执行

+SAPBR: 1,1,"10.159.1.145"    //请求到的PDP地址

OK

AT+HTTPINIT

OK

AT+HTTPPARA="CID",1

OK

AT+HTTPPARA="URL","airtest.openluat.com"

OK

AT+HTTPACTION=1		// POST请求

OK

+HTTPACTION: 0,200,285

AT+HTTPREAD

+HTTPREAD: 285

<!DOCTYPE html>
<html lang="en">


<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    Hello
</body>

</html>
OK

HTTPS SSL请求示例

具体指令和参数使用说明，可参考AT指令手册

带SSL证书双向验证功能的HTTPS过程：

AT+FSCREATE=“ca.crt” // 创建服务器端CA 证书文件
OK

AT+FSCREATE=“client.crt” // 创建客户端证书文件
OK

AT+FSCREATE=“client.key” // 创建客户端密钥文件
OK

AT+FSWRITE=“ca.crt”,0,2080,15 // 文件长度2080字节只是举例，要根据实际填写。指令发送后会返回">"，随后写入数据

这里输入CA证书文件
OK

AT+FSWRITE=“client.crt”,0,128,10 // 指令发送后会返回">"，随后写入数据
这里输入客户端证书文件
OK

AT+FSWRITE=“client.key”,0,188,10 // 指令发送后会返回">"，随后写入数据
这里输入客户端密钥文件
OK

AT+SAPBR=3,1,“CONTYPE”,“GPRS”
OK

AT+SAPBR=3,1,“APN”,“” // 设置PDP承载之APN参数 模块注册网络后会从网络自动获取并激活一个 PDP上下文，用于RNDIS上网使用（此可以通 过AT+CGDCONT?来查询），所以输入 AT+SAPBR=3,,“APN”,“” 即可，模块内部会按 照自动获取的来设置APN
OK

AT+SAPBR=1,1
OK

AT+SAPBR=2,1
+SAPBR: 1,1,010.169.179.213

OK

下发ssl配置请根据实际请求服务器所需要的进行设置

AT+SSLCFG=“cacert”,153,“ca.crt” // 设置服务器CA 证书 SSL 上下文id，在TCP单链接的情况下缺省为0； 在HTTPS链接下为153，下同
OK

AT+SSLCFG=“clientcert”,153,“client.crt” // 设置客户端证书
OK

AT+SSLCFG=“clientkey”,153,“client.key” // 设置客户端KEY
OK

AT+SSLCFG=“seclevel”,153,2 // 设置安全等级
OK

AT+SSLCFG=“ciphersuite”,153,0X0035 // 设置加密套件
OK

AT+SSLCFG=“clientrandom”,153,01B12C31 41516171F19202122232425262728293031 323334353637D // 设置随机数
OK

AT+HTTPINIT // HTTP协议栈初始化
OK

AT+HTTPPARA=“CID”,1 // 设置HTTP会话参数：CID
OK

AT+HTTPPARA=“URL”,“https://..**” // 设置HTTP会话参数：URL 请写具体的网址，而不要照抄
OK

AT+HTTPACTION=0 // GET 开始
OK

+HTTPACTION:0,200,1348

+HTTPACTION:0,200,1348

+HTTPACTION:0,200,1348 … … // 出现这些URC上报表明GET数据成功，等待READ

AT+HTTPREAD // 读取从HTTP 服务器GET的数据

+HTTPREAD:1592 ……………… // …表示HTTP数据

OK

AT+HTTPTERM // 结束HTTP服务
OK

断点续传

在实际的应用场景中，可能需要下载一个非常大的文件，例如几百K字节、几M字节，但是4G模块中HTTP可用的内存缓冲区780EP模块只有4KB左右，当文件大小超过这个缓冲区时，就要使用断点续传功能来分段下载处理了。下面以“下载一个119345字节的文件”为例，来说明如何使用断点续传功能（注意：本示例仅仅演示了正常流程的HTTP AT命令，完整流程以及异常处理流程请参考本文应用流程部分）

AT+CGATT?

+CGATT: 1

OK

AT+SAPBR=3,1,"CONTYPE","GPRS"

OK

AT+SAPBR=3,1,"APN",""

OK

AT+SAPBR=1,1

OK

AT+SAPBR=2,1

+SAPBR: 1,1,"10.55.195.210"

OK

AT+HTTPINIT 

OK

AT+HTTPPARA="URL","http://rcems.hzccs.com/upfile/ROBAM-M2-V13704A7-20240308-APP.bin"

OK

AT+HTTPACTION=2		// 使用head方式请求

OK

+HTTPACTION: 2,200,0


AT+HTTPHEAD		

+HTTPHEAD: 247
Accept-Ranges: bytes
ETag: W/"119345-1710117624106"
Last-Modified: Mon, 11 Mar 2024 00:40:24 GMT
Content-Type: application/octet-stream
Content-Length: 119345
Date: Mon, 22 Jul 2024 03:34:24 GMT
Keep-Alive: timeout=20
Connection: keep-alive

OK


//如下指令，表示下载文件的第一个3KB数据

AT+HTTPPARA="BREAK",0

OK

AT+HTTPPARA="BREAKEND",3071

OK

AT+HTTPACTION=0

OK

+HTTPACTION: 0,206,3072


AT+HTTPREAD

+HTTPREAD: 3072

......                          //此处输出3072字节数据

OK			//表示下载文件的第一个3KB数据完成


//如下指令，表示下载文件的第二个3KB数据

AT+HTTPPARA="BREAK",3072

OK

AT+HTTPPARA="BREAKEND",6143

OK

AT+HTTPACTION=0

OK

+HTTPACTION: 0,206,3072


AT+HTTPREAD

+HTTPREAD: 3072

......                          //此处输出3072字节数据

OK		 //表示下载文件的第二个3KB数据完成

//此处参考上文指令，一直循环读取文件的下一个300KB数据，直到读取结束

......

AT+HTTPTERM			// 断开HTTP

OK

常见问题

1、HTTP支持多连接吗

目前HTTP仅支持单连接，不支持多连接

2、HTTPS如何使用

本文主要描述了基本流程和异常处理，对于HTTPS使用方法没有做过多描述，这一部分，请自行参考AT指令手册HTTP章节下《使用方法举例》中的"带SSL证书验证功能的HTTPS流程"使用方法；支持的SSL参数，请自行参考AT+SSLCFG命令说明
如果SSL的参数配置不变，则每次开机运行过程中，仅设置一次即可

3、重试多次PDP，HTTP应用一直连接失败

如果重试多次PDP激活，PDP一直激活失败，或者HTTP一直请求应答失败，则尝试使用如下手段恢复：

​ 使用RESET引脚复位模块

​ 极端情况下，直接给模块断电，再上电，POWER KEY引脚拉低开机

4、HTTP下载的大文件如何可靠的发送给MCU（AT流控）

需要在断点续传流程指令里开头加入AT+IFC的配置指令

AT+HTTPREAD

+HTTPREAD: 3072

… //此处输出3072字节数据

OK
…处的3072字节数据，是模块通过UART AT口发送给MCU，在实际传输过程中，由于串口芯片驱动、MCU端的处理能力、波特率的选择都存在不确定性，可能会导致MCU端接收到的数据，实际上没有3072字节，这就要求UART AT口打开流控功能。模块支持硬流控和软流控两种：

硬流控，参考如下步骤操作：
（1） 模块和 的UART口，CTS、RTS要交叉相连

（2） MCU端固件要支持并且打开硬流控功能

（3） MCU端要发送AT+IFC=2,2命令到模块端，打开模块端的硬流控功能

软流控，参考如下步骤操作：
（1） MCU端固件要支持并且打开软流控功能

（2） MCU端要发送AT+IFC=1,1命令到模块端，打开模块端的硬流控功能

5、为什么我只发了10字节消息，100次却消耗了很多流量？

因为还有HTTP自带的请求头。

6、为什么频繁请求会失败?

支持的http连接总数有限数量为tcp连接数量8个，建议一个http连接返回请求结果之后，再去请求下一个连接；不要使用循环定时器方式不断的发起新的http请求。

7、如何POST文件?

主要是使用AT+HTTPDATA命令录入文件数据后，发送AT+HTTPACTION=1利用post上传

8、数据发送接收缓存问题

AT版本：有缓存机制，内存中有一个的缓冲区（780EP模块AT固件HTTP缓存为4KB），发送和接受使用的是同一块缓冲区，发送和收到数据后，插入此缓冲区，然后通过AT口输出urc，提示收到的数据长度；缓冲区满之后，再收到新数据，会丢弃新收到的数据，并通过AT口输出urc提示出错；需要读取数据时，发送AT+HTTPREAD命令读取，可分段读取，也可全部读取

注意：缓冲区位于内存中，断电或者重启后，缓存表中的数据会被清空；虽然缓冲区可以缓存很多数据，但是建议收到数据时，通过AT+HTTPREAD及时读取出来，以防缓冲区满出错

合宙Luat
关注
  • 14
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
博客
Air780EP- AT开发-阿里云应用指南
07-22 598
使用AT方式连接阿里云分为一机一密和一型一密两种方式，其中一机一密又包括HTTP认证二次连接和MQTT直连两种方式。
博客
Air780E/Air780EP/Air780EQ/Air201模块遇到内存死机如何分析
07-19 841
合宙Air780E、Air780EP、Air780EQ、Air201
博客
Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析
07-19 755
本文档适用于合宙Air780E、Air780EP、Air780EQ、Air201luatools和EPAT这2个工具，具体使用方法要了解，本文不做深入讲解，文档内有详细使用说明luatools用于捕获从USB口的用户log，即luat_debug_print输出的log，仅用于csdk和luatos。AT版本没有用户log和用户串口通道，需要使用EPAT工具抓取。luatools捕获用户log时，自动识别GB2312还是UTF8编码，也能正确打印64bit数据和浮点数据。
博客
780EP_AT_FOTA远程升级指南
07-19 855
使用自己的服务器来升级模块和使用iot平台升级最重要的区别是下载固件的来源不同。其实FOTA的过程是新老版本生成差分包再进行升级的过程，那么这个差分的过程在哪里呢？使用合宙iot平台升级，差分的过程在iot服务器后台，那使用自己的服务器该怎么办呢？答案当然是自己来完成差分的过程，放在服务器等待模块来下载。
博客
无法抓log的情况下如何导出死机DUMP（适用于7xx芯片系列模块,例如718p/716s ）
07-18 536
EC7XX系列芯片，Flash 空间十分紧张，无法像 618 一样在异常处理时将所有 RAM 信息 dump 到Flash中保存以便后续分析，所以要求 dump 一些关键性信息到 flash 中，这样在无法抓log的场景下，用户可以将这些信息发送到电脑上后进行分析，以尽可能的分析死机问题。选中此选项后会弹出 dump 文件处理窗，选择对应的 dump 文件后，会在 Excep Info 窗里显示解析后的 dump 数据，如图所示。操作模块进入烧录模式，点击start即可，文件保存在binpkg所在目录。
博客
适用于618/7xx芯片平台 AT开发 远程FOTA升级指南教程
07-18 768
使用自己的服务器来升级模块和使用iot平台升级最重要的区别是下载固件的来源不同。其实FOTA的过程是新老版本生成差分包再进行升级的过程，那么这个差分的过程在哪里呢？使用合宙iot平台升级，差分的过程在iot服务器后台，那使用自己的服务器该怎么办呢？答案当然是自己来完成差分的过程，放在服务器等待模块来下载。
博客
超低功耗 AT方案说明文档 新增716s/718p芯片模块的固件获取以及测试方法
07-18 880
远程唤醒速度快(2秒内)信号好的情况下能达到474uA 的平均待机电流支持UART和带WAKEUP功能的GPIO中断唤醒远程唤醒速度快(2分钟内)信号好的情况下能达到220uA 的平均待机电流支持UART和带WAKEUP功能的GPIO中断唤醒远程无法唤醒待机功耗2.89uA支持UART和带WAKEUP功能的GPIO中断以及定时器唤醒(会拉低RI唤醒或者打开单片机)需要设置AT+CFGRI=1指令，才会拉低RI管脚VBUS 拉高和DTR 拉低可唤醒模块。
博客
8910 API新增sysplus接口
07-18 760
创建一个任务线程,在模块最末行调用该函数并注册模块中的任务函数，main.lua导入该模块即可。msg or false 成功返回table型的msg，超时返回false。true or false 成功返回true。删除由taskInitEx创建的任务线程。模块功能：Luat协程调度框架。co 返回该任务的线程号。向目标任务发送一个消息。等待接收一个目标消息。
博客
合宙“全球通“模组Air795UG上市，支持4G+2G全球频段
01-10 1187
Air795UG-NFM模组——合宙基于紫光展锐UIS8910DM平台设计的LTE Cat.1无线通信模组，稳定可靠性能优秀。针对海外市场，支持4G+2G全球频段，并且可以根据具体地区进行频段筛选，从而为客户有效降本。Air795UG-NFM内置展锐8910高性能芯片（16MB RAM+8MB ROM），兼容模组行业经典封装25mm×29mm。模组内置Codec支持音频输入输出，支持VoLTE通话；支持蓝牙4.2；支持Wi-Fi定位；支持AT/LuatOS软件开发；
博客
合宙海外模组硬核出击，Air780UA&Air780UU全新上市
01-10 715
Air780UA/UU系列模组——合宙基于紫光展锐UIS8850BM平台设计的LTE Cat.1无线通信模组，稳定可靠性能优秀，支持亚太、欧洲频段，且价格独具优势。
博客
全球最小？合宙“花生米”4G模组——Air700EL&Air700EY全新上市
01-08 1194
是花生米太大，还是Air700模组太小？”深受工程师朋友喜爱的Air700系列迷你小封装4G模组，也被称为“合宙花生米”。合宙花生米4G模组家族再添新成员——Air700EL、Air700EY。合宙Air700EL/Air700EY新品简介Air700EL/Air700EY——合宙基于移芯EC716S平台设计，全新推出的小尺寸4G-Cat.1系列无线通信模组。Air700EL为中国移动双模（支持TDD+FDD B3/B8，信号更好），Air700EY为中国移动单模（仅支持TDD，价格更低）。
博客
海外各国家&地区频段大揭秘
01-05 4869
1. 北美1.1 美国1.2 加拿大2. 欧洲2.1 德国2.2 英国2.3 法国2.4 俄罗斯2.5 奥地利2.6 比利时2.7 波斯尼亚和黑塞哥维那2.8 丹麦2.9 保加利亚2.10 克罗地亚2.11 捷克2.12 匈牙利2.13 意大利2.14 荷兰2.15 科索沃2.16 挪威2.17 丹麦2.18 摩尔多瓦共和国Moldova2.19 黑山2.20 波兰2.21 葡萄牙2.22 罗马利亚2.23 瑞
博客
Air780EG —— 合宙4G定位解决方案
08-18 6511
合宙低功耗Air780EG系列模组——基于移芯EC618平台设计开发，4G Cat.1通信+GNSS定位二合一，支持北斗/GPS双模卫星定位，行业通用1618小封装，可灵活应用于户外定位、资产管理、人员位置管理等定位应用场景。
博客
超低功耗在智能门锁行业的应用
08-10 603
1.在本体上以电子方式识别、处理人体生物特征信息、电子信息、网络通讯信息等并控制机械执行机构实施启闭的门锁”叫电子智能门锁。通俗地理解，智能门锁是电子信息技术与机械技术相结合的全新的锁具品类，是在传统机械锁基础上升级改进的，在用户的识别、管理安全等方面更加智能化、便利化的锁具。2.
博客
Air780E模块休眠控制应用指南
11-09 3583
Air780E支持多种省电模式，通过进入不同的省电模式达到降低功耗的目的。1.全功能模式（默认）：一般的工作模式，CPU，时钟全速运行。2.睡眠模式：CPU休眠，射频部分工作，周期进行寻呼，仅维持网络连接，能随时接收网络端的电话，短信等。功耗较低，主要的省电模式。可以通过GPIO中断，内部计时器中断，网络消息，来电，短信等唤醒。3.飞行模式：CPU休眠,射频与SIM卡关闭，无法注册网络，无法接收网络端的任何信息。功耗最低。只能通过发AT指令或者软件主动调用接口退出。注意：模块是否有进入睡眠模式，从外部
博客
Air780E模块PPP应用开发指南
10-24 4521
Air780E模块PPP应用开发指南
博客
Air780E模块RNDIS应用开发指南
10-24 4155
Air780E模块RNDIS应用开发指南
博客
Air780E模块AT开发环境搭建
10-24 1497
Air780E模块AT开发环境搭建
博客
Air780E模块AT固件和AT手册
10-24 2149
Air780E模块AT固件和AT手册
博客
Air780E模块AT开发简介
10-24 4849
Air780E模块AT开发简介

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值