数据中心动态库说明
1、数据类型
typedef UINT u32t
typedef UCHAR u8t
typedef USHORT u16t
typedef ULONG u64t
2、数据结构
1) 用以区分标识各台DTU的数据结构
typedef struct _modem_info_t_
{
u32t m_modemId //Modem模块的ID号
u8t m_phoneno[12] //Modem的11位电话号码,必须以'\0'字符结尾
u8t m_dynip[4] //Modem的4位动态ip地址
u64t m_conn_time //Modem模块最后一次建立TCP连接的时间
u64t m_refresh_time //Modem模块最后一次收发数据的时间
} ModemInfoStruct
2) DTU数据包的数据结构
#define MAX_RECEIVE_BUF 1450
typedef struct _modem_data_t
{
u32t m_modemId // Modem模块的ID号
u64t m_recv_time //接收到数据包的时间
u8t m_data_buf[MAX_RECEIVE_BUF+1] //存储接收到的数据
u16t m_data_len //接收到的数据包长度
u8t m_data_type //接收到的数据包类型,
// 0x01:用户数据包
// 0x02:对控制命令帧的回应
}ModemDataStruct
以上u64t类型的时间是基于GMT时间1970年1月1日0:00:000以来的秒数指示时间值,即当前时间距1970年1月1日0点0分0秒以秒为单位的数值。在大多数语言都提供转换函数。
3、API函数说明
1) BOOL DSStartService(u16t uiListenPort)
功能:启动服务器的数据服务
参数:u16ListenPort:服务的侦听端口
返回:成功返回TRUE,失败返回FALSE;
说明:启动服务器的数据服务。启动数据服务后,服务器侦听在指定端口。
如果失败了,可以调用DSGetLastError()函数查看错误原因。
2) BOOL DSStopService(void)
功能:停止服务器的数据服务
参数:无
返回:成功返回TRUE,失败返回FALSE;
说明:停止服务器的数据服务。所有的DTU都将下线。
如果失败了,可以调用DSGetLastError()函数查看错误原因。
3) BOOL DSGetNextData(ModemDataStruct* pDataStruct, u16t waitseconds)
功能:读取下一条DTU送上来的信息
参数:pDataStruct: 存放DTU所送上来的信息和数据的结构,读函数执行成功后,返回的数据存放到该参数指向的结构中
waitseconds:本函数读到数据后立即返回;如果没有数据到达,则等待最长waitseconds(时间单位:秒)的时间,直到有数据到达,取值范围从0~65535,如果取值为0表明本函数将立即返回。另外,当在另一个线程中执行成功了DSStopService()后,本函数将立即返回。
返回:成功返回TRUE,失败返回FALSE;
说明:如果失败了,可以调用DSGetLastError()函数查看错误原因。
4) BOOL DSSendData(u32t modemId, u16t len, u8t * buf)
功能:向指定ID号的的DTU发送数据
参数:modemId:DTU的ID号,用以标识一个DTU
len:待发送的数据长度(字节数),数据长度必须小于或等于1450个字节
buf:待发送的数据
返回:成功返回TRUE,失败返回FALSE;
说明:如果失败了,可以调用DSGetLastError()函数查看错误原因。
5) BOOL DSSendControl(u32t modemId, u16t len, u8t * buf)
功能:向指定ID号的的DTU发送控制命令
参数:modemId:DTU的ID号,用以标识一个DTU
len:待发送的控制命令长度(字节数),数据长度必须小于或等于1000个字节
buf:待发送的控制命令帧
返回:成功返回TRUE,失败返回FALSE
说明:如果失败了,可以调用DSGetLastError()函数查看错误原因。]
6) u32t DSGetModemCount(void)
功能:取得当前在线的所有的DTU的总数
参数:无
返回:得到在线的DTU的数量
7) BOOL DSGetModemByPosition(u32t pos, ModemInfoStruct *pModemInfo)
功能:取得指定位置的DTU的数据;
参数:pos:DTU列表中的位置信息,0代表第一个DTU位置
pModemInfo:指向用以保存DTU信息的数据结构
返回:成功返回TRUE,失败返回FALSE
说明:如果失败了,可以调用DSGetLastError()函数查看错误原因。
一般来说DSGetDtuCount()和DSGetDtuByPosition()函数配合使用,用以查看当前所有DTU的信息,如下例所示:
u32t uiDtuCount
uiDtuCount = DSGetDtuCount()
DtuInfoStruct dtuInfo
u32t i
for (i = 0 i < uiDtuCount i++)
{
DSGetDtuByPosition (i, &dtuInfo)
//对dtuInfo进行操作
}
8) void DSGetLastError(char *str, int nMaxBufSize)
功能:获得先前API执行时发生的错误;
参数:str:用来存放错误信息的缓冲区;
nMaxStrSize:缓冲区的最大长度,如果错误信息的大小超过了这个值,则此函数将把错误信息的尾部截除。
返回:无
9) BOOL DSDisconnect(u32t modemId)
功能:断开指定ID号的DTU连接
参数:modemId: DTU的ID号,用以标识一个DTU
返回:成功返回TRUE,失败返回FALSE
说明:如果失败了,可以调用DSGetLastError()函数查看错误原因。
4、函数的具体使用
3) 导入动态库
调用WINDOWS API函数LoadLibrary装载动态库,如下:
HMODULE DllMudule //指向动态库的句柄
BOOL (*DSStartService)(u16t) //定义一个指向函数的地址的指针
hDllModule = LoadLibrary(“gprsdll.dll”)
If (hDllModule != NULL) //判断调用是否成功
{
//从动态库中取函数地址
DSStartService = GetProcAddress(hDllModule,”DSStartService”)
if (DSStartService != NULL) //判断是否取到该函数地址
{
if ((*DSStartService)( 5001) != FALSE)
MessageBox(“启动成功”)
Else
MessageBox(“启动失败”)
}
}
在程序开始时需要调用动态库,程序运行完毕后,要释放动态库,调用windows API函数FreeLibrary可释放动态库:
FreeLibrary(hDllModule) //TRUE-success FALSE-failed
程序中LoadLibrary次数必须和FreeLibrary相同,每调用一次LoadLibrary,相应的应该调用一次FreeLibrary,保证每次调用后都会释放。
4) 启动服务
首先从动态库中取到该函数地址,取到地址后,就可以执行该函数,如下:
BOOL (*DSStartService)(u16t) //定义一个指向函数的地址的指针
DSStartService = (BOOL(*)(u16t))GetProcAddress(hDllModule, “DSStartService”)
if (DSStartService != NULL)
{
(*DSStartService)( 5001)
}
5) 停止服务
BOOL (*DSStopService)(void)
DSStopService = (BOOL (*)(void))GetProcAddress(hDllModule, “DSStopService”)
If (DSStopService != NULL)
(*DSStopService)()
6) 读数据
BOOL DSGetNextData(ModemDataStruct*, u16t)
DSGetNextData =
(BOOL(*)(ModemDataStruct*, u16t))GetProcAddress(hDllModule, “DSGetNextData”)
if (DSGetNextData != Null)
if ((*DSGetNextData)(&dtudata, 100) == 0) //dtudata为DtuDataStruct型结构
//如果没有数据最长等待100秒
{
//处理结构dtudata中的数据
}
7) 发送数据
BOOL DSSendData (u32t, u16t, u8t *)
DSSendData = (BOOL(*)(u32t, u16t, u8t*))GetProcAddress(hDllModule, “DSSendData”)
if (DSSendData != NULL)
{
(*DSSendData)(nID, len, buf)
}
8) 用户列表
底层服务维护一张用户列表,记录当前在线用户的信息,DSC如果想知道底层用户列表,需要调用提供的API函数:DSGetModemCount、DSGetModemByPosition
for (u32t i = 0 i < (*DSGetModemCount)() i++)
{
(*DSGetModemByPosition)(i, &dtuinfo)
//1、处理记录用户信息记录dtuinfo中的信息;
}
9) 错误信息
可以通过调用DSGetLastError()函数来获得上次调用API函数失败后的具体的错误信息。
char szErrorMsg[256]
DSGetLastError(szErrorMsg, 255)
这个是厦门才茂DTU动态库文件,如果需要咨询更详细,可以直接联系厦门才茂技术,或者直接到他们网站咨询
无线数据采集器是指采用2G网络将采集来的数据,打包成TCP或者UDP发送到远程数据中心服务器的设备.一般都叫DTU.DTU是无线数据传输模块,采用2G、3G网络进行远程数据传输的终端模块。其原理是将串口数据打包成TCP或者UDP包进行数据远传。
DTU一般只能传输标准的232、485数据.
广泛用于楼宇自动化控制、发电机发电,停车场设备、交通控制、LED屏幕控制、工厂、车间、矿井、银行、电气等遥控领域。
新加坡力可赛 的DTU采用工业级端子接法,可以实现232、485数据传输,同时更具备了强大的功能:
1、代替RTU,直接采集模拟量,做逻辑控制
2、可以用手机短信配置、可以手机短信作为数据备份
3、可以独立加密
4、可以通过指示灯了解设备工作状态,信号状态。
5.还有GPS卫星定位功能,24小时管理你的设备。
6. 支持telnet功能。
7. 支持远程配置,远程控制
8. 通过串口软件升级
9. 同时支持LINUX、UNIX和WINDOWS操作系统
10. 支持GPS定位数据上报和查询功能,数据导入google地图即可实现卫星地图精确定位
FC-Gateway数据采集接口网关是北京华恒信远专门为工业标准通讯接口OPC Server软件、数据采集接口软件配套定制开发的一款嵌入式硬件产品,内置两个标准RS-232串口(其中一个串口可以通过跳线设置成RS-485)和两个RJ45以太网口,型号为Gateway-227B, 此外,还有Gateway-240B、Gateway-230B等嵌入式工控机型号。
该设备操作系统有Windows、Linux两种,其功能与特点如下:
1、OPC服务器:可连接DCS、PLC等控制系统,读写实时数据,包装成OPC Server工业标准通讯接口,提供给实时数据库系统、先进控制系统和MES系统集成商;
2、安全隔离:当数据采集接口网关为实时数据库系统提供实时数据时,它一般位于自动化控制系统和实时数据库服务器之间,由于数据采集接口网关采用了内置单向数据传输技术,可达到自动化控制系统和实时数据库服务器之间的安全隔离目的
3、该产品操作系统、数据采集程序等均固化,不可修改。一旦被修改,重新启动后,自动恢复到初始状态,可防止病毒以及黑客软件攻击。
4、结构先进、安装方便,该产品高度1U,可以直接安装在标准机柜中,独特的散热技术,1U机箱有多个磁悬浮风扇散热。
5、数据采集冗余设计:支持双机双网冗余通讯。
6、可作为InfoPlus.21、PI、PHD等实时数据库系统的数据采集终端,也可写数据至关系数据库,为MIS、ERP等管理信息系统提供生产实时数据。
欢迎分享,转载请注明来源:夏雨云
评论列表(0条)