975 lines
21 KiB
C
975 lines
21 KiB
C
/*
|
|
NanoStack: MCU software and PC tools for IP-based wireless sensor networking.
|
|
|
|
Copyright (C) 2006-2007 Sensinode Ltd.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
Address:
|
|
Sensinode Ltd.
|
|
Teknologiantie 6
|
|
90570 Oulu, Finland
|
|
|
|
E-mail:
|
|
info@sensinode.com
|
|
*/
|
|
|
|
|
|
/*++
|
|
|
|
Copyright (c) 2001-2006 Future Technology Devices International Ltd.
|
|
|
|
Module Name:
|
|
|
|
ftd2xx.h
|
|
|
|
Abstract:
|
|
|
|
Native USB interface for FTDI FT8U232/245/2232C
|
|
FTD2XX library definitions
|
|
|
|
Environment:
|
|
|
|
kernel & user mode
|
|
|
|
Revision History:
|
|
|
|
13/03/01 awm Created.
|
|
13/01/03 awm Added device information support.
|
|
19/03/03 awm Added FT_W32_CancelIo.
|
|
12/06/03 awm Added FT_StopInTask and FT_RestartInTask.
|
|
18/09/03 awm Added FT_SetResetPipeRetryCount.
|
|
10/10/03 awm Added FT_ResetPort.
|
|
/03/04 st modified for linux users
|
|
12/10/04 st added FT_SetVIDPID
|
|
|
|
|
|
--*/
|
|
|
|
|
|
#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 DWORD *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
|
|
|
|
//
|
|
// 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
|
|
#define FT_BITS_6 (UCHAR) 6
|
|
#define FT_BITS_5 (UCHAR) 5
|
|
|
|
//
|
|
// Stop Bits
|
|
//
|
|
|
|
#define FT_STOP_BITS_1 (UCHAR) 0
|
|
#define FT_STOP_BITS_1_5 (UCHAR) 1
|
|
#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
|
|
|
|
//
|
|
// 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
|
|
};
|
|
|
|
|
|
#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( // Linux, OS X: Not supported
|
|
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_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( // Linux, OS X: Not supported
|
|
FT_HANDLE ftHandle,
|
|
DWORD Mask
|
|
);
|
|
|
|
FTD2XX_API
|
|
FT_STATUS WINAPI FT_WaitOnMask( // Linux, OS X: Not supported
|
|
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
|
|
|
|
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 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)
|
|
//
|
|
// FT2232C 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
|
|
//
|
|
// 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 RIsVCP; // zero if using VCP drivers
|
|
|
|
} 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_SetDeadmanTimeout(
|
|
FT_HANDLE ftHandle,
|
|
ULONG ulDeadmanTimeout
|
|
);
|
|
|
|
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_StopInTask(
|
|
FT_HANDLE ftHandle
|
|
);
|
|
|
|
FTD2XX_API
|
|
FT_STATUS WINAPI FT_RestartInTask(
|
|
FT_HANDLE ftHandle
|
|
);
|
|
|
|
FTD2XX_API
|
|
FT_STATUS WINAPI FT_SetResetPipeRetryCount( // Linux, OS X: Not supported
|
|
FT_HANDLE ftHandle,
|
|
DWORD dwCount
|
|
);
|
|
|
|
FTD2XX_API
|
|
FT_STATUS WINAPI FT_ResetPort( // Linux, OS X: Not supported
|
|
FT_HANDLE ftHandle
|
|
);
|
|
|
|
FTD2XX_API
|
|
FT_STATUS WINAPI FT_CyclePort( // Linux, OS X: Not supported
|
|
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( // Linux, OS X: Not supported
|
|
FT_HANDLE ftHandle,
|
|
LPOVERLAPPED lpOverlapped,
|
|
LPDWORD lpdwBytesTransferred,
|
|
BOOL bWait
|
|
);
|
|
|
|
FTD2XX_API
|
|
BOOL WINAPI FT_W32_CancelIo( // Linux, OS X: Not supported
|
|
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;
|
|
|
|
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
|
|
);
|
|
|
|
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 */
|
|
|
|
|
|
|
|
|
|
|
|
|