网上对外发布资料适用版本

Size: px

Start display at page:

Download "网上对外发布资料适用版本"

絺褚
7 years ago
Views:

1 HDLC-ETH 通告接口 1 概述目的适用产品字节顺序对齐方式基本数据类型利用 DMS 激活通告接口组网配置通告消息 DMS 消息组成 DMSG_HEADER:DMS 消息头字段定义结构定义设备类型编码消息类型消息接收注意事项 DMSG_SEARCH_ACK 消息错误代码定义数据结构字段描述 DMSG_REPORT_GET_ACK 消息定义数据结构字段描述... 8 第 1 页共 8 页

2 1 概述 1.1 目的亚册 HDLC-ETH-200 HDLC-ETH-400 提供了通告接口, 能够主动发送通告数据, 为监控服务器或计算机提供设备运行信息数据通信收发统计报告 1.2 适用产品 HDLC-ETH-200 HDLC-ETH-400 本文统称 HDLC-ETH 1.3 字节顺序字节顺序是指占内存多于一个字节类型的数据在内存中的存放顺序, 通常有 : 小端字节序 (Little-Endian): 指低字节数据存放在内存低地址处, 高字节数据存放在内存高地址处 ; 大端字节序 (Big-Endian): 指高字节数据存放在低地址处, 低字节数据存放在高地址处由于用户系统多用基于小字节序的 x86 系列 CPU, 因此 HDLC-ETH 编程接口统一采用小端字节 (Little-Endian) 顺序定义 1.4 对齐方式为了减少数据包长度,HDLC-ETH-200/400 编程接口数据结构采用 1 字节对齐方式 1.5 基本数据类型 uint8_t:unsigned char,1 字节无符号整型数 uint16_t:unsigned short,2 字节无符号整型数 uint32_t:unsigned word,4 字节无符号整型数第 2 页共 8 页

2 利用 DMS 激活通告接口 2.1 组网 HDLC-ETH-200 以太网通告接收计算机 HDLC-ETH-400 2.

3 2 利用 DMS 激活通告接口 2.1 组网 HDLC-ETH-200 以太网通告接收计算机 HDLC-ETH 配置用户可以运行 DMS, 进入以太网接口配置, 进行通告设置通告设置包括如下参数 : 参数描述目的 IP 地址通告消息发送目的 IP, 可以为单播或组播地址目的 UDP 端口通告采用 UDP 报文发送, 目的 UDP 端口号可设设备信息通告周期设备运行信息通告的发送周期,1~255 秒统计报告通告周期收发统计报告的发送周期,1~255 秒第 3 页共 8 页

4 3 通告消息 3.1 DMS 消息组成通告消息属于 DMS 消息,DMS 为设备与管理监控计算机之间的专用交互消息接口 DMS 消息由 message header( 消息头 ) 和 message body( 消息体 ) 组成, 其中消息体最大长度不能超过 1440: 消息头 Message header 消息体 Message body 3.2 DMSG_HEADER:DMS 消息头字段定义消息头字段按顺序定义如下 : 字段字节数描述 dmsflag 2 DMS 消息标志字段, 必须为 0x444D dmsversion 1 DMS 消息版本号, 必须为 0x20, 表示 V2.0 版本 reserved 1 保留 snddevtype 4 发送方设备类型编码 snddevsn 4 发送方设备序列号 rcvdevtype 4 接收方设备类型编码, 全 1 为所有类型设备 rcvdevsn 4 接收方设备序列号, 全 1 为所有设备 msgtype 2 消息类型 msglen 2 消息长度 ( 字节数 ), 含消息头, 不超过结构定义 struct DMSG_HEADER { uint16_t dmsflag; // DMS 消息标志 uint8_t dmsversion; // DMS 消息发送方 DMS 的版本号 uint8_t reserved; // 保留 uint32_t snddevtype; uint32_t snddevsn; // 发送方设备类型编码 // 发送方设备序列号 uint32_t rcvdevtype; uint32_t rcvdevsn; // 接收方设备类型编码 // 接收方设备序列号 } uint16_t msgtype; uint16_t msglen; // 消息类型 // 消息长度, 含消息头第 4 页共 8 页

5 3.2.3 设备类型编码设备类型编码 0xFFFFFFFF 0x x 描述所有类型 HDLC-ETH-200 HDLC-ETH-400 DMS 消息类型消息名称类型编码描述 DMSG_SEARCH_ACK_ID 0x0011 设备信息通告设备搜索响应 DMSG_REPORT_GET_ACK_ID 0x1202 统计报告通告设备报告查询响应宏定义如下 : #define DMSG_SEARCH_ACK_ID #define DMSG_REPORT_GET_ACK_ID 0x0011 0x 消息接收注意事项在未来的版本中, 消息长度有可能增加, 为了保证软件的稳定性, 用户应该用 DMSG_BUFFER 大小的缓冲区接收该消息 #define DMSG_MAXLEN 1440 struct DMSG_BUFFER { DMSG_HEADER header; char data[dmsg_maxlen]; }; 第 5 页共 8 页

6 3.4 DMSG_SEARCH_ACK 消息错误代码定义错误代码采用位掩码的方式定义, 全 0 表示系统正常 #define YC_ER_HDLC_ETH_NONE 0 // 0 表示无故障 #define YC_ER_HDLC_ETH_CLOCK 0x UL // 时钟故障 #define YC_ER_HDLC_ETH_RAM 0x UL // 内存故障 #define YC_ER_HDLC_ETH_FLASH 0x UL // 闪存故障 #define YC_ER_HDLC_ETH_SWITCH 0x UL // 以太网交换功能故障 #define YC_ER_HDLC_ETH_UDPCLT 0x UL // UDP 客户端异常 #define YC_ER_HDLC_ETH_UDPSVR 0x UL // UDP 服务器异常 #define YC_ER_HDLC_ETH_DFTSET 0x UL // 以默认配置启动 #define YC_ER_HDLC_ETH_DNA 0x UL // 设备身份 ID 异常 #define YC_ER_HDLC_ETH_FACTORY 0x UL // 出厂配置异常 #define YC_ER_HDLC_ETH_CONFIG 0x UL // 设备配置异常 #define YC_ER_HDLC_ETH_HWVER 0x UL // 硬件版本号异常 #define YC_ER_HDLC_ETH_SN 0x UL // 设备序列号异常数据结构 struct DMSG_SEARCH_ACK { DMSG_HEADER header; char devicealias[32]; uint32_t errorcodes; // 设备别名 // 错误代码, 位组合 uint32_t reserved; uint32_t firmwareversion; // 设备固件版本 }; char reserved256[256]; 字段描述 DMSG_SEARCH_ACK 消息字段按顺序定义为 : 字段类型描述 header DMSG_HEADER 消息头,DMSG_HEADER devicealias [ ] char [ ] 设备别名字符串 errorcodes uint32_t 设备故障代码 firmwareversion uint32_t 固件版本第 6 页共 8 页

7 3.5 DMSG_REPORT_GET_ACK 消息定义 #define YC_HDLC_ETH_SER_NUM 4 // 设备串口数量 #define YC_HDLC_ETH_UDPCLT_NUM 16 // 设备支持 UDP client 数量 #define YC_HDLC_ETH_UDPSVR_NUM 16 // 设备支持 UDP Server 数量数据结构数据结构定义 : struct DMSG_REPORT_GET_ACK { uint32_t runseconds; // 设备加电后运行秒数 // DMS 统计 uint32_t dms_tx_pkt; uint32_t dms_tx_fail; uint32_t dms_rx_pkt; uint32_t dms_rx_invalid; // 串口收发统计 uint32_t ser_tx_pkt[yc_hdlc_eth_ser_num]; uint32_t ser_tx_overflow[yc_hdlc_eth_ser_num]; uint32_t ser_tx_toolong[yc_hdlc_eth_ser_num]; uint32_t ser_rx_pkt[yc_hdlc_eth_ser_num]; uint32_t ser_rx_crc_error[yc_hdlc_eth_ser_num]; uint32_t ser_rx_overflow[yc_hdlc_eth_ser_num]; uint32_t ser_rx_tooshort[yc_hdlc_eth_ser_num]; uint32_t ser_rx_toolong[yc_hdlc_eth_ser_num]; uint32_t ser_rx_bit_error[yc_hdlc_eth_ser_num]; // UDP client uint32_t udp_tx_pkt[yc_hdlc_eth_udpclt_num]; uint32_t udp_tx_fail[yc_hdlc_eth_udpclt_num]; // UDP Server uint32_t udp_rx_pkt[yc_hdlc_eth_udpsvr_num]; uint32_t udp_rx_fail[yc_hdlc_eth_udpsvr_num]; // 串口真实波特率 uint32_t ser_realbd[yc_hdlc_eth_ser_num]; // 内部保留 uint32_t reserved[2]; 第 7 页共 8 页

8 } 字段描述 DMSG_REPORT_GET_ACK 消息字段按顺序定义为 : 字段类型描述 header DMSG_HEADER 消息头,DMSG_HEADER runseconds uint32_t 设备加电后运行秒数 dms_tx_pkt uint32_t 设备发送 DMS 消息计数 dms_tx_fail uint32_t 设备发送 DMS 消息失败计数 dms_rx_pkt uint32_t 设备接收 DMS 消息计数 dms_rx_invalid uint32_t 设备接收无效 DMS 消息计数 ser_tx_pkt [ ] uint32_t [ ] 串口发帧计数 ser_tx_overflow [ ] uint32_t [ ] 串口发送溢出计数 ser_tx_toolong [ ] uint32_t [ ] 串口发送超长帧计数 ser_rx_pkt [ ] uint32_t [ ] 串口收帧计数 ser_rx_crc_error [ ] uint32_t [ ] 串口接收 CRC 错误计数 ser_rx_overflow [ ] uint32_t [ ] 串口接收溢出计数 ser_rx_tooshort [ ] uint32_t [ ] 串口接收超短帧计数 ser_rx_toolong [ ] uint32_t [ ] 串口接收超长帧计数 ser_rx_bit_error [ ] uint32_t [ ] 串口接收位错误计数 udp_tx_pkt [ ] uint32_t [ ] UDP 发包计数 udp_tx_fail [ ] uint32_t [ ] UDP 发送错误计数 udp_rx_pkt [ ] uint32_t [ ] UDP 收包计数 udp_rx_fail [ ] uint32_t [ ] UDP 接收错误计数第 8 页共 8 页

untitled

untitled 1....2...2...6 2....10 3. UDP...15 4. TCP...16...16...16 1 1. PC COM1 COM2 COM1 COM2 DTU 2 3 4 COM1 COM1 COM2 COM ID 13900000000 DTU COM1 5 COM2 DTU DTU DTU DTU DTU DTU DTU ID ID 3031 3032 2 ID 13900000001