DSC 开发帮助文档
版本号:2.4
深圳市宏电技术股份有限公司
深圳市宏电技术股份有限公司
目 录
简介.................................................................................................................................................................4
开发包使用环境............................................................................................................................................4
开发包的数据结构........................................................................................................................................4
自定义数据类型....................................................................................................................................4
DTU 信息结构.......................................................................................................................................4
DTU 数据结构.......................................................................................................................................5
函数说明........................................................................................................................................................5
服务函数................................................................................................................................................5
用户列表函数......................................................................................................................................12
参数配置函数......................................................................................................................................15
日志查询函数......................................................................................................................................19
远程升级函数......................................................................................................................................20
特殊函数..............................................................................................................................................21
DSC 开发流程举例......................................................................................................................................23
消息模式..............................................................................................................................................23
非阻塞模式..........................................................................................................................................25
阻塞模式..............................................................................................................................................27
参数配置..............................................................................................................................................29
判断 DTU 超时.............................................................................................................................................31
常见问题......................................................................................................................................................32
旧版开发包函数..........................................................................................................................................34
附录...............................................................................................................................................................34
参数配置查询界面使用说明..............................................................................................................34
日志查询界面使用说明......................................................................................................................36
远程升级界面使用说明......................................................................................................................37
配置文件说明..............................................................................................................................................39
文件名称......................................................................................................................................................39
文件说明......................................................................................................................................................39
dtuparam_H7710_S.ini.................................................................................................................................39
H7710 单中心...............................................................................................................................................39
dtuparam_H7710_M.ini...............................................................................................................................39
H7710 多中心...............................................................................................................................................39
dtuparam_H7210 标准单中心版本.ini........................................................................................................39
H7210 标准单中心.......................................................................................................................................39
dtuparam_H7210 升级版本.ini....................................................................................................................39
H7210 升级...................................................................................................................................................39
dtuparam_H7210 主备版本.ini....................................................................................................................39
H7210 主备...................................................................................................................................................39
参数表...........................................................................................................................................................39
移动服务中心参数选项......................................................................................................................39
终端参数选项......................................................................................................................................40
数据中心..............................................................................................................................................41
串口参数..............................................................................................................................................41
特殊设置..............................................................................................................................................41
系统参数(只可查询)......................................................................................................................41
深圳市宏电技术股份有限公司
简介
DSC(Data Service Center)是用于管理 DTU、与 DTU 进行数据收发的的服务软件,它需要通过开
发包中动态库 wcomm_dll.dll 来完成和 DTU 之间的通讯。 动态库 wcomm_dll.dll 包括了和 DTU 通讯所需
要的全部 API 函数,包括服务的启动、服务的停止、数据的发送、数据的接收、参数的配置、参数的查询等 。
DSC 实际上是架构在动态库 wcomm_dll.dll 所提供的功能之上的数据处理软件,其所需要完成的主要功能
如下:
1、 调用 API 启动服务和停止服务。
2、 调用 API 接收数据和向 DTU 发送数据,并且对数据作进一步处理。
3、 调用 API 轮询 DTU 用户列表,如果需要可作进一步处理,包括对终端用户认证等。
4、 调用 API 对 DTU 进行远程配置。
开发包使用环境
DSC 开发包中的动态库 wcomm_dll.dll 是在 VC7.0 基础上进行编译的,需要在 windows 平台,.net 环境
下使用。如果用户没有安装.net 环境,使用时必须将开发包中的 MFC 库文件拷贝到用户执行程序相同的目
录中。
开发包的数据结构
开发包中主要包括如下几种类型的函数:
DTU
信息结构 用于维护用户列表的函数。
DTU
数据结构 用于读取 DTU 数据函数。
自定义数据类型
uint8 = unsigned char;
uint16 = unsigned short;
uint32 = unsigned int;
MAX_RECEIVE_BUF = 1024; //数据包的最大长度
DTU 信息结构
typedef struct _USER_INFO
{
Char m_userid[12]; //DTU 身份识别码
uint32 m_sin_addr; //DTU 进入 Internet 的代理主机 IP 地址
uint16 m_sin_port; //DTU 进入 Internet 的代理主机 IP 端口
uint32 m_local_addr; //DTU 在移动网内 IP 地址
uint16 m_local_port; //DTU 在移动网内 IP 端口
char m_logon_date[20];//DTU 登录时间
char m_update_time[20]; //DTU 包更新时间,DSC 接收到该 DTU 最近一个包的时间,使
用前四字节,time_t 类型,后 16 字节未使用
uint8 m_status; //DTU 状态, 1 在线 ,0 不在线
}user_info;
深圳市宏电技术股份有限公司
DTU 数据结构
typedef struct _USER_DATA_RECORD
{
char m_userid[12]; //DTU 身份识别码
char m_recv_date[20]; //接收到数据包的时间
char m_data_buf[MAX_RECEIVE_BUF]; //存储接收到的数据
uint16 m_data_len; //接收到的数据包长度
uint8 m_data_type; //接收到的数据包类型
}data_record;
接收到的数据包类型(m_data_type):
1)0x01 DTU 请求注册包
2)0x02 DTU 请求注销包
3)0x03 忽略(当 DTU 尚未注册成功而向 DSC 发送数据时)
3)0x04>无效的数据包
4)0x05 DTU 已经接收到 DSC 发送的用户数据包
5)0x09 DTU 向 DSC 发送的用户数据包
6)0x0d DTU 参数设置成功应答包
7)0x0b DTU 参数查询应答包
8)0x06 请求断开 DTU PPP 连接成功应答包
9)0x07 请求 DTU 停止向 DSC 发送数据成功应答包
10)0x08 请求 DTU 开始向 DSC 发送数据成功应答包
11)0x0A 请求 DTU 清除缓冲区数据成功应答包
函数说明
DSC 开发包包含一系列函数,以下是这些函数的分类:
服务函数 开发包中主要的功能函数,用于启动、停止 DSC 服务,与 DTU 进行数据收发
等。
用户列表函数 用于维护开发包中 DTU 列表的函数。
参数配置函数 用于对 DTU 进行远程参数查询、配置的函数。
特殊函数 某种特殊功能,或某些特殊版本 DTU 需要用到的函数。
服务函数
服务函数是开发包中主要的功能函数,实现启动、停止 DSC 服务,与 DTU 进行数据收发等功能,它包含
以下的函数:
start_net_service
启动服务
stop_net_service
停止服务
do_read_proc
读取数据
do_send_user_data
发送数据
do_close_one_user
关闭某一 DTU,不向其发送下线指令
do_close_one_user2
关闭某一 DTU,同时向其发送下线指令
do_close_all_user
关闭所有 DTU,不向其发送下线指令
do_close_all_user2
关闭所有 DTU,同时向其发送下线指令
SetWorkMode
设置开发包读取数据方式
SelectProtocol
选择开发包的通讯协议
cancel_read_block
取消阻塞方式的读取动作
GetCurrentIP
获取当前服务使用的 IP
- 1
- 2
- 3
- 4
前往页