最新API-接口-设计文档-模板.doc

《最新API-接口-设计文档-模板.doc》由会员分享，可在线阅读，更多相关《最新API-接口-设计文档-模板.doc（8页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、精品资料API-接口-设计文档-模板.Dream调试工具DLL接口文档文件状态： 草 稿 正式发布 正在修改当前版本： 1.0作 者：ChunFeng Li文件密级： 普通 秘密 绝密文档版本版本/状态作者参与者日期说明1.0ChunFeng LiChunFeng Li2016-04-13设备只能发现串口连接的设备，指令只能下发单条修改一、 DLL初始化1. 描述调用所有接口之前需要先调用初始化接口。2. 接口名（dll导出名）Dream_Init()3. 请求参数说明参数字段必选类型限制说明_net_pointTrueint1000发送消息的设备ID例如1000_ChannelCodeTru

2、eint0-0xFF通道编码：例如0x10_FunctionCodeTrueint0-0xFF功能编码，不同的编码对应不同的功能_FunctionNumberTrueint0-0xFF功能编号，标记当前编码对应不同的功能data_msgTruechar*发送指令的data，没有数据为NULL，如果是单个数据：12.1，如果是整组数据：12.1,1,0,. 按顺序逗号隔开的连续字符time_outTrueint20*N接口调用超时时间，单位毫秒out_bufTruechar*存放返回数据的内存指针，空间大小有调用方分配buf_max_lenTrueint分配的空间大小4. 返回参数说明a. 返回

3、类型Int : 返回数据长度。如果为0,表示超时或网络异常b. 返回的数据结构：如果是下发数据，返回的是成功和失败；”ACK”,”NAK”,”NO_CMD”,”ERROR”,”TimeOut”,如果是读取数据，返回的是数据，例如12.1，或数据组12.1,12.2,1,1.2.四、 DLL初始化1. 描述下发数据和读取数据指令都通过该接口实现。(非阻塞方式调用函数)2. 接口名（dll导出名）Dream_SendAction()3. 请求参数说明参数字段必选类型限制说明device_idTrueint1000发送消息的设备ID例如1000_ChannelCodeTrueint0-0xFF通道编

4、码：例如0x10_FunctionCodeTrueint0-0xFF功能编码，不同的编码对应不同的功能_FunctionNumberTrueint0-0xFF功能编号，标记当前编码对应不同的功能data_msgTruechar*发送指令的data，没有数据为NULL，如果是单个数据：12.1，如果是整组数据：12.1,1,0,. 按顺序逗号隔开的连续字符4. 返回参数说明a. 返回类型Int :数据为消息编号(Seq)。五、 回调函数1. 描述异步消息收到后的回调，10秒内没有收到，会返回“TimeOut”数据2. 回调函数类型intAsync_CallBack(int_device_id,i

5、nt_seq,int_ChannelCode,int_FunctionCode,int_FunctionNumber,char*data_msg)3. 请求参数说明参数字段必选类型限制说明_device_idTrueint1000发送消息的设备ID例如1000_seqTrueint100消息编号，与异步调用的返回值对应_ChannelCodeTrueint0-0xFF通道编码：例如0x10_FunctionCodeTrueint0-0xFF功能编码，不同的编码对应不同的功能_FunctionNumberTrueint0-0xFF功能编号，标记当前编码对应不同的功能data_msgTruechar*发送指令的data，没有数据为NULL，如果是单个数据：12.1，如果是整组数据：12.1,1,0,. 按顺序逗号隔开的连续字符4. 返回参数说明a. 返回类型Int :0处理成功 -1处理失败