logo资料库

移远中文Quectel_LTE_Standard_TCP(IP)_应用指导_V1.0.pdf

第1页 / 共46页
第2页 / 共46页
第3页 / 共46页
第4页 / 共46页
第5页 / 共46页
第6页 / 共46页
第7页 / 共46页
第8页 / 共46页
资料共46页,剩余部分请下载后查看
文档历史
目录
表格索引
1 引言
1.1. 使用TCP/IP命令的流程
1.2. 数据访问模式说明
2 TCP/IP AT命令详解
2.1. AT命令说明
2.1.1. AT+QICSGP 配置TCP/IP 场景参数
2.1.2. AT+QIACT 激活PDP场景
2.1.3. AT+QIDEACT 去激活PDP场景
2.1.4. AT+QIOPEN 打开Socket服务
2.1.5. AT+QICLOSE 关闭Socket服务
2.1.6. AT+QISTATE 查询Socket服务状态
2.1.7. AT+QISEND 发送数据
2.1.8. AT+QIRD 读取收到的TCP/IP数据
2.1.9. AT+QISENDEX 发送16进制字符串数据
2.1.10. AT+QISWTMD 切换数据访问模式
2.1.11. AT+QPING 进行远程服务器Ping操作
2.1.12. AT+QNTP 使用NTP服务器同步本地时间
2.1.13. AT+QIDNSCFG 配置DNS服务器地址
2.1.14. AT+QIDNSGIP 用域名获取IP地址
2.1.15. AT+QICFG 配置可选参数
2.1.16. AT+QISDE 控制是否回显AT+QISEND的数据
2.1.17. AT+QIGETERROR 查询上一个错误代码
2.2. URC说明
2.2.1. 连接断开URC
2.2.2. 数据接收URC
2.2.3. 客户端连接已满URC
2.2.4. 客户端连接URC
2.2.5. PDP去激活URC
3 示例
3.1. 场景配置和激活
3.1.1. 场景配置
3.1.2. 场景激活
3.1.3. 场景去激活
3.2. TCP客户端在非透传Buffer模式下工作
3.2.1. 创建TCP客户端连接并进入非透传Buffer模式
3.2.2. Buffer模式下发送数据
3.2.3. Buffer模式下从远处服务器接收数据
3.2.4. 断开连接
3.3. TCP客户端在透传模式下工作
3.3.1. 创建TCP客户端连接并进入透传模式
3.3.2. 透传模式下发送数据
3.3.3. 透传模式接收远程器端数据
3.3.4. 断开TCP客户端连接
3.4. TCP客户端在非透传Push模式下工作
3.4.1. 创建TCP客户端连接并进入非透传Push模式
3.4.2. 非透传Push模式下发送数据
3.4.3. 非透传Push模式下接收远程服务器端数据
3.4.4. 断开TCP用户端连接
3.5. TCP服务器在非透传Buffer模式下工作
3.5.1. 启动TCP服务器
3.5.2. 接受客户端的连接请求
3.5.3. 接收的客户端数据
3.5.4. 断开TCP服务器连接
3.6. UDP服务示例
3.6.1. 打开UDP服务
3.6.2. 向服务器发送UDP数据
3.6.3. 接收远程端数据
3.6.4. 关闭UDP服务
3.7. PING
3.8. 同步本地时间
3.9. 获取上一个错误代码示例
4 错误代码
5 附录A 术语缩写
LTE Standard TCP/IP 应用指导 LTE Standard 模块系列 版本:LTE_Standard_TCP/IP_应用指导_V1.0 日期:2019-10-28 状态:受控文件 www.quectel.com
LTE Standard TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助,请随时 联系我司上海总部,联系方式如下: 上海移远通信技术股份有限公司 上海市闵行区田林路 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 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失,本公司不承担任何责任。在未 声明前,上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司,任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019,保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 45
LTE Standard TCP/IP 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2019-10-28 李柱 初始版本 上海移远通信技术股份有限公司 2 / 45
LTE Standard TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 使用 TCP/IP 命令的流程 ............................................................................................................. 6 1.2. 数据访问模式说明 ....................................................................................................................... 8 2 TCP/IP AT 命令详解 ............................................................................................................................ 10 2.1. AT 命令说明 .............................................................................................................................. 10 2.1.1. AT+QICSGP 配置 TCP/IP 场景参数 ........................................................................... 10 2.1.2. AT+QIACT 激活 PDP 场景 .......................................................................................... 11 2.1.3. AT+QIDEACT 去激活 PDP 场景 ................................................................................... 12 2.1.4. AT+QIOPEN 打开 Socket 服务 ................................................................................... 13 2.1.5. AT+QICLOSE 关闭 Socket 服务 ................................................................................. 15 2.1.6. AT+QISTATE 查询 Socket 服务状态 ........................................................................... 15 2.1.7. AT+QISEND 发送数据 ................................................................................................. 17 2.1.8. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 19 2.1.9. AT+QISENDEX 发送 16 进制字符串数据 .................................................................... 21 2.1.10. AT+QISWTMD 切换数据访问模式 .............................................................................. 21 2.1.11. AT+QPING 进行远程服务器 Ping 操作 ....................................................................... 22 2.1.12. AT+QNTP 使用 NTP 服务器同步本地时间 .................................................................. 23 2.1.13. AT+QIDNSCFG 配置 DNS 服务器地址 ....................................................................... 24 2.1.14. AT+QIDNSGIP 用域名获取 IP 地址 ............................................................................. 25 2.1.15. AT+QICFG 配置可选参数 ............................................................................................ 25 2.1.16. AT+QISDE 控制是否回显 AT+QISEND 的数据 .......................................................... 29 2.1.17. AT+QIGETERROR 查询上一个错误代码 .................................................................... 30 2.2. URC 说明 .................................................................................................................................. 30 2.2.1. 连接断开 URC ................................................................................................................ 31 2.2.2. 数据接收 URC ................................................................................................................ 31 2.2.3. 客户端连接已满 URC ..................................................................................................... 32 2.2.4. 客户端连接 URC ............................................................................................................. 32 2.2.5. PDP 去激活 URC ........................................................................................................... 33 3 示例 ...................................................................................................................................................... 34 3.1. 场景配置和激活 ......................................................................................................................... 34 3.1.1. 场景配置 ......................................................................................................................... 34 3.1.2. 场景激活 ......................................................................................................................... 34 3.1.3. 场景去激活 ..................................................................................................................... 34 3.2. TCP 客户端在非透传 Buffer 模式下工作 ................................................................................... 34 3.2.1. 创建 TCP 客户端连接并进入非透传 Buffer 模式 ............................................................ 34 3.2.2. Buffer 模式下发送数据 ................................................................................................... 35 3.2.3. Buffer 模式下从远处服务器接收数据 .............................................................................. 35 上海移远通信技术股份有限公司 3 / 45
LTE Standard TCP/IP 应用指导 3.2.4. 断开连接 ......................................................................................................................... 36 3.3. TCP 客户端在透传模式下工作 .................................................................................................. 36 3.3.1. 创建 TCP 客户端连接并进入透传模式 ........................................................................... 36 3.3.2. 透传模式下发送数据 ....................................................................................................... 36 3.3.3. 透传模式接收远程器端数据 ............................................................................................ 36 3.3.4. 断开 TCP 客户端连接 ..................................................................................................... 37 3.4. TCP 客户端在非透传 Push 模式下工作 .................................................................................... 37 3.4.1. 创建 TCP 客户端连接并进入非透传 Push 模式 .............................................................. 37 3.4.2. 非透传 Push 模式下发送数据 ......................................................................................... 37 3.4.3. 非透传 Push 模式下接收远程服务器端数据 ................................................................... 38 3.4.4. 断开 TCP 用户端连接 ..................................................................................................... 38 3.5. TCP 服务器在非透传 Buffer 模式下工作 ................................................................................... 38 3.5.1. 启动 TCP 服务器 ............................................................................................................ 38 3.5.2. 接受客户端的连接请求 ................................................................................................... 38 3.5.3. 接收的客户端数据 .......................................................................................................... 38 3.5.4. 断开 TCP 服务器连接 ..................................................................................................... 39 3.6. UDP 服务示例 ........................................................................................................................... 39 3.6.1. 打开 UDP 服务 ............................................................................................................... 39 3.6.2. 向服务器发送 UDP 数据 ................................................................................................. 39 3.6.3. 接收远程端数据 .............................................................................................................. 40 3.6.4. 关闭 UDP 服务 ............................................................................................................... 40 3.7. PING .......................................................................................................................................... 40 3.8. 同步本地时间 ............................................................................................................................. 41 3.9. 获取上一个错误代码示例 .......................................................................................................... 41 4 错误代码 ............................................................................................................................................... 42 5 附录 A 术语缩写 .................................................................................................................................. 44 上海移远通信技术股份有限公司 4 / 45
LTE Standard TCP/IP 应用指导 表格索引 表 1:错误代码列表 ........................................................................................................................................... 42 表 2:术语缩写 .................................................................................................................................................. 44 上海移远通信技术股份有限公司 5 / 45
LTE Standard TCP/IP 应用指导 1 引言 移远通信 LTE Standard 模块内置 TCP/IP 协议栈,Host 可以直接通过 AT 命令访问网络,在很大程度 上可降低对 PPP 和 TCP/IP 协议栈的依赖性,从而降低成本。LTE Standard 模块可提供 TCP 客户端、UDP 客户端、TCP 服务器、UDP 服务器等 Socket 服务。 该文档适用于以下移远通信模块:  EC2x:EC25、EC21、EC20 R2.0 和 EC20 R2.1  EG2x-G:EG25-G、EG21-G  EG9x:EG91、EG95  EM05  EP200F 1.1. 使用 TCP/IP 命令的流程 通过 TCP/IP AT 命令,Host 可以配置 PDP 场景、激活/去激活场景、建立/关闭 Socket 服务,并通过 Socket 服务发送/接收数据。下图说明了 TCP/IP AT 命令的流程: 上海移远通信技术股份有限公司 6 / 45
LTE Standard TCP/IP 应用指导 图 1:TCP/IP AT 命令使用流程图 上海移远通信技术股份有限公司 7 / 45 给模块上电并开机 通过"AT+CPIN?"命令查询(U)SIM卡状态查询(U)SIM卡状态:执行AT+CPIN,如果20s后命令AT+CPIN无法识别(U)SIM卡状态,建议重启模块建议开关机流程:1.关机:发送"AT+QPOWD",等待12s以上,直接断电。2. 开机:先使Power Key按键处于低电平状态,等待2s后,再拉高Power Key 通过"AT+CREG?"命令查询CS业务的状态CS业务:1. 当 "AT+CREG?" 结果中的等于 1 或者5,表示模块已经注册上CS业务2. 如果在90s内没有注册上CS业务,建议重启模块通过"AT+QIACT="和"AT+QIACT"命令激活指定的PDP Context激活PDP Context:1. 通过 "AT+QIACT=" 激活PDP Context2. 通过 "AT+QIACT?" 查询PDP Context IP地址注意事项:a) 以上命令必须按顺序执行b) 如果等待150s后,"AT+QIACT"没有响应,建议重启模块.c) 如果连续3次反激活PDP Context失败,建议重启模块3. 反激活PDP Context:如果等待40s后"AT+QIDEACT"没有响应,建议重启模块通过AT+QIOPEN命令打开连接通过AT+QISEND=命令 发送数据通过"AT+QISEND=,0"命令查询发送的数据是否成功被接收 通过"AT+QICLOSE=" 关闭连接通过"AT+QIDE ACT="命令反激活指定的PDP Context60s内注册上CS业务如果在90s内,没有注册上CS业务,建议重启模块识别(U)SIM卡PDP Context激活成功如果等待10s,无响应,建议重启模块+QIOPEN:,在收到ACK 90s后PS 业务:1. 当 "AT+CGREG?/AT+CEREG?" 结果中的等于 1 或者5,表示模块已在UMTS/LTE网络注册上PS业务2. 等待60s后,不管是否注册上PS业务,都进入下一个流程如果在20s内无法识别(U)SIM状态,建议重启模块1. 如果等待150s后,没有收到结果,建议重启模块.2. 如果连续3次反激活PDP context失败,建议重启模块注意事项:1.请注意必须接收到上一个AT命令的执行结果后(例如:"OK"/"CME ERROR"/"CMS ERROR"),才能执行下一个AT命令。一般情况下,如果在60s内没有收到AT命令执行结果,建议重启模块。2.若150s内未收到"AT+QIACT"响应,10s内未收到"AT+QICLOSE"响应,40s内未收到"AT+QIDEACT"响应,建议重启模块。3.不建议频繁重启模块。如果因为执行AT命令连续3次重启模块失败,此后第一次可立即重启,然后等待10分钟,再进行第二次重启,如果仍重启失败,建议等待30分钟,再进行第三次重启,以此类推,逐渐增大重启的时间间隔。60s内通过"AT+CGREG?/AT+CEREG?"命令查询PS业务的状态PDP Context激活失败1. 连续5次打开连接失败2. 150s内无响应90s内未收到ACKOKPDP Context 反激活成功如果等待40s,没有响应,建议重启模块打开连接:1. 如果等待150s,没有收到"AT+QIOPEN"的响应,请关闭连接。2.如果连续5次打开连接失败,先反激活PDP Context,然后重新激活PDP Context并再次打开连接。发送AT命令并等待响应结果 "OK"TCP连接的维护和检测:1. 通过 "AT+QISEND=[,]" 发送数据。建议定期向远程端发送小数据包以维护和检测TCP连接。2. 通过 "AT+QISEND=,0" 查询ACK的发送。如果在2分钟后(每5s查询一次,一共查询24次),对方没有收到数据,说明TCP连接可能出现异常,请执行"AT+QICLOSE"命令关闭这个TCP连接,然后通过"AT+QIOPEN"重新建立TCP连接。通过如下AT命令来配置PDP场景和Qos参数:"AT+QICSGP/AT+CGQREQ/AT+CGEQREQ/AT+CGQMIN/AT+CGEQMIN"配置PDP Context激活参数:1. 通过 "AT+QICSGP" 命令配置APN,User Name,Password 和Auth Type2. 通过 "AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ" 配置 QoS 参数
分享到:
收藏