UsbControl动态库使用说明.docVIP

UsbControlDLL动态库使用说明 UsbControlDLL动态库不仅提供了在 PC 机上访问这些端点的 API 低级函数(必须在安装设备控制器的PC机驱动程序后才可以使用, 通过本动态库提供的 API 函数，即使您没有完全理解复杂的 USB 协议也可以快速完成USB的应用软件开发)。还提供了直接控制五路步进或者伺服马达运动的高级函数,通过这些提供的函数,可以帮助您快速地开发出如雕刻机\激光切割机\点胶机等运动控制类型的软件。 一、库函数说明 UsbControlDLL动态库一共有3个文件，包括UsbControlDLL.h、UsbControlDLL.lib、UsbControlDLL.dll。动态库是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 为配合下位机固件程序和方便用户使用，本动态库对上面的读写端点缓冲区函数做了进一步封装，提供了逻辑端点1(管道0、1)和逻辑端点2(管道2、3)的读写函数。 3． 读逻辑端点1 读逻辑端点1 函数名称 Usb _ReadPort1 函数原型 int __stdcall Usb _ReadPort1 (unsigned char *pucRcvBuf, int siReadLen, int siWaitTime) 功能描述 从USB设备的逻辑端点1读取数据 函数参数 pucRcvBuf：接收数据缓冲区指针 siReadLen： 待读取字节数 siWaitTime：等待超时时间，单位ms，为-1表示一直等待 函数返回值 操作成功：成功读取的字节数；操作失败：-1 4． 读逻辑端点2 读逻辑端点2 函数名称 Usb _ReadPort2 函数原型 int __stdcall Usb _ReadPort2 (unsigned char *pucRcvBuf, int siReadLen, int siWaitTime) 功能描述 从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