1、介绍

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

1.1 使用 AT 命令的过程

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

3、代码示例（略）

4、错误代码（略）

5、术语和缩写

• APN：接入点名称
• CHAP：挑战握手认证协议
• CS：电路交换
• DNS：域名系统
• ID：互联网协议
• IP：互联网协议
• NTP：网络时间协议
• NV：永久存储，不消失
• PAP：密码验证协议
• PDP：分组数据协议
• PPP：点对点协议
• PS：分组交换
• QoS：网络通讯服务质量
• TCP：传输控制协议
• UART：通用异步收发器
• UDP：用户数据报协议
• URC：未经请求的结果代码
• USB：通用串行总线
• （U）SIM：（通用）用户身份识别卡
• UTC：世界标准时间

****************************结束********************************

最后

以上就是爱笑飞鸟为你收集整理的Quectel EC20 R2.1 AT指令集（TCP/部分）1、介绍2、TCP / IP AT命令的描述3、代码示例（略）4、错误代码（略）5、术语和缩写的全部内容，希望文章能够帮你解决Quectel EC20 R2.1 AT指令集（TCP/部分）1、介绍2、TCP / IP AT命令的描述3、代码示例（略）4、错误代码（略）5、术语和缩写所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。