| 0,0 → 1,1087 |
|---|
| /*++ |
| |
| Copyright (c) 2001-2011 Future Technology Devices International Limited |
| |
| THIS SOFTWARE IS PROVIDED BY FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED "AS IS" |
| AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL |
| FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT |
| OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION) |
| HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR |
| TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, |
| EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| |
| FTDI DRIVERS MAY BE USED ONLY IN CONJUNCTION WITH PRODUCTS BASED ON FTDI PARTS. |
| |
| FTDI DRIVERS MAY BE DISTRIBUTED IN ANY FORM AS LONG AS LICENSE INFORMATION IS NOT MODIFIED. |
| |
| IF A CUSTOM VENDOR ID AND/OR PRODUCT ID OR DESCRIPTION STRING ARE USED, IT IS THE |
| RESPONSIBILITY OF THE PRODUCT MANUFACTURER TO MAINTAIN ANY CHANGES AND SUBSEQUENT WHQL |
| RE-CERTIFICATION AS A RESULT OF MAKING THESE CHANGES. |
| |
| |
| Module Name: |
| |
| ftd2xx.h |
| |
| Abstract: |
| |
| Native USB device driver for FTDI FT232x, FT245x, FT2232x and FT4232x devices |
| FTD2XX library definitions |
| |
| Environment: |
| |
| user mode |
| |
| |
| --*/ |
| |
| |
| #ifndef FTD2XX_H |
| #define FTD2XX_H |
| |
| #ifndef _WINDOWS |
| #include <pthread.h> |
| #define WINAPI |
| #endif |
| |
| // The following ifdef block is the standard way of creating macros |
| // which make exporting from a DLL simpler. All files within this DLL |
| // are compiled with the FTD2XX_EXPORTS symbol defined on the command line. |
| // This symbol should not be defined on any project that uses this DLL. |
| // This way any other project whose source files include this file see |
| // FTD2XX_API functions as being imported from a DLL, whereas this DLL |
| // sees symbols defined with this macro as being exported. |
| |
| #ifdef FTD2XX_EXPORTS |
| #define FTD2XX_API __declspec(dllexport) |
| #else |
| #define FTD2XX_API __declspec(dllimport) |
| #endif |
| |
| #ifndef _WINDOWS |
| #include "WinTypes.h" |
| |
| #ifdef FTD2XX_API |
| #undef FTD2XX_API |
| #define FTD2XX_API |
| #endif |
| #endif |
| typedef struct _EVENT_HANDLE{ |
| pthread_cond_t eCondVar; |
| pthread_mutex_t eMutex; |
| int iVar; |
| } EVENT_HANDLE; |
| |
| typedef PVOID FT_HANDLE; |
| typedef ULONG FT_STATUS; |
| |
| // |
| // Device status |
| // |
| enum { |
| FT_OK, |
| FT_INVALID_HANDLE, |
| FT_DEVICE_NOT_FOUND, |
| FT_DEVICE_NOT_OPENED, |
| FT_IO_ERROR, |
| FT_INSUFFICIENT_RESOURCES, |
| FT_INVALID_PARAMETER, |
| FT_INVALID_BAUD_RATE, //7 |
| |
| FT_DEVICE_NOT_OPENED_FOR_ERASE, |
| FT_DEVICE_NOT_OPENED_FOR_WRITE, |
| FT_FAILED_TO_WRITE_DEVICE, |
| FT_EEPROM_READ_FAILED, |
| FT_EEPROM_WRITE_FAILED, |
| FT_EEPROM_ERASE_FAILED, |
| FT_EEPROM_NOT_PRESENT, |
| FT_EEPROM_NOT_PROGRAMMED, |
| FT_INVALID_ARGS, |
| FT_NOT_SUPPORTED, |
| FT_OTHER_ERROR |
| }; |
| |
| |
| #define FT_SUCCESS(status) ((status) == FT_OK) |
| |
| // |
| // FT_OpenEx Flags |
| // |
| |
| #define FT_OPEN_BY_SERIAL_NUMBER 1 |
| #define FT_OPEN_BY_DESCRIPTION 2 |
| #define FT_OPEN_BY_LOCATION 4 |
| |
| // |
| // FT_ListDevices Flags (used in conjunction with FT_OpenEx Flags |
| // |
| |
| #define FT_LIST_NUMBER_ONLY 0x80000000 |
| #define FT_LIST_BY_INDEX 0x40000000 |
| #define FT_LIST_ALL 0x20000000 |
| |
| #define FT_LIST_MASK (FT_LIST_NUMBER_ONLY|FT_LIST_BY_INDEX|FT_LIST_ALL) |
| |
| // |
| // Baud Rates |
| // |
| |
| #define FT_BAUD_300 300 |
| #define FT_BAUD_600 600 |
| #define FT_BAUD_1200 1200 |
| #define FT_BAUD_2400 2400 |
| #define FT_BAUD_4800 4800 |
| #define FT_BAUD_9600 9600 |
| #define FT_BAUD_14400 14400 |
| #define FT_BAUD_19200 19200 |
| #define FT_BAUD_38400 38400 |
| #define FT_BAUD_57600 57600 |
| #define FT_BAUD_115200 115200 |
| #define FT_BAUD_230400 230400 |
| #define FT_BAUD_460800 460800 |
| #define FT_BAUD_921600 921600 |
| |
| // |
| // Word Lengths |
| // |
| |
| #define FT_BITS_8 (UCHAR) 8 |
| #define FT_BITS_7 (UCHAR) 7 |
| |
| // |
| // Stop Bits |
| // |
| |
| #define FT_STOP_BITS_1 (UCHAR) 0 |
| #define FT_STOP_BITS_2 (UCHAR) 2 |
| |
| // |
| // Parity |
| // |
| |
| #define FT_PARITY_NONE (UCHAR) 0 |
| #define FT_PARITY_ODD (UCHAR) 1 |
| #define FT_PARITY_EVEN (UCHAR) 2 |
| #define FT_PARITY_MARK (UCHAR) 3 |
| #define FT_PARITY_SPACE (UCHAR) 4 |
| |
| // |
| // Flow Control |
| // |
| |
| #define FT_FLOW_NONE 0x0000 |
| #define FT_FLOW_RTS_CTS 0x0100 |
| #define FT_FLOW_DTR_DSR 0x0200 |
| #define FT_FLOW_XON_XOFF 0x0400 |
| |
| // |
| // Purge rx and tx buffers |
| // |
| #define FT_PURGE_RX 1 |
| #define FT_PURGE_TX 2 |
| |
| // |
| // Events |
| // |
| |
| typedef void (*PFT_EVENT_HANDLER)(DWORD,DWORD); |
| |
| #define FT_EVENT_RXCHAR 1 |
| #define FT_EVENT_MODEM_STATUS 2 |
| #define FT_EVENT_LINE_STATUS 4 |
| |
| // |
| // Timeouts |
| // |
| |
| #define FT_DEFAULT_RX_TIMEOUT 300 |
| #define FT_DEFAULT_TX_TIMEOUT 300 |
| |
| // |
| // Device types |
| // |
| |
| typedef ULONG FT_DEVICE; |
| |
| enum { |
| FT_DEVICE_BM, |
| FT_DEVICE_AM, |
| FT_DEVICE_100AX, |
| FT_DEVICE_UNKNOWN, |
| FT_DEVICE_2232C, |
| FT_DEVICE_232R, |
| FT_DEVICE_2232H, |
| FT_DEVICE_4232H, |
| FT_DEVICE_232H |
| }; |
| |
| // |
| // Bit Modes |
| // |
| |
| #define FT_BITMODE_RESET 0x00 |
| #define FT_BITMODE_ASYNC_BITBANG 0x01 |
| #define FT_BITMODE_MPSSE 0x02 |
| #define FT_BITMODE_SYNC_BITBANG 0x04 |
| #define FT_BITMODE_MCU_HOST 0x08 |
| #define FT_BITMODE_FAST_SERIAL 0x10 |
| #define FT_BITMODE_CBUS_BITBANG 0x20 |
| #define FT_BITMODE_SYNC_FIFO 0x40 |
| |
| |
| // |
| // FT232R CBUS Options EEPROM values |
| // |
| |
| #define FT_232R_CBUS_TXDEN 0x00 // Tx Data Enable |
| #define FT_232R_CBUS_PWRON 0x01 // Power On |
| #define FT_232R_CBUS_RXLED 0x02 // Rx LED |
| #define FT_232R_CBUS_TXLED 0x03 // Tx LED |
| #define FT_232R_CBUS_TXRXLED 0x04 // Tx and Rx LED |
| #define FT_232R_CBUS_SLEEP 0x05 // Sleep |
| #define FT_232R_CBUS_CLK48 0x06 // 48MHz clock |
| #define FT_232R_CBUS_CLK24 0x07 // 24MHz clock |
| #define FT_232R_CBUS_CLK12 0x08 // 12MHz clock |
| #define FT_232R_CBUS_CLK6 0x09 // 6MHz clock |
| #define FT_232R_CBUS_IOMODE 0x0A // IO Mode for CBUS bit-bang |
| #define FT_232R_CBUS_BITBANG_WR 0x0B // Bit-bang write strobe |
| #define FT_232R_CBUS_BITBANG_RD 0x0C // Bit-bang read strobe |
| |
| // |
| // FT232H CBUS Options EEPROM values |
| // |
| |
| #define FT_232H_CBUS_TRISTATE 0x00 // Tristate |
| #define FT_232H_CBUS_TXLED 0x01 // Tx LED |
| #define FT_232H_CBUS_RXLED 0x02 // Rx LED |
| #define FT_232H_CBUS_TXRXLED 0x03 // Tx and Rx LED |
| #define FT_232H_CBUS_PWREN 0x04 // Power Enable |
| #define FT_232H_CBUS_SLEEP 0x05 // Sleep |
| #define FT_232H_CBUS_DRIVE_0 0x06 // Drive pin to logic 0 |
| #define FT_232H_CBUS_DRIVE_1 0x07 // Drive pin to logic 1 |
| #define FT_232H_CBUS_IOMODE 0x08 // IO Mode for CBUS bit-bang |
| #define FT_232H_CBUS_TXDEN 0x09 // Tx Data Enable |
| #define FT_232H_CBUS_CLK30 0x0A // 30MHz clock |
| #define FT_232H_CBUS_CLK15 0x0B // 15MHz clock |
| #define FT_232H_CBUS_CLK7_5 0x0C // 7.5MHz clock |
| |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_Open( |
| int deviceNumber, |
| FT_HANDLE *pHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_OpenEx( |
| PVOID pArg1, |
| DWORD Flags, |
| FT_HANDLE *pHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ListDevices( |
| PVOID pArg1, |
| PVOID pArg2, |
| DWORD Flags |
| ); |
| |
| FTD2XX_API |
| FT_STATUS FT_SetVIDPID( |
| DWORD dwVID, |
| DWORD dwPID |
| ); |
| |
| FTD2XX_API |
| FT_STATUS FT_GetVIDPID( |
| DWORD * pdwVID, |
| DWORD * pdwPID |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_Close( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_Read( |
| FT_HANDLE ftHandle, |
| LPVOID lpBuffer, |
| DWORD nBufferSize, |
| LPDWORD lpBytesReturned |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_Write( |
| FT_HANDLE ftHandle, |
| LPVOID lpBuffer, |
| DWORD nBufferSize, |
| LPDWORD lpBytesWritten |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_IoCtl( |
| FT_HANDLE ftHandle, |
| DWORD dwIoControlCode, |
| LPVOID lpInBuf, |
| DWORD nInBufSize, |
| LPVOID lpOutBuf, |
| DWORD nOutBufSize, |
| LPDWORD lpBytesReturned, |
| LPOVERLAPPED lpOverlapped |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetBaudRate( |
| FT_HANDLE ftHandle, |
| ULONG BaudRate |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetDivisor( |
| FT_HANDLE ftHandle, |
| USHORT Divisor |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetDataCharacteristics( |
| FT_HANDLE ftHandle, |
| UCHAR WordLength, |
| UCHAR StopBits, |
| UCHAR Parity |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetFlowControl( |
| FT_HANDLE ftHandle, |
| USHORT FlowControl, |
| UCHAR XonChar, |
| UCHAR XoffChar |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ResetDevice( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetDtr( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ClrDtr( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetRts( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ClrRts( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetModemStatus( |
| FT_HANDLE ftHandle, |
| ULONG *pModemStatus |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetChars( |
| FT_HANDLE ftHandle, |
| UCHAR EventChar, |
| UCHAR EventCharEnabled, |
| UCHAR ErrorChar, |
| UCHAR ErrorCharEnabled |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_Purge( |
| FT_HANDLE ftHandle, |
| ULONG Mask |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetTimeouts( |
| FT_HANDLE ftHandle, |
| ULONG ReadTimeout, |
| ULONG WriteTimeout |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetQueueStatus( |
| FT_HANDLE ftHandle, |
| DWORD *dwRxBytes |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetQueueStatusEx( |
| FT_HANDLE ftHandle, |
| DWORD *dwRxBytes |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetEventNotification( |
| FT_HANDLE ftHandle, |
| DWORD Mask, |
| PVOID Param |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetStatus( |
| FT_HANDLE ftHandle, |
| DWORD *dwRxBytes, |
| DWORD *dwTxBytes, |
| DWORD *dwEventDWord |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetBreakOn( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetBreakOff( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetWaitMask( |
| FT_HANDLE ftHandle, |
| DWORD Mask |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_WaitOnMask( |
| FT_HANDLE ftHandle, |
| DWORD *Mask |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetEventStatus( |
| FT_HANDLE ftHandle, |
| DWORD *dwEventDWord |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ReadEE( |
| FT_HANDLE ftHandle, |
| DWORD dwWordOffset, |
| LPWORD lpwValue |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_WriteEE( |
| FT_HANDLE ftHandle, |
| DWORD dwWordOffset, |
| WORD wValue |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EraseEE( |
| FT_HANDLE ftHandle |
| ); |
| |
| // |
| // structure to hold program data for FT_Program function |
| // |
| typedef struct ft_program_data { |
| |
| DWORD Signature1; // Header - must be 0x00000000 |
| DWORD Signature2; // Header - must be 0xffffffff |
| DWORD Version; // Header - FT_PROGRAM_DATA version |
| // 0 = original |
| // 1 = FT2232C extensions |
| // 2 = FT232R extensions |
| // 3 = FT2232H extensions |
| // 4 = FT4232H extensions |
| // 5 = FT232H extensions |
| WORD VendorId; // 0x0403 |
| WORD ProductId; // 0x6001 |
| char *Manufacturer; // "FTDI" |
| char *ManufacturerId; // "FT" |
| char *Description; // "USB HS Serial Converter" |
| char *SerialNumber; // "FT000001" if fixed, or NULL |
| WORD MaxPower; // 0 < MaxPower <= 500 |
| WORD PnP; // 0 = disabled, 1 = enabled |
| WORD SelfPowered; // 0 = bus powered, 1 = self powered |
| WORD RemoteWakeup; // 0 = not capable, 1 = capable |
| // |
| // Rev4 (FT232B) extensions |
| // |
| UCHAR Rev4; // non-zero if Rev4 chip, zero otherwise |
| UCHAR IsoIn; // non-zero if in endpoint is isochronous |
| UCHAR IsoOut; // non-zero if out endpoint is isochronous |
| UCHAR PullDownEnable; // non-zero if pull down enabled |
| UCHAR SerNumEnable; // non-zero if serial number to be used |
| UCHAR USBVersionEnable; // non-zero if chip uses USBVersion |
| WORD USBVersion; // BCD (0x0200 => USB2) |
| // |
| // Rev 5 (FT2232) extensions |
| // |
| UCHAR Rev5; // non-zero if Rev5 chip, zero otherwise |
| UCHAR IsoInA; // non-zero if in endpoint is isochronous |
| UCHAR IsoInB; // non-zero if in endpoint is isochronous |
| UCHAR IsoOutA; // non-zero if out endpoint is isochronous |
| UCHAR IsoOutB; // non-zero if out endpoint is isochronous |
| UCHAR PullDownEnable5; // non-zero if pull down enabled |
| UCHAR SerNumEnable5; // non-zero if serial number to be used |
| UCHAR USBVersionEnable5; // non-zero if chip uses USBVersion |
| WORD USBVersion5; // BCD (0x0200 => USB2) |
| UCHAR AIsHighCurrent; // non-zero if interface is high current |
| UCHAR BIsHighCurrent; // non-zero if interface is high current |
| UCHAR IFAIsFifo; // non-zero if interface is 245 FIFO |
| UCHAR IFAIsFifoTar; // non-zero if interface is 245 FIFO CPU target |
| UCHAR IFAIsFastSer; // non-zero if interface is Fast serial |
| UCHAR AIsVCP; // non-zero if interface is to use VCP drivers |
| UCHAR IFBIsFifo; // non-zero if interface is 245 FIFO |
| UCHAR IFBIsFifoTar; // non-zero if interface is 245 FIFO CPU target |
| UCHAR IFBIsFastSer; // non-zero if interface is Fast serial |
| UCHAR BIsVCP; // non-zero if interface is to use VCP drivers |
| // |
| // Rev 6 (FT232R) extensions |
| // |
| UCHAR UseExtOsc; // Use External Oscillator |
| UCHAR HighDriveIOs; // High Drive I/Os |
| UCHAR EndpointSize; // Endpoint size |
| UCHAR PullDownEnableR; // non-zero if pull down enabled |
| UCHAR SerNumEnableR; // non-zero if serial number to be used |
| UCHAR InvertTXD; // non-zero if invert TXD |
| UCHAR InvertRXD; // non-zero if invert RXD |
| UCHAR InvertRTS; // non-zero if invert RTS |
| UCHAR InvertCTS; // non-zero if invert CTS |
| UCHAR InvertDTR; // non-zero if invert DTR |
| UCHAR InvertDSR; // non-zero if invert DSR |
| UCHAR InvertDCD; // non-zero if invert DCD |
| UCHAR InvertRI; // non-zero if invert RI |
| UCHAR Cbus0; // Cbus Mux control |
| UCHAR Cbus1; // Cbus Mux control |
| UCHAR Cbus2; // Cbus Mux control |
| UCHAR Cbus3; // Cbus Mux control |
| UCHAR Cbus4; // Cbus Mux control |
| UCHAR RIsD2XX; // non-zero if using D2XX drivers |
| // |
| // Rev 7 (FT2232H) Extensions |
| // |
| UCHAR PullDownEnable7; // non-zero if pull down enabled |
| UCHAR SerNumEnable7; // non-zero if serial number to be used |
| UCHAR ALSlowSlew; // non-zero if AL pins have slow slew |
| UCHAR ALSchmittInput; // non-zero if AL pins are Schmitt input |
| UCHAR ALDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR AHSlowSlew; // non-zero if AH pins have slow slew |
| UCHAR AHSchmittInput; // non-zero if AH pins are Schmitt input |
| UCHAR AHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR BLSlowSlew; // non-zero if BL pins have slow slew |
| UCHAR BLSchmittInput; // non-zero if BL pins are Schmitt input |
| UCHAR BLDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR BHSlowSlew; // non-zero if BH pins have slow slew |
| UCHAR BHSchmittInput; // non-zero if BH pins are Schmitt input |
| UCHAR BHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR IFAIsFifo7; // non-zero if interface is 245 FIFO |
| UCHAR IFAIsFifoTar7; // non-zero if interface is 245 FIFO CPU target |
| UCHAR IFAIsFastSer7; // non-zero if interface is Fast serial |
| UCHAR AIsVCP7; // non-zero if interface is to use VCP drivers |
| UCHAR IFBIsFifo7; // non-zero if interface is 245 FIFO |
| UCHAR IFBIsFifoTar7; // non-zero if interface is 245 FIFO CPU target |
| UCHAR IFBIsFastSer7; // non-zero if interface is Fast serial |
| UCHAR BIsVCP7; // non-zero if interface is to use VCP drivers |
| UCHAR PowerSaveEnable; // non-zero if using BCBUS7 to save power for self-powered designs |
| // |
| // Rev 8 (FT4232H) Extensions |
| // |
| UCHAR PullDownEnable8; // non-zero if pull down enabled |
| UCHAR SerNumEnable8; // non-zero if serial number to be used |
| UCHAR ASlowSlew; // non-zero if AL pins have slow slew |
| UCHAR ASchmittInput; // non-zero if AL pins are Schmitt input |
| UCHAR ADriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR BSlowSlew; // non-zero if AH pins have slow slew |
| UCHAR BSchmittInput; // non-zero if AH pins are Schmitt input |
| UCHAR BDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR CSlowSlew; // non-zero if BL pins have slow slew |
| UCHAR CSchmittInput; // non-zero if BL pins are Schmitt input |
| UCHAR CDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR DSlowSlew; // non-zero if BH pins have slow slew |
| UCHAR DSchmittInput; // non-zero if BH pins are Schmitt input |
| UCHAR DDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR ARIIsTXDEN; // non-zero if port A uses RI as RS485 TXDEN |
| UCHAR BRIIsTXDEN; // non-zero if port B uses RI as RS485 TXDEN |
| UCHAR CRIIsTXDEN; // non-zero if port C uses RI as RS485 TXDEN |
| UCHAR DRIIsTXDEN; // non-zero if port D uses RI as RS485 TXDEN |
| UCHAR AIsVCP8; // non-zero if interface is to use VCP drivers |
| UCHAR BIsVCP8; // non-zero if interface is to use VCP drivers |
| UCHAR CIsVCP8; // non-zero if interface is to use VCP drivers |
| UCHAR DIsVCP8; // non-zero if interface is to use VCP drivers |
| // |
| // Rev 9 (FT232H) Extensions |
| // |
| UCHAR PullDownEnableH; // non-zero if pull down enabled |
| UCHAR SerNumEnableH; // non-zero if serial number to be used |
| UCHAR ACSlowSlewH; // non-zero if AC pins have slow slew |
| UCHAR ACSchmittInputH; // non-zero if AC pins are Schmitt input |
| UCHAR ACDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR ADSlowSlewH; // non-zero if AD pins have slow slew |
| UCHAR ADSchmittInputH; // non-zero if AD pins are Schmitt input |
| UCHAR ADDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA |
| UCHAR Cbus0H; // Cbus Mux control |
| UCHAR Cbus1H; // Cbus Mux control |
| UCHAR Cbus2H; // Cbus Mux control |
| UCHAR Cbus3H; // Cbus Mux control |
| UCHAR Cbus4H; // Cbus Mux control |
| UCHAR Cbus5H; // Cbus Mux control |
| UCHAR Cbus6H; // Cbus Mux control |
| UCHAR Cbus7H; // Cbus Mux control |
| UCHAR Cbus8H; // Cbus Mux control |
| UCHAR Cbus9H; // Cbus Mux control |
| UCHAR IsFifoH; // non-zero if interface is 245 FIFO |
| UCHAR IsFifoTarH; // non-zero if interface is 245 FIFO CPU target |
| UCHAR IsFastSerH; // non-zero if interface is Fast serial |
| UCHAR IsFT1248H; // non-zero if interface is FT1248 |
| UCHAR FT1248CpolH; // FT1248 clock polarity - clock idle high (1) or clock idle low (0) |
| UCHAR FT1248LsbH; // FT1248 data is LSB (1) or MSB (0) |
| UCHAR FT1248FlowControlH; // FT1248 flow control enable |
| UCHAR IsVCPH; // non-zero if interface is to use VCP drivers |
| UCHAR PowerSaveEnableH; // non-zero if using ACBUS7 to save power for self-powered designs |
| |
| } FT_PROGRAM_DATA, *PFT_PROGRAM_DATA; |
| |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_Program( |
| FT_HANDLE ftHandle, |
| PFT_PROGRAM_DATA pData |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_ProgramEx( |
| FT_HANDLE ftHandle, |
| PFT_PROGRAM_DATA lpData, |
| char *Manufacturer, |
| char *ManufacturerId, |
| char *Description, |
| char *SerialNumber |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_Read( |
| FT_HANDLE ftHandle, |
| PFT_PROGRAM_DATA pData |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_ReadEx( |
| FT_HANDLE ftHandle, |
| PFT_PROGRAM_DATA lpData, |
| char *Manufacturer, |
| char *ManufacturerId, |
| char *Description, |
| char *SerialNumber |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_UASize( |
| FT_HANDLE ftHandle, |
| LPDWORD lpdwSize |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_UAWrite( |
| FT_HANDLE ftHandle, |
| PUCHAR pucData, |
| DWORD dwDataLen |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_EE_UARead( |
| FT_HANDLE ftHandle, |
| PUCHAR pucData, |
| DWORD dwDataLen, |
| LPDWORD lpdwBytesRead |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetLatencyTimer( |
| FT_HANDLE ftHandle, |
| UCHAR ucLatency |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetLatencyTimer( |
| FT_HANDLE ftHandle, |
| PUCHAR pucLatency |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetBitMode( |
| FT_HANDLE ftHandle, |
| UCHAR ucMask, |
| UCHAR ucEnable |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetBitMode( |
| FT_HANDLE ftHandle, |
| PUCHAR pucMode |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetUSBParameters( |
| FT_HANDLE ftHandle, |
| ULONG ulInTransferSize, |
| ULONG ulOutTransferSize |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetDeviceInfo( |
| FT_HANDLE ftHandle, |
| FT_DEVICE *lpftDevice, |
| LPDWORD lpdwID, |
| PCHAR SerialNumber, |
| PCHAR Description, |
| LPVOID Dummy |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetDeviceLocId( |
| FT_HANDLE ftHandle, |
| LPDWORD lpdwLocId |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_StopInTask( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_RestartInTask( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_SetResetPipeRetryCount( |
| FT_HANDLE ftHandle, |
| DWORD dwCount |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_ResetPort( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_CyclePort( |
| FT_HANDLE ftHandle |
| ); |
| |
| // |
| // Win32-type functions |
| // |
| |
| FTD2XX_API |
| FT_HANDLE WINAPI FT_W32_CreateFile( |
| LPCSTR lpszName, |
| DWORD dwAccess, |
| DWORD dwShareMode, |
| LPSECURITY_ATTRIBUTES lpSecurityAttributes, |
| DWORD dwCreate, |
| DWORD dwAttrsAndFlags, |
| HANDLE hTemplate |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_CloseHandle( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_ReadFile( |
| FT_HANDLE ftHandle, |
| LPVOID lpBuffer, |
| DWORD nBufferSize, |
| LPDWORD lpBytesReturned, |
| LPOVERLAPPED lpOverlapped |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_WriteFile( |
| FT_HANDLE ftHandle, |
| LPVOID lpBuffer, |
| DWORD nBufferSize, |
| LPDWORD lpBytesWritten, |
| LPOVERLAPPED lpOverlapped |
| ); |
| |
| FTD2XX_API |
| DWORD WINAPI FT_W32_GetLastError( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_GetOverlappedResult( |
| FT_HANDLE ftHandle, |
| LPOVERLAPPED lpOverlapped, |
| LPDWORD lpdwBytesTransferred, |
| BOOL bWait |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_CancelIo( |
| FT_HANDLE ftHandle |
| ); |
| |
| |
| // |
| // Win32 COMM API type functions |
| // |
| typedef struct _FTCOMSTAT { |
| DWORD fCtsHold : 1; |
| DWORD fDsrHold : 1; |
| DWORD fRlsdHold : 1; |
| DWORD fXoffHold : 1; |
| DWORD fXoffSent : 1; |
| DWORD fEof : 1; |
| DWORD fTxim : 1; |
| DWORD fReserved : 25; |
| DWORD cbInQue; |
| DWORD cbOutQue; |
| } FTCOMSTAT, *LPFTCOMSTAT; |
| |
| typedef struct _FTDCB { |
| DWORD DCBlength; /* sizeof(FTDCB) */ |
| DWORD BaudRate; /* Baudrate at which running */ |
| DWORD fBinary: 1; /* Binary Mode (skip EOF check) */ |
| DWORD fParity: 1; /* Enable parity checking */ |
| DWORD fOutxCtsFlow:1; /* CTS handshaking on output */ |
| DWORD fOutxDsrFlow:1; /* DSR handshaking on output */ |
| DWORD fDtrControl:2; /* DTR Flow control */ |
| DWORD fDsrSensitivity:1; /* DSR Sensitivity */ |
| DWORD fTXContinueOnXoff: 1; /* Continue TX when Xoff sent */ |
| DWORD fOutX: 1; /* Enable output X-ON/X-OFF */ |
| DWORD fInX: 1; /* Enable input X-ON/X-OFF */ |
| DWORD fErrorChar: 1; /* Enable Err Replacement */ |
| DWORD fNull: 1; /* Enable Null stripping */ |
| DWORD fRtsControl:2; /* Rts Flow control */ |
| DWORD fAbortOnError:1; /* Abort all reads and writes on Error */ |
| DWORD fDummy2:17; /* Reserved */ |
| WORD wReserved; /* Not currently used */ |
| WORD XonLim; /* Transmit X-ON threshold */ |
| WORD XoffLim; /* Transmit X-OFF threshold */ |
| BYTE ByteSize; /* Number of bits/byte, 4-8 */ |
| BYTE Parity; /* 0-4=None,Odd,Even,Mark,Space */ |
| BYTE StopBits; /* 0,1,2 = 1, 1.5, 2 */ |
| char XonChar; /* Tx and Rx X-ON character */ |
| char XoffChar; /* Tx and Rx X-OFF character */ |
| char ErrorChar; /* Error replacement char */ |
| char EofChar; /* End of Input character */ |
| char EvtChar; /* Received Event character */ |
| WORD wReserved1; /* Fill for now. */ |
| } FTDCB, *LPFTDCB; |
| |
| typedef struct _FTTIMEOUTS { |
| DWORD ReadIntervalTimeout; /* Maximum time between read chars. */ |
| DWORD ReadTotalTimeoutMultiplier; /* Multiplier of characters. */ |
| DWORD ReadTotalTimeoutConstant; /* Constant in milliseconds. */ |
| DWORD WriteTotalTimeoutMultiplier; /* Multiplier of characters. */ |
| DWORD WriteTotalTimeoutConstant; /* Constant in milliseconds. */ |
| } FTTIMEOUTS,*LPFTTIMEOUTS; |
| |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_ClearCommBreak( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_ClearCommError( |
| FT_HANDLE ftHandle, |
| LPDWORD lpdwErrors, |
| LPFTCOMSTAT lpftComstat |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_EscapeCommFunction( |
| FT_HANDLE ftHandle, |
| DWORD dwFunc |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_GetCommModemStatus( |
| FT_HANDLE ftHandle, |
| LPDWORD lpdwModemStatus |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_GetCommState( |
| FT_HANDLE ftHandle, |
| LPFTDCB lpftDcb |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_GetCommTimeouts( |
| FT_HANDLE ftHandle, |
| FTTIMEOUTS *pTimeouts |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_PurgeComm( |
| FT_HANDLE ftHandle, |
| DWORD dwMask |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_SetCommBreak( |
| FT_HANDLE ftHandle |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_SetCommMask( |
| FT_HANDLE ftHandle, |
| ULONG ulEventMask |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_SetCommState( |
| FT_HANDLE ftHandle, |
| LPFTDCB lpftDcb |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_SetCommTimeouts( |
| FT_HANDLE ftHandle, |
| FTTIMEOUTS *pTimeouts |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_SetupComm( |
| FT_HANDLE ftHandle, |
| DWORD dwReadBufferSize, |
| DWORD dwWriteBufferSize |
| ); |
| |
| FTD2XX_API |
| BOOL WINAPI FT_W32_WaitCommEvent( |
| FT_HANDLE ftHandle, |
| PULONG pulEvent, |
| LPOVERLAPPED lpOverlapped |
| ); |
| |
| // |
| // Device information |
| // |
| |
| typedef struct _ft_device_list_info_node { |
| ULONG Flags; |
| ULONG Type; |
| ULONG ID; |
| DWORD LocId; |
| char SerialNumber[16]; |
| char Description[64]; |
| FT_HANDLE ftHandle; |
| } FT_DEVICE_LIST_INFO_NODE; |
| |
| // Device information flags |
| enum { |
| FT_FLAGS_OPENED = 1, |
| FT_FLAGS_HISPEED = 2 |
| }; |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_CreateDeviceInfoList( |
| LPDWORD lpdwNumDevs |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetDeviceInfoList( |
| FT_DEVICE_LIST_INFO_NODE *pDest, |
| LPDWORD lpdwNumDevs |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetDeviceInfoDetail( |
| DWORD dwIndex, |
| LPDWORD lpdwFlags, |
| LPDWORD lpdwType, |
| LPDWORD lpdwID, |
| LPDWORD lpdwLocId, |
| LPVOID lpSerialNumber, |
| LPVOID lpDescription, |
| FT_HANDLE *pftHandle |
| ); |
| |
| |
| // |
| // Version information |
| // |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetDriverVersion( |
| FT_HANDLE ftHandle, |
| LPDWORD lpdwVersion |
| ); |
| |
| FTD2XX_API |
| FT_STATUS WINAPI FT_GetLibraryVersion( |
| LPDWORD lpdwVersion |
| ); |
| |
| // |
| // Events |
| // |
| |
| #define EV_RXCHAR 0x0001 // Any Character received |
| #define EV_RXFLAG 0x0002 // Received certain character |
| #define EV_TXEMPTY 0x0004 // Transmitt Queue Empty |
| #define EV_CTS 0x0008 // CTS changed state |
| #define EV_DSR 0x0010 // DSR changed state |
| #define EV_RLSD 0x0020 // RLSD changed state |
| #define EV_BREAK 0x0040 // BREAK received |
| #define EV_ERR 0x0080 // Line status error occurred |
| #define EV_RING 0x0100 // Ring signal detected |
| #define EV_PERR 0x0200 // Printer error occured |
| #define EV_RX80FULL 0x0400 // Receive buffer is 80 percent full |
| #define EV_EVENT1 0x0800 // Provider specific event 1 |
| #define EV_EVENT2 0x1000 // Provider specific event 2 |
| |
| // |
| // Escape Functions |
| // |
| |
| #define SETXOFF 1 // Simulate XOFF received |
| #define SETXON 2 // Simulate XON received |
| #define SETRTS 3 // Set RTS high |
| #define CLRRTS 4 // Set RTS low |
| #define SETDTR 5 // Set DTR high |
| #define CLRDTR 6 // Set DTR low |
| #define RESETDEV 7 // Reset device if possible |
| #define SETBREAK 8 // Set the device break line. |
| #define CLRBREAK 9 // Clear the device break line. |
| |
| // |
| // PURGE function flags. |
| // |
| #define PURGE_TXABORT 0x0001 // Kill the pending/current writes to the comm port. |
| #define PURGE_RXABORT 0x0002 // Kill the pending/current reads to the comm port. |
| #define PURGE_TXCLEAR 0x0004 // Kill the transmit queue if there. |
| #define PURGE_RXCLEAR 0x0008 // Kill the typeahead buffer if there. |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| |
| #endif /* FTD2XX_H */ |
| |
| |
| |
| |
| |
| |