376.3远程通信模块接口协议(3)

Q/GDW 1376.3—2012

$MYIPFILTER: ,, … OK $MYIPFILTER=? $MYIPFILTER: ,, OK

a) ：0-4, 5组数据； b) ：0-2；

1) 0：删除指定的IP认证通道 2) 1：添加指定的IP认证通道 3) 2：删除全部IP认证通道

c) ：合法客户端的IP地址，字符型，格式为XXX.XXX.XXX.XXX； d) ：子网掩码，字符型，格式为XXX.XXX.XXX.XXX。

示例：

AT$MYIPFILTER=0,1,“192.168.0.23”,“255.255.255.255” // 添加指定的IP认证通道 OK

AT$MYIPFILTER=0,0,“192.168.0.23”,“255.255.255.255” // 删除指定的IP认证通道 OK

AT$MYIPFILTER=0,1,“192.168.0.23”,“255.255.255.0” OK

// 添加可允许访问的IP地址队列（192.168.0.0 // 到192.168.0.255）

6.3 非透明数据传输命令集 6.3.1 设置服务参数 $MYNETSRV

该命令用于设置TCP/IP的服务参数，命令语法见表12。

表12 $MYNETSRV命令语法

命令 $MYNETSRV=,,, , $MYNETSRV? $MYNETSRV: ,,,, OK ERROR $MYNETSRV=? OK OK ERROR: 返回值

a) ：整数类型，0-5，通道号，每个通道应该分配至少2K Bytes的发送缓冲区和2K Bytes

的接收缓冲区；

b) ：整数类型，0-5，本命令使用的链接号；

c) ：网络类型，支持TCP Client，TCP Server，UDP三种类型；

1) 0：TCP Client

8

Q/GDW 1376.3—2012

2) 1：TCP Server, 本模式下，只能建立一个侦听，不能建立多个侦听 3) 2：UDP

d) ：非透明数据传输模式下数据显示方式；

1) 0：HEX（默认） 2) 1：TEXT

e) < ip:port>：address所对应的值，如：218.108.43.26:8000。Address 中的IP 地址为

127.0.0.1 的时候，表示使用该SocketID建立侦听服务。

示例：

AT$MYNETSRV=0,0,0,0,“172.22.33.2:5000” OK

// 通道0设置TCP Client服务参数

6.3.2 开启服务 $MYNETOPEN

使用该命令打开TCP/UDP连接，命令语法见表13。

表13 $MYNETOPEN命令语法

命令 $MYNETOPEN= 返回值 $MYNETOPEN: [,] OK ERROR: $MYNETOPEN? $MYNETOPEN:,,,,,,,< dest_ip>, OK ERROR: $MYNETOPEN=? OK a) b) c) d) e) f) g) h)

：整数类型，0-5，本命令使用的链接号；

：整数类型，TCP连接打开时候，client和server协商成功的MSS值； ：字符类型，本地IP地址；

：本地端口（每个通道可能不一样）； ：网关；

：首选域名解析服务器； ：备用域名解析服务器；

：TCP Client/TCP Server/UDP； 1) 0: TCP Client 2) 1: TCP Server 3) 2: UDP i) ：需要连接的IP地址(当type为TCP Server时，ip为0.0.0.0；当type为TCP Client

或者UDP时，ip为对端的ip地址)，当链接断开后，地址恢复为0.0.0.0； j) ：需要连接的端口号 (当type为TCP Server时，port为0；当type为TCP Client

或者UDP时，port为对端端口号) ，当链接断开后，port恢复为0。

示例：

AT$MYNETOPEN=0

// 开启SocketID_0

9

Q/GDW 1376.3—2012

$MYNETOPEN: 0,1460 OK

// 开启成功

6.3.3 读取数据 $MYNETREAD

该命令用于读取数据，命令语法见表14。

表14 $MYNETREAD命令语法

命令 返回值 $MYNETREAD=,$MYNETREAD: , ta_len> OK ERROR: $MYNETREAD=? OK a) ：整数类型，0-5，本命令使用的链接号； b) ：需要读取的最大数据长度，1-1460； c) ：实际读取到的数据长度，0-1460； d) ：数据，当data_length=0时，此行为空。

示例：

AT$MYNETREAD=0,1408 // 从0号Socket读取1408个数据 $MYNETREAD: 0,0

// 这个Socket没有数据

OK

AT$MYNETREAD=0,1408 // 从0号Socket读取1408个数据 $MYNETREAD: 0,10 // 有10个数据,UDP连接时 1234567890 OK

6.3.4 发送数据 $MYNETWRITE

该命令用于发送数据，命令语法见表15。

表15 $MYNETWRITE命令语法

命令 返回值 $MYNETWRITE=,$MYNETWRITE: , ata_len> OK ERROR: $MYNETWRITE=? OK

a) ：整数类型，0-5，本命令使用的链接号； b) ：要发送的数据长度，1-1460； c) ：本次发送的数据内容。

示例：

AT$MYNETWRITE=0,10

// 向0号Socket发送10个数据

10

Q/GDW 1376.3—2012

$MYNETWRITE: 0,10 1234567890

OK // 数据发送成功

6.3.5 关闭连接 $MYNETCLOSE

该命令用于关闭一条连接，命令语法见表16。

表16 $MYNETCLOSE命令语法

命令 $MYNETCLOSE= 返回值 $MYNETCLOSE: OK ERROR: $MYNETCLOSE? $MYNETCLOSE=? OK OK

：整数类型，0-5，需要断开的链接号；

示例：

AT$MYNETCLOSE=0 $MYNETCLOSE: 0 0K

// 关闭0号Socket

6.3.6 查询TCP ACK信息 $MYNETACK

该命令用于查询终端已发送但未被对端确认的TCP数据数量，模块内置协议栈剩余缓冲区的大小，命令语法见表17。

表17 $MYNETACK命令语法

命令 AT$MYNETACK= 返回值 $MYNETACK:,, OK

a) :整数类型，0-5，需要查询的链接号

b) ：数据发送但未收到对方确认信息的数量，最大值为2^32-1； c) : 模块内置协议栈剩余缓冲区 的大小，最大值为2^32-1。

示例：

AT$MYNETACK=0 $MYNETACK: 0,2456,1024 0K

// 查询TCP SocketID_0发送数据未被对端ACK的数量

6.3.7 接受侦听请求 $MYNETACCEPT

该命令是用于当通信模块工作在TCP/UDP服务器模式下，接收客户端的侦听请求，命令成功后，当transportMode为0时，进入非透明数据传输模式；当transportMode为1时，进入透明数据传输模式。

11

Q/GDW 1376.3—2012

在透明数据传输模式下，如果要关闭Server的连接，首先要退出数据模式，进入命令模式，然后运行AT$MYNETCLOSE=SocketID，这样将一起关闭Server侦听的SocketID和这个SocketID下建立的其他链接。命令语法见表18。

表18 $MYNETACCEPT命令语法

命令 $MYNETACCEPT=,, OK CONNECT ERROR: $MYNETACCEPT? $MYNETACCEPT=? OK OK 返回值 a) ：0-5，新接入的socket id，由主动上报$MYURCCLIENT提供； b) ：是否接受侦听；

1) 0：接受 2) 1：拒绝

c) ：侦听成功后模块的传输模式。

1) 0：非透明数据传输模式 2) 1：透明数据传输模式

d) 当=0，返回OK，表示建立成功，模块进入非透明数据传输模式；当

=1，返回CONNECT表示成功，模块进入透明数据传输模式。

示例：

AT$MYNETSRV=0,2,1,0,“127.0.0.1:5100” OK

AT$MYNETOPEN=2 $MYNETOPEN: 2 OK

$MYURCCLIENT: 1,“172.16.23.100”,31256 // 客户连接通知 AT$MYNETACCEPT=1,0,0 OK

// 接受连接，使用第1个Socket,命令模式

// 使用第2号Socket侦听 // 服务器侦听5100端口

6.4 透明数据传输命令集

在开启透明数据传输服务之前，首先需要使用非透明数据传输中网络初始化的相关命令对网络进行

初始化，然后才可以使用以下的透明数据传输命令。 6.4.1 开启服务 $MYNETCREATE

该命令是用于开启通信模块透明数据传输服务, 命令语法见表19。

表19 $MYNETCREATE命令语法

命令 $MYNETCREATE=,,,,[,] CONNECT OK ERROR: 12

返回值