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

Q/GDW 1376.3—2012

$MYNETCREATE? $MYNETCREATE=? OK OK

a) ：0-5，通道号；

b) ：0-2；TCP Client/TCP Server/UDP；

1) 0：TCPClient 2) 1：TCPServer 3) 2：UDP TCP/UDP Client模式下，执行本条命令后通信模块开始连接服务器，连接服务器成功后，通信模块进入透明数据传输模式。TCP/UDP Server模式下，执行本条命令，模块返回OK，仅代表通信模块建立侦听socket成功，但模块不立即进入数据模式，仍旧在命令模式；只有在客户端连接成功以后，通信模块才进入透明数据传输模式。透明数据传输模式的挂断，必须首先使用“+++”切入命令模式后，方可执行AT$MYNETCLOSE命令。

c) ：整数类型，0-5，本次的链接号； d) ：需要连接的IP； e) ：需要连接的端口； f) ：本地端口。

示例：

AT$MYNETCREATE=1,2,2,“172.22.44.123”,5300,3000 CONNECT OK

// 建立UDP透明数据传输通道 // 开始透明数据传输

// 输入+++，模块返回OK表示回到命令模式

6.5 主动上报命令集

主动上报命令仅仅在非透明数据传输模式下有效，是指在通信过程中，有数据接收或通信异常时，通信模块主动上报给终端的命令。

6.5.1 数据到来主动上报 $MYURCREAD

该主动上报命令表达模块接收到了数据，语法见表20。

表20 $MYURCREAD命令语法

命令 $MYURCREAD 返回值 $MYURCREAD:

：整数类型，0-5，本次上报的链接号。

注意：在缓冲区内数据未被完全读空之前，通信模块新到数据时不需要重复上报本命令。

示例：

AT$MYNETOPEN=2 $MYNETOPEN: 2 OK

$MYURCREAD: 2

// 2号Socket收到数据时上报

// 使用第2号SOCKET建立连接

13

Q/GDW 1376.3—2012

AT$MYNETREAD=2,1460 $MYNETREAD: 2,10 1234567890 OK

// 从2号Socket读取1460个数据 // 有10个数据

6.5.2 链路断开主动上报 $ MYURCCLOSE

该主动上报命令表达当前SocketID对应的链接已断开，命令语法见表21。

表21 $MYURCCLOSE命令语法

命令 $MYURCCLOSE 返回值 $MYURCCLOSE:

：0-5，断开的链接号。

注意：上报了本命令后， SocketID对应的缓冲区内的收发数据会被清空。

示例：

AT$MYNETOPEN=2 $MYNETOPEN: 2 OK

$MYURCCLOSE: 2

// 2号Socket链接断开时上报

// 使用第2号SOCKET建立连接

6.5.3 网络连接状态主动上报 $MYURCACT

该主动上报命令表达网络连接建立或者断开，命令语法见表22。

表22 $MYURCACT命令语法

命令 $MYURCACT 返回值 $MYURCACT: ,

a) ：使用的Channel通道； b) ：网络连接状态；

1) 0：网络连接断开 2) 1：网络连接建立 c) ：本机IP 地址。

示例：

$MYURCACT: 1,0 // 网络主动断开网络连接 AT$MYNETACT?

$MYNETACT: 1,0,“0,0,0,0” OK

6.5.4 客户端连接主动上报 $MYURCCLIENT

当开启侦听服务后，一旦有客户端连接上来，就使用该AT命令主动上报给采集终端，命令语法见表23。

表23 $MYURCCLIENT命令语法

14

Q/GDW 1376.3—2012

命令 $MYURCCLIENT 返回值 $MYURCCLIENT: ,,

a) ：新Client socket id； b) ：客户端IP地址； c) ：客户端端口号。

示例：

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

// 有客户端连接时上报

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

6.5.5 FTP连接断开主动上报 $MYURCFTP

该主动上报命令表达FTP连接断开，对应的FTP收发缓冲区内的数据会被清空，命令语法见表24。

表24 $MYURCFTP命令语法

命令 $MYURCFTP 返回值 $MYURCFTP:

：整数类型，FTP连接的状态。 a) 0: FTP命令socket断开 b) 1: FTP数据socket断开

示例：

AT$MYFTPOPEN=1,“someftpsite.com”,“anonymous”,“qwerty@somemail.com”,1,30,1 OK

// FTP连接成功打开 // 主动上报到来

$MYURCFTP: 0

// FTP命令连接断开主动上报，如果要继续FTP服务需重新执行AT$MYFTPOPEN

6.6 FTP功能命令集

6.6.1 启动FTP服务 $MYFTPOPEN

通信模块一次只能进行一个FTP连接, 连接建立后占用2个Socket ID。FTP连接进行时，不能使用透明数据传输模式传输数据；使用透明数据传输模式传输数据时，也无法启动FTP服务。命令语法见表25。

表25 $MYFTPOPEN命令语法

命令 $MYFTPOPEN=,,,,,, $MYFTPOPEN? $MYFTPOPEN: 15

OK ERROR: 返回值 Q/GDW 1376.3—2012

OK $MYFTPOPEN=? OK

a) ：FTP服务启动基于的Channel类型；

b) or：远程FTP 站点IP或者

URL，IP地址为点分十进制表示法形式:XXX.XXX.XXX.XXX；URL: ASCII字符，最大长度为255个字节；如果省略，则默认FTP端口为21；

c) ：FTP登录用户名，ASCII字符，最大长度为255个字节； d) ：FTP登录密码，ASCII字符，最大长度为255个字节； e) ：0表示主动FTP模式；1表示被动FTP模式（默认被动模式）； f) ：5-180s，FTP命令或者数据空闲超时设置，单位秒；默认为30秒； g) : 0表示二进制模式 (默认)；1表示文本模式； h) ：1表示连接成功；0表示连接失败。

示例：

AT$MYFTPOPEN=1,“someftpsite.com”,“anonymous”,“qwerty@somemail.com”,1,30,1 OK // FTP连接成功打开

AT$MYFTPOPEN=1,“anotherftpsite.com”,“anonymous”,“qwerty@somemail.com”,1,30,1 ERROR

6.6.2 关闭FTP服务 $MYFTPCLOSE

关闭FTP服务，命令语法见表26。

表26 $MYFTPCLOSE命令语法

命令 返回值 $MYFTPCLOSE OK ERROR

示例：

AT$MYFTPCLOSE OK

6.6.3 获取FTP文件大小 $MYFTPSIZE

该命令用于获取FTP服务器上对应文件的长度，命令语法见表27。

表27 $MYFTPSIZE命令语法

命令 返回值 $MYFTPSIZE= $MYFTPSIZE: OK ERROR

a) ：需要下载的文件名，包含路径；

b) ：需要下载的FTP文件的长度，长度为2^32-1。

16

Q/GDW 1376.3—2012

示例：

AT$MYFTPSIZE=“//myfile/ftp_file.txt” $MYFTPSIZE: 2048 OK

6.6.4 文件下载 $MYFTPGET

该命令用于FTP下载功能实现文件获取，命令语法见表28。

表28 $MYFTPGET命令语法

命令 返回值 $MYFTPGET=[,CONNECT ata_offset>, ] OK ERROR CONNECT ERROR

a) ：需要下载的文件名； b) ：文件数据的偏移量；

c) : 本次读取文件数据的长度； d) : FTP文件的数据内容。 注：可使用“+++”退出FTP GET模式。

示例：

AT$MYFTPOPEN=1,“someftpsite.com”,“anonymous”,“qwerty@somemail.com”,1,30,1 OK

AT$MYFTPGET=“//myfile/ftp_download.txt”,0,18 CONNECT

I like traveling OK

6.6.5 文件上传 $MYFTPPUT

该命令用于FTP上传功能实现，命令语法见表29。

表29 $MYFTPPUT命令语法

命令 返回值 $MYFTPPUT=,CONNECT ta_length>, OK ERROR

a) ：需要上传的文件名，包括路径；

17