TCP/IP指令集¶

AT+ CIPSTATUS：查询TCP/UDP/SSL连接状态和信息¶

查询命令

命令：

AT+CIPSTATUS?

返回：

+BIPSTATUS:<type>,<remoteip>,<port>,<localport>,<tetype>

参数

<type>：连接类型
- 0: “TCP”
- 1: “UDP”
- 2: “TLS”
- 3: “DTLS”
<remoteip>：远程连接IP
<port>：远程连接的端口
<localport>：连接的本地端口
<tetype>：
- 0: 设备作为客户端
- 1: 设备作为服务器

AT+CIPSTART：建立TCP连接、UDP 传输或 TLS连接¶

执行命令

命令：

AT+CIPSTART=<linkID>,<"type">,<remotehost>,<remoteport>[,<keepalive>,"localport"],<"localip">

返回：

OK

参数

<linkID>：网络连接 ID (0 ~ 5)，最多支持6个连接
<”type”>：连接类型
- 0: “TCP”
- 1: “UDP”
- 2: “TLS”
- 3: “DTLS”
<remotehost>：远程连接IP
<remoteport>：远程连接的端口
<keepalive>：TCP keep-alive 间隔，默认值：0
- 0: 禁用 TCP keep-alive 功能
- 1 ~ 7200: 检测间隔，单位：秒

说明

只能TCP有效，UDP不需要设置，此参数最终会配置到 socket 选项 TCP_KEEPIDLE，keepalive 另外的 socket 选项。
TCP_KEEPINTVL 默认会使用 1，TCP_KEEPCNT 默认会使用 3。
<”localport”>:本地端口，当需要设置为server时需要设置此端口。
<”localip”>：本地IP，当需要配置为server时需要配置此IP。

示例

//1.建立连接ID为0，keep-alive 1800秒一次的TCP 连接
AT+CIPSTART=0,"tcp","192.168.0.103",20108,1800

//2. 建立连接ID为1的TCP Server连接
AT+CIPSTART=2,"tcp","192.168.0.103",20108,1800, 5637, "192.168.0.107"

//3. 建立连接ID为1的UDP client连接
AT+CIPSTART=1,"udp","192.168.0.103",20108

//4.建立连接ID为1，本地端口为5637的UDP Server连接
AT+CIPSTART=1,"udp","192.168.0.103",20108,5637, "192.168.0.107"

AT+CIPSEND：在普通传输模式或 Wi-Fi 透传模式下发送数据¶

执行命令

命令：

//执行TCP数据发送
AT+CIPSEND=<linkID>,<length>

//执行UDP数据发送
AT+CIPSEND=<linkID>,<length>[,<"remotehost">,<remote port>]

返回：

上述响应表示 AT 已准备好接收串行数据，此时您可以输入数据，当AT接收到的数据长度达到<length>后，数据传输开始。如果未建立连接或数据传输时连接被断开，返回：

CMDRSP:ERROR

如果数据传输成功，返回：

SEND OK

执行命令

功能：

进入 Wi-Fi 透传模式

命令：

AT+CIPSEND

返回：

或

CMDRSP:ERROR

说明

进入 Wi-Fi 透传模式，设备每次最大接收 1024 字节，最大发送 1460 字节；如果当前接收的数据长度大于最大发送字节数，AT 将立即发送；否则，接收的数据将在 20 ms 内发送。当输入单独一包+++ 时，退出透传模式下的数据发送模式，请至少间隔 1 秒再发下一条 AT 命令。本命令必须在开启透传模式以及单连接下使用。

参数

<linkID>：网络连接 ID (0 ~ 4)，用于多连接的情况
<length>：数据长度，最大值：2048 字节
<”remote host”>：UDP 传输可以指定对端主机：IPv4 地址或域名
<remote port>：UDP 传输可以指定对端端口

AT+CIPCLOSE：关闭 TCP/UDP/SSL 连接¶

执行命令

命令：

AT+CIPSEND=<linkID>

返回：

OK

参数

<linkID>：需关闭的网络连接 ID，如果设为 5，则表示关闭所有连接

AT+CIPMUX：启用/禁用多连接模式¶

查询命令

命令：

AT+CIPMUX?

返回：

+CIPMUX:<mode>
OK

执行命令

命令：

AT+CIPMUX=<mode>

返回：

OK

参数

<mode>：连接模式，默认值：0
- 0: 单连接
- 1: 多连接

说明

只有当所有连接都断开时才可更改连接模式
只有普通传输模式 (AT+CIPMODE=0)，才能设置为多连接

AT+CIPMODE：查询/设置传输模式¶

查询命令

命令：

AT+CIPMODE?

返回：

+CIPMODE:<mode>
OK

执行命令

命令：

AT+CIPMODE=<mode>

返回：

OK

参数

<mode>：
- 0: 普通传输模式
- 1: Wi-Fi 透传接收模式，仅支持 TCP 单连接、UDP 固定通信对端、SSL 单连接的情况

AT+CIPSNTPCFG：查询/设置NTP服务器¶

查询命令

命令：

AT+CIPSNTPCFG?

返回：

+CIPSNTPCFG:<enable>,<timezone>,<SNTP server>
OK

执行命令

命令：

AT+CIPSNTPCFG=<enable>,<timezone>,<SNTP server>

返回：

OK

参数

<enable>：设置 SNTP 服务器：
- 1: 设置 SNTP 服务器。
- 0: 不设置 SNTP 服务器。
<timezone>：
- 数值范围：[-12,12]，它以小时为单位，通过与协调世界时 (UTC) 的偏移来标记大多数时区（UTC−12:00 至 UTC+12:00）
[<SNTP server>]： SNTP 服务器地址或域名。

示例

//使能 SNTP 服务器，设置中国时区 (UTC+08:00)
AT+CIPSNTPCFG=1,8,"cn.ntp.org.cn"

//使能 SNTP服务器，设置美国纽约的时区 (UTC−05:00)
AT+CIPSNTPCFG=1,-5,"0.pool.ntp.org"

AT+CIPSNTPTIME：查询SNTP时间¶

查询命令

命令：

AT+CIPSNTPTIME?

返回：

+CIPSNTPTIME:<asctime style time>
OK

示例

AT+CIPSNTPTIME?

+CIPSNTPTIME:2022-10-21 19:20:39
OK

AT+PING：ping对端主机¶

执行命令

命令：

AT+PING=<"host">

返回：

+PING:<time>

或

+PING:TIMEOUT

参数

<”host”>：字符串参数，表示对端主机的 IPv4 地址或域名。
<time>：ping 的响应时间，单位：毫秒。

AT+CIPDOMAIN：域名解析¶

执行命令

命令：

AT+CIPDOMAIN=<"domain name">

返回：

+CIPDOMAIN:<"IP address">
OK

参数

<”domain name”>：待解析的域名
<”IP address”>：解析出的 IP 地址

说明

目前仅支持解析为 IPv4 地址

AT+CIPDNS：查询/设置 DNS 服务器信息¶

查询命令

命令：

AT+CIPDNS?

返回：

+CIPDNS:<enable>[,<"DNS IP1">,<"DNS IP2">,<"DNS IP3">]
OK

执行命令

命令：

AT+CIPDNS=<enable>[,<"DNS IP1">,<"DNS IP2">,<"DNS IP3">]

返回：

OK

或

ERROR

参数

<enable>：设置 DNS
- 0: 启用自动获取 DNS 设置，DNS 将会恢复为 208.67.222.222，只有当 DHCP 更新时才会生效。
- 1: 启用手动设置 DNS 信息，如果不设置参数 <DNS IPx> 的值，则使用默认值 208.67.222.222。
<DNS IP1>：第一个 DNS IP 地址，对于执行命令，只有当 <enable> 参数为 1 时，也就是启用手动 DNS 设置，本参数才有效。
<DNS IP2>：第二个 DNS IP 地址，对于执行命令，只有当 <enable> 参数为 1 时，也就是启用手动 DNS 设置，本参数才有效。
<DNS IP3>：第三个 DNS IP 地址，对于执行命令，只有当 <enable> 参数为 1 时，也就是启用手动 DNS 设置，本参数才有效。

说明

若AT+SYSSTORE=1，配置更改将保存在 NVS 区。

AT+CIPSSLCPSK：查询/设置 SSL 客户端的 PSK¶

查询命令

命令：

AT+CIPSSLCPSK?

返回：

+CIPSSLCPSK:<linkID>,<"psk">,<"hint">
OK

执行命令

命令：

//单连接：(AT+CIPMUX=0)
AT+CIPSSLCPSK=<"psk">,<"hint">

//多连接：(AT+CIPMUX=1)
AT+CIPSSLCPSK=<linkID>,<"psk">,<"hint">

返回：

OK

参数

<linkID>：网络连接 ID (0 ~ max)，在单连接的情况下，本参数值为 0；在多连接的情况下，若参数值设为 max，则表示所有连接；本参数默认值为 5。
<”psk”>：PSK identity，最大长度：48。
<”hint”>：PSK hint，最大长度：48。

说明

如果想要本配置立即生效，请在建立 SSL 连接前运行本命令。

AT+CIPDNS：查询/设置 DNS 服务器信息¶

查询命令

命令：

AT+CIPDNS?

返回：

+CIPDNS:<enable>[,<"DNS IP1">,<"DNS IP2">,<"DNS IP3">]
OK

执行命令

命令：

AT+CIPDNS=<enable>[,<"DNS IP1">,<"DNS IP2">,<"DNS IP3">]

返回：

OK

或

ERROR

参数

<enable>：设置 DNS
- 0: 启用自动获取 DNS 设置，DNS 将会恢复为 208.67.222.222，只有当 DHCP 更新时才会生效；
- 1: 启用手动设置 DNS 信息，如果不设置参数 <DNS IPx> 的值，则使用默认值 208.67.222.222。
<DNS IP1>：第一个 DNS IP 地址。
<DNS IP2>：第二个 DNS IP 地址。
<DNS IP3>：第三个 DNS IP 地址。

说明

若AT+SYSSTORE=1，配置更改将保存在 NVS 区。
这三个参数不能设置在同一个服务器上。
当 <enable> 为 0 时，DNS 服务器可能会根据设备所连接的路由器的配置而改变。