华为GTM900 无线模块TCP IP AT指令

华为 GTM900 无线模块 TCPIP AT命令 V100R001 使用指导书 文档版本 03 发布日期 2007-05-22 部件编码 华为技术有限公司为客户提供全方位的技术支持，用户可与就近的华为办事处联系，也可直接与公司 总部联系。 华为技术有限公司 地址： 深圳市龙岗区坂田华为总部办公楼 邮编：518129 网址： http://www.huawei.com 客户服务电 话： 0755-28560000 8008302118 客户服务传 真： 0755-28560111 客户服务邮 箱： Support@huawei.com 版权所有 © 华为技术有限公司 2007。 保留一切权利。 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何 形式传播。 商标声明 和其他华为商标均为华为技术有限公司的商标。 本文档提及的其他所有商标或注册商标，由各自的所有人拥有。 注意 由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指 导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 目 录 文档版本 03 (2007-05-22) 华为技术有限公司 i 目 录 1 命令列 表 关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf .......................................................................................................................................1-1 2 打开一条TCP链接.......................................................................................................................2-1 2.1 配置apn........................................................................................................................................................2-1 2.2 进入tcpip功能..............................................................................................................................................2-1 2.3 打开一条tcp链接 .........................................................................................................................................2-1 2.4 发送数据到tcp对端(%IOMODE=1)...........................................................................................................2-1 2.5 发送数据到tcp对端(%IOMODE=0)...........................................................................................................2-2 2.6 新数据直接提交到串口，默认缓存没有打开(%IOMODE=1,1,1) ..........................................................2-2 2.7 缓存打开，从接收缓存中数据读取(%IOMODE=1,,0) ............................................................................2-2 2.8 关闭链接(单链接) .......................................................................................................................................2-2 3 打开一条UDP链接......................................................................................................................3-1 3.1 配置apn........................................................................................................................................................3-1 3.2 进入tcpip功能..............................................................................................................................................3-1 3.3 打开一条udp链接........................................................................................................................................3-1 3.4 发送数据到udp对端 ....................................................................................................................................3-1 3.5 新数据直接提交到串口，默认缓存没有打开 ..........................................................................................3-2 3.6 缓存打开，接收缓存中数据读取(%IOMODE=1,,0) ................................................................................3-2 3.7 关闭链接(单链接) .......................................................................................................................................3-2 4 多链接功能的使用 ......................................................................................................................4-1 4.1 配置apn........................................................................................................................................................4-1 4.2 进入tcpip功能..............................................................................................................................................4-1 4.3 设置多链接模式..........................................................................................................................................4-1 4.4 分别打开一条tcp和udp链接 .......................................................................................................................4-2 4.5 发送数据到链接 1或 2 (%IOMODE=1)....................................................................................................4-2 4.6 新数据直接提交到串口，默认缓存没有打开 ..........................................................................................4-2 4.7 缓存功能打开，但要区分link_num来判断数据来源 ...............................................................................4-2 4.8 关闭链接......................................................................................................................................................4-3 5 TCP服务器AT命令的使用..........................................................................................................5-1 5.1 配置APN......................................................................................................................................................5-1 目 录 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 ii 华为技术有限公司 文档版本 03 (2007-05-22) 5.2 进入tcpip功能..............................................................................................................................................5-1 5.3 开启服务器功能..........................................................................................................................................5-1 5.4 查询服务器状态(可选) ...............................................................................................................................5-1 5.5 成功接入客户端..........................................................................................................................................5-2 5.6 查询链路状态（可选） ..............................................................................................................................5-2 5.7 关闭服务器链路..........................................................................................................................................5-2 5.8 查询服务器状态(可选) ...............................................................................................................................5-2 5.9 查询链路状态(可选) ...................................................................................................................................5-2 6 UDP服务器AT命令的使用 .........................................................................................................6-1 6.1 配置APN......................................................................................................................................................6-1 6.2 进入tcpip功能..............................................................................................................................................6-1 6.3 开启服务器功能..........................................................................................................................................6-1 6.4 查询服务器状态(可选) ...............................................................................................................................6-1 6.5 收到客户端数据后自动建立连接 ..............................................................................................................6-2 6.6 查询链路状态（可选） ..............................................................................................................................6-2 7 延时发送AT命令的使用.............................................................................................................7-1 7.1 设置延时......................................................................................................................................................7-1 7.2 发送数据......................................................................................................................................................7-1 7.3 查询待发内存状态......................................................................................................................................7-1 7.4 数据发送......................................................................................................................................................7-1 8 其它AT命令的使用.....................................................................................................................8-1 8.1 TCP ACK查询 ..............................................................................................................................................8-1 8.2 接收缓存中数据查询 ..................................................................................................................................8-1 8.3 删除接收缓存中的数据包 ..........................................................................................................................8-1 8.4 限定UDP数据对方发送端口 ......................................................................................................................8-2 8.5 退出tcpip功能..............................................................................................................................................8-2 8.6 域名解析......................................................................................................................................................8-2 9 附录...............................................................................................................................................9-1 9.1 注意事项 软件开发合同注意事项软件销售合同注意事项电梯维保合同注意事项软件销售合同注意事项员工离职注意事项 ......................................................................................................................................................9-1 9.2 各种命令返回时间......................................................................................................................................9-1 9.3 转换函数......................................................................................................................................................9-2 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 1 命令列表 文档版本 03 (2007-05-22) 华为技术有限公司 1-1 1 命令列表 1 AT%ETCPIP PDP激活，初始化 TCPIP 2 AT%IPOPEN 打开一条 TCP/UDP链接 3 AT%IPOPENX 打开多条 TCP/UDP链接 4 AT%IOMODE 设置数据模式，单链接或多链接模式选择，缓存设置 5 AT%IPSEND 单链接模式下发送数据 6 AT%IPSENDX 多链接模式下发送数据 7 AT%IPCLOSE 关闭链接 8 AT%TXSTATE TCP的 ACK查询 9 AT%IPDQ 数据查询 10 AT%IPDR 数据读取 11 AT%IPDD 数据删除 12 AT%IPDDMODE 数据删除模式 13 AT%DNSR 域名解析 14 AT%IPLISTEN 服务器功能 15 AT%IPSP 延时发送功能 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 2 打开一条 TCP链接 文档版本 03 (2007-05-22) 华为技术有限公司 2-1 2 打开一条 TCP链接 2.1 配置 apn AT+CGDCONT=1,”IP”,”CMNET” OK 2.2 进入 tcpip功能 AT%ETCPIP OK 如果需要输入用户名和密码，假如用户名：user，密码：gprs AT%ETCPIP=”user”,”gprs” OK 2.3 打开一条 tcp链接 AT%IPOPEN=”TCP”,”202.206.1.26”,23,,4098 CONNECT 4098为绑定本地端口 2.4 发送数据到 tcp对端(%IOMODE=1) 假如发送数据 0x01 0x02 0x03 0x04 0xEF 在发送中需要把 0x01转换成 0x30 0x31，也就是可显字符 ‘0’，’1’，依次类推，可 以参考附录转换函数 AT%IPSEND=”01020304EF” 2 打开一条 TCP链接 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 2-2 华为技术有限公司 文档版本 03 (2007-05-22) %IPSEND: 15 OK 2.5 发送数据到 tcp对端(%IOMODE=0) 假如发送的数据为可显，且不包含非法字符 ‘;’和’”’,比如需要发送字符串 “0123456789ABCD%^&EFGH”到 TCP对端： AT%IPSEND=”0123456789ABCD%^&EFGH” %IPSEND: 15 OK 2.6 新数据直接提交到串口，默认缓存没有打开 (%IOMODE=1,1,1) %IPDATA:, eg: %IPDATA:6,”78125578AABB” 表明：实际数据长度为 6 数据为：0x78 0x12 0x55 0x78 0xAA 0xBB 2.7 缓存打开，从接收缓存中数据读取(%IOMODE=1,,0) AT%IPDR %IPDR：1，2，4，”3038EF55” 1：连接号 2：包序号 4：数据包长度 0x30,0x38,0xEF,0x55：数据内容 2.8 关闭链接(单链接) AT%IPCLOSE OK 这个 OK最长需要 15秒 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 3 打开一条 UDP链接 文档版本 03 (2007-05-22) 华为技术有限公司 3-1 3 打开一条 UDP链接 3.1 配置 apn AT+CGDCONT=1,”IP”,”CMNET” OK 3.2 进入 tcpip功能 AT%ETCPIP OK 如果需要输入用户名和密码，假如用户名：user，密码：gprs AT%ETCPIP=”user”,”gprs” OK 3.3 打开一条 udp链接 AT%IPOPEN=”UDP”,”61.171.1.26”,23,,4098 CONNECT 4098为绑定本地端口 3.4 发送数据到 udp对端 假如发送数据 0x01 0x02 0x03 0x04 0xEF 在发送中需要把 0x01转换成 0x30 0x31，也就是可显字符 ‘0’，’1’，依次类推，可 以参考附录转换函数 AT%IPSEND=”01020304EF” 3 打开一条 UDP链接 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 3-2 华为技术有限公司 文档版本 03 (2007-05-22) OK 3.5 新数据直接提交到串口，默认缓存没有打开 %IPDATA:, eg: %IPDATA:6,”78125578AABB” 表明：实际数据长度为 6 数据为：0x78 0x12 0x55 0x78 0xAA 0xBB 3.6 缓存打开，接收缓存中数据读取(%IOMODE=1,,0) AT%IPDR %IPDR：1，2，4，”3038EF55” 1：连接号 2：包序号 4：数据包长度 0x30,0x38,0xEF,0x55：数据内容 3.7 关闭链接(单链接) AT%IPCLOSE OK 这个 OK很快返回，因为是 UDP 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 4 多链接功能的使用 文档版本 03 (2007-05-22) 华为技术有限公司 4-1 4 多链接功能的使用 4.1 配置 apn AT+CGDCONT=1,”IP”,”CMNET” OK 4.2 进入 tcpip功能 AT%ETCPIP OK 如果需要输入用户名和密码，假如用户名：user，密码：gprs AT%ETCPIP=”user”,”gprs” OK 4.3 设置多链接模式 AT%IOMODE=,2 OK 当已经有链接存在的情况下，也就是使用了 AT%IPOPEN 或者 AT%IPOPENX，就 无法对 AT%IOMODE第二个参数进行设置。 4 多链接功能的使用 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 4-2 华为技术有限公司 文档版本 03 (2007-05-22) 4.4 分别打开一条 tcp和 udp链接 AT%IPOPENX=1,”TCP”,”202.206.1.26”,23 CONNECT AT%IPOPENX=2,”UDP”,”61.175.8.90”,8888 CONNECT 4.5 发送数据到链接 1或 2 (%IOMODE=1) AT%IPSENDX=1,”032078291F” %IPSEND: 15 OK AT%IPSENDX=2,”AA0F3899” OK 4.6 新数据直接提交到串口，默认缓存没有打开 %IPDATA:,, eg: %IPDATA:1,6,”78125578AABB” 表明： 数据来源于链接 1 实际数据长度为 6 数据为：0x78 0x12 0x55 0x78 0xAA 0xBB 4.7 缓存功能打开，但要区分 link_num来判断数据来源 AT%IPDR %IPDR：1，2，4，”3038EF55” 1：连接号 2：包序号 4：数据包长度 0x30,0x38,0xEF,0x55：数据内容 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 4 多链接功能的使用 文档版本 03 (2007-05-22) 华为技术有限公司 4-3 AT%IPDR %IPDR：2，10，4，”3038EF55” 2：连接号 10：包序号 4：数据包长度 0x30,0x38,0xEF,0x55：数据内容 4.8 关闭链接 AT%IPCLOSE=1 OK AT%IPCLOSE=2 OK 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 5 TCP服务器 AT命令的使用 文档版本 03 (2007-05-22) 华为技术有限公司 5-1 5 TCP服务器 AT命令的使用 5.1 配置 APN AT+CGDCONT=1,”IP”,”CMNET” OK 5.2 进入 tcpip功能 AT%ETCPIP OK 如果需要输入用户名和密码，假如用户名：user，密码：gprs AT%ETCPIP=”user”,”gprs” OK 5.3 开启服务器功能 AT%IPLISTEN=”TCP”,5000 OK 开启服务器,类型 TCP,端口 5000 5.4 查询服务器状态(可选) AT%IPLISTEN? %IPLISTEN: ”TCP”,5000,1 1表示目前还可连接 1个客户端(当前为单链接模式) 5 TCP服务器 AT命令的使用 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 5-2 华为技术有限公司 文档版本 03 (2007-05-22) 5.5 成功接入客户端 CONNECT: "10.10.100.115",4097,1 该步骤由客户端发起，上面为服务器端显示的非请求结果码 5.6 查询链路状态（可选） AT%IPOPEN? %IPOPEN:"TCP","10.10.100.115",4097,5000 "10.10.100.115"为客户端 IP，4097为客户端端口，5000为本地端口。 5.7 关闭服务器链路 AT%IPCLOSE=6 %IPCLOSE: 6 OK 6代表服务器正常关闭 5.8 查询服务器状态(可选) AT%IPLISTEN? %IPLISTEN:0 0表示服务器已关闭 5.9 查询链路状态(可选) AT%IPOPEN? %IPOPEN:"TCP","10.10.100.115",4097,5000 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 6 UDP服务器 AT命令的使用 文档版本 03 (2007-05-22) 华为技术有限公司 6-1 6 UDP服务器 AT命令的使用 6.1 配置 APN AT+CGDCONT=1,”IP”,”CMNET” OK 6.2 进入 tcpip功能 AT%ETCPIP OK 如果需要输入用户名和密码，假如用户名：user，密码：gprs AT%ETCPIP=”user”,”gprs” OK 6.3 开启服务器功能 AT%IPLISTEN=”UDP”,5000 OK 开启服务器,类型 UDP,端口 5000 6.4 查询服务器状态(可选) AT%IPLISTEN? %IPLISTEN: ”UDP”,5000,1 6 UDP服务器 AT命令的使用 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 6-2 华为技术有限公司 文档版本 03 (2007-05-22) 6.5 收到客户端数据后自动建立连接 %IPDATA:1,10,"0123456789” 该步骤由客户端发起。当客户端向服务器端的监听端口成功发送一包数据后，服务器会自动建立 连接。以上为服务器端收到数据后的非请求结果码。 6.6 查询链路状态（可选） AT%IPOPEN? %IPOPEN:"UDP","10.10.100.120",4097,5000,4097 第一个 4097为客户端的接收端口；5000为本地端口，第二个 4097表示客户端的发送端口。 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 7 延时发送 AT命令的使用 文档版本 03 (2007-05-22) 华为技术有限公司 7-1 7 延时发送 AT命令的使用 7.1 设置延时 AT%IPSP=5000 //设置 5秒延时 OK AT%IPSP? %IPSP:5000,1400 //5000为延时时间，1400为目前剩余内存 7.2 发送数据 AT%IPSEND=”01234” //发送第一包数据，最大长度 512字节 OK AT%IPSEND=”56789” //发送第二包数据 OK 7.3 查询待发内存状态 AT%IPSP? %IPSP:5000,1390 5000为延时时间，1390为目前剩余内存(最大量为 1400,之前已放入 10个字节) 7.4 数据发送 %IPSD: 10 %IPSEND:15 7 延时发送 AT命令的使用 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 7-2 华为技术有限公司 文档版本 03 (2007-05-22) OK 延时结束发送数据，10表示发送 10个数据,该步骤由设备自动执行，以上为非请求结果码。此时 对端只收到 1个数据包，其内容为”0123456789” 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 8 其它 AT命令的使用 文档版本 03 (2007-05-22) 华为技术有限公司 8-1 8 其它 AT命令的使用 8.1 TCP ACK查询 AT%TXSTATE % TXSTATE: 1,6,6 2,0,0 3,150,149 OK 表示链接 1，发了 6包，并且对方收到了 6包 链接 2没有建立或者是 UDP 链接 3发送了 150包，对方确认了 149包 8.2 接收缓存中数据查询 AT%IPDQ %IPDQ：4，5 OK 4：表示接收缓存中有 4包未读数据包 5：表示接收缓存中共有 5包数据（接收缓存总共能储存 10K字节数据） 8.3 删除接收缓存中的数据包 AT%IPDD %IPDD:1 OK 8 其它 AT命令的使用 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 8-2 华为技术有限公司 文档版本 03 (2007-05-22) 1:删除数据包的个数 如果不进行 AT%IPDDMODE=1的设置，使用 AT%IPDR读取后，会自动删除。缺省情 况下，自动删除。 8.4 限定 UDP数据对方发送端口 AT%IPOPENX=2,”UDP”,”61.175.8.90”,1000,2000 CONNECT 这个时候，模块只会把远端服务器 61.175.8.90 2000端口的数据提交给用户，其他端 口数据直接丢弃。 8.5 退出 tcpip功能 AT%IPCLOSE=5 OK 模块从 GPRS网络注销，仅进行 PDP去激活，没有进行 GPRS DETATCH，也就是说 GPRS仍然处于附着状态，如果您想再次打开链接，请首先进行 AT%ETCPIP操作。 8.6 域名解析 AT%DNSR=”www.huawei.com” %DNSR: 219.133.0.61 OK 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 9 附录 文档版本 03 (2007-05-22) 华为技术有限公司 9-1 9 附录 9.1 注意事项 1. 模块上电 20-30 秒后再进行 TCPIP 相关命令的使用，因为模块需要时间搜索网 络，以及相关信息初始化等。 2. 使用 AT%ETCPIP 命令，当命令还没有返回的时候，串口有任何输入都会导致该 命令强制结束，有%IPCLOSE： 5 的返回，表明模块退出 TCPIP 功能，这个时候 必须重新使用 AT%ETCPIP进行 TCPIP功能的打开操作。 3. 使用%IPSEND 发送数据，在%IOMODE=1 的时候一包请不要超过 1024 字节，如 果要发送大于 1024字节的数据包，可以采用延时发送。%IOMODE=0的时候一包 请不要超过 512 字节。推荐使用 MODE 1，因为 MODE 0 输入的必须为可见字 符，并且不能为引号（”）和分号（;）。 4. UDP 方式下，服务器下发数据一包请不要超过 512 字节，否则多余的部分会丢 失。如果要发送大于 1024字节的数据包，可以采用延时发送。 5. 打电话的时候请不要使用 AT%IPSEND或者 AT%IPSENDX进行数据发送。 6. 打电话的时候请不要使用 AT%IPCLOSE=5进行 GPRS网络注销。 7. UDP远端发送端口的校验。在打开 UDP连接时，如果设置了远端发送端口，则模 块对于该链路只接收该端口的发送过来的数据；如果没有设置远端发送端口，模 块将接收到的第一包 UDP 数据中的端口设为该链路的远端发送端口，以后对该端 口进行校验。 9.2 各种命令返回时间 1. 使用 AT%ETCPIP 返回时间与网络状况有关，3-60 秒不等，应用最长等待时间可 设置为 30 秒。为了保证通信质量，要确保 AT+CSQ 返回值在 15 以上，如果长时 间没有结果返回，可以通过输入回车符结束这条命令，然后重新使用。 2. 使用 AT%IPOPEN和 AT%IPOPENX最长需要等待 20-30秒钟左右。 3. 使用 AT%IPCLOSE关闭一条 TCP链接最长需要等待 15秒钟左右有 OK返回。 4. 使用 AT%DNSR最长需要等待 13秒左右，有结果返回。 5. 其他命令一般都能在 500ms左右有返回，应用超时等待可以设置成 3秒。 9 附录 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 9-2 华为技术有限公司 文档版本 03 (2007-05-22) 9.3 转换函数 当您设置 AT％IOMODE=1后，数据收发需要进行转换，可参考下面 2个函数： #define MAX_USER_DATA 1024 typedef unsigned char UBYTE /***************************************** ASCII 到 HEX的转换函数 入口参数： O_data: 转换数据的入口指针， N_data: 转换后新数据的入口指针 len : 需要转换的长度 返回参数：-1: 转换失败 其它：转换后数据长度 注意：O_data[]数组中的数据在转换过程中会被修改。 ****************************************/ int ascii_2_hex(UBYTE *O_data, UBYTE *N_data, int len) { int i,j,tmp_len; UBYTE tmpData; UBYTE *O_buf = O_data; UBYTE *N_buf = N_data; for(i = 0; i < len; i++) { if ((O_buf[i] >= '0') && (O_buf[i] <= '9')) { tmpData = O_buf[i] - '0'; } else if ((O_buf[i] >= 'A') && (O_buf[i] <= 'F')) //A....F { tmpData = O_buf[i] - 0x37; } else if((O_buf[i] >= 'a') && (O_buf[i] <= 'f')) //a....f { tmpData = O_buf[i] - 0x57; } else 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 9 附录 文档版本 03 (2007-05-22) 华为技术有限公司 9-3 { return -1; } O_buf[i] = tmpData; } for(tmp_len = 0,j = 0; j < i; j+=2) { N_buf[tmp_len++] = (O_buf[j]<<4) | O_buf[j+1]; } return tmp_len; } /***************************************** HEX 到 ASCII的转换函数 入口参数： data: 转换数据的入口指针 buffer: 转换后数据入口指针 len : 需要转换的长度 返回参数：转换后数据长度 *******************************************/ int hex_2_ascii(UBYTE *data, CHAR *buffer, int len) { const CHAR ascTable[17] = {"0123456789ABCDEF"}; CHAR *tmp_p = buffer; int i, pos; pos = 0; for(i = 0; i < len; i++) { tmp_p[pos++] = ascTable[data[i] >> 4]; tmp_p[pos++] = ascTable[data[i] & 0x0f]; 9 附录 华为 GTM900 无线模块 TCPIP AT命令 使用指导书 9-4 华为技术有限公司 文档版本 03 (2007-05-22) } tmp_p[pos] = '\0'; return pos; } 1 命令列表 2 打开一条TCP链接 2.1 配置apn 2.2 进入tcpip功能 2.3 打开一条tcp链接 2.4 发送数据到tcp对端(%IOMODE=1) 2.5 发送数据到tcp对端(%IOMODE=0) 2.6 新数据直接提交到串口，默认缓存没有打开(%IOMODE=1,1,1) 2.7 缓存打开，从接收缓存中数据读取(%IOMODE=1,,0) 2.8 关闭链接(单链接) 3 打开一条UDP链接 3.1 配置apn 3.2 进入tcpip功能 3.3 打开一条udp链接 3.4 发送数据到udp对端 3.5 新数据直接提交到串口，默认缓存没有打开 3.6 缓存打开，接收缓存中数据读取(%IOMODE=1,,0) 3.7 关闭链接(单链接) 4 多链接功能的使用 4.1 配置apn 4.2 进入tcpip功能 4.3 设置多链接模式 4.4 分别打开一条tcp和udp链接 4.5 发送数据到链接1或2 (%IOMODE=1) 4.6 新数据直接提交到串口，默认缓存没有打开 4.7 缓存功能打开，但要区分link_num来判断数据来源 4.8 关闭链接 5 TCP服务器AT命令的使用 5.1 配置APN 5.