CH341PAR.ZIP_CH341_CH341PAR_CH341PAR driver_CH341W_CH341WDM.SYS

// 2004.05.28, 2004.10.20, 2005.01.08, 2005.03.25, 2005.04.28, 2005.07.18, 2005.07.28, 2005.09.19, 2007.12.19, 2008.10.15 //**************************************** //** Copyright (C) W.ch 1999-2008 ** //** Web: http://www.winchiphead.com ** //**************************************** //** DLL for USB interface chip CH341 ** //** C, VC5.0 ** //**************************************** // // USB总线接口芯片CH341并口应用层接口库 V2.1 // 南京沁恒电子有限公司 作者: W.ch 2008.10 // CH341-DLL V2.1 // 运行环境: Windows 98/ME, Windows 2000/XP // support USB chip: CH341, CH341A // USB => Parallel, I2C, SPI, JTAG ... // #ifndef _CH341_DLL_H #define _CH341_DLL_H #ifdef __cplusplus extern "C" { #endif #define mOFFSET( s, m ) ( (ULONG) & ( ( ( s * ) 0 ) -> m ) ) // 定义获取结构成员相对偏移地址的宏 #ifndef max #define max( a, b ) ( ( ( a ) > ( b ) ) ? ( a ) : ( b ) ) // 较大值 #endif #ifndef min #define min( a, b ) ( ( ( a ) < ( b ) ) ? ( a ) : ( b ) ) // 较小值 #endif #ifdef ExAllocatePool #undef ExAllocatePool // 删除带TAG的内存分配 #endif #ifndef NTSTATUS typedef LONG NTSTATUS; // 返回状态 #endif typedef struct _USB_SETUP_PKT { // USB控制传输的建立阶段的数据请求包结构 UCHAR mUspReqType; // 00H 请求类型 UCHAR mUspRequest; // 01H 请求代码 union { struct { UCHAR mUspValueLow; // 02H 值参数低字节 UCHAR mUspValueHigh; // 03H 值参数高字节 }; USHORT mUspValue; // 02H-03H 值参数 }; union { struct { UCHAR mUspIndexLow; // 04H 索引参数低字节 UCHAR mUspIndexHigh; // 05H 索引参数高字节 }; USHORT mUspIndex; // 04H-05H 索引参数 }; USHORT mLength; // 06H-07H 数据阶段的数据长度 } mUSB_SETUP_PKT, *mPUSB_SETUP_PKT; #define mCH341_PACKET_LENGTH 32 // CH341支持的数据包的长度 #define mCH341_PKT_LEN_SHORT 8 // CH341支持的短数据包的长度 typedef struct _WIN32_COMMAND { // 定义WIN32命令接口结构 union { ULONG mFunction; // 输入时指定功能代码或者管道号 NTSTATUS mStatus; // 输出时返回操作状态 }; ULONG mLength; // 存取长度,返回后续数据的长度 union { mUSB_SETUP_PKT mSetupPkt; // USB控制传输的建立阶段的数据请求 UCHAR mBuffer[ mCH341_PACKET_LENGTH ]; // 数据缓冲区,长度为0至255B }; } mWIN32_COMMAND, *mPWIN32_COMMAND; // WIN32应用层接口命令 #define IOCTL_CH341_COMMAND ( FILE_DEVICE_UNKNOWN << 16 | FILE_ANY_ACCESS << 14 | 0x0f34 << 2 | METHOD_BUFFERED ) // 专用接口 #define mWIN32_COMMAND_HEAD mOFFSET( mWIN32_COMMAND, mBuffer ) // WIN32命令接口的头长度 #define mCH341_MAX_NUMBER 16 // 最多同时连接的CH341数 #define mMAX_BUFFER_LENGTH 0x1000 // 数据缓冲区最大长度4096 #define mMAX_COMMAND_LENGTH ( mWIN32_COMMAND_HEAD + mMAX_BUFFER_LENGTH ) // 最大数据长度加上命令结构头的长度 #define mDEFAULT_BUFFER_LEN 0x0400 // 数据缓冲区默认长度1024 #define mDEFAULT_COMMAND_LEN ( mWIN32_COMMAND_HEAD + mDEFAULT_BUFFER_LEN ) // 默认数据长度加上命令结构头的长度 // CH341端点地址 #define mCH341_ENDP_INTER_UP 0x81 // CH341的中断数据上传端点的地址 #define mCH341_ENDP_INTER_DOWN 0x01 // CH341的中断数据下传端点的地址 #define mCH341_ENDP_DATA_UP 0x82 // CH341的数据块上传端点的地址 #define mCH341_ENDP_DATA_DOWN 0x02 // CH341的数据块下传端点的地址 // 设备层接口提供的管道操作命令 #define mPipeDeviceCtrl 0x00000004 // CH341的综合控制管道 #define mPipeInterUp 0x00000005 // CH341的中断数据上传管道 #define mPipeDataUp 0x00000006 // CH341的数据块上传管道 #define mPipeDataDown 0x00000007 // CH341的数据块下传管道 // 应用层接口的功能代码 #define mFuncNoOperation 0x00000000 // 无操作 #define mFuncGetVersion 0x00000001 // 获取驱动程序版本号 #define mFuncGetConfig 0x00000002 // 获取USB设备配置描述符 #define mFuncSetTimeout 0x00000009 // 设置USB通讯超时 #define mFuncSetExclusive 0x0000000b // 设置独占使用 #define mFuncResetDevice 0x0000000c // 复位USB设备 #define mFuncResetPipe 0x0000000d // 复位USB管道 #define mFuncAbortPipe 0x0000000e // 取消USB管道的数据请求 // CH341并口专用的功能代码 #define mFuncSetParaMode 0x0000000f // 设置并口模式 #define mFuncReadData0 0x00000010 // 从并口读取数据块0 #define mFuncReadData1 0x00000011 // 从并口读取数据块1 #define mFuncWriteData0 0x00000012 // 向并口写入数据块0 #define mFuncWriteData1 0x00000013 // 向并口写入数据块1 #define mFuncWriteRead 0x00000014 // 先输出再输入 #define mFuncBufferMode 0x00000020 // 设定缓冲上传模式及查询缓冲区中的数据长度 #define mFuncBufferModeDn 0x00000021 // 设定缓冲下传模式及查询缓冲区中的数据长度 // USB设备标准请求代码 #define mUSB_CLR_FEATURE 0x01 #define mUSB_SET_FEATURE 0x03 #define mUSB_GET_STATUS 0x00 #define mUSB_SET_ADDRESS 0x05 #define mUSB_GET_DESCR 0x06 #define mUSB_SET_DESCR 0x07 #define mUSB_GET_CONFIG 0x08 #define mUSB_SET_CONFIG 0x09 #define mUSB_GET_INTERF 0x0a #define mUSB_SET_INTERF 0x0b #define mUSB_SYNC_FRAME 0x0c // CH341控制传输的厂商专用请求类型 #define mCH341_VENDOR_READ 0xC0 // 通过控制传输实现的CH341厂商专用读操作 #define mCH341_VENDOR_WRITE 0x40 // 通过控制传输实现的CH341厂商专用写操作 // CH341控制传输的厂商专用请求代码 #define mCH341_PARA_INIT 0xB1 // 初始化并口 #define mCH341_I2C_STATUS 0x52 // 获取I2C接口的状态 #define mCH341_I2C_COMMAND 0x53 // 发出I2C接口的命令 // CH341并口操作命令代码 #define mCH341_PARA_CMD_R0 0xAC // 从并口读数据0,次字节为长度 #define mCH341_PARA_CMD_R1 0xAD // 从并口读数据1,次字节为长度 #define mCH341_PARA_CMD_W0 0xA6 // 向并口写数据0,从次字节开始为数据流 #define mCH341_PARA_CMD_W1 0xA7 // 向并口写数据1,从次字节开始为数据流 #define mCH341_PARA_CMD_STS 0xA0 // 获取并口状态 // CH341A并口操作命令代码 #define mCH341A_CMD_SET_OUTPUT 0xA1 // 设置并口输出 #define mCH341A_CMD_IO_ADDR 0xA2 // MEM带地址读写/输入输出,从次字节开始为命令流 #define mCH341A_CMD_PRINT_OUT 0xA3 // PRINT兼容打印方式输出,从次字节开始为数据流 #define mCH341A_CMD_PWM_OUT 0xA4 // PWM数据输出的命令包,从次字节开始为数据流 #define mCH341A_CMD_SHORT_PKT 0xA5 // 短包,次字节是该命令包的真正长度,再次字节及之后的字节是原命令包 #define mCH341A_CMD_SPI_STREAM 0xA8 // SPI接口的命令包,从次字节开始为数据流 //#define mCH341A_CMD_SIO_STREAM 0xA9 // SIO接口的命令包,从次字节开始为数据流 #define mCH341A_CMD_I2C_STREAM 0xAA // I2C接口的命令包,从次字节开始为I2C命令流 #define mCH341A_CMD_UIO_STREAM 0xAB // UIO接口的命令包,从次字节开始为命令流 #define mCH341A_CMD_PIO_STREAM 0xAE // PIO接口的命令包,从次字节开始为数据流 // CH341A控制传输的厂商专用请求代码 #define mCH341A_BUF_CLEAR 0xB2 // 清除未完成的数据 #define mCH341A_I2C_CMD_X 0x54 // 发出I2C接口的命令,立即执行 #define mCH341A_DELAY_MS 0x5E // 以亳秒为单位延时指定时间 #define mCH341A_GET_VER 0x5F // 获取芯片版本 #define mCH341_EPP_IO_MAX ( mCH341_PACKET_LENGTH - 1 ) // CH341在EPP/MEM方式下单次读写数据块的最大长度 #define mCH341A_EPP_IO_MAX 0xFF // CH341A在EPP/MEM方式下单次读写数据块的最大长度 #define mCH341A_CMD_IO_ADDR_W 0x00 // MEM带地址读写/输入输出的命令流:写数据,位6-位0为地址,下一个字节为待写数据 #define mCH341A_CMD_IO_ADDR_R 0x80 // MEM带地址读写/输入输出的命令流:读数据,位6-位0为地址,读出数据一起返回 #define mCH341A_CMD_I2C_STM_STA 0x74 // I2C接口的命令流:产生起始位 #define mCH341A_CMD_I2C_STM_STO 0x75 // I2C接口的命令流:产生停止位 #define mCH341A_CMD_I2C_STM_OUT 0x80 // I2C接口的命令流:输出数据,位5-位0为长度,后续字节为数据,0长度则只发送一个字节并返回应答 #define mCH341A_CMD_I2C_STM_IN 0xC0 // I2C接口的命令流:输入数据,位5-位0为长度,0长度则只接收一个字节并发送无应答 #define mCH341A_CMD_I2C_STM_MAX ( min( 0x3F, mCH341_PACKET_LENGTH ) ) // I2C接口的命令流单个命令输入输出数据的最大长度 #define mCH341A_CMD_I2C_STM_SET 0x60 // I2C接口的命令流:设置参数,位2=SPI的I/O数(0=单入单出,1=双入双出),位1位0=I2C速度(00=低速,01=标准,10=快速,11=高速) #d