移远EC2x&EG9x&EM05_TCP/IP_AT_Commands_Manual_V1.0

最新推荐文章于 2022-02-28 16:19:36 发布

舒泽

最新推荐文章于 2022-02-28 16:19:36 发布

阅读量1.9k

点赞数 1

分类专栏： 4G 文章标签： 4G

原文链接：https://blog.csdn.net/jingliuting/article/details/90368773

版权

4G 专栏收录该内容

0 篇文章 0 订阅

订阅专栏

1、介绍

Quectel EC2x 模块具有嵌入式 TCP/IP堆栈，使主机可以通过 AT 命令直接上网。可以实现TCP客户端、UDP客户端、TCP服务器和UDP服务器。

1.1 使用 AT 命令的过程

开启模块电源，发送 AT指令，等待模块返回 OK。
1. 开机过程：保持电源键拉低 2 秒，然后拉高。
2. 关机过程：发送 AT + QPOWD 命令，再过12 秒后，切断电源。
查询 SIM 卡状态（AT + CPIN？），如果 20 秒后还无法识别 SIM 卡，重新启动模块。
1. 如果返回 1 或 5 ，代表 CS 服务注册成功。
查询 CS 服务（AT + CREG？），如果 90秒后未能在 CS 上注册域名服务，重新启动模块。
在 60秒内成功注册CS域名服务后，查询 PS 服务（AT + CGREG？/AT + CEREG?）
1. 如果返回 1 或 5 ，代表 PS 服务注册成功。
配置 PDP 上下文和 Qos（AT+QICSGP/AT+CGQREQ/AT+CGEQREQ/AT+CGQMIN/AT+CGEQMIN）
激活 PDP 上下文（AT+QIACT=<CONTEXTID>和 AT+QiACT？）
1. 如果 150 秒内没有回应，则需重启模块。
2. 如果重试 3 次都无法激活 PDP，则需停用 PDP 上下文（AT+QIDEACT=<CONTEXTID>），停止成功，转到第 2 步（查询SIM卡状态）重新执行。如果 3 次都没停止成功或超过40秒没有回应，则重启模块。
打开连接（AT+QIOPEN），返回 connectID，err
1. 如果重试 5 次或 150 秒内都没连接成功，则需停止 PDP后，转到第 6 步（激活 PDP 上下文）。
发送数据（AT+QISEND=<connectID>）
1. 发送数据后，每 5 秒发送一次确认，如果 24 次后仍未确认，可能 TCP 连接异常，需要关闭当前连接，转到第 7 步（打开连接）重新建立连接。
2. TCP心跳：定时发送小数据包，来检测 TCP 连接是否正常。
关闭连接（AT+QICLOSE=<connectID>）
1. 如果 10 秒内无法关闭连接，需要重新启动模块。

1.2 数据访问模式

Buffer access mode （缓冲区访问模式）
- 可以通过 AT+QISEND命令发送数据，收到互联网数据时，先保存到缓冲区，并发送 URC 报告（+QIURC：“recv”，<connectID>）。客户端可以通过 AT+QIRD 命令读取数据。
Direct push mode （直推模式）
- 可以通过 AT+QISEND命令发送数据，收到互联网数据时，数据直接输出到客户端（+QIURC：“recv”，<connectID><CR><LF><data>）。
Transparent access mode （透明访问模式，透传）
- 客户端直接发送数据到互联网，接收的数据直接输出到客户端。
- 模块切换到缓冲区访问模式。客户端可以使用 “+++”退出透传模式。返回 OK 。退出透传模式时，为了防止 “+++” 被解释为数据，输入 “+++” 之前和之后，1 秒内不能输入任何字符。
- 可以通过 AT+QISWTMD 命令返回透传模式。将<access_mode>设为 2。如果成功进入透传模式，将返回 CONNECT。
- 如果ATO从透明访问模式退出后。如果成功重新进入透明访问模式，将返回“CONNECT” 。如果没有进入透明访问模式，ATO将返回“NO CARRIER”。

2、TCP / IP AT命令的描述

2.1、AT命令的描述

AT+QICSGP 配置TCP / IP参数

该命令可用于配置<APN>，<username>，<password>等TCP / IP上下文参数。QoS设置可以由AT + CGQMIN，AT + CGEQMIN，AT + CGQREQ和AT + CGEQREQ配置。

AT+QICSGP=?：查询命令参数。
AT+QICSGP=<contextID>：查询 contextID的配置信息。
AT+QICSGP=<contextID>[,<context_type>,<APN>[,<username>,<password>)[,<authentication>]]]：配置 contextID信息。
- <contextID>：整数类型。上下文ID。范围是1-16。
- <context_type>：整数类型。协议类型。1（IPV4）、2（IPV4V6）。
- <APN>：字符串类型。接入点名称。
- <username>：字符串类型。用户名。
- <password>：字符串类型。密码。
- <authentication>：整数类型。身份验证方法。0（没有）、1（PAP）、2（CHAP）、3（PAP或CHAP）。
- 返回信息：OK 或 ERROR。

AT+QIACT 激活 PDP 上下文

在PDP上下文激活之前,应该配置TCP/IP参数。激活后，通过 AT+QIACT 可以查询IP地址。根据3GPP规范中,该模块同时只支持三个PDP上下文激活，所以客户必须确保PDP上下文激活的数量小于3。根据网络，在 150 秒内返回 OK 或 ERROR，然后执行 AT+QIACT？。在这之前不能执行任何命令。

AT+QIACT=? ：查询命令参数
AT+QIACT?：查询当前激活的 PDP 上下文信息。
- <contextID>：激活的 PDP 上下文 ID。
- <context_state>：整数类型。上下文状态。0（停用）、1（活动）
- <context_type>：协议类型。1（IPV4）、2（IPV4V6）。
- <IP_address>：本地 IP 地址。
AT+QIACT=<contextID>：激活 PDP 上下文。
- <contextID>：激活的 PDP 上下文 ID。
- 返回信息：OK 或 ERROR、超时时间 150 秒。

AT+QIDEACT 停用 PDP 上下文

AT+QIDEACT=?：查询命令参数。
AT+QIDEACT=<contextID> ：停用指定 PDP 上下文。返回 OK 或 ERROR，超时时间 40 秒。

AT+QIOPEN 打开 Socket 服务

该命令用于打开套接字服务。

AT+QIOPEN=?：查询命令参数。
AT+QIOPEN=<contextID>,<connectID>,<service_type>,<IP_address>/<domain_name>,<remote_port>[,<local_po CONNECTrt>[,<access_mode>]] ：打开 Socket 服务。
- <contextID> ：整数类型。上下文ID。范围是1-16。
- <connectID> ：整数类型。套接字服务索引。范围是0-11。
- <SERVICE_TYPE>：字符串类型。套接字服务类型。
  - “ TCP ” ：作为客户端启动TCP连接
  - “ UDP ”：作为客户端启动UDP连接
  - “TCP LISTENER” ：启动TCP服务器以侦听TCP连接
  - “UDP SERVICE” ：启动UDP服务
- <IP_address>：字符串类型。
  - 如果<service_type>是TCP或UDP ，则表示远程服务器的IP地址，例如 “220.180.239.212”。
  - 如果<service_type>是TCP LISTENER或UDP SERVICE 地址，请输入“127.0.0.1”。
- <domain_name>：字符串类型。远程服务器的域名地址。
- <remote_port> ：远程服务器的端口，仅在<service_type>为“TCP”或“UDP”时有效。范围是0-65535。
- <LOCAL_PORT> ：本地端口。范围是0-65535。
  - 如果<service_type>是“TCP LISTENER”或“UDP SERVICE”，则此参数必须指定。
  - 如果<service_type>是“TCP”或“UDP”。如果<local_port>为0，那么本地端口将是自动分配。否则，将按指定分配本地端口。
- <access_mode> ：整数类型。套接字服务的数据访问模式。
  - 0：缓冲区访问模式
  - 1：直推模式
  - 2：透明访问模式
- <err>：整数类型。操作的错误代码。请参阅第4章。

A T + QICLOSE关闭套接字服务

该命令用于关闭指定的套接字服务。根据网络的不同，最多需要一次 10秒（默认值，可以通过<timeout>修改）在执行后返回“ OK ” 或“ ERROR ”AT + QICLOSE。在返回响应之前，无法执行其他AT命令。

AT + QICLOSE =？：返回命令参数。
AT + QICLOSE = <connectID> [，<timeout>]：如果成功关闭，响应： OK，如果未能关闭，则回复：错误
- <connectID> ：整数类型。套接字服务索引。范围是0-11。
- <timeout>：整数类型。如果在<timeout>内没有收到其他对等体的FIN ACK，则
  模块将强制关闭套接字。范围是1-65535，默认值是10。单位：秒。

AT+QISTATE 查询套接字服务状态

该命令用于查询套接字服务状态。如果<query_type>为0，则返回所有现有套接字服务状态。如果<query_type>为1，则返回指定的套接字服务状态。

AT+QISTATE=?：测试模块返回是否正常。
AT+QISTATE? or AT+QISTATE：返回所有套接字的信息。
AT+QISTATE=<query_type>,<contextID>：查询指定上下文的所有套接字的连接状态。
- <query_type>：整数类型。查询类型。
  - 0：查询指定上下文的连接状态
  - 1：查询指定套接字服务的连接状态
- <contextID> ：整数类型。上下文ID。范围是1-16。
- <connectID> ：整数类型。套接字服务索引。范围是0-11。
- <SERVICE_TYPE>：字符串类型。套接字服务类型。
  - “ TCP ” ：作为客户端启动TCP连接
  - “ UDP ”：作为客户端启动UDP连接
  - “TCP LISTENER” ：启动TCP服务器以侦听TCP连接
  - “TCP INCOMING”：启动TCP服务器接受的TCP连接
  - “UDP SERVICE” ：启动UDP服务
- <IP_address>：字符串类型。
  - 如果<service_type>是TCP或UDP ，则表示远程服务器的IP地址，例如 “220.180.239.212”。
  - 如果<service_type>是TCP LISTENER或UDP SERVICE 地址，请输入“127.0.0.1”。
- <remote_port> ：远程服务器的端口，仅在<service_type>为“TCP”或“UDP”时有效。范围是0-65535。
- <LOCAL_PORT> ：本地端口。范围是0-65535。
  - 如果<service_type>是“TCP LISTENER”或“UDP SERVICE”，则此参数必须指定。
  - 如果<service_type>是“TCP”或“UDP”。如果<local_port>为0，那么本地端口将是自动分配。否则，将按指定分配本地端口。
- <socket_state>：整数类型。套接字服务状态
  - 0：“初始”：尚未建立连接
  - 1：“打开”：客户端正在连接或服务器正在尝试l isten
  - 2：“已连接”：已建立客户端/传入连接
  - 3：“侦听”：服务器在侦听客户端连接”
  - 4：“关闭”：连接正在关闭
- <serverID>：仅在<service_type>为“TCP INCOMING”时有效。<serverID>代表哪个服务器接受此TCP传入连接，其值与之相同此服务器的“TCP LISTENER”的<connectID>。
- <access_mode> ：整数类型。套接字服务的数据访问模式。
  - 0：缓冲区访问模式
  - 1：直推模式
  - 2：透明访问模式
- <AT_port>：字符串类型。套接字服务的COM端口。
  - “usbmodem” ：USB MODEM端口
  - “USBAT” ：USB AT PORT
  - “UART1” ：UART PORT1
  - “cmux1” ：MUX PORT 1
  - “cmux2” ：MUX PORT 2
  - “cmux3” ：MUX PORT 3
  - “cmux4”：MUX PORT 4

A T + QISEND发送数据

如果指定套接字服务的<access_mode>是缓冲区访问模式或直接推送模式，则数据可以是通过AT + QISEND发送。如果数据成功发送到模块，将返回“ SEND OK ” 。否则它将返回“ SEND FAIL ” 或“ ERROR ” 。“ SEND FAIL ” 表示发送缓冲区已满客户可以尝试重新发送数据。“ERROR”表示在发送过程中遇到错误数据。客户应该延迟一段时间来发送数据。最大数据长度为1460字。“SEND OK”并不意味着数据已成功发送到服务器。客户可以查询数据是否通过AT + QISEND = <connectID>，0命令到达服务器。透传模式下不需要AT指令发送数据

AT + QISEND =？：所有命令的这种格式（=？）的作用是测试模块是否支持此指令。
AT+QISEND=<connectID>：指定通过那个连接发送不定长的数据。输入完数据后按 CTRL+Z 发送，或按ESC取消发送，如果缓冲区满返回 SEND FAIL，如果连接关闭或参数错误则返回 ERROR。
AT+QISEND=<connectID>,<send_length>：发送定长的数据，在提示符 “>" 后输入数据，长度到达指定值时将自动发送数据。如果缓冲区满返回 SEND FAIL，如果连接关闭或参数错误则返回 ERROR。
AT+QISEND=<connectID>,<send_length>,<remoteIP>,<remote_port> ：当服务类型是UDP SERVICE时，使用这条语句发送。流程同上。
AT + QISEND = <connectID>，0：当数据长度为0时，语句的作用就是查询发送缓冲区状态。
- <connectID>：整数类型。套接字服务索引。范围是0-11。
- <send_length>：整数类型。要发送的数据长度，不能超过1460字节。
- <remoteIP>：字符串类型。远程IP地址（必须是点格式），仅在<service_type>是“UDP SERVICE”时才有效。
- <remote_port> ：整数类型。远程端口，仅在<service_type>为“UDP SERVICE”时有效。
- <total_send_length>：整数类型。发送数据的总长度。单位：字节。
- <ackedbytes>：整数类型。确认数据的总长度。单位：字节。
- <unackedbytes>：整数类型。未确认数据的总长度。单位：字节。
- <err>：整数类型。操作的错误代码。请参阅第4章。

AT+QIRD 检索 TCP/IP 数据

在缓冲区访问模式下，模块接收数据后，将数据存入缓冲区，并报告“ + QIURC：“recv”，<connectID>“ ，然后AT + QIRD可以检索数据。请注意，如果缓冲区不为空，并且模块再次接收数据，则不会报告新的数据URC，直到通过AT + QIRD从缓冲区检索到所有接收到的数据。

AT+QIRD=?：测试命令
AT+QIRD=<connectID>[,<read_length>]：当<service_type>是“TCP” / “ UD P” / “TCP INCOMING”时如果指定的连接已收到数据，则响应：+ QIRD：<read_actual_length> <CR> <LF> <data>
AT + QIRD = <connectID>：当<service_type>是“UDP服务”时，如果数据存在则相应+ QIRD：<read_actual_length> <REMOTEIP>，<REMOTE_PORT><CR> <LF> <data> 。
- <connectID>：整数类型。套接字服务索引。范围是0-11。
- <read_length>：要检索的最大数据长度。范围是0-1500字节。
- <read_actual_length>：接收数据的实际长度。单位：字节。
- <remoteIP>：字符串类型。远程IP地址（必须是点格式），仅在<service_type>是“UDP”时才有效。
- <remote_port> ：整数类型。远程端口，仅在<service_type>为“UDP”时有效。
- <data> ：检索到的数据。
- <total_receive_length>：接收数据的总长度。单位：字节。
- <have_read_length>：读取数据的长度。单位：字节。
- <unread_length> ：未读数据的长度。单位：字节。

A T + QISENDEX发送十六进制字符串

AT+QISENDEX=?：测试命令
AT+QISENDEX=<connectID>,<hex_string>：返回 Send OK，SEND FAIL 或 ERROR。
- <connectID>：整数类型。套接字服务索引。范围是0-11。
- <hex_string> ：字符串类型。十六进制字符最大长度为512字节。

AT + QISWTMD切换数据访问模式

该命令可用于切换数据访问模式：缓冲区访问模式、直接推送模式和透明访问模式。启动套接字服务时，可以通过以下方式指定数据访问模式 AT + QIOPEN的<access_mode>参数。打开套接字后，数据访问模式可以通过AT + QISWTMD进行更改。

AT + QISWTMD =？：测试命令
AT+QISWTMD=<connectID>,<access_mode>：如果<access_mode>为0或1时，切换成功返回 OK，如果<access_mode>为2时，切换成功返回 CONNECT。如果发生错误返回 ERROR。
- <connectID> ：整数类型。套接字服务索引。范围是0-11。
- <access_mode>：整数类型。连接的数据访问模式。 0 缓冲区访问模式、1 直推模式、2 透明访问模式。

A T + QPING Ping远程服务器

AT + QPING =？测试命令
AT+QPING=<contextID>,<host>[,<timeout>[,<pingnum>]]：Ping远程服务器。

AT+QNTP 从NTP服务器同步本地时间

AT+QNTP=?：测试命令，如果在同步时，则返回 NTP 服务器地址。

AT+QIDNSCFG 配置DNS服务器

AT+QIDNSCFG=?：测试命令。
AT+QIDNSCFG=<contextID>：查询DNS服务器地址。
AT+QIDNSCFG=<contextID>,<pridnsaddr>[,<secdnsaddr>] ：配置DNS服务器地址。

AT+QIDNSGIP 通过域名查询IP地址

AT+QIDNSGIP=? ：测试命令。
AT+QIDNSGIP=<contextID>,<hostname>：查询域名对应的 IP 地址。

A T + QICFG 配置可选参数

AT+QICFG=?：测试命令。
AT+QICFG="transpktsize"[,<transpktsize>]：发送数据包大小。默认1024。
AT+QICFG="transwaittm"[,<transwaittm>] ：透明模式下如果发送数据未到数据包大小时，时间超过设定值时自动发送。默认值 2，单位：100毫秒。
AT+QICFG="dataformat"[,<send_data_format>,<recv_data_format>]：发送和接收的默认数据格式，0 文本、1 16进制。
AT+QICFG="viewmode"[,<view_mode>]：接收到的数据的输出格式，0=data header\r\ndata、1= data header,data。
AT+QICFG="tcp/retranscfg"[,<max_backoffs>,<max_rto>] ：整数类型。TCP重传的最大数量。范围是 3-20，默认值为12。这个值无法保存到NV，将对于所有TCP套接字生效。
AT+QICFG="dns/cache"[,dns_cache] ：0 禁用DNS缓存、1 启用 DNS 缓存。
AT+QICFG="qisend/timeout"[,time]：AT + QISEND的超时时间，默认 0 ，单位毫秒。
AT+QICFG="passiveclosed"[,closed] ：0 关闭服务器时禁用TCP连接的被动关闭。1 关闭服务器时启用TCP连接的被动关闭。
AT+QICFG="udp/readmode"[,mode]：0 禁用阻止模式。1 启用流模式。
AT+QICFG="udp/sendmode"[,mode] ：0 禁用阻止模式。1 启用流模式。
AT+QICFG="tcp/accept"[,state]：0 禁用自动接受来自客户端的TCP连接。1 启用自动接受来自客户端的TCP连接。

AT+QISDE 用于控制是否回显AT + QISEND的数据

AT + QISDE =？：测试命令。
AT+QISDE=<echo> ：0 不回显数据，1 回显数据。

A T + QIGETERROR 查询上一个错误代码

如果在执行TCP / IP命令后返回“ERROR”，则可以通过查询错误的详细信息 AT + QIGETERROR。请注意，AT + IGETERROR只返回最后一个TCP / IP AT命令的错误代码。

AT + QIGETERROR =？：测试命令。
AT + QIGETERROR：查询错误详细信息。

2.2、URC 的描述

TCP / IP AT命令的URC将以“+ QIURC：” 开头的格式报告给主机。它包含有关传入数据，连接已关闭和传入连接等的报告。实际上，在URC之前和之后都有“<CR> <LF>” ，但可以省略 “<CR> <LF>” 。

连接关闭：+QIURC: "closed",<connectID>。
当有传入的数据：
- +QIURC: "recv",<connectID>：缓冲区访问模式下的传入数据的URC。可以通过AT + QIRD接收数据。
- +QIURC:"recv",<connectID>,<currentrecvlength><CR><LF><data>：直接访问模式下的URC。
- +QIURC:"recv",<connectID>,<currentrecvlength>,<remoteIP>,<remote_port><CR><LF><data>：UDP SERVICE模式下的URC。
传入连接已满：+QIURC: "incoming full"
有新的连接：+QIURC:"incoming",<connectID>,<serverID>,<remoteIP>,<remote_port> 。
PDP停用：+QIURC: "pdpdeact",<contextID>。