DSC开发帮助文档V2.2【荐】.docVIP

DSC开发帮助文档 版本号：2.2 305时间间隔略roc 深圳市宏电技术股份有限公司  目 录 简介 3 开发包使用环境 3 开发包的数据结构 3 自定义数据类型 3 DTU信息结构 3 DTU数据结构 4 函数说明 4 服务函数 4 用户列表函数 11 参数配置函数 14 特殊函数 17 DSC开发流程举例 19 消息模式 19 非阻塞模式 21 阻塞模式 23 参数配置 25 判断DTU超时 27 常见问题 28 旧版开发包函数 30 参数表 30 移动服务中心参数选项 30 终端参数选项 30 数据中心 31 串口参数 31 特殊设置 31 系统参数（只可查询） 32 简介 DSC（Data Service Center）是用于管理DTU、与DTU进行数据收发的的服务软件，它需要通过开发包中动态库wcomm_dll.dll来完成和DTU之间的通讯。 动态库wcomm_dll.dll包括了和DTU通讯所需要的全部API函数，包括服务的启动、服务的停止、数据的发送、数据的接收、参数的配置、参数的查询等。DSC实际上是架构在动态库wcomm_dll.dll所提供的功能之上的数据处理软件，其所需要完成的主要功能如下： 调用API启动服务和停止服务。 调用API接收数据和向DTU发送数据，并且对数据作进一步处理。 调用API轮询DTU用户列表，如果需要可作进一步处理，包括对终端用户认证等。 调用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?无效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开发包包