工业级 RTU动态库说明文档为了便于广大用户更好的使用工业级RTU ，在用户能够根据自身的应用需求 的基础上， 通过自已的工具开发软件， 调用工业 RTU的一些接口函数， 简单的进 行二次开发， 就使之能够很好的适用于用户的各种工业控制系统中，实现对设备 的远程监测管理。一、数据中心动态库说明1、数据类型typedef unsigned long long u64; /uint8 typedef long long s64; /sint8 typedef unsigned int u32; /uint4 typedef int s32; /sint4 typedef unsigned short u16; /uint2 typedef short s16; /sint2 typedef unsigned char u8; /uint1 typedef char s8; /sint1 2、数据结构1）用以获取注册信息的数据结构/*/ 功能： 获取注册信息 strSIM ： 手机号 strIMEI ： 无线模块编号 strVer ： 程序版本号 strModule ：模块型号 /*/ typedef struct _logonInfo CString strSIM; CString strIMEI; CString strVer; CString strModule; LogonInfo; 2） 数字输出数据结构 /*/ 功能：数字输出 state ：数字输出的接口状态（取值： 1-高电平 2- 低电平 3-方波） cycle ：周期 （毫秒 0-65535 ）只用于方波/*/ typedef struct _digital_out_ int state; int cycle; DIGITAL_OUT; 3） PWM 输出数据结构 /*/ 功能： PWM 输出 cycle ：周期 （毫秒 0-65535 ） duty ： 频率 （毫秒 0-100 ） /*/ typedef struct _pwm_ int cycle; int duty; PWM; 4） 计数器输入数据结构 /*/ 功能：计数器输入 val ：计数当前值 ( 最大值为 8 字节正整数 ) /*/ typedef struct _counter_ _int64 val; COUNTER; 5） 重复使用数据结构 /*/ 功能：重复使用 val ： 继电器（ 1- 断开、 2-闭合） 、数字输入（ 1-高电平、 2-低电平） 、AD （4 字 节有符号整型数） /*/ typedef struct _common_ int val; COMMON; 6） 6 路接口数据结构 /*/ 功能： 6 路接口数据接口 digitalOut： 数字输出相关数据 pwm ： PWM 输出相关数据 counter ： 计数器输入相关数据 common ： 重复使用相关数据 /*/ typedef union _interface_value_ DIGITAL_OUT digitalOut; PWM pwm; COUNTER counter; COMMON common; INTERFACE_VAL; 7） RDV格式接口数据结构 /*/ 功能：RDV 格式接口，用于读取任意一路接口的状态，每一个RDV格式可携带一 路接口的状态信息 type: 接口类型用于指定是哪种接口 (1- 数字输出、 2- 继电器、 3-开关输入、 4-PWM 、5-AD 、6-计数器 ) number: 接口编号 用于指定该接口的第几路 ( 数字输出： 0-3、继电器： 0-3、 开关输入： 0-7 、 PWM：0-1、AD ：0-7、计数器： 0-5) valueUnit: 该接口当前的状态值 */ typedef struct _interface_rdv_ int type; int number; INTERFACE_VAL valueUnit; INTERFACE_RDV; 8） CTL 格式接口数据结构 /*/ 功能：ctl格式接口、用于控制任意类型的接口、每一个CTL格式控制一路接口 type ： 接口类型用于指定是哪种接口 (1- 数字输出、 2-继电器、 3- 开关输入、 4-PWM 、5-AD 、6-计数器 ) number：接口编号用于指定该接口的第几路 ( 数字输出： 0-3、继电器： 0-3、 开关输入： 0-7 、 PWM：0-1、AD ：0-7、计数器： 0-5) val ：该接口当前的状态值（1-数字输出（ 1- 高电平、 2- 低电平、 3-方波、 4-上 升沿、5-下降沿） 、2-继电器（1-断开、2-闭合） 、 3-开关输入（无） 、4-PWM（无） 、 5-AD（无） 、6-计数器（ 1-清零） ） */ typedef struct _interface_ctl_ int type; int number; int val; INTERFACE_CTL; 9） RTU参数类型 /*/ 功 能 ：参 数 类 型STRINGTYPE ：字 符 串INTTYPE：整 型 */ enum ValueType STRINGTYPE, INTTYPE, ; 10） RTU参数配置读取存取相关数据结构 /*/ 功能： 参数读取存取 id ： 参数配置的 ID 号 type ： 参数类型 intVal： 参数 值 */ typedef struct _config_item_ int id; ValueType type; int intVal; CString strVal; CONFIG_ITEM; 11） 报警接口数据结构 /*/ 功能： 报警接口 type ：接口类型 (1- 数字输出、2-继电器、 3-开关输入、4-PWM 、 5-AD 、6-计数器 ) number： 接口编号 ( 数字输出：0-3、继电器：0-3、 开关输入：0-7 、PWM： 0-1、 AD ：0-7、计数器： 0-5) strAlarm：报警的内容 /*/ typedef struct _interface_alarm_ int type; int number; string strAlarm; INTERFACE_ALARM; 3、API 函数说明设备上下线回调 /*pThiz: 回调对象 */ /*devAddr: 设备地址 */ /*bLogon: 1 是 上 线0 是 下 线 */ /*info: 注 册 信 息 */ typedef void (WINAPI *RtuLogonCallBack) (const void *pThiz, const u32 devAddr,const u8 bLogon, const LogonInfo info); 接 口 状 态 获 取 的 回 调/*pThiz: 回 调 对 象 */ /*devAddr: 设 备 地 址 */ /*nRequestID: 通信包标识号 */ /*nResult: =0则表示成功，否则失败*/ /*pList: 接口状态链表（具体格式参照协议）*/ typedef void (WINAPI *RtuInterfaceGetCallBack)(const void *pThiz, const u32 devAddr, const u32 nRequestID, const s32 nResult, const list *pList); 接口设置的回调 /*pFailedList: 返回设置失败的链表（具体格式参照协议） */ typedef void (WINAPI *RtuInterfaceSetCallBack)(const void *pThiz, const u32 devAddr, const u32 nRequestID, const s32 nResult, const list *pFailedList); 配置获取的回调 /*pList: 配置参数的链表（具体格式参照协议）*/ typedef void (WINAPI *RtuConfigGetCallBack)(const void *pThiz, const u32 devAddr, const u32 nRequestID, const s32 nResult, const list *pList); 配置设置的回调 /*pFailedList: 返回设置失败的链表（具体格式参照协议） */ typedef void (WINAPI *RtuConfigSetCallBack)(const void *pThiz, const u32 devAddr, const u32 nRequestID, const s32 nResult, const list *pFailedList); gps 重启的回调 typedef void (WINAPI *RtuGpsRebootCallBack)(const void *pThiz, const u32 devAddr, const u32 nRequestID, const s32 nResult); 接口状态主动上报的回调: pList 接口状态链表（具体格式参照协议） typedef void (WINAPI *RtuInterfaceReport)(const void *pThiz, const u32 devAddr, const list *pList); 接口报警主动上报的回调 : pList 接口报警链 表（具体格式参照协议） typedef void (WINAPI *RtuInterfaceAlarm)(const void *pThiz, const u32 devAddr, const list *pList); 短 信 报 警 主 动 上 报 的 回 调 : strAlarm 报 警 内 容typedef void (WINAPI *RtuSmsAlarm)(const void *pThiz, const u32 devAddr, const CString 启动服务器： Port 端口号 ;fun 上下线回调函数 ; pThiz 回调对象 ;handle1