logo资料库

Quectel_EC200x&EG912Y&EC600S系列_HTTP(S)_应用指导_V1.0.pdf

第1页 / 共37页
第2页 / 共37页
第3页 / 共37页
第4页 / 共37页
第5页 / 共37页
第6页 / 共37页
第7页 / 共37页
第8页 / 共37页
资料共37页,剩余部分请下载后查看
文档历史
目录
表格索引
1 引言
1.1. 适用模块
1.2. HTTP(S)命令使用流程
1.3. HTTP(S)头信息说明
1.3.1. 自定义HTTP(S)请求头信息
1.3.2. 输出HTTP(S)响应头信息
1.4. 数据模式说明
2 HTTP(S) AT命令详解
2.1. AT命令语句
2.1.1. 定义
2.1.2. AT 命令语句
2.2. AT命令详解
2.2.1. AT+QHTTPCFG 配置HTTP(S)服务器参数
2.2.2. AT+QHTTPURL 设置HTTP(S)服务器URL
2.2.3. AT+QHTTPGET 发送GET请求到HTTP(S)服务器
2.2.4. AT+QHTTPGETEX 发送范围GET请求到HTTP(S)服务器
2.2.5. AT+QHTTPPOST 通过UART/USB发送POST请求到HTTP(S)服务器
2.2.6. AT+QHTTPPOSTFILE 通过文件发送POST请求到HTTP(S)服务器
2.2.7. AT+QHTTPREAD 通过UART/USB读取HTTP(S)服务器响应信息
2.2.8. AT+QHTTPREADFILE 通过文件读取HTTP(S)服务器响应信息
2.2.9. AT+QHTTPSTOP 取消HTTP(S)请求
3 举例
3.1. 访问HTTP服务器
3.1.1. 发送HTTP GET请求并读取响应信息
3.1.2. 发送HTTP POST请求并读取响应信息
3.1.2.1. 通过UART/USB获取POST Body
3.1.2.2. 从文件系统获取POST Body
3.2. 访问HTTPS服务器
3.2.1. 发送HTTPS GET请求并读取响应信息
3.2.2. 发送HTTPS POST请求并读取响应信息
3.2.2.1. 从UART/USB获取POST Body
3.2.2.2. 从文件系统获取POST Body
4 常见问题处理
4.1. HTTP(S) AT命令执行失败
4.2. PDP激活失败
4.3. DNS解析失败
4.4. 数据模式进入失败
4.5. GET/POST请求发送失败
4.6. 响应信息读取失败
5 错误代码
6 HTTP(S)响应错误代码
7 附录
EC200x&EG912Y& EC600S 系列 HTTP(S)应用指导 LTE Standard 模块系列 版本:EC200x&EG912Y&EC600S 系列_HTTP(S)_应用指导_V1.0 日期:2020-09-15 状态:临时文件 www.quectel.com
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助,请随时 联系我司上海总部,联系方式如下: 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期(B 区)5 号楼 邮编:200233 电话:+86 21 51086236 邮箱:info@quectel.com 或联系我司当地办事处,详情请登录:http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题,可随时登陆如下网址: http://www.quectel.com/cn/support/technical.htm 或发送邮件至:support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害,上海移远通信技术股份有限公司 不承担任何责任。在未声明前,上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用,但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定,否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内,上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任,无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权,否则我司所提供文档和信息的接收方须对接收的文档和信 息保密,不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意,不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为,上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司,任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020,保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2020-09-15 刘康康 初始版本 上海移远通信技术股份有限公司 2 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 1.1. 适用模块 ...................................................................................................................................... 5 1.2. HTTP(S)命令使用流程 ................................................................................................................ 5 1.3. HTTP(S)头信息说明 .................................................................................................................... 6 1.3.1. 自定义 HTTP(S)请求头信息 ............................................................................................. 6 1.3.2. 输出 HTTP(S)响应头信息 ................................................................................................. 6 1.4. 数据模式说明 ............................................................................................................................... 6 2 HTTP(S) AT 命令详解 ............................................................................................................................ 8 2.1. AT 命令语句 ................................................................................................................................ 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句..................................................................................................................... 8 2.2. AT 命令详解 ................................................................................................................................ 8 2.2.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 .................................................................. 8 2.2.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL ................................................................ 12 2.2.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器.................................................... 12 2.2.4. AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 ....................................... 14 2.2.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 ................... 15 2.2.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 ........................ 17 2.2.7. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 ........................... 18 2.2.8. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 ................................ 18 2.2.9. AT+QHTTPSTOP 取消 HTTP(S)请求 ......................................................................... 19 3 举例 ...................................................................................................................................................... 21 3.1. 访问 HTTP 服务器 ..................................................................................................................... 21 3.1.1. 发送 HTTP GET 请求并读取响应信息 ............................................................................ 21 3.1.2. 发送 HTTP POST 请求并读取响应信息 ......................................................................... 22 3.1.2.1. 通过 UART/USB 获取 POST Body ..................................................................... 22 3.1.2.2. 从文件系统获取 POST Body .............................................................................. 23 3.2. 访问 HTTPS 服务器................................................................................................................... 24 3.2.1. 发送 HTTPS GET 请求并读取响应信息 ......................................................................... 24 3.2.2. 发送 HTTPS POST 请求并读取响应信息 ....................................................................... 26 3.2.2.1. 从 UART/USB 获取 POST Body ........................................................................ 26 3.2.2.2. 从文件系统获取 POST Body .............................................................................. 27 4 常见问题处理........................................................................................................................................ 29 4.1. HTTP(S) AT 命令执行失败 ........................................................................................................ 29 4.2. PDP 激活失败............................................................................................................................ 29 上海移远通信技术股份有限公司 3 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 4.3. DNS 解析失败 ........................................................................................................................... 29 4.4. 数据模式进入失败 ..................................................................................................................... 30 4.5. GET/POST 请求发送失败 ......................................................................................................... 30 4.6. 响应信息读取失败 ..................................................................................................................... 30 5 错误代码 ............................................................................................................................................... 31 6 HTTP(S)响应错误代码 ......................................................................................................................... 33 7 附录 ...................................................................................................................................................... 34 上海移远通信技术股份有限公司 4 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 表格索引 表 1:适用模块 .............................................................................................................................................. 5 表 2:AT 命令及响应类型 .............................................................................................................................. 8 表 3:错误代码列表 ..................................................................................................................................... 31 表 4:HTTP(S)响应代码列表........................................................................................................................ 33 表 5:参考文档 ............................................................................................................................................ 34 表 6:术语缩写 ............................................................................................................................................ 34 上海移远通信技术股份有限公司 4 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 1 引言 EC200x&EG912Y&EC600S 系列模块为 HTTP(S)服务器提供 HTTP(S)应用程序。本文档主要介绍了 与 HTTP(S)相关的 AT 命令。 1.1. 适用模块 表 1:适用模块 模块系列 模块 EC200x 系列 EC200T 系列 EC200S-CN EG912Y 系列 EG912Y 系列 EC600S EC600S-CN 1.2. HTTP(S)命令使用流程 通过 EC200x&EG912Y&EC600S 系列模块 TCP/IP AT 命令,可配置 PDP 上下文,激活/去激活上下 文以及查询 PDP 上下文状态。通过 EC200x&EG912Y&EC600S 系列模块的 HTTP(S) AT 命令,可以发送 HTTP(S) GET/POST 请求到 HTTP(S)服务器,并读取来自 HTTP(S)服务器的响应结果。大致流程如下: 第一步,使用 AT+QICSGP 配置 PDP 上下文的和其他参数,参 见文档[1]。 第二步,通过 AT+QIACT 激活 PDP 上下文后,可使用 AT+QIACT?查询已分配的 IP 地址,参见文档 [1]。 第三步,通过 AT+QHTTPCFG 配置 PDP 和 SSL 上下文 ID。 第四步,通过 AT+QSSLCFG 配置 SSL 上下文参数,参见文档[3]。 第五步,通过 AT+QHTTPURL 设置 HTTP(S) URL。 上海移远通信技术股份有限公司 5 / 35
EC200x&EG912Y&EC600S 系列 HTTP(S)应用指导 第六步,发送 HTTP(S)请求。AT+QHTTPGET 用于发送 HTTP(S) GET 请求,AT+QHTTPPOST 或 AT+QHTTPPOSTFILE 用于发送 HTTP(S) POST 请求。 第七步,通过 AT+QHTTPREAD 或 AT+QHTTPREADFILE 读取 HTTP(S)响应信息。 第八步,通过 AT+QIDEACT 去激活 PDP 上下文,参见文档[1]。 1.3. HTTP(S)头信息说明 1.3.1. 自定义 HTTP(S)请求头信息 模块自动填补 HTTP(S)请求头信息,用户可通过 AT+QHTTPCFG 将配置为 1 自定 义 HTTP(S)请求头信息,但需遵循以下标准:  遵循 HTTP(S)头信息语句规范。  HTTP(S)请求行中的 URI 值和 Host:头信息必须与 AT+QHTTPURL 命令配置的 URL 一致。  HTTP(S)请求头信息必须以结尾。 以下为标准 HTTP(S) POST 请求头信息示例: POST /processorder.php HTTP/1.1 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 1.3.2. 输出 HTTP(S)响应头信息 模块不自动输出 HTTP(S)响应头信息,可通过 AT+QHTTPCFG 将配置为 1 获取 HTTP(S)响应头信息,然后执行 AT+QHTTPREAD 或 AT+QHTTPREADFILE 命令,HTTP(S)响应头信息 将以 HTTP(S)响应体形式输出。 1.4. 数据模式说明 上海移远通信技术股份有限公司 6 / 35
分享到:
收藏