505 lines
23 KiB
C
505 lines
23 KiB
C
/*****************************************************************************
|
||
** Copyright (C) WCH 2001-2022 **
|
||
** Web: http://wch.cn **
|
||
******************************************************************************
|
||
Abstract:
|
||
USB2.0转接芯片CH347,基于480Mbps高速USB总线扩展UART、SPI、I2C、JTAG
|
||
Environment:
|
||
user mode only,VC6.0 and later
|
||
Notes:
|
||
Copyright (c) 2022 Nanjing Qinheng Microelectronics Co., Ltd.
|
||
--*/
|
||
|
||
#ifndef _CH347_DLL_H
|
||
#define _CH347_DLL_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#ifdef _WIN64
|
||
#define mOFFSET( s, m ) ( (ULONG_PTR) & ( ( ( s * ) 0 ) -> m ) ) // 定义获取结构成员相对偏移地址的宏
|
||
#else
|
||
#define mOFFSET( s, m ) ( (ULONG) & ( ( ( s * ) 0 ) -> m ) ) // 定义获取结构成员相对偏移地址的宏
|
||
#endif
|
||
|
||
#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
|
||
|
||
//与CH31DLL合用CH341WDM驱动
|
||
#ifndef _CH341_DLL_H
|
||
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;
|
||
|
||
|
||
typedef struct _WIN32_COMMAND { // 定义WIN32命令接口结构
|
||
union {
|
||
ULONG mFunction; // 输入时指定功能代码或者管道号
|
||
NTSTATUS mStatus; // 输出时返回操作状态
|
||
};
|
||
ULONG mLength; // 存取长度,返回后续数据的长度
|
||
union {
|
||
mUSB_SETUP_PKT mSetupPkt; // USB控制传输的建立阶段的数据请求
|
||
UCHAR mBuffer[ 512]; // 数据缓冲区,长度为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 mCH347_ENDP_DATA_UP 0x86 // CH347的数据块上传端点的地址
|
||
#define mCH347_ENDP_DATA_DOWN 0x06 // CH347的数据块下传端点的地址
|
||
|
||
// 设备层接口提供的管道操作命令
|
||
#define mPipeDeviceCtrl 0x00000004 // CH347的综合控制管道
|
||
#define mPipeDataUp 0x00000006 // CH347的数据块上传管道
|
||
#define mPipeDataDown 0x00000007 // CH347的数据块下传管道
|
||
|
||
// 应用层接口的功能代码
|
||
#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管道的数据请求
|
||
#define mFuncBufferMode 0x00000020 // 设定缓冲上传模式及查询缓冲区中的数据长度
|
||
#define mFuncBufferModeDn 0x00000021 // 设定缓冲下传模式及查询缓冲区中的数据长度
|
||
#define mFuncGetVersionEx 0x00000022 // 获取驱动程序版本号及芯片型号
|
||
// 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厂商专用写操作
|
||
|
||
#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 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=高速)
|
||
#define mCH341A_CMD_I2C_STM_US 0x40 // I2C接口的命令流:以微秒为单位延时,位3-位0为延时值
|
||
#define mCH341A_CMD_I2C_STM_MS 0x50 // I2C接口的命令流:以亳秒为单位延时,位3-位0为延时值
|
||
#define mCH341A_CMD_I2C_STM_DLY 0x0F // I2C接口的命令流单个命令延时的最大值
|
||
#define mCH341A_CMD_I2C_STM_END 0x00 // I2C接口的命令流:命令包提前结束
|
||
|
||
#define mCH341A_CMD_UIO_STM_IN 0x00 // UIO接口的命令流:输入数据D7-D0
|
||
#define mCH341A_CMD_UIO_STM_DIR 0x40 // UIO接口的命令流:设定I/O方向D5-D0,位5-位0为方向数据
|
||
#define mCH341A_CMD_UIO_STM_OUT 0x80 // UIO接口的命令流:输出数据D5-D0,位5-位0为数据
|
||
#define mCH341A_CMD_UIO_STM_US 0xC0 // UIO接口的命令流:以微秒为单位延时,位5-位0为延时值
|
||
#define mCH341A_CMD_UIO_STM_END 0x20 // UIO接口的命令流:命令包提前结束
|
||
|
||
#define MAX_DEVICE_PATH_SIZE 128 // 设备名称的最大字符数
|
||
#define MAX_DEVICE_ID_SIZE 64 // 设备ID的最大字符数
|
||
#endif _CH341_DLL_H
|
||
|
||
//驱动接口
|
||
#define CH347_USB_VENDOR 0
|
||
#define CH347_USB_HID 2
|
||
#define CH347_USB_VCP 3
|
||
|
||
//CH347_USB_VENDOR支持CH341/7
|
||
#define CHIP_TYPE_CH341 0
|
||
#define CHIP_TYPE_CH347 1
|
||
|
||
//芯片功能接口号
|
||
#define CH347_FUNC_UART 0
|
||
#define CH347_FUNC_SPI_IIC 1
|
||
#define CH347_FUNC_JTAG_IIC 2
|
||
|
||
#define DEFAULT_READ_TIMEOUT 500 //默认读超时毫秒数
|
||
#define DEFAULT_WRITE_TIMEOUT 500 //默认写超时毫秒数
|
||
|
||
#define mCH347_PACKET_LENGTH 512 // CH347支持的数据包的长度
|
||
|
||
#pragma pack(1)
|
||
//SPI控制器配置
|
||
typedef struct _SPI_CONFIG{
|
||
UCHAR iMode; // 0-3:SPI Mode0/1/2/3
|
||
UCHAR iClock; // 0=60MHz, 1=30MHz, 2=15MHz, 3=7.5MHz, 4=3.75MHz, 5=1.875MHz, 6=937.5KHz,7=468.75KHz
|
||
UCHAR iByteOrder; // 0=低位在前(LSB), 1=高位在前(MSB)
|
||
USHORT iSpiWriteReadInterval; // SPI接口常规读取写入数据命令,单位为uS
|
||
UCHAR iSpiOutDefaultData; // SPI读数据时默认输出数据
|
||
ULONG iChipSelect; // 片选控制, 位7为0则忽略片选控制, 位7为1则参数有效: 位1位0为00/01分别选择CS1/CS2引脚作为低电平有效片选
|
||
UCHAR CS1Polarity; // 位0:片选CS1极性控制:0:低电平有效;1:高电平有效;
|
||
UCHAR CS2Polarity; // 位0:片选CS2极性控制:0:低电平有效;1:高电平有效;
|
||
USHORT iIsAutoDeativeCS; // 操作完成后是否自动撤消片选
|
||
USHORT iActiveDelay; // 设置片选后执行读写操作的延时时间,单位us
|
||
ULONG iDelayDeactive; // 撤消片选后执行读写操作的延时时间,单位us
|
||
}mSpiCfgS,*mPSpiCfgS;
|
||
|
||
//设备信息
|
||
typedef struct _DEV_INFOR{
|
||
UCHAR iIndex; // 当前打开序号
|
||
UCHAR DevicePath[MAX_PATH]; // 设备链接名,用于CreateFile
|
||
UCHAR UsbClass; // 0:CH347_USB_CH341, 2:CH347_USB_HID,3:CH347_USB_VCP
|
||
UCHAR FuncType; // 0:CH347_FUNC_UART,1:CH347_FUNC_SPI_I2C,2:CH347_FUNC_JTAG_I2C
|
||
CHAR DeviceID[64]; // USB\VID_xxxx&PID_xxxx
|
||
UCHAR ChipMode; // 芯片模式,0:Mode0(UART0/1); 1:Mode1(Uart1+SPI+I2C); 2:Mode2(HID Uart1+SPI+I2C) 3:Mode3(Uart1+Jtag+IIC)
|
||
HANDLE DevHandle; // 设备句柄
|
||
USHORT BulkOutEndpMaxSize; // 上传端点大小
|
||
USHORT BulkInEndpMaxSize; // 下传端点大小
|
||
UCHAR UsbSpeedType; // USB速度类型,0:FS,1:HS,2:SS
|
||
UCHAR CH347IfNum; // 设备接口号: 0:UART,1:SPI/IIC/JTAG/GPIO
|
||
UCHAR DataUpEndp; // 端点地址
|
||
UCHAR DataDnEndp; // 端点地址
|
||
CHAR ProductString[64]; // USB产品字符串
|
||
CHAR ManufacturerString[64]; // USB厂商字符串
|
||
ULONG WriteTimeout; // USB写超时
|
||
ULONG ReadTimeout; // USB读超时
|
||
CHAR FuncDescStr[64]; // 接口功能描述符
|
||
UCHAR FirewareVer; // 固件版本
|
||
}mDeviceInforS,*mPDeviceInforS;
|
||
#pragma pack()
|
||
|
||
// CH347模式公用函数,支持CH347所有模式下的打开、关闭、USB读、USB写,包含HID
|
||
//打开USB设备
|
||
HANDLE WINAPI CH347OpenDevice(ULONG DevI);
|
||
|
||
//关闭USB设备
|
||
BOOL WINAPI CH347CloseDevice(ULONG iIndex);
|
||
|
||
//获取设备信息
|
||
BOOL WINAPI CH347GetDeviceInfor(ULONG iIndex,mDeviceInforS *DevInformation);
|
||
|
||
// 获得驱动版本、库版本、设备版本、芯片类型(CH341(FS)/CH347HS)
|
||
BOOL WINAPI CH347GetVersion(ULONG iIndex,
|
||
PUCHAR iDriverVer,
|
||
PUCHAR iDLLVer,
|
||
PUCHAR ibcdDevice,
|
||
PUCHAR iChipType); //CHIP_TYPE_CH341/7
|
||
|
||
typedef VOID ( CALLBACK * mPCH347_NOTIFY_ROUTINE ) ( // 设备事件通知回调程序
|
||
ULONG iEventStatus ); // 设备事件和当前状态(在下行定义): 0=设备拔出事件, 3=设备插入事件
|
||
|
||
#define CH347_DEVICE_ARRIVAL 3 // 设备插入事件,已经插入
|
||
#define CH347_DEVICE_REMOVE_PEND 1 // 设备将要拔出
|
||
#define CH347_DEVICE_REMOVE 0 // 设备拔出事件,已经拔出
|
||
|
||
BOOL WINAPI CH347SetDeviceNotify( // 设定设备事件通知程序
|
||
ULONG iIndex, // 指定设备序号,0对应第一个设备
|
||
PCHAR iDeviceID, // 可选参数,指向字符串,指定被监控的设备的ID,字符串以\0终止
|
||
mPCH347_NOTIFY_ROUTINE iNotifyRoutine ); // 指定设备事件回调程序,为NULL则取消事件通知,否则在检测到事件时调用该程序
|
||
|
||
// 读取USB数据块
|
||
BOOL WINAPI CH347ReadData( ULONG iIndex, // 指定设备序号
|
||
PVOID oBuffer, // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
PULONG ioLength ); // 指向长度单元,输入时为准备读取的长度,返回后为实际读取的长度
|
||
|
||
// 写取USB数据块
|
||
BOOL WINAPI CH347WriteData(ULONG iIndex, // 指定设备序号
|
||
PVOID iBuffer, // 指向一个缓冲区,放置准备写出的数据
|
||
PULONG ioLength ); // 指向长度单元,输入时为准备写出的长度,返回后为实际写出的长度
|
||
|
||
// 设置USB数据读写的超时
|
||
BOOL WINAPI CH347SetTimeout(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteTimeout, // 指定USB写出数据块的超时时间,以毫秒mS为单位,0xFFFFFFFF指定不超时(默认值)
|
||
ULONG iReadTimeout ); // 指定USB读取数据块的超时时间,以毫秒mS为单位,0xFFFFFFFF指定不超时(默认值)
|
||
|
||
/***************SPI********************/
|
||
// SPI控制器初始化
|
||
BOOL WINAPI CH347SPI_Init(ULONG iIndex,mSpiCfgS *SpiCfg);
|
||
|
||
//获取SPI控制器配置信息
|
||
BOOL WINAPI CH347SPI_GetCfg(ULONG iIndex,mSpiCfgS *SpiCfg);
|
||
|
||
//设置片选状态,使用前需先调用CH347SPI_Init对CS进行设置
|
||
BOOL WINAPI CH347SPI_ChangeCS(ULONG iIndex, // 指定设备序号
|
||
UCHAR iStatus); // 0=撤消片选,1=设置片选
|
||
|
||
//设置SPI片选
|
||
BOOL WINAPI CH347SPI_SetChipSelect(ULONG iIndex, // 指定设备序号
|
||
USHORT iEnableSelect, // 低八位为CS1,高八位为CS2; 字节值为1=设置CS,为0=忽略此CS设置
|
||
USHORT iChipSelect, // 低八位为CS1,高八位为CS2;片选输出,0=撤消片选,1=设置片选
|
||
ULONG iIsAutoDeativeCS, // 低16位为CS1,高16位为CS2;操作完成后是否自动撤消片选
|
||
ULONG iActiveDelay, // 低16位为CS1,高16位为CS2;设置片选后执行读写操作的延时时间,单位us
|
||
ULONG iDelayDeactive); // 低16位为CS1,高16位为CS2;撤消片选后执行读写操作的延时时间,单位us
|
||
|
||
//SPI4写数据
|
||
BOOL WINAPI CH347SPI_Write(ULONG iIndex, // 指定设备序号
|
||
ULONG iChipSelect, // 片选控制, 位7为0则忽略片选控制, 位7为1进行片选操作
|
||
ULONG iLength, // 准备传输的数据字节数
|
||
ULONG iWriteStep, // 准备读取的单个块的长度
|
||
PVOID ioBuffer); // 指向一个缓冲区,放置准备从MOSI写出的数据
|
||
|
||
//SPI4读数据.无需先写数据,效率较CH347SPI_WriteRead高很多
|
||
BOOL WINAPI CH347SPI_Read(ULONG iIndex, // 指定设备序号
|
||
ULONG iChipSelect, // 片选控制, 位7为0则忽略片选控制, 位7为1进行片选操作
|
||
ULONG oLength, // 准备发出的字节数
|
||
PULONG iLength, // 准备读入的数据字节数
|
||
PVOID ioBuffer); // 指向一个缓冲区,放置准备从DOUT写出的数据,返回后是从DIN读入的数据
|
||
|
||
// 处理SPI数据流,4线接口
|
||
BOOL WINAPI CH347SPI_WriteRead(ULONG iIndex, // 指定设备序号
|
||
ULONG iChipSelect, // 片选控制, 位7为0则忽略片选控制, 位7为1则操作片选
|
||
ULONG iLength, // 准备传输的数据字节数
|
||
PVOID ioBuffer ); // 指向一个缓冲区,放置准备从DOUT写出的数据,返回后是从DIN读入的数据
|
||
|
||
// 处理SPI数据流,4线接口
|
||
BOOL WINAPI CH347StreamSPI4(ULONG iIndex, // 指定设备序号
|
||
ULONG iChipSelect, // 片选控制, 位7为0则忽略片选控制, 位7为1则参数有效
|
||
ULONG iLength, // 准备传输的数据字节数
|
||
PVOID ioBuffer ); // 指向一个缓冲区,放置准备从DOUT写出的数据,返回后是从DIN读入的数据
|
||
|
||
/***************JTAG********************/
|
||
//JTAG接口初始化,设置模式及速度
|
||
BOOL WINAPI CH347Jtag_INIT(ULONG iIndex,
|
||
UCHAR iClockRate); //通信速度;有效值为0-5,值越大通信速度越快
|
||
|
||
//获取Jtag速度设置
|
||
BOOL WINAPI CH347Jtag_GetCfg(ULONG iIndex, // 指定设备序号
|
||
UCHAR *ClockRate); //通信速度;有效值为0-5,值越大通信速度越快
|
||
|
||
//位带方式JTAG IR/DR数据读写.适用于少量数据的读写。如指令操作、状态机切换等控制类传输。如批量数据传输,建议使用CH347Jtag_WriteRead_Fast
|
||
//命令包以4096字节为单位批量读写
|
||
//状态机:Run-Test->Shift-IR/DR..->Exit IR/DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_WriteRead(ULONG iIndex, // 指定设备序号
|
||
BOOL IsDR, // =TRUE: DR数据读写,=FALSE:IR数据读写
|
||
ULONG iWriteBitLength, // 写长度,准备写出的长度
|
||
PVOID iWriteBitBuffer, // 指向一个缓冲区,放置准备写出的数据
|
||
PULONG oReadBitLength, // 指向长度单元,返回后为实际读取的长度
|
||
PVOID oReadBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//JTAG IR/DR数据批量读写,用于多字节连续读写。如JTAG固件下载操作。因硬件有4K缓冲区,如先写后读,长度不超过4096字节。缓冲区大小可自行调整
|
||
//状态机:Run-Test->Shift-IR/DR..->Exit IR/DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_WriteRead_Fast(ULONG iIndex, // 指定设备序号
|
||
BOOL IsDR, // =TRUE: DR数据读写,=FALSE:IR数据读写
|
||
ULONG iWriteBitLength, // 写长度,准备写出的长度
|
||
PVOID iWriteBitBuffer, // 指向一个缓冲区,放置准备写出的数据
|
||
PULONG oReadBitLength, // 指向长度单元,返回后为实际读取的长度
|
||
PVOID oReadBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//切换JTAG状态机
|
||
BOOL WINAPI CH347Jtag_SwitchTapState(UCHAR TapState);
|
||
|
||
//JTAG DR写,以字节为单位,用于多字节连续读写。如JTAG固件下载操作。
|
||
//状态机:Run-Test->Shift-DR..->Exit DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_ByteWriteDR(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteLength, // 写长度,准备写出的字节长度
|
||
PVOID iWriteBuffer); // 指向一个缓冲区,放置准备写出的数据
|
||
|
||
//JTAG DR读,以字节为单位,多字节连续读。
|
||
//状态机:Run-Test->Shift-DR..->Exit DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_ByteReadDR(ULONG iIndex, // 指定设备序号
|
||
PULONG oReadLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID oReadBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//JTAG IR写,以字节为单位,多字节连续写。
|
||
//状态机:Run-Test->Shift-IR..->Exit IR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_ByteWriteIR(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteLength, // 写长度,准备写出的字节长度
|
||
PVOID iWriteBuffer); // 指向一个缓冲区,放置准备写出的数据
|
||
|
||
//JTAG IR读,以字节为单位,多字节连续读写。
|
||
//状态机:Run-Test->Shift-IR..->Exit IR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_ByteReadIR(ULONG iIndex, // 指定设备序号
|
||
PULONG oReadLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID oReadBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//位带方式JTAG DR数据写.适用于少量数据的读写。如指令操作、状态机切换等控制类传输。如批量数据传输,建议使用USB20Jtag_ByeWriteDR
|
||
//状态机:Run-Test->Shift-DR..->Exit DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_BitWriteDR(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteBitLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID iWriteBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//位带方式JTAG IR数据写.适用于少量数据的读写。如指令操作、状态机切换等控制类传输。如批量数据传输,建议使用USB20Jtag_ByteWriteIR
|
||
//状态机:Run-Test->Shift-IR..->Exit IR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_BitWriteIR(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteBitLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID iWriteBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//位带方式JTAG IR数据读.适用于少量数据的读写。如指令操作、状态机切换等。如批量数据传输,建议使用USB20Jtag_ByteReadIR
|
||
//状态机:Run-Test->Shift-IR..->Exit IR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_BitReadIR(ULONG iIndex, // 指定设备序号
|
||
PULONG oReadBitLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID oReadBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//位带方式JTAG DR数据读.适用于少量数据的读写。如批量和高速数据传输,建议使用USB20Jtag_ByteReadDR
|
||
//状态机:Run-Test->Shift-DR..->Exit DR -> Run-Test
|
||
BOOL WINAPI CH347Jtag_BitReadDR(ULONG iIndex, // 指定设备序号
|
||
PULONG oReadBitLength, // 指向长度单元,返回后为实际读取的字节长度
|
||
PVOID oReadBitBuffer ); // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
|
||
//获取CH347的GPIO方向和引脚电平值
|
||
BOOL WINAPI CH347GPIO_Get(ULONG iIndex,
|
||
UCHAR *iDir, //引脚方向:GPIO0-7对应位0-7.0:输入;1:输出
|
||
UCHAR *iData); //GPIO0电平:GPIO0-7对应位0-7,0:低电平;1:高电平)
|
||
|
||
//设置CH347的GPIO方向和引脚电平值
|
||
BOOL WINAPI CH347GPIO_Set(ULONG iIndex,
|
||
UCHAR iEnable, //数据有效标志:对应位0-7,对应GPIO0-7.
|
||
UCHAR iSetDirOut, //设置I/O方向,某位清0则对应引脚为输入,某位置1则对应引脚为输出.GPIO0-7对应位0-7.
|
||
UCHAR iSetDataOut); //输出数据,如果I/O方向为输出,那么某位清0时对应引脚输出低电平,某位置1时对应引脚输出高电平
|
||
|
||
//进入IAP固件升级模式
|
||
BOOL WINAPI CH347StartIapFwUpate(ULONG iIndex,
|
||
ULONG FwSize); // 固件长度
|
||
|
||
/**************HID/VCP串口**********************/
|
||
//打开串口
|
||
HANDLE WINAPI CH347Uart_Open(ULONG iIndex);
|
||
|
||
//关闭串口
|
||
BOOL WINAPI CH347Uart_Close(ULONG iIndex);
|
||
|
||
BOOL WINAPI CH347Uart_SetDeviceNotify( // 设定设备事件通知程序
|
||
ULONG iIndex, // 指定设备序号,0对应第一个设备
|
||
PCHAR iDeviceID, // 可选参数,指向字符串,指定被监控的设备的ID,字符串以\0终止
|
||
mPCH347_NOTIFY_ROUTINE iNotifyRoutine ); // 指定设备事件回调程序,为NULL则取消事件通知,否则在检测到事件时调用该程序
|
||
|
||
//获取UART硬件配置
|
||
BOOL WINAPI CH347Uart_GetCfg(ULONG iIndex, // 指定设备序号
|
||
PULONG BaudRate, // 波特率
|
||
PUCHAR ByteSize, // 数据位数(5,6,7,8,16)
|
||
PUCHAR Parity, // 校验位(0:None; 1:Odd; 2:Even; 3:Mark; 4:Space)
|
||
PUCHAR StopBits, // 停止位数(0:1停止位; 1:1.5停止位; 2:2停止位);
|
||
PUCHAR ByteTimeout); //字节超时
|
||
|
||
//设置UART配置
|
||
BOOL WINAPI CH347Uart_Init(ULONG iIndex, // 指定设备序号
|
||
DWORD BaudRate, // 波特率
|
||
UCHAR ByteSize, // 数据位数(5,6,7,8,16)
|
||
UCHAR Parity, // 校验位(0:None; 1:Odd; 2:Even; 3:Mark; 4:Space)
|
||
UCHAR StopBits, // 停止位数(0:1停止位; 1:1.5停止位; 2:2停止位);
|
||
UCHAR ByteTimeout);// 字节超时时间,单位100uS
|
||
|
||
// 设置USB数据读写的超时
|
||
BOOL WINAPI CH347Uart_SetTimeout(ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteTimeout, // 指定USB写出数据块的超时时间,以毫秒mS为单位,0xFFFFFFFF指定不超时(默认值)
|
||
ULONG iReadTimeout ); // 指定USB读取数据块的超时时间,以毫秒mS为单位,0xFFFFFFFF指定不超时(默认值)
|
||
|
||
// 读取数据块
|
||
BOOL WINAPI CH347Uart_Read(ULONG iIndex, // 指定设备序号
|
||
PVOID oBuffer, // 指向一个足够大的缓冲区,用于保存读取的数据
|
||
PULONG ioLength );// 指向长度单元,输入时为准备读取的长度,返回后为实际读取的长度
|
||
|
||
// 写出数据块
|
||
BOOL WINAPI CH347Uart_Write(ULONG iIndex, // 指定设备序号
|
||
PVOID iBuffer, // 指向一个缓冲区,放置准备写出的数据
|
||
PULONG ioLength );// 指向长度单元,输入时为准备写出的长度,返回后为实际写出的长度
|
||
|
||
//查询读缓冲区有多少字节未取
|
||
BOOL WINAPI CH347Uart_QueryBufUpload(ULONG iIndex, // 指定设备序号
|
||
LONGLONG *RemainBytes);
|
||
|
||
//获取设备信息
|
||
BOOL WINAPI CH347Uart_GetDeviceInfor(ULONG iIndex,mDeviceInforS *DevInformation);
|
||
|
||
|
||
/********IIC***********/
|
||
// 设置串口流模式
|
||
BOOL WINAPI CH347I2C_Set(ULONG iIndex, // 指定设备序号
|
||
ULONG iMode ); // 指定模式,见下行
|
||
// 位1-位0: I2C接口速度/SCL频率, 00=低速/20KHz,01=标准/100KHz(默认值),10=快速/400KHz,11=高速/750KHz
|
||
// 其它保留,必须为0
|
||
|
||
// 设置硬件异步延时,调用后很快返回,而在下一个流操作之前延时指定毫秒数
|
||
BOOL WINAPI CH347I2C_SetDelaymS(ULONG iIndex, // 指定设备序号
|
||
ULONG iDelay ) ; // 指定延时的毫秒数
|
||
|
||
// 处理I2C数据流,2线接口,时钟线为SCL引脚,数据线为SDA引脚
|
||
BOOL WINAPI CH347StreamI2C( ULONG iIndex, // 指定设备序号
|
||
ULONG iWriteLength, // 准备写出的数据字节数
|
||
PVOID iWriteBuffer, // 指向一个缓冲区,放置准备写出的数据,首字节通常是I2C设备地址及读写方向位
|
||
ULONG iReadLength, // 准备读取的数据字节数
|
||
PVOID oReadBuffer ); // 指向一个缓冲区,返回后是读入的数据
|
||
#ifndef _CH341_DLL_H
|
||
typedef enum _EEPROM_TYPE {// EEPROM型号
|
||
ID_24C01,
|
||
ID_24C02,
|
||
ID_24C04,
|
||
ID_24C08,
|
||
ID_24C16,
|
||
ID_24C32,
|
||
ID_24C64,
|
||
ID_24C128,
|
||
ID_24C256,
|
||
ID_24C512,
|
||
ID_24C1024,
|
||
ID_24C2048,
|
||
ID_24C4096
|
||
} EEPROM_TYPE;
|
||
#endif
|
||
|
||
// 从EEPROM中读取数据块,速度约56K字节
|
||
BOOL WINAPI CH347ReadEEPROM(ULONG iIndex, // 指定设备序号
|
||
EEPROM_TYPE iEepromID, // 指定EEPROM型号
|
||
ULONG iAddr, // 指定数据单元的地址
|
||
ULONG iLength, // 准备读取的数据字节数
|
||
PUCHAR oBuffer ); // 指向一个缓冲区,返回后是读入的数据
|
||
// 向EEPROM中写入数据块
|
||
BOOL WINAPI CH347WriteEEPROM(ULONG iIndex, // 指定设备序号
|
||
EEPROM_TYPE iEepromID, // 指定EEPROM型号
|
||
ULONG iAddr, // 指定数据单元的地址
|
||
ULONG iLength, // 准备写出的数据字节数
|
||
PUCHAR iBuffer ); // 指向一个缓冲区,放置准备写出的数据
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif // _CH347_DLL_H
|