跳转至

CIPSTART

建立TCP连接或注册UDP端口号:AT+CIPSTART

语法规则:

命令类型 语法 返回和说明
设置命令 单 路 连 接 (+CIPMUX=0)时:AT+CIPSTART=<mode>,<sever>,<port> 如果格式正确且处于IP INITIAL 或者 IP STATUS或TCP/UDP CLOSE状态,返回:
OK
否则返回:
+CME ERROR <err>
紧接着会有URC上报,上报内容如下:
如果连接已经存在,返回:ALREADY CONNECT 如果连接成功(非透传),返回:CONNECT OK如果连接成功(透传),返回:CONNECT 否则返回:
STATE:
CONNECT FAIL
多路连接(+CIPMUX=1)时: AT+CIPSTART=<n>,<mode>,<server>,<port> 如果格式正确且处于 IP STATUS或IP PROCESSING时,返回:
OK
否则返回:
+CME ERROR <err>
紧接着会有URC上报,上报内容如下:
如果连接已经存在, 返回:
<n>,ALREADY CONNECT如果连接成功,返回:<n>,CONNECT OK
否则返回:
<n>,CONNECT FAIL
测试命令 AT+CIPSTART=? 单路连接(+CIPMUX=0)时返回:<br>+CIPSTART: (<mode>取值列表),(IP address range),(port range)
+CIPSTART: (<mode>取值列表),(domain name),(port range)
OK
多路连接(+CIPMUX=1)时返回:
+CIPSTART: (<n> 取 值 列 表 ),( <mode> 取 值 列 表 ),(IP addressrange),(port range)
+CIPSTART: (<n>取值列表),(<mode>取值列表),(domain name),(portrange)
OK
注意事项 1. 此命令应用于建立 TCP/UDP 连接;
2. 当前状态可用AT+CIPSTATUS查询;
3. 单路连接时只当前状态为IP INITIAL 或者 IP STATUS或TCP/UDP CLOSE 时可执行,多路连接时当前状态为 IP STATUS或IP PROCESSING时可执行;
4. 在当前状态不是上述可执行状态时,需执行 AT+CIPSHUT后再开始建立连接;
5. 多路连接时,设置此命令前,必须先执行AT+CSTT, AT+CIICR,AT+CIFSR这三个命令。

参数定义:

参数 定义 取值 对取值的说明
<n> Link No. 0~5 整数型,表示连接序号
<mode> 连接类型,字符串型(双引号可加可不加) "TCP" 建立TCP连接
"UDP" 建立UDP连接
<server> 远端服务器 IP 地址或域名皆可 最大128个字节 字符串参数(双引号可加可不加)
<port> 远端服务端口 1~65535 整数型
<sl_state> 单连接状态 IP INITIAL 初始化
IP START 启动任务
IP CONFIG 配置场景
IP GPRSACT 场景已激活
IP STATUS 获得本地 IP 状态
TCP CONNECTING/UDP CONNECTING/SERVER LISTENING TCP 连接中/UDP 端口注册中/服务器侦听中
CONNECT OK 连接建立成功
TCP CLOSING/UDP CLOSING 正在关闭 TCP 连接,正在注销 UDP 端口
TCP CLOSED/UDP CLOSED 连接断开 /UDP 端口被注销
PDP DEACT 场景被释放