usbcontrol动态库使用说明.doc

UsbControl动态库使用说明
UsbControlDLL动态库使用说明
UsbControlDLL动态库不仅提供了在 PC 机上访问这些端点的 API 低级函数(必须在安装设备控制器的PC机驱动程序后才可以使用, 通过本动态库提供的 API 函数，即使您没有完全理解复杂的 USB 协议也可以快速完成USB的应用软件开发)。还提供了直接控制五路步进或者伺服马达运动的高级函数,通过这些提供的函数,可以帮助您快速地开发出如雕刻机\激光切割机\点胶机等运动控制类型的软件。
一、库函数说明
UsbControlDLL动态库一共有3个文件，、、。动态库是Microsoft Windows的接口标准，流行的软件开发工具VC.
1． 读IN端点缓冲区函数
读IN端点FIFO
函数名称 Usb_ReadData
函数原型
int __stdcall Usb _ReadData (int siPipeNum,
unsigned char *pucRcvBuf, int siReadLen, int siWaitTime)
功能描述
从USB设备读取数据
函数参数
siPipeNum：待操作管道号，可以是0、2、4、6、8、10、12
pucRcvBuf：接收数据缓冲区指针
siReadLen： 待读取字节数
siWaitTime：等待超时时间，单位ms，为-1表示一直等待
函数返回值
操作成功：成功读取的字节数；操作失败：-1
2． 写OUT端点缓冲区函数 写OUT端点FIFO
函数名称 Usb _WriteData
函数原型
int __stdcall Usb _WriteData(int siPipeNum, unsigned char *pucSendBuf, int siSendLen, int siWaitTime)
功能描述
向USB设备写入数据
函数参数
siPipeNum： 待操作管道号，可以是1、3、5、7、9、11、13
pucSendBuf：发送数据缓冲区指针
siSendLen： 待发送字节数
siWaitTime： 等待超时时间，单位ms，为-1表示一直等待
函数返回值
操作成功：成功发送的字节数；操作失败：-1
功能描述
从USB设备的逻辑端点2读取数据
函数参数
pucRcvBuf：接收数据缓冲区指针
siReadLen： 待读取字节数
siWaitTime：等待超时时间，单位ms，为-1表示一直等待
函数返回值
操作成功：成功读取的字节数；操作失败：-1
5． 写逻辑端点1 写逻辑端点1
函数名称 Usb _WritePort1
函数原型
int __stdcall Usb _WritePort1 (unsigned char *pucSendBuf,
int siSendLen, int siWaitTime)
功能描述
向USB设备的逻辑端点1写入数据
函数参数
pucSendBuf：发送数据缓冲区指针
siSendLen： 待发送字节数
siWaitTime：等待超时时间，单位ms，为-1表示一直等待
函数返回值
操作成功：成功发送的字节数；操作失败：-1
6． 写逻辑端点2 写逻辑端点2
函数名称 Usb _WritePort2
函数原型
int __stdcall Usb _WritePort2 (unsigned char *pucSendBuf,
int siSendLen, int siWaitTime)
功能描述
向USB设备的逻辑端点2写入数据
函数参数
pucSendBuf：发送数据缓冲区指针
siSendLen： 待发送字节数
siWaitTime：等待超时时间，单位ms，为-1表示一直等待
函数返回值
操作成功：成功发送的字节数；操作失败：-1
二、库函数应用举例
1． 对IN端点进行读操作
unsigned char RcvBuf [16]; // 定义16字节接收数据缓冲区
Usb _ReadData (0,RcvBuf,16,1000); // 从逻辑端点1的IN端点读取16字节数据 // 等待超时时间为 1000 毫秒
2． 对OUT端点进行写操作
unsigned char SendBuf [5]={0,0,0,0,0}; //