修订历史版本日期原因 V /09/01 第一次发布 V /06/11 新增函数 V /02/05 新增函数 V /08/24 更改用户手册文档模板 2013 Guangzhou ZHIYUAN Electronics Stock C

Size: px

Start display at page:

Download "修订历史版本日期原因 V /09/01 第一次发布 V /06/11 新增函数 V /02/05 新增函数 V /08/24 更改用户手册文档模板 2013 Guangzhou ZHIYUAN Electronics Stock C"

禹邴
6 years ago
Views:

1 User Manual UM V1.04 Date: 2015/08/24 类别关键词摘要内容 GPRS DTU 3G DTU, 适用于所有 ZLG 致远电子研发生产的 DTU 模块及设备广州致远电子股份有限公司

2 修订历史版本日期原因 V /09/01 第一次发布 V /06/11 新增函数 V /02/05 新增函数 V /08/24 更改用户手册文档模板 2013 Guangzhou ZHIYUAN Electronics Stock Co., Ltd. i

3 目录 1. 函数库说明串口控制函数说明 DTU_AddCOM 远程控制函数说明 DTU_AddNetServer DTU_GetNewConnectedClient DTU_GetClientInfo DTU_IsClientAvailable DTU_SendData DTU_GetReceiveDataCount DTU_ReceiveData DTU_SetReceiveDataTimeout DTU_SendDataEx DTU_Reset DTU_Disconnect DTU_StartIO DTU_ReceiveStateData DTU_SendStateData DTU_StopIO 通用配置函数说明 DTU_Init DTU_Uninit DTU_Delete DTU_EnterConfig DTU_ExitConfig DTU_ConfigRead DTU_ConfigWrite DTU_GetAllConfig DTU_GetConfig 配置表 ZWG-22A ZWG-23A ZWG-25A ZWG-23PL 函数使用串口配置操作流程远程配置操作流程使用举例如何进行本地配置如何进行远程配置详细使用例程 Guangzhou ZHIYUAN Electronics Stock Co., Ltd. 1

4 4. 产品服务软件升级 Guangzhou ZHIYUAN Electronics Stock Co., Ltd. 2

5 1. 函数库说明 1.1 串口控制函数说明 DTU_AddCOM 描述调用此函数选择 PC 上的一个串口作为 DTU 的配置串口 HANDLE stdcall DTU_AddCOM(int comindex,int baud,int databits,int checkbits,int stopbits); comindex 串口序号,1 表示 COM1,2 表示 COM2, 依此类推 baud 串口波特率, 支持的波特率为 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, databits 数据位,5 到 8 checkbits 校验位,0 表示无校验,1 表示奇校验,2 表示偶校验,3 表示强制为 1,4 表示强制为 0 stopbits 停止位,1 表示 1 个停止位,2 表示 2 个停止位返回值返回此配置串口句柄 1.2 远程控制函数说明 DTU_AddNetServer 描述调用此函数添加远程配置服务器 HANDLE stdcall DTU_AddNetServer(char* szip,int localport,char* szpwd); szip 本机的 IP 地址, 比如 localport 本机的监听端口 szpwd 服务器验证密码, 当 DTU 连接上时服务器将会用此密码和 DTU 传过来的密码进行验 1

6 证, 相同时才允许连接, 否则会禁止此 DTU 的连接当 szpwd 为表示不进行密码校验, 即允许任何 DTU 客户端连接返回值返回服务器句柄 DTU_GetNewConnectedClient 描述调用此函数获取新连接上服务器的 DTU 客户端句柄 HANDLE stdcall DTU_GetNewConnectedClient(HANDLE hserverdtu); hserverdtu 服务器句柄返回值返回 0 表示没有新连接上的 DTU 客户端, 否则为新连接上的 DTU 客户端句柄 DTU_GetClientInfo 描述调用此函数获取 DTU 客户端的相关信息 int stdcall DTU_GetClientInfo(HANDLE,char* pszdesip,int *pdesport,char* sztype,char* szid,char* szphone); DTU 客户端句柄 pszdesip 存储 DTU 的 IP 地址 pdesport 存储 DTU 的端口 sztype 存储 DTU 的设备类型 szid 存储 DTU 的设备 ID szphone 存储 DTU 对应的手机号码返回值返回为 1 表示获取成功,pszdesip pdesport sztype szid 和 szphone 分别存储获取到的信息 2

7 1.2.4 DTU_IsClientAvailable 描述调用此函数查询 DTU 客户端是否还有效, 即是否还在连接状态 int stdcall DTU_IsClientAvailable(HANDLE ); DTU 客户端句柄返回值返回 1 表示有效, 否则无效, 此时应该删除此客户端 DTU_SendData 描述调用此函数往 DTU 客户端发送数据, 此时必须保证客户端不在配置状态 int stdcall DTU_SendData(HANDLE,BYTE* pdata,int len); DTU 客户端句柄 pdata 要发送的数据地址指针 len 要发送的数据长度返回值返回发送成功的数据长度, 小于等于 0 表示发送失败 DTU_GetReceiveDataCount 描述调用此函数查询从 DTU 客户端接收到的数据长度, 此时必须保证客户端不在配置状态 int stdcall DTU_GetReceiveDataCount(HANDLE ); DTU 客户端句柄返回值返回接收到的数据长度 DTU_ReceiveData 描述 3

8 调用此函数查询从 DTU 客户端接收数据, 此时必须保证客户端不在配置状态, 此函数最好和 DTU_GetReceiveDataCount 函数配合使用 int stdcall DTU_ReceiveData(HANDLE,BYTE* pdata,int len); DTU 客户端句柄 pdata 存储接收到的数据 len 想要接收的数据长度返回值返回实际接收到的数据长度举例 if(dtu_getreceivedatacount()>0) { BYTE szdata[1024]; int res=dtu_receivedata(,szdata,1024); if(res>0) { // 对接收到的数据进行处理 } } DTU_SetReceiveDataTimeout 描述调用此函数设置从 DTU 客户端接收数据超时时间, 当超过此时间没有数据到来, 则认为此客户端已经断开连接, 默认超时时间为无限长 int stdcall DTU_SetReceiveDataTimeout(HANDLE,int tmout); DTU 客户端句柄 tmout 接收数据超时时间, 单位为毫秒返回值为 1 表示成功 4

9 1.2.9 DTU_SendDataEx 描述调用此函数发送数据, 可设置是否需要发送应答和等待应答时间, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_SendDataEx(HANDLE,BYTE* pdata,int len,int needack=0,int waittm=10000) DTU 客户端句柄 pdata 要发送的数据地址指针 len 要发送的数据长度 needack 是否需要发送应答 waittm 等待应答时间, 当 needack 为 1 时有效返回值为 1 表示成功 DTU_Reset 描述调用此函数复位设备, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_Reset(HANDLE,int waittm=10000) DTU 客户端句柄 waittm 等待应答时间返回值为 1 表示成功 DTU_Disconnect 描述调用此函数使设备断开连接, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_Disconnect(HANDLE,int waittm) 5

10 DTU 客户端句柄 waittm 等待应答时间返回值为 1 表示成功 DTU_StartIO 描述调用此函数启动设备 IO 数据采集和输出, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_StartIO(HANDLE,int waittm=10000) DTU 客户端句柄 waittm 等待应答时间返回值为 1 表示成功 DTU_ReceiveStateData 描述调用此函数获取设备 IO 采集数据, 必须在 DTU_StartIO 后调用, 可通过定时器周期性调用循环获取采集数据, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_ReceiveStateData(HANDLE,BYTE* pdata,int len) DTU 客户端句柄 pdata 存储接受数据的缓冲区地址指针 len 缓冲区长度返回值为接收到的数据长度 6

11 DTU_SendStateData 描述调用此函数发送 IO 控制数据, 可设置是否需要发送应答和等待应答时间, 必须在 DTU_StartIO 后调用, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_SendStateData(HANDLE,BYTE* pdata,int len,int needack=0,int waittm=10000) DTU 客户端句柄 pdata 要发送的数据地址指针 len 要发送的数据长度 needack 是否需要发送应答 waittm 等待应答时间, 当 needack 为 1 时有效返回值为 1 表示成功 DTU_StopIO 描述调用此函数停止设备 IO 数据采集和输出, 目前只适用于 ZWG-23PL 设备 int stdcall DTU_StartIO(HANDLE,int waittm=10000) DTU 客户端句柄 waittm 等待应答时间返回值为 1 表示成功 1.3 通用配置函数说明 DTU_Init 描述调用此函数对配置串口或远程配置服务器进行初始化, 此函数必须在程序的主线程中调 7

12 用 int stdcall DTU_Init(HANDLE ); 配置串口或远程配置服务器句柄返回值为 1 表示成功 DTU_Uninit 描述调用此函数释放配置串口或远程配置服务器所占用的资源, 此函数必须在程序的主线程中调用 int stdcall DTU_Uninit(HANDLE ); 配置串口或远程配置服务器句柄返回值为 1 表示成功 DTU_Delete 描述调用此函数释放配置串口或远程配置服务器或在远程配置中的 DTU 客户端 void stdcall DTU_Delete(HANDLE ); 配置串口或远程配置服务器或在远程配置中的 DTU 客户端句柄返回值无 DTU_EnterConfig 描述调用此函数使连接在配置串口上的 DTU 设备或连接上服务器的 DTU 客户端设备进入配置状态 int stdcall DTU_EnterConfig(HANDLE ); 8

13 返回值配置串口或在远程配置中的 DTU 客户端句柄为 1 表示成功 DTU_ExitConfig 描述调用此函数使连接在配置串口上的 DTU 设备或连接上服务器的 DTU 客户端设备退出配置状态 int stdcall DTU_ExitConfig(HANDLE,int wait); 配置串口或在远程配置中的 DTU 客户端句柄 wait 为 1 表示等待 DTU 设备返回响应信息后此函数才返回, 为 0 表示不等待直接返回 ( 有时 DTU 设备要比较长时间才返回响应信息 ) 返回值为 1 表示成功 DTU_ConfigRead 描述调用此函数读取连接在配置串口上的 DTU 设备或连接上服务器的 DTU 客户端设备的配置信息 int stdcall DTU_ConfigRead(HANDLE,char* szcmd,char* szdata); 配置串口或在远程配置中的 DTU 客户端句柄 szcmd 配置命令字符串 szdata 存储返回的配置信息返回值为 1 表示成功,0 表示操作失败,-1 表示不支持的命令码,-2 表示不支持的命令 DTU_ConfigWrite 描述 9

14 调用此函数往连接在配置串口上的 DTU 设备或连接上服务器的 DTU 客户端设备写入配置信息 int stdcall DTU_ConfigWrite(HANDLE,char* szcmd,char* szdata); 配置串口或在远程配置中的 DTU 客户端句柄 szcmd 配置命令字符串 szdata 存储要写入的配置信息返回值为 1 表示成功,0 表示操作失败,-1 表示不支持的命令码,-2 表示不支持的命令 DTU_GetAllConfig 描述调用此函数一次性获取连接在配置串口上的 DTU 设备或连接上服务器的 DTU 客户端设备的所有信息 ( 除了 GPRS 信号强度之外的其它可读信息,GPRS 信号强度需要调用 DTU_ConfigRead 来获取 ), 和 DTU_GetConfig 一起配合使用 int stdcall DTU_GetAllConfig(HANDLE ); 配置串口或在远程配置中的 DTU 客户端句柄返回值为 1 表示成功 DTU_GetConfig 描述调用 DTU_GetAllConfig 函数成功后, 调用此函数提取获取到的设备信息 int stdcall DTU_GetConfig(HANDLE,char* szcmd,char* szdata); 配置串口或在远程配置中的 DTU 客户端句柄 szcmd 存储接收到的配置命令字符串 szdata 存储接收到的和配置命令对应的配置数据返回值 10

15 为 1 表示成功举例 if(dtu_getallconfig()==1) { char szcmd[50],szdata[50]; while(dtu_getconfig(,szcmd,szdata)==1) { // 在此处对接收到的信息进行处理 } } 1.4 配置表 ZWG-22A 功能名称类型 szcmd szdata 最大长度 szdata 模块型号 R DTUTYPE 10 如 ZNE-DTU01 工作模式 RW MODE 6 ONLIN: 永远在线 ; IDLDWN: 空闲下线本地设置设备 ID 号 R DTUID 10 如设备名称 RW DTUNAM 8 如 ZLGMCU01 设备硬件版本号 R HDVER 5 如 V1.03 设备软件版本号 R SWVER 5 如 V1.03 手机号码 RW PHON 11 如 ( 固定长度 ) 数据中心主站数量 RW SVRCNT 1 默认为 1( 暂时不用 ) DNS 服务器地址 (1) RW DNS 15 如 ( 暂时不用 ) 目标设置 DNS 服务器地址 (2) RW DNS2 15 如 ( 暂时不用 ) 数据中心登录密码 RW SVRPWD 8 如 ZLGMCU01 数据中心主站 IP(1) RW SVRIP 15 如数据中心主站域名 (1) RW SVRNAM 40 如数据中心端口号 (1) RW SVRPORT 5 如

16 目标重连次数 RW TRYCUT 2 从 0( 无限制 )~99 目标重连间隔 RW TRYTIM 5 从 10~65534( 单位 : 秒 ) 目标重连中断间隔 RW TIMSPAC 5 从 1~65534( 单位 : 分 ) 串口波特率 RW SERBAUD 6 从 300~ 串口数据位长度 RW SERDAT 1 从 5~8 串口停止位长度 RW SERSTP 1 从 1~2 传输控制串口校验类型 RW SERCHK 1 0 表示无校验,1 表示奇校验,2 表示偶校验,3 表示强制为 1,4 表示强制为 0 心跳包间隔时间 RW BEATTIM 5 从 30~65534( 单位 : 秒 ) 帧间隔时间 RW SERS 5 从 0~65534( 单位 : 毫秒 ) 数据包最大长度 RW MTU 4 从 0~1024( 单位 : 字节 ) 空闲下线时间 RW IDLETIM 5 从 30~65534( 单位 : 秒 ) 远程配置模式下本地数据如何处理 RW SETDAT 9 SAVE: 保存 GIVEUP: 抛弃 APN 名称 RW APN 20 默认 CMNET APN 访问用户名 RW USRNAM 20 默认 WAP 网络 APN 访问密码 RW PWD 20 默认 WAP 短信中心号码 RW SMSNO 14 如 ( 固定长度 ) 拨号中心号码 RW CENT 20 默认 *999**1# 其它设置调试信息输出 RW DBGINF 3 ON: 有 ;OFF: 无 GPRS 信号强度 R CSQ 2 控制复位 DTU 模块 RW RSTDTU 2 ON: 复位 ; 恢复出厂设置 W DEFAULT 2 ON: 恢复出厂设置 12

17 命令退出配置模式 W OUTSET 2 ON: 进入正常工作模式 ZWG-23A 功能名称类型代号最大长度设置值模块型号 R DTUTYPE 10 如 ZWG-23A 设备硬件版本号 R HDVER 5 如 V1.01 设备软件版本号 R SWVER 5 如 V1.02 设备名称 RW DTUNAM 8 如 ZWGDTU01 设备 ID 号 RW DTUID 10 为设备唯一 ID, 不可改写本地设置 SIM 卡号码 RW PHON 11 如 ( 固定长度 ) ONLIN: 永远在线 ; 工作模式 RW MODE 6 IDLDWN: 空闲下线 IDLOFF: 空闲掉电 DTU 模式 RW DTUMODE 6 CLIENT: 客户端模式 SERVER: 服务器模式数据中心主站数量 RW SVRCNT 1 1~2( 默认为 1) DNS1 RW DNS1 15 如 : " " DNS2 RW DNS2 15 如 : " " 数据中心登录密码 RW SVRPWD 8 如主数据中心 IP RW SVRIP 15 如目标设置主数据中心域名 RW SVRNAM 40 如主数据中心端口号 RW SVRPORT 5 如 6006 主数据中心连接模式 RW CNTMODE 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接备用数据中心 IP RW SVR1IP 15 如备用数据中心域名 RW SVR1NAM 40 如备用数据中心端口号 RW SVR1PORT 5 如 6006 备用数据中心连接模式 RW CNTMODE1 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接 13

18 一批内目标重连次数 RW TRYCNT 2 从 0( 无限制 )~99 一批内目标重连间隔 RW TRYTIM 5 从 10~65534( 单位 : 秒 ) 两批间目标重连中断间隔 RW TRYSPAC 5 从 1~65534( 单位 : 秒 ) 串口波特率 RW SERBAUD 6 从 300~ 串口数据位长度 RW SERDAT 1 从 5~8 串口停止位长度 RW SERSTP 1 从 1~2 串口校验类型 RW SERCHK 4 详见说明传输控制 ON: 使能硬件流控串口硬件流控使能 RW FLOW 3 OFF: 禁止硬件流控心跳包间隔时间 RW BEATTIM 5 从 30~65534( 单位 : 秒 ) 心跳包数据设置 RW BEATDATA 2 一字节 16 进制数, 如 :"FE" 帧间隔时间 RW SERS 5 从 0~65534( 单位 : 毫秒 ) 数据包最大长度 RW MTU 4 从 0~1024( 单位 : 字节 ) 空闲下线时间 RW IDLETIM 5 从 30~65534( 单位 : 秒 ) 远程配置模式下本地数据处理方式 RW SETDAT 9 SAVE: 保存 GIVEUP: 抛弃 APN 名称 RW APN 20 默认 CMNET APN 访问用户名 RW USRNAM 20 默认 WAP APN 访问密码 RW PWD 20 默认 WAP 短信中心号码 RW SMSNO 14 如 ( 固定长度 ) 网络 DTU 本地端口号 RW LCOPORT 4 当 DTU 配置为 SERVER 时的登陆端口如 : "2020" 授权用户号码 1 RW USERNO1 13 只有被授权的手机号码才能对授权用户号码 1 RW USERNO2 13 DTU 进行短信配置如 : 或授权用户号码 1 RW USERNO DTU 登录密码 W DTUPWD 6 进行短信配置时的密码任意字符控 GPRS 信号强度 W CSQ 2 ON: 输出 14

19 制命令显示帮助信息 RW HELP - 任意内容复位当前固件 ( 软件复位 ) W RSTDTU 2 ON: 使能 ; 重新引导系统 ( 硬件复位 ) W REBOOT 2 ON: 使能 ; 恢复出厂设置 W DEFAULT 2 ON: 恢复出厂设置列出系统所有已配置 W SETLIST 2 ON: 输出退出配置模式 W OUTSET 2 ON: 进入正常工作模式其它设置调试信息输出 RW DBGINF 3 ON: 有 ;OFF: 无选择启动固件 W BOOT 2 A: 固件 A 启动 B: 固件 B 启动 ZWG-25A 功能名称类型代号最大长度设置值模块型号 R DTUTYPE 10 如 ZWD-25A 设备硬件版本号 R HDVER 5 如 V1.01 设备软件版本号 R SWVER 5 如 V1.02 设备名称 RW DTUNAM 8 如 ZWDDTU01 本地设置设备 ID 号 RW DTUID 10 为设备唯一 ID, 不可改写 UIM 卡号码 RW PHON 11 如 ( 固定长度 ) ONLIN: 永远在线 ; 工作模式 RW MODE 6 IDLDWN: 空闲下线 IDLOFF: 空闲掉电数据中心主站数量 RW SVRCNT 1 1~2( 默认为 1) 数据中心登录密码 RW SVRPWD 8 如目标设置主数据中心 IP RW SVRIP 15 如主数据中心端口号 RW SVRPORT 5 如 6006 主数据中心连接模式 RW CNTMODE 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接备用数据中心 IP RW SVR1IP 15 如备用数据中心端口号 RW SVR1PORT 5 如

20 备用数据中心连接模式 RW CNTMODE1 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接一批内目标重连次数 RW TRYCNT 2 从 0( 无限制 )~99 一批内目标重连间隔 RW TRYTIM 5 从 10~65534( 单位 : 秒 ) 两批间目标重连中断间隔 RW TRYSPAC 5 从 1~65534( 单位 : 秒 ) 串口波特率 RW SERBAUD 6 从 300~ 串口数据位长度 RW SERDAT 1 从 5~8 串口停止位长度 RW SERSTP 1 从 1~2 串口校验类型 RW SERCHK 4 详见说明传输控制 ON: 使能硬件流控串口硬件流控使能 RW FLOW 3 OFF: 禁止硬件流控心跳包间隔时间 RW BEATTIM 5 从 30~65534( 单位 : 秒 ) 心跳包数据设置 RW BEATDATA 2 一字节 16 进制数, 如 :"FE" 帧间隔时间 RW SERS 5 从 0~65534( 单位 : 毫秒 ) 数据包最大长度 RW MTU 4 从 0~1024( 单位 : 字节 ) 空闲下线时间 RW IDLETIM 5 从 30~65534( 单位 : 秒 ) 远程配置模式下本地数据处理方式 RW SETDAT 9 SAVE: 保存 GIVEUP: 抛弃数据业务号码 RW PNUM 20 默认 #777 数据业务访问用户名 RW USRNAM 20 默认 CARD 数据业务访问密码 RW PWD 20 默认 CARD 网络授权用户号码 1 RW USERNO1 13 只有被授权的手机号码才能对 DTU 进行短信配置如 : 授权用户号码 2 RW USERNO 或授权用户号码 3 RW USERNO DTU 登录密码 W DTUPWD 6 进行短信配置时的密码任意字符控制 CDMA 信号强度 W CSQ 2 ON: 输出显示帮助信息 RW HELP - 任意内容 16

21 命令复位当前固件 ( 软件复位 ) W RSTDTU 2 ON: 使能 ; 重新引导系统 ( 硬件复位 ) W REBOOT 2 ON: 使能 ; 恢复出厂设置 W DEFAULT 2 ON: 恢复出厂设置列出系统所有已配置 W SETLIST 2 ON: 输出退出配置模式 W OUTSET 2 ON: 进入正常工作模式其它设置调试信息输出 RW DBGINF 3 ON: 有 ;OFF: 无选择启动固件 W BOOT 2 A: 固件 A 启动 B: 固件 B 启动 ZWG-23PL 功能名称类型代号最大长度设置值模块型号 R DTUTYPE 10 如 ZWG-23PL 设备 ID 号 R DTUID 10 为设备唯一 ID, 不可改写设备硬件版本号 R HDVER 5 如 V1.01 设备软件版本号 R SWVER 5 如 V1.02 设备名称 RW DTUNAM 8 如 ZWGDTU01 本地设置 SIM 卡号码 RW PHON 11 如 ( 固定长度 ) ONLIN: 永远在线 ; 工作模式 RW MODE 6 IDLDWN: 空闲下线 IDLOFF: 空闲掉电 DTU 模式 RW DTUMODE 6 CLIENT: 客户端模式 SERVER: 服务器模式数据中心主站数量 RW SVRCNT 1 1~2( 默认为 1) 目标设置 DNS RW DNS 15 如 : " " 数据中心登录密码 W SVRPWD 8 如主数据中心 IP RW SVRIP 15 如主数据中心域名 RW SVRNAM 40 如主数据中心端口号 RW SVRPORT 5 如

22 主数据中心连接模式 RW CNTMODE 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接备用数据中心 IP RW SVR1IP 15 如备用数据中心域名 RW SVR1NAM 40 如备用数据中心端口号 RW SVR1PORT 5 如 6006 备用数据中心连接模式 RW CNTMODE1 3 TCP: 建立 TCP 连接 UDP: 建立 UDP 连接一批内目标重连次数 RW TRYCNT 2 从 0( 无限制 )~99 一批内目标重连间隔 RW TRYTIM 5 从 10~65534( 单位 : 秒 ) 两批间目标重连中断间隔 RW TRYSPAC 5 从 1~65534( 单位 : 秒 ) 数据中心侦听重连时间 [1] RW INTRCPTIM 5 从 0~65534( 单位 : 秒 ) 功能名称类型代号最大长度设置值串口波特率 RW SERBAUD 6 从 300~ 串口数据位长度 RW SERDAT 1 从 5~8 串口停止位长度 RW SERSTP 1 从 1~2 串口校验类型 RW SERCHK 4 详见说明传输控制 ON: 使能流控 ; 串口硬件流控使能 RW FLOW 3 OFF: 禁止流控心跳包间隔时间 RW BEATTIM 5 从 30~65534( 单位 : 秒 ) 心跳包数据设置 [1] RW BEATDATA 512 ASCII 码表示的 16 进制数帧间隔时间 RW SERS 5 从 0~65534( 单位 : 毫秒 ) 数据包最大长度 RW MTU 4 从 0~1024( 单位 : 字节 ) 空闲下线时间 RW IDLETIM 5 从 30~65534( 单位 : 秒 ) 远程配置模式下本地数据处理方式 RW SETDAT 9 SAVE: 保存 GIVEUP: 抛弃 I/O 控制 I/O 功能使能控制 RW IOENABLE 3 ON,OFF I/O 功能配置 RW IOxFUN 2 IO,AD,DA(DA 功能仅限 IO0) I/O 方向配置 RW IOxDIR 3 OUT,IN 或留空 18

23 I/O 极性配置 RW IOxPOL 1 N,P,C 或留空 I/O 匹配值设置 RW IOxVAL 4 0~2500 或留空 I/O 触发次数设置 RW IOxTRNM 2 1~99 或留空 I/O 采样周期设置 RW IOxSMPTM 5 50~65534 或留空 I/O 采样数据上报使能控制 RW IOxSDAT 3 ON,OFF I/O 短信报警使能控制 RW IOxSMS 3 ON,OFF I/O 报警短信内容 RW IOxSMSTXT 40 自定义英文字符, 如 Alarm! APN 名称 RW APN 20 默认 CMNET APN 访问用户名 RW USRNAM 20 默认 WAP APN 访问密码 RW PWD 20 默认 WAP 短信中心号码 RW SMSNO 14 如 ( 固定长度 ) 网络当 DTU 配置为 SERVER 时 DTU 本地端口号 RW LCOPORT 4 的登录端口如 : "2020" 授权用户号码 1 RW USERNO1 13 只有被授权的手机号码才能对授权用户号码 2 RW USERNO2 13 DTU 进行短信配置如 : 授权用户号码 3 RW USERNO 或 DTU 登录密码 W DTUPWD 6 进行短信操作时的密码任意字符功能名称类型代号最大长度设置值 GPRS 信号强度 R CSQ 2 ON: 输出显示帮助信息 RW HELP - 任意内容控制命令复位当前固件 ( 软件复位 ) W RSTDTU 2 ON: 使能 ; 重新引导系统 ( 硬件复位 ) W REBOOT 2 ON: 使能 ; 恢复出厂设置 W DEFAULT 2 ON: 恢复出厂设置列出系统所有已配置 W SETLIST 2 ON: 输出退出配置模式 W OUTSET 2 ON: 进入正常工作模式 19

24 调试信息输出 RW DBGINF 3 ON: 有 ;OFF: 无选择启动固件 RW BOOT 2 A: 固件 A 启动 B: 固件 B 启动其它设置保留 1 RW RSRVPARM1 4 用作工程配置保留, 保留 2 RW RSRVPARM2 4 字符串格式保留 3 RW RSRVPARM3 5 工程配置保留, 数据格式保留 4 RW RSRVPARM4 5 范围 :0~65534 [1] 该只适用于某些定制版本的 ZWG-23PL 设备中, 对于通用产品不适用 20

25 2. 函数使用 2.1 串口配置操作流程 DTU_AddCOM DTU_Init DTU_EnterConfig DTU_ConfigRead DTU_ConfigWrite DTU_GetAllConfig DTU_GetConfig DTU_ExitConfig DTU_Uninit DTU_Delete 21

26 2.2 远程配置操作流程 DTU_AddNetServer DTU_Init ( 初始化服务器 ) DTU_GetNewConnectedClient 客户端操作 DTU_GetClientInfo DTU_EnterConfig DTU_SendData DTU_GetReceiveDataCount DTU_ReceiveData DTU_ConfigRead DTU_ConfigWrite DTU_GetAllConfig DTU_GetConfig DTU_ExitConfig DTU_Delete ( 删除客户端 ) DTU_Uninit ( 卸载服务器 ) DTU_Delete ( 删除服务器 ) 22

27 3. 使用举例 3.1 如何进行本地配置 HANDLE ; char szcmd[20],szdata[20]; =DTU_AddCOM(1,57600,8,0,1); DTU_Init(); DTU_EnterConfig(); if(dtu_getallconfig()) // 获取所有配置信息 { while(dtu_getconfig(,szcmd,szdata)) { // 对接收到的配置信息进行处理 } } DTU_ExitConfig(); DTU_Uninit(); DTU_Delete(); 3.2 如何进行远程配置 HANDLE hserver,; hserver=dtu_addnetserver( ,4001); // 添加服务器 DTU_Init(hServer); // 在定时器中进行查询是否有客户端连接上 =DTU_GetNewConnectedClient(hServer); // 当!=NULL 表示有新的客户端连接上 // 当!=NULL 时进行以下操作 char szcmd[20],szdata[20]; DTU_EnterConfig(); if(dtu_getallconfig()) // 获取所有配置信息 { while(dtu_getconfig(,szcmd,szdata)) { // 对接收到的配置信息进行处理 } 23

28 } DTU_ExitConfig(); // 删除已经连接上的客户端 DTU_Delete(); DTU_Uninit(hServer); DTU_Delete(hServer); 3.3 详细使用例程在 Examples 目录中有在 VC VB CB 和 Delphi 下如何使用此动态库的完整例程, 请自行查看 24

29 4. 产品服务 4.1 软件升级终生免费升级技术支持 25

销售与服务网络广州致远电子股份有限公司地址 : 广州市天河区车陂路黄洲工业区 7 栋 2 楼邮编 :510660 网址 :www.zlg.

30 销售与服务网络广州致远电子股份有限公司地址 : 广州市天河区车陂路黄洲工业区 7 栋 2 楼邮编 : 网址 : 全国销售与服务电话 : 全国服务电话 : 销售与服务网络 : 广州总公司广州市天河区车陂路黄洲工业区 7 栋 2 楼电话 :(020) 上海分公司 : 上海上海市北京东路 668 号科技京城东楼 12E 室电话 :(021) 北京分公司北京市海淀区知春路 108 号豪景大厦 A 座 19 层电话 :(010) 上海分公司 : 南京南京市珠江路 280 号珠江大厦 1501 室电话 :(025) 深圳分公司深圳市福田区深南中路 2072 号电子大厦 12 楼电话 :(0755) 上海分公司 : 杭州杭州市天目山路 217 号江南电子大厦 502 室电话 :(0571) 武汉分公司武汉市洪山区广埠屯珞瑜路 158 号室 ( 华中电脑数码市场 ) 电话 :(027) 重庆分公司重庆市九龙坡区石桥铺科园一路二号大西洋国际大厦 ( 赛格电子市场 )2705 室电话 :(023) 成都分公司成都市一环路南二段 1 号数码科技大厦 403 室电话 :(028) 西安办事处西安市长安北路 54 号太平洋大厦 1201 室电话 :(029) 请您用以上方式联系我们, 我们会为您安排样机现场演示, 感谢您对我公司产品的关注! 26

修订历史版本日期原因 V /09/25 创建文档 V /12/10 根据文档新模板更改 i

修订历史版本日期原因 V /09/25 创建文档 V /12/10 根据文档新模板更改 i Application Note V1.01 Date: 2014/12/10 类别关键词摘要内容 DTU AT 命令本文讲解了 DTU 的配置 AT 命令广州致远电子股份有限公司修订历史版本日期原因 V1.00 2010/09/25 创建文档 V1.01 2014/12/10 根据文档新模板更改 i 目录 1. DTU 的配置方式...1 1.1 本地方式下配置模式的进入...2

修订历史版本 日期 原因 V /09/01 第一次发布 V /06/11 新增函数 V /02/05 新增函数 V /08/24 更改用户手册文档模板 2013 Guangzhou ZHIYUAN Electronics Stock C

修订历史版本日期原因 V /09/01 第一次发布 V /06/11 新增函数 V /02/05 新增函数 V /08/24 更改用户手册文档模板 2013 Guangzhou ZHIYUAN Electronics Stock C