ch341a_software_and_drivers/Drivers/LIB/CH341/CH341DLL_EN.H

681 lines
41 KiB
C++
Raw Normal View History

// 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