681 lines
41 KiB
C
681 lines
41 KiB
C
// 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, 2022.5
|
|
//****************************************
|
|
//** Copyright (C) WCH 1999-2022 **
|
|
//** Web: http://www.winchiphead.com **
|
|
//****************************************
|
|
//** DLL for USB interface chip CH341 **
|
|
//** C, VC5.0 **
|
|
//****************************************
|
|
//
|
|
// USB interface chip CH341 parallel application interface lib V2.2
|
|
// Nanjing Qinheng Microelectronics Co., Ltd. Author: W.ch 2008.10
|
|
// CH341-DLL V2.2
|
|
// Runtime environment: Windows 98/ME, Windows 2000/XP/7/10/11
|
|
// support USB chip: CH341, CH341A, CH347 SPI/I2C
|
|
// USB => Parallel, I2C, SPI, ...
|
|
//
|
|
|
|
#ifndef _CH341_DLL_H
|
|
#define _CH341_DLL_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifdef _WIN64
|
|
#define mOFFSET( s, m ) ( (ULONG_PTR) & ( ( ( s * ) 0 ) -> m ) ) // Defines a macro that gets the relative offset address of a structure member
|
|
#else
|
|
#define mOFFSET( s, m ) ( (ULONG) & ( ( ( s * ) 0 ) -> m ) ) // Defines a macro that gets the relative offset address of a structure member
|
|
#endif
|
|
|
|
#ifndef max
|
|
#define max( a, b ) ( ( ( a ) > ( b ) ) ? ( a ) : ( b ) ) // Larger value
|
|
#endif
|
|
|
|
#ifndef min
|
|
#define min( a, b ) ( ( ( a ) < ( b ) ) ? ( a ) : ( b ) ) // Smaller values
|
|
#endif
|
|
|
|
#ifdef ExAllocatePool
|
|
#undef ExAllocatePool // Delete a memory allocation with TAG
|
|
#endif
|
|
|
|
#ifndef NTSTATUS
|
|
typedef LONG NTSTATUS; // Return status
|
|
#endif
|
|
|
|
|
|
typedef struct _USB_SETUP_PKT { // USB control transmission of the establishment phase of the data request packet structure
|
|
UCHAR mUspReqType; // 00H Request type
|
|
UCHAR mUspRequest; // 01H Request code
|
|
union {
|
|
struct {
|
|
UCHAR mUspValueLow; // 02H Value parameter low bytes
|
|
UCHAR mUspValueHigh; // 03H Value parameter high bytes
|
|
};
|
|
USHORT mUspValue; // 02H-03H Value parameter
|
|
};
|
|
union {
|
|
struct {
|
|
UCHAR mUspIndexLow; // 04H Index parameter low bytes
|
|
UCHAR mUspIndexHigh; // 05H Index parameter high bytes
|
|
};
|
|
USHORT mUspIndex; // 04H-05H Index parameter
|
|
};
|
|
USHORT mLength; // 06H-07H Data length of the data phase
|
|
} mUSB_SETUP_PKT, *mPUSB_SETUP_PKT;
|
|
|
|
|
|
#define mCH341_PACKET_LENGTH 32 // Length of data packets supported by CH341
|
|
#define mCH341_PKT_LEN_SHORT 8 // Length of short packets supported by CH341
|
|
|
|
|
|
typedef struct _WIN32_COMMAND { // Define WIN32 command interface structure
|
|
union {
|
|
ULONG mFunction; // Specify the function code or pipe number when entering
|
|
NTSTATUS mStatus; // Returns operation status on output
|
|
};
|
|
ULONG mLength; // Access length, returns the length of subsequent data
|
|
union {
|
|
mUSB_SETUP_PKT mSetupPkt; // USB controls the transmission of data requests during the setup phase
|
|
UCHAR mBuffer[ 512]; // Data buffer, 0 to 255B in length
|
|
};
|
|
} mWIN32_COMMAND, *mPWIN32_COMMAND;
|
|
|
|
// WIN32 application layer interface command
|
|
#define IOCTL_CH341_COMMAND ( FILE_DEVICE_UNKNOWN << 16 | FILE_ANY_ACCESS << 14 | 0x0f34 << 2 | METHOD_BUFFERED ) // Special interface
|
|
|
|
#define mWIN32_COMMAND_HEAD mOFFSET( mWIN32_COMMAND, mBuffer ) // WIN32 command interface header length
|
|
|
|
#define mCH341_MAX_NUMBER 16 // Maximum number of CH341 connected at the same time
|
|
|
|
#define mMAX_BUFFER_LENGTH 0x1000 // Maximum length of the data buffer is 4096
|
|
|
|
#define mMAX_COMMAND_LENGTH ( mWIN32_COMMAND_HEAD + mMAX_BUFFER_LENGTH ) // Maximum data length plus the length of the command structure header
|
|
|
|
#define mDEFAULT_BUFFER_LEN 0x0400 // Default length of the data buffer is 1024
|
|
|
|
#define mDEFAULT_COMMAND_LEN ( mWIN32_COMMAND_HEAD + mDEFAULT_BUFFER_LEN ) // Default data length plus the length of the command structure header
|
|
|
|
// CH341 endpoint address
|
|
#define mCH341_ENDP_INTER_UP 0x81 // Address of the interrupt data upload endpoint of CH341
|
|
#define mCH341_ENDP_INTER_DOWN 0x01 // Address of the interrupt data download endpoint of CH341
|
|
#define mCH341_ENDP_DATA_UP 0x82 // Address of the data block upload endpoint of CH341
|
|
#define mCH341_ENDP_DATA_DOWN 0x02 // IP address of the data block download endpoint of the CH341
|
|
|
|
// Operation command of pipes provided by device layer interfaces
|
|
#define mPipeDeviceCtrl 0x00000004 // Integrated control piping for CH341
|
|
#define mPipeInterUp 0x00000005 // Interrupt data upload pipeline for CH341
|
|
#define mPipeDataUp 0x00000006 // CH341 data block upload pipeline
|
|
#define mPipeDataDown 0x00000007 // CH341 data block dowload pipeline
|
|
|
|
// Function code of the application interface
|
|
#define mFuncNoOperation 0x00000000 // No operation
|
|
#define mFuncGetVersion 0x00000001 // Gets the driver version number
|
|
#define mFuncGetConfig 0x00000002 // Gets the USB device configuration descriptor
|
|
#define mFuncSetTimeout 0x00000009 // Set USB communication timeout
|
|
#define mFuncSetExclusive 0x0000000b // Set exclusive use
|
|
#define mFuncResetDevice 0x0000000c // Reset USB device
|
|
#define mFuncResetPipe 0x0000000d // Reset USB pipe
|
|
#define mFuncAbortPipe 0x0000000e // Cancels data requests for USB pipes
|
|
|
|
//Function code of CH341 parallel port dedicated
|
|
#define mFuncSetParaMode 0x0000000f // Set parallel port mode
|
|
#define mFuncReadData0 0x00000010 // Read block 0 from parallel port
|
|
#define mFuncReadData1 0x00000011 // Read block 1 from parallel port
|
|
#define mFuncWriteData0 0x00000012 // Write data block 0 to parallel port
|
|
#define mFuncWriteData1 0x00000013 // Write data block 1 to parallel port
|
|
#define mFuncWriteRead 0x00000014 // Output before input
|
|
#define mFuncBufferMode 0x00000020 // Set buffered upload mode and query the length of data in the buffer
|
|
#define mFuncBufferModeDn 0x00000021 // Set buffered download mode and query the length of data in the buffer
|
|
#define mFuncGetVersionEx 0x00000022 // Get driver version number and chip model
|
|
|
|
// USB device standard request code
|
|
#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
|
|
|
|
// Vendor-specific request type of CH341 control transmission
|
|
#define mCH341_VENDOR_READ 0xC0 // CH341 Vendor-specific read operations which achieved by control transmission
|
|
#define mCH341_VENDOR_WRITE 0x40 // CH341 Vendor-specific write operations which achieved by control transmission
|
|
|
|
// Vendor-specific request code of CH341 control transmission
|
|
#define mCH341_PARA_INIT 0xB1 // Initialize parallel port
|
|
#define mCH341_I2C_STATUS 0x52 // Get status of the I2C interface
|
|
#define mCH341_I2C_COMMAND 0x53 // Sends I2C interface command
|
|
|
|
// CH341 Parallel port operation command code
|
|
#define mCH341_PARA_CMD_R0 0xAC // Read data 0 from parallel port, subbyte length
|
|
#define mCH341_PARA_CMD_R1 0xAD // Read data from parallel port 1, subbyte length
|
|
#define mCH341_PARA_CMD_W0 0xA6 // Writes data 0 to parallel port, starting with the next byte as a data stream
|
|
#define mCH341_PARA_CMD_W1 0xA7 // Writes data 1 to parallel port, starting with the next byte as a data stream
|
|
#define mCH341_PARA_CMD_STS 0xA0 // Gets parallel port status
|
|
|
|
// CH341A Parallel port operation command code
|
|
#define mCH341A_CMD_SET_OUTPUT 0xA1 // Set parallel output
|
|
#define mCH341A_CMD_IO_ADDR 0xA2 // MEM address read&write/ input&output, starting with the next byte as a command stream
|
|
#define mCH341A_CMD_PRINT_OUT 0xA3 // Compatible PRINT print output, starting with the next byte as a code stream
|
|
#define mCH341A_CMD_PWM_OUT 0xA4 // PWM command package for data output, starting with the next byte as a code stream
|
|
#define mCH341A_CMD_SHORT_PKT 0xA5 // Short packet, the next byte is the actual length of the command packet, the next after next byte and the bytes after that are the original command packet
|
|
#define mCH341A_CMD_SPI_STREAM 0xA8 // SPI interface command package, starting with the next byte as data stream
|
|
//#define mCH341A_CMD_SIO_STREAM 0xA9 // SIO interface command package, starting with the next byte as data stream
|
|
#define mCH341A_CMD_I2C_STREAM 0xAA // I2C interface command package ,I2C command stream starting from subbyte
|
|
#define mCH341A_CMD_UIO_STREAM 0xAB // The command packet of the UIO interface, starting from the next byte is the command stream
|
|
#define mCH341A_CMD_PIO_STREAM 0xAE // The command packet of the PIO interface, starting from the second byte is the data stream
|
|
|
|
// Vendor-specific request code of CH341 control transmission
|
|
#define mCH341A_BUF_CLEAR 0xB2 // Clear unfinished data
|
|
#define mCH341A_I2C_CMD_X 0x54 // Issue the command of the I2C interface and execute it immediately
|
|
#define mCH341A_DELAY_MS 0x5E // Delay the specified time in milliseconds
|
|
#define mCH341A_GET_VER 0x5F // Get the chip version
|
|
|
|
#define mCH341_EPP_IO_MAX ( mCH341_PACKET_LENGTH - 1 ) // The maximum length of a single read and write data block of CH341 in EPP/MEM mode
|
|
#define mCH341A_EPP_IO_MAX 0xFF // The maximum length of a single read and write data block for CH341A in EPP/MEM mode
|
|
|
|
#define mCH341A_CMD_IO_ADDR_W 0x00 // MEM command stream with address read/write/input and output: write data, bit 6-bit 0 is the address, and the next byte is the data to be written
|
|
#define mCH341A_CMD_IO_ADDR_R 0x80 // MEM command stream with address read/write/input and output: read data, bit 6-bit 0 is the address, read data and return together
|
|
|
|
#define mCH341A_CMD_I2C_STM_STA 0x74 // Command flow of I2C interface: generate start bit
|
|
#define mCH341A_CMD_I2C_STM_STO 0x75 // Command flow of I2C interface: generate stop bit
|
|
#define mCH341A_CMD_I2C_STM_OUT 0x80 // Command flow of I2C interface: output data, bit 5-bit 0 is the length, the subsequent bytes are data, and only one byte is sent with a length of 0 and a response is returned
|
|
#define mCH341A_CMD_I2C_STM_IN 0xC0 // Command flow of I2C interface: input data, bit 5-bit 0 is the length, 0 length means only one byte is received and no response is sent
|
|
#define mCH341A_CMD_I2C_STM_MAX ( min( 0x3F, mCH341_PACKET_LENGTH ) ) // The maximum length of the input and output data of a single command in the command stream of the I2C interface
|
|
#define mCH341A_CMD_I2C_STM_SET 0x60 // Command flow of I2C interface: set parameters, bit 2=SPI I/O number (0=single input and single output, 1=double input and double output), bit 1 bit 0=I2C speed (00=low speed, 01=standard, 10=fast, 11=high speed)
|
|
#define mCH341A_CMD_I2C_STM_US 0x40 // Command flow of I2C interface: delay in microseconds, bit 3-bit 0 is the delay value
|
|
#define mCH341A_CMD_I2C_STM_MS 0x50 // Command flow of I2C interface: delay in milliseconds, bit 3-bit 0 is the delay value
|
|
#define mCH341A_CMD_I2C_STM_DLY 0x0F // The maximum value of the single command delay of the command stream of the I2C interface
|
|
#define mCH341A_CMD_I2C_STM_END 0x00 // Command flow of I2C interface: command packet ends prematurely
|
|
|
|
#define mCH341A_CMD_UIO_STM_IN 0x00 // Command flow of UIO interface: input data D7-D0
|
|
#define mCH341A_CMD_UIO_STM_DIR 0x40 // Command flow of UIO interface: set I/O direction D5-D0, bit 5-bit 0 is the direction data
|
|
#define mCH341A_CMD_UIO_STM_OUT 0x80 // Command flow of UIO interface: output data D5-D0, bit 5-bit 0 is data
|
|
#define mCH341A_CMD_UIO_STM_US 0xC0 // Command flow of UIO interface: delay in microseconds, bit 5-bit 0 is the delay value
|
|
#define mCH341A_CMD_UIO_STM_END 0x20 // Command flow of UIO interface: command packet ends prematurely
|
|
|
|
// CH341 parallen port work model
|
|
#define mCH341_PARA_MODE_EPP 0x00 // CH341 parallel port working mode is EPP mode
|
|
#define mCH341_PARA_MODE_EPP17 0x00 // CH341A parallel port working mode is EPP mode V1.7
|
|
#define mCH341_PARA_MODE_EPP19 0x01 // CH341A parallel port working mode is EPP mode V1.9
|
|
#define mCH341_PARA_MODE_MEM 0x02 // CH341 parallel port working mode is MEM mode
|
|
#define mCH341_PARA_MODE_ECP 0x03 // CH341A parallel port working mode is ECP mode
|
|
|
|
// I/O direction setting bit definition, direct input status signal bit definition, direct output bit data definition
|
|
#define mStateBitERR 0x00000100 // Read-only and writable, ERR# pin input status, 1: high level, 0: low level
|
|
#define mStateBitPEMP 0x00000200 // Read-only and writable, PEMP pin input state, 1: high level, 0: low level
|
|
#define mStateBitINT 0x00000400 // Read-only and writable, INT# pin input status, 1: high level, 0: low level
|
|
#define mStateBitSLCT 0x00000800 // Read-only and writable, SLCT pin input status, 1: high level, 0: low level
|
|
#define mStateBitWAIT 0x00002000 // Read-only and writable, WAIT# pin input status, 1: high level, 0: low level
|
|
#define mStateBitDATAS 0x00004000 // Only write and read, DATAS#/READ# pin input status, 1: high level, 0: low level
|
|
#define mStateBitADDRS 0x00008000 // Write only read, ADDRS#/ADDR/ALE pin input status, 1: high level, 0: low level
|
|
#define mStateBitRESET 0x00010000 // Write only, RESET# pin input status, 1: high level, 0: low level
|
|
#define mStateBitWRITE 0x00020000 // Write only, WRITE# pin input status, 1: high level, 0: low level
|
|
#define mStateBitSCL 0x00400000 // Read only, SCL pin input status, 1: high level, 0: low level
|
|
#define mStateBitSDA 0x00800000 // Read only, SDA pin input status, 1: high level, 0: low level
|
|
|
|
#define MAX_DEVICE_PATH_SIZE 128 // Maximum number of characters for device name
|
|
#define MAX_DEVICE_ID_SIZE 64 // Maximum number of characters for device ID
|
|
|
|
typedef VOID ( CALLBACK * mPCH341_INT_ROUTINE ) ( // interrupt service routine
|
|
ULONG iStatus ); // Interrupt status data, refer to the following bit description
|
|
// Bit 7-bit 0 correspond to D7-D0 pins of CH341
|
|
// Bit 8 corresponds to ERR# pin of CH341, Bit 9 corresponds to PEMP pin of CH341, Bit 10 corresponds to INT# pin of CH341, Bit 11 corresponds to SLCT pin of CH341
|
|
|
|
|
|
HANDLE WINAPI CH341OpenDevice( // Open the CH341 device, return the handle, if an error occurs, it will be invalid
|
|
ULONG iIndex ); // Specify the device serial number of CH341, 0 corresponds to the first device
|
|
|
|
|
|
VOID WINAPI CH341CloseDevice( // Close the CH341 device
|
|
ULONG iIndex ); // Specify the serial number of the CH341 device
|
|
|
|
|
|
ULONG WINAPI CH341GetVersion( ); // Get the DLL version number, return the version number
|
|
|
|
|
|
ULONG WINAPI CH341DriverCommand( // Directly pass the command to the driver, return 0 if there is an error, otherwise return the data length
|
|
ULONG iIndex, // Specify the serial number of the CH341 device, the DLL above V1.6 can also be the handle after the device is opened
|
|
mPWIN32_COMMAND ioCommand ); // pointer to command structure
|
|
// The program returns the data length after the call, and still returns the command structure, if it is a read operation, the data is returned in the command structure,
|
|
// The returned data length is 0 when the operation fails, and the length of the entire command structure when the operation is successful. For example, if one byte is read, mWIN32_COMMAND_HEAD+1 is returned.
|
|
// Before the command structure is called, provide: pipe number or command function code, length of access data (optional), data (optional)
|
|
// After the command structure is called, it returns: the operation status code, the length of the subsequent data (optional),
|
|
// The operation status code is the code defined by WINDOWS, you can refer to NTSTATUS.H,
|
|
// The length of the subsequent data refers to the length of the data returned by the read operation. The data is stored in the subsequent buffer, and is generally 0 for the write operation.
|
|
|
|
ULONG WINAPI CH341GetDrvVersion( ); // Get the driver version number, return the version number, or return 0 if there is an error
|
|
|
|
|
|
BOOL WINAPI CH341ResetDevice( // Reset USB device
|
|
ULONG iIndex ); // Specify the serial number of the CH341 device
|
|
|
|
|
|
BOOL WINAPI CH341GetDeviceDescr( // Read device descriptor
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the descriptor
|
|
PULONG ioLength ); // Points to the length unit, the length to be read when input is the length to be read, and the actual read length after return
|
|
|
|
|
|
BOOL WINAPI CH341GetConfigDescr( // Read configuration descriptor
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the descriptor
|
|
PULONG ioLength ); // Points to the length unit, the length to be read when input is the length to be read, and the actual read length after return
|
|
|
|
|
|
BOOL WINAPI CH341SetIntRoutine( // Set interrupt service routine
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
mPCH341_INT_ROUTINE iIntRoutine ); // Specify the interrupt service routine, if it is NULL, the interrupt service will be cancelled, otherwise the routine will be called when interrupted
|
|
|
|
|
|
BOOL WINAPI CH341ReadInter( // Read interrupt data
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PULONG iStatus ); // Points to a double word location used to store the read interrupt status data, see below
|
|
// Bit 7-bit 0 correspond to D7-D0 pins of CH341
|
|
// Bit 8 corresponds to err# pin of CH341, bit 9 corresponds to PEMP pin of CH341, bit 10 corresponds to int# pin of CH341, and bit 11 corresponds to SLCT pin of CH341
|
|
|
|
BOOL WINAPI CH341AbortInter( // Abort interrupt data read operation
|
|
ULONG iIndex ); // Specify the serial number of the CH341 device
|
|
|
|
|
|
BOOL WINAPI CH341SetParaMode( // Set parallel port mode
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
ULONG iMode ); // Specify parallel port mode: 0 is EPP mode/EPP mode V1.7, 1 is EPP mode V1.9, 2 is MEM mode
|
|
|
|
|
|
BOOL WINAPI CH341InitParallel( // Reset and initialize the parallel port, RST# outputs a low-level pulse
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
ULONG iMode ); // Specify parallel port mode: 0 is EPP mode/EPP mode V1.7, 1 is EPP mode V1.9, 2 is MEM mode, >= 0x00000100 keep current mode
|
|
|
|
|
|
BOOL WINAPI CH341ReadData0( // Read data block from 0# port
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the read data
|
|
PULONG ioLength ); // Points to the length unit, the length to be read when input is the length to be read, and the actual read length after return
|
|
|
|
|
|
BOOL WINAPI CH341ReadData1( // Read data block from port 1#
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the read data
|
|
PULONG ioLength ); // Points to the length unit, the length to be read when input is the length to be read, and the actual read length after return
|
|
|
|
|
|
BOOL WINAPI CH341AbortRead( // Abort data block read operation
|
|
ULONG iIndex ); // Specify the serial number of the CH341 device
|
|
|
|
|
|
BOOL WINAPI CH341WriteData0( // Write data block to port 0#
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID iBuffer, // Pointer to a buffer where the data to be written is placed
|
|
PULONG ioLength ); // Points to the length unit, the length to be written out when input is the length to be written out, and the length actually written out after return
|
|
|
|
|
|
BOOL WINAPI CH341WriteData1( // Write data block to port 1#
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID iBuffer, // Pointer to a buffer where the data to be written is placed
|
|
PULONG ioLength ); // Points to the length unit, the length to be written out when input is the length to be written out, and the length actually written out after return
|
|
|
|
|
|
BOOL WINAPI CH341AbortWrite( // Abort block write operation
|
|
ULONG iIndex ); // Specify the serial number of the CH341 device
|
|
|
|
|
|
BOOL WINAPI CH341GetStatus( // Input data and status directly through CH341
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PULONG iStatus ); // Points to a double word unit, used to save status data, refer to the following bit description
|
|
// Bit 7-bit 0 correspond to D7-D0 pins of CH341
|
|
// Bit 8 corresponds to ERR# pin of CH341, Bit 9 corresponds to PEMP pin of CH341, Bit 10 corresponds to INT# pin of CH341, Bit 11 corresponds to SLCT pin of CH341, Bit 23 corresponds to SDA pin of CH341
|
|
// Bit 13 corresponds to BUSY/WAIT# pin of CH341, Bit 14 corresponds to AUTOFD#/DATAS# pin of CH341, Bit 15 corresponds to SLCTIN#/ADDRS# pin of CH341
|
|
|
|
|
|
BOOL WINAPI CH341ReadI2C( // Read one byte of data from the I2C interface
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
UCHAR iDevice, // The lower 7 bits specify the I2C device address
|
|
UCHAR iAddr, // Address of specified data unit
|
|
PUCHAR oByte ); // Address of specified data unit
|
|
|
|
|
|
BOOL WINAPI CH341WriteI2C( // Write a byte of data to the I2C interface
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
UCHAR iDevice, // The lower 7 bits specify the I2C device address
|
|
UCHAR iAddr, // Address of specified data unit
|
|
UCHAR iByte ); // Byte data to be written
|
|
|
|
|
|
BOOL WINAPI CH341EppReadData( // Byte data to be written
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the read data
|
|
PULONG ioLength ); // Points to a buffer large enough to hold the read data
|
|
|
|
|
|
BOOL WINAPI CH341EppReadAddr( // Read address in EPP mode: WR#=1, DS#=1, AS#=0, D0-D7=input
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID oBuffer, // Point to a buffer large enough to hold the read address data
|
|
PULONG ioLength ); // Points to the length unit, the length to be read when input is the length to be read, and the actual read length after return
|
|
|
|
|
|
BOOL WINAPI CH341EppWriteData( // Write data in EPP mode: WR#=0, DS#=0, AS#=1, D0-D7=output
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID iBuffer, // Pointer to a buffer where the data to be written is placed
|
|
PULONG ioLength ); // Points to the length unit, the length to be written out when input is the length to be written out, and the length actually written out after return
|
|
|
|
|
|
BOOL WINAPI CH341EppWriteAddr( // Write address in EPP mode: WR#=0, DS#=1, AS#=0, D0-D7=output
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
PVOID iBuffer, // Point to a buffer to place the address data to be written out
|
|
PULONG ioLength ); // Points to the length unit, the length to be written out when input is the length to be written out, and the length actually written out after return
|
|
|
|
|
|
BOOL WINAPI CH341EppSetAddr( // EPP mode setting address: WR#=0, DS#=1, AS#=0, D0-D7=output
|
|
ULONG iIndex, // Specify the serial number of the CH341 device
|
|
UCHAR iAddr ); // Specify the EPP address
|
|
|
|
|
|
BOOL WINAPI CH341MemReadAddr0( // Read the address in MEM mode 0: WR#=1, DS#/RD#=0, AS#/ADDR=0, D0-D7=input
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the data read from address 0
|
|
PULONG ioLength ); // Refers to the length unit, input is the length to read, return is the actual length to read
|
|
|
|
|
|
BOOL WINAPI CH341MemReadAddr1( // Read the address in MEM mode 1: WR#=1, DS#/RD#=0, AS#/ADDR=1, D0-D7=input
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the data read from address 1
|
|
PULONG ioLength ); // Refers to the length unit, input is the length to read, return is the actual length to read
|
|
|
|
|
|
BOOL WINAPI CH341MemWriteAddr0( // Write the address in MEM mode 0: WR#=0, DS#/RD#=1, AS#/ADDR=0, D0-D7=output
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID iBuffer, // Points to a buffer to place the data to be written to address 0
|
|
PULONG ioLength ); // Refers to the length unit. The input is the intended length and the return is the actual length
|
|
|
|
|
|
BOOL WINAPI CH341MemWriteAddr1( // Write the address in MEM mode 1: WR#=0, DS#/RD#=1, AS#/ADDR=1, D0-D7=output
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID iBuffer, // Points to a buffer to place the data to be written to address 1
|
|
PULONG ioLength ); // Refers to the length unit. The input is the intended length and the return is the actual length
|
|
|
|
|
|
BOOL WINAPI CH341SetExclusive( // Set exclusive use of the current CH341 device
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iExclusive ); // If the value is 0, the device can be shared. If the value is not 0, the device can be exclusively used
|
|
|
|
BOOL WINAPI CH341SetTimeout( // Set the timeout of USB data read and write
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iWriteTimeout, // Specifies the timeout for USB to write data blocks, in milliseconds mS, 0xFFFFFFFF specifies no timeout (default)
|
|
ULONG iReadTimeout ); // Specifies the timeout for USB to read data blocks, in milliseconds mS, 0xFFFFFFFF specifies no timeout (default)
|
|
|
|
|
|
BOOL WINAPI CH341ReadData( // Read data block
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID oBuffer, // Points to a buffer large enough to hold the read data
|
|
PULONG ioLength ); // Refers to the length unit, input is the length to read, return is the actual length to read
|
|
|
|
|
|
BOOL WINAPI CH341WriteData( // Write out blocks of data
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PVOID iBuffer, // Points to a buffer to place data ready to be written out
|
|
PULONG ioLength ); // Refers to the length unit. The input is the intended length and the return is the actual length
|
|
|
|
|
|
PVOID WINAPI CH341GetDeviceName( // Returns a buffer pointing to the CH341 device name, or NULL on error
|
|
ULONG iIndex ); // Specify the CH341 device number,0 corresponds to the first device
|
|
|
|
|
|
ULONG WINAPI CH341GetVerIC( // 0= device invalid,0x10=CH341,0x20=CH341A
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
#define IC_VER_CH341A 0x20
|
|
#define IC_VER_CH341A3 0x30
|
|
|
|
|
|
BOOL WINAPI CH341FlushBuffer( // Clear the buffer of CH341
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
|
|
|
|
BOOL WINAPI CH341WriteRead( // Execute the data flow command, output before input
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iWriteLength, // Write the length, the length you're going to write
|
|
PVOID iWriteBuffer, // Points to a buffer to place data ready to be written out
|
|
ULONG iReadStep, // The length of a single block to be read. The total length to be read is(iReadStep*iReadTimes)
|
|
ULONG iReadTimes, // Number of times you are ready to read
|
|
PULONG oReadLength, // Points to the length unit and returns the length actually read
|
|
PVOID oReadBuffer ); // Points to a buffer large enough to hold the read data
|
|
|
|
|
|
BOOL WINAPI CH341SetStream( // Set the serial port flow mode
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iMode ); // To specify the mode, see Downlink
|
|
// Bit 1-bit 0: I2C interface speed /SCL frequency, 00= low speed /20KHz,01= standard /100KHz(default),10= fast /400KHz,11= high speed /750KHz
|
|
// Bit 2: SPI I/O number /IO pins, 0= single in/single out (D3 clock /D5 out /D7 in)(default),1= double in/double out (D3 clock /D5 out D4 out /D7 in D6 in)
|
|
// Bit 7: Bit order in SPI bytes, 0= low first, 1= high first
|
|
// All other reservations must be 0
|
|
|
|
|
|
BOOL WINAPI CH341SetDelaymS( // Set the hardware asynchronous delay to a specified number of milliseconds before the next stream operation
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iDelay ); // Specifies the number of milliseconds to delay
|
|
|
|
|
|
BOOL WINAPI CH341StreamI2C( // Process I2C data stream, 2-wire interface, clock line for SCL pin, data line for SDA pin (quasi-bidirectional I/O), speed of about 56K bytes
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iWriteLength, // Number of bytes of data to write out
|
|
PVOID iWriteBuffer, // Points to a buffer to place data to be written, usually with the I2C device address and read/write direction bits as the first byte
|
|
ULONG iReadLength, // Number of bytes of data to be read
|
|
PVOID oReadBuffer ); // Points to a buffer and returns the data read in
|
|
|
|
|
|
typedef enum _EEPROM_TYPE { // EEPROM type
|
|
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;
|
|
|
|
|
|
BOOL WINAPI CH341ReadEEPROM( // Reads data blocks from EEPROM at a speed of about 56 KB
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
EEPROM_TYPE iEepromID, // Specifies the EEPROM model
|
|
ULONG iAddr, // Specifies the address of the data unit
|
|
ULONG iLength, // Number of bytes of data to be read
|
|
PUCHAR oBuffer ); // Points to a buffer and returns the data read in
|
|
|
|
|
|
BOOL WINAPI CH341WriteEEPROM( // Writes a data block to the EEPROM
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
EEPROM_TYPE iEepromID, // Specifies the EEPROM model
|
|
ULONG iAddr, // Specifies the address of the data unit
|
|
ULONG iLength, // Number of bytes of data to write out
|
|
PUCHAR iBuffer ); // Points to a buffer to place data ready to be written out
|
|
|
|
|
|
BOOL WINAPI CH341GetInput( // Using the CH341 to directly enter data and status is more efficient than using the CH341GetStatus function
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
PULONG iStatus ); // Points to a two-word unit that holds state data, as described in the bit description below
|
|
// Bits 7-0 correspond to the D7-D0 pins of CH341
|
|
// Bit 8 corresponds to the ERR# pin of CH341, bit 9 to the PEMP pin of CH341, bit 10 to the INT# pin of CH341, bit 11 to the SLCT pin of CH341, and bit 23 to the SDA pin of CH341
|
|
// Bit 13 corresponds to the BUSY/WAIT# pin of CH341, bit 14 corresponds to the AUTOFD#/ data # pin of CH341, and bit 15 corresponds to the SLCTIN#/ADDRS# pin of CH341
|
|
|
|
|
|
BOOL WINAPI CH341SetOutput( // Set the I/O direction for the CH341 and output data over the CH341
|
|
/* ***** Use this API with care to prevent damage to the chip by changing the I/O direction to change the input pin to the output pin, resulting in short circuits with other output pins ***** */
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iEnable, // Data valid flag, refer to the bit description below
|
|
// If bit 0 is 1, bits 15 to 8 of iSetDataOut are valid. Otherwise, it is ignored
|
|
// If bit 1 is 1, bits 15 to 8 of iSetDirOut are valid. Otherwise, the value is ignored
|
|
// If bit 2 is 1, the 7-bit 0 of iSetDataOut is valid. Otherwise, it is ignored
|
|
// If bit 3 is 1, the iSetDirOut bit 7 to bit 0 is valid. Otherwise, the iSetDirOut bit is ignored
|
|
// If bit 4 is 1, bits 23 to 16 of iSetDataOut are valid. Otherwise, it is ignored
|
|
ULONG iSetDirOut, // To set the I/O direction, pin 0 corresponds to input and pin 1 corresponds to output. In parallel port mode, the default value is 0x000FC000. Refer to the bit description below
|
|
ULONG iSetDataOut ); // Output data. If the I/O direction is output, then a clear 0 corresponds to pin output low level, and a position 1 corresponds to pin output high level, refer to the bit description below
|
|
// Bits 7-0 correspond to the D7-D0 pins of CH341
|
|
// Bit 8 corresponds to the ERR# pin of CH341, bit 9 to the PEMP pin of CH341, bit 10 to the INT# pin of CH341, and bit 11 to the SLCT pin of CH341
|
|
// Bit 13 corresponds to the WAIT# pin of CH341, bit 14 to the DATAS#/READ# pin of CH341, and bit 15 to the ADDRS#/ADDR/ALE pin of CH341
|
|
// The following pins can only be output, irrespective of the I/O direction: bit 16 corresponds to set # for CH341, bit 17 corresponds to WRITE# for CH341, bit 18 corresponds to SCL for CH341, and bit 29 corresponds to SDA for CH341
|
|
|
|
|
|
BOOL WINAPI CH341Set_D5_D0( // Set the I/O direction of D5-D0 pins of CH341, and directly output data through THE D5-D0 pins of CH341. The efficiency is higher than that of CH341SetOutput
|
|
/* ***** Use this API with care to prevent damage to the chip by changing the I/O direction to change the input pin to the output pin, resulting in short circuits with other output pins ***** */
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iSetDirOut, // Set the I/O direction of each pin d5-D0. Pin 0 corresponds to input, pin 1 corresponds to output. In parallel port mode, the default value is 0x00 for all input
|
|
ULONG iSetDataOut ); // Set the output data of each pin of D5-D0. If the I/O direction is output, then a clear 0 corresponds to pin output low level, and a position 1 corresponds to pin output high level
|
|
// Bits 5-0 of the above data correspond to the D5-D0 pins of CH341 respectively
|
|
|
|
|
|
BOOL WINAPI CH341StreamSPI3( // This API is invalid. Do not use it
|
|
ULONG iIndex,
|
|
ULONG iChipSelect,
|
|
ULONG iLength,
|
|
PVOID ioBuffer );
|
|
|
|
|
|
BOOL WINAPI CH341StreamSPI4( // SPI data stream processing, 4-line interface, clock line is DCK/D3 pin, output data line is DOUT/D5 pin, input data line is DIN/D7 pin, chip line is D0/D1/D2, speed is about 68K bytes
|
|
/* SPI timing: DCK/D3 pin is clock output, default low level, DOUT/D5 pin is output during low level before clock rising edge, DIN/D7 pin is input during high level before clock falling edge */
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iChipSelect, // Chip selection control. If bit 7 is 0, chip selection control is ignored. If bit 7 is 1, the parameter is effective: if bit 1 is 00/01/10, D0/D1/D2 pins are selected as low level effective chip selection respectively
|
|
ULONG iLength, // Number of bytes of data to be transferred
|
|
PVOID ioBuffer ); // Points to a buffer, places data to be written out from DOUT, and returns data to be read in from DIN
|
|
|
|
|
|
BOOL WINAPI CH341StreamSPI5( // SPI data stream processing, 5-line interface, clock line is DCK/D3 pin, output data line is DOUT/D5 and DOUT2/D4 pin, input data line is DIN/D7 and DIN2/D6 pin, chip line is D0/D1/D2, speed is about 30K bytes *2
|
|
/* SPI timing: DCK/D3 pins are clock outputs and are low by default, DOUT/D5 and DOUT2/D4 pins are output during the low period before the rising edge of the clock, and DIN/D7 and DIN2/D6 pins are input during the high period before the falling edge of the clock */
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iChipSelect, // Chip selection control. If bit 7 is 0, chip selection control is ignored. If bit 7 is 1, the parameter is effective: if bit 1 is 00/01/10, D0/D1/D2 pins are selected as low level effective chip selection respectively
|
|
ULONG iLength, // Number of bytes of data to be transferred
|
|
PVOID ioBuffer, // Points to a buffer, places data to be written out from DOUT, and returns data to be read in from DIN
|
|
PVOID ioBuffer2 ); // Point to the second buffer, place the data to be written from DOUT2, and return the data to be read from DIN2
|
|
|
|
|
|
BOOL WINAPI CH341BitStreamSPI( // SPI bit data flow processing,4 line /5 line interface, clock line for DCK/D3 pin, output data line for DOUT/DOUT2 pin, input data line for DIN/DIN2 pin, chip line for D0/D1/D2, speed about 8K bit *2
|
|
ULONG iIndex, // Specify the CH341 device number
|
|
ULONG iLength, // The number of bits to be transmitted at a time is a maximum of 896. It is recommended that the number not exceed 256
|
|
PVOID ioBuffer ); // Point to a buffer, place data to be written from DOUT/DOUT2/ d2-d0, and return data to be read from DIN/DIN2
|
|
/* SPI timing: DCK/D3 pins are clock outputs and are low by default, DOUT/D5 and DOUT2/D4 pins are output during the low period before the rising edge of the clock, and DIN/D7 and DIN2/D6 pins are input during the high period before the falling edge of the clock*/
|
|
/* One byte of the ioBuffer has 8 bits corresponding to d7-D0 pins. Bit 5 is output to DOUT, bit 4 to DOUT2, bit 2-0 to D2-d0, bit 7 is input from DIN, bit 6 is input from DIN2, bit 3 is ignored */
|
|
/* Before calling this API, CH341Set_D5_D0 should be called to set the I/O direction of the D5-D0 pins of CH341 and set the default level of the pins */
|
|
|
|
|
|
BOOL WINAPI CH341SetBufUpload( // Set internal buffered upload mode
|
|
ULONG iIndex, // Specify the CH341 device number,0 corresponds to the first device
|
|
ULONG iEnableOrClear ); // If the value is 0, the internal buffered upload mode is disabled and direct upload is used. If the value is not 0, the internal buffered upload mode is enabled and the existing data in the buffer is cleared
|
|
// If internal buffered-upload mode is enabled, the CH341 driver creation thread automatically receives USB upload data to the internal buffer and clears the existing data in the buffer. The existing data in the buffer will be returned immediately when the application calls CH341ReadData
|
|
|
|
|
|
LONG WINAPI CH341QueryBufUpload( // Query the number of existing data packets in the internal upload buffer. The number of data packets is returned successfully, or -1 is returned if an error occurs
|
|
ULONG iIndex ); // Specify the CH341 device number,0 corresponds to the first device
|
|
|
|
|
|
BOOL WINAPI CH341SetBufDownload( // Set the internal buffer down mode
|
|
ULONG iIndex, // Specify the CH341 device number,0 corresponds to the first device
|
|
ULONG iEnableOrClear ); // If the value is 0, the internal buffered downtransmission mode is disabled and direct downtransmission is used. If the value is not 0, the internal buffered downtransmission mode is enabled and the existing data in the buffer is cleared
|
|
// If internal buffer-down mode is enabled, when an application calls CH341WriteData, it simply puts USB downpass data into an internal buffer and returns it immediately, while threads created by the CH341 driver automatically send it to completion
|
|
|
|
|
|
LONG WINAPI CH341QueryBufDownload( // Query the number of remaining packets in the internal downtransmission buffer (that have not been sent). The number of successful packets is returned, and -1 is returned if an error occurs
|
|
ULONG iIndex ); // Specify the CH341 device number,0 corresponds to the first device
|
|
|
|
|
|
BOOL WINAPI CH341ResetInter( // Reset an interrupted data read operation
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
|
|
|
|
BOOL WINAPI CH341ResetRead( // Reset the data block read operation
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
|
|
|
|
BOOL WINAPI CH341ResetWrite( // Reset a block write operation
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
|
|
|
|
typedef VOID ( CALLBACK * mPCH341_NOTIFY_ROUTINE ) ( // Device event notification callback program
|
|
ULONG iEventStatus ); // Device event and current status (defined downstream): 0= device removal event, 3= device insertion event
|
|
|
|
#define CH341_DEVICE_ARRIVAL 3 // Device insertion event, already inserted
|
|
#define CH341_DEVICE_REMOVE_PEND 1 // Device to be pulled out
|
|
#define CH341_DEVICE_REMOVE 0 // The device is removed
|
|
|
|
|
|
BOOL WINAPI CH341SetDeviceNotify( // Set up the device event notification procedure
|
|
ULONG iIndex, // Specify the CH341 device number,0 corresponds to the first device
|
|
PCHAR iDeviceID, // Optional argument pointing to a string specifying the ID of the device to be monitored, terminated with \0
|
|
mPCH341_NOTIFY_ROUTINE iNotifyRoutine ); // Specifies a device event callback that cancels event notification if NULL, or is called when an event is detected
|
|
|
|
|
|
BOOL WINAPI CH341SetupSerial( // Set the serial port feature of the CH341. This API can only be used for CH341 chips that work in serial port mode
|
|
ULONG iIndex, // Specify the CH341 device number,0 corresponds to the first device
|
|
ULONG iParityMode, // Specifies the data verification mode of the CH341 serial port: NOPARITY/ODDPARITY/EVENPARITY/MARKPARITY/SPACEPARITY
|
|
ULONG iBaudRate ); // Set the baud rate of the CH341 serial port. The value ranges from 50 to 3000000
|
|
|
|
/* The following apis can be used for CH341 chips that work in serial port mode. Other apis can only be used for CH341 chips that work in parallel port mode
|
|
CH341OpenDevice
|
|
CH341CloseDevice
|
|
CH341SetupSerial
|
|
CH341ReadData
|
|
CH341WriteData
|
|
CH341SetBufUpload
|
|
CH341QueryBufUpload
|
|
CH341SetBufDownload
|
|
CH341QueryBufDownload
|
|
CH341SetDeviceNotify
|
|
CH341GetStatus
|
|
// The above API is the primary API and the following API is the secondary API
|
|
CH341GetVersion
|
|
CH341DriverCommand
|
|
CH341GetDrvVersion
|
|
CH341ResetDevice
|
|
CH341GetDeviceDescr
|
|
CH341GetConfigDescr
|
|
CH341SetIntRoutine
|
|
CH341ReadInter
|
|
CH341AbortInter
|
|
CH341AbortRead
|
|
CH341AbortWrite
|
|
CH341ReadI2C
|
|
CH341WriteI2C
|
|
CH341SetExclusive
|
|
CH341SetTimeout
|
|
CH341GetDeviceName
|
|
CH341GetVerIC
|
|
CH341FlushBuffer
|
|
CH341WriteRead
|
|
CH341ResetInter
|
|
CH341ResetRead
|
|
CH341ResetWrite
|
|
*/
|
|
HANDLE WINAPI CH341OpenDeviceEx( // Turn on the CH341 device and return the handle
|
|
ULONG iIndex ); // Specify the CH341 device number,0 corresponds to the first device to be inserted, and 1 corresponds to the second device to be inserted. To save device serial number resources, shut down the device after it is used up
|
|
|
|
|
|
VOID WINAPI CH341CloseDeviceEx( // Close the CH341
|
|
ULONG iIndex ); // Specify the CH341 device number
|
|
|
|
|
|
PCHAR WINAPI CH341GetDeviceNameEx( // Returns a buffer pointing to the CH341 device name, or NULL on error
|
|
ULONG iIndex ); // Specify the CH341 device number,0 corresponds to the first device
|
|
|
|
|
|
BOOL WINAPI CH341SetDeviceNotifyEx( // Set up the device event notification procedure
|
|
ULONG iIndex, // Specify the CH341 device number,0 corresponds to the first device
|
|
PCHAR iDeviceID, // Optional argument pointing to a string specifying the ID of the device to be monitored, terminated with \0
|
|
mPCH341_NOTIFY_ROUTINE iNotifyRoutine ); // Specifies a device event callback that cancels event notification if NULL, or is called when an event is detected
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // _CH341_DLL_H
|