合宙Air780EP低功耗4G模组—AT开发HTTP应用指南

Air780EP是合宙推出的一款低功耗4G全网通模组,兼容模组行业1618经典封装,支持OpenCPU开发及全功能数传AT开发,可广泛应用于多样化的物联网终端。

上周写了基于Air780EP模组AT开发的FOTA远程升级指南有客户朋友询问能否讲讲HTTP应用部分?本期特别安排——涵盖HTTP基本应用流程、GET/POST/SSL请求示例、断点续传、常见问题等内容。

一、相关准备工作 


1.1 硬件准备

  • 合宙EVB_Air780EP开发板一套,包括天线、SIM卡;

  • USB线

  • PC电脑

1.2 软件准备

  • 串口调试工具
    如果没有准备,推荐使用LLCOM:
    https://llcom.papapoi.com

  • AT固件下载
    https://gitee.com/openLuat/airm2m-ec718-at/releases

进入AT固件下载页面按下Ctrl+F,搜索AirM2M_780EP_LTE_AT,即可找到Air780EP模块所使用的AT固件。

本文使用示例为:
AirM2M_780EP_V1007_LTE_AT版本固件

推荐选用:相关型号固件名称后面数字版本号最高的最新relase版本进行调试。

二、HTTP应用基本流程 


合宙低功耗4G模块支持HTTP和HTTPS协议,HTTP应用的基本流程如下:


  1. 激活PDP

  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步开始重新执行。

三、HTTP GET请求示例 


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

相关注意事项:

01. 请求及应答

发送AT+HTTPACTION命令后,收到OK仅仅表示4G模块开始处理这条命令,并不表示请求发送成功,收到了应答。

只有收到+HTTPACTION: n,statusCode,len才表示请求结束,statusCode表示应答成功,其余都表示应答失败。

02. 数据大小限制

HTTP应答数据的缓冲区大小为4KB,如果返回的http body数据超过了这个大小,则需要断点下载——可以使用AT+HTTPPARA命令,通过设置BREAK和BREAKEND参数来实现。

03. HTTP被动断开

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

04. 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被动去激活,为异常处理的触发点。


四、HTTP POST请求示例 


POST请求流程与GET流程基本一致,只有指令参数:

AT+HTTPACTION=0
变为:
AT+HTTPACTION=1

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



五、HTTPS SSL请求示例 


本示例为带SSL证书双向验证功能的HTTPS过程,具体指令和参数使用说明,可参考AT指令手册:

六、HTTP断点续传示例 


在实际的应用场景中,可能需要下载一个非常大的文件,例如几百K字节、几M字节,但是4G模块中HTTP可用的内存缓冲区Air780EP模块只有4KB左右。当文件大小超过这个缓冲区时,就要使用断点续传功能来分段下载处理了。

下文以“下载一个119345字节的文件”为例,来说明如何使用断点续传功能(注意:本示例仅仅演示了正常流程的HTTP AT命令,完整流程以及异常处理流程请参考本文应用流程部分)。


七、常见问题Q&A 


以下针对客户朋友们实际应用中的反馈,整理了HTTP应用中的常见问题:

01. HTTP支持多连接吗?

目前HTTP仅支持单连接,不支持多连接。

02. HTTPS如何使用?

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


03. 重试多次PDP,HTTP应用一直连接失败?

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

  • 使用RESET引脚复位模块;

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


04. HTTP下载的大文件,如何可靠的发送给MCU(AT流控)?

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

AT+HTTPREAD

+HTTPREAD: 3072

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

OK 


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

模块支持硬件流控和软件流控两种:


硬件流控,参考如下步骤操作:

  • 模块和MCU的UART口,CTS、RTS要交叉相连

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

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


软件流控,参考如下步骤操作:

  • MCU端固件要支持并且打开软流控功能

  • MCU端要发送AT+IFC=1,1命令到模块端,打开模块端的软流控功能


05. 为什么我只发了10字节消息,100次却消耗了很多流量?

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

06. 为什么频繁请求会失败?

HTTP连接总数数量有限,且不支持HTTP2多路复用连接,因此建议等一个HTTP连接返回请求结果之后,再去请求下一个连接;不要使用循环定时器方式不断的发起新的HTTP请求。

07. 如何POST文件?

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

08. 数据发送接收缓存问题如何解决?

AT版本有缓存机制,内存中有一个的缓冲区(Air780EP模块AT固件HTTP缓存为4KB),发送和接受使用的是同一块缓冲区。

发送和收到数据后,插入此缓冲区,然后通过AT口输出URC,提示收到的数据长度;缓冲区满之后,再收到新数据,会丢弃新收到的数据,并通过AT口输出URC提示出错;需要读取数据时,发送AT+HTTPREAD命令读取,可分段读取,也可全部读取。

特别注意:

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


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343

推荐阅读更多精彩内容