ftd2xx.h 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341
  1. /*++
  2. Copyright © 2001-2011 Future Technology Devices International Limited
  3. THIS SOFTWARE IS PROVIDED BY FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED "AS IS"
  4. AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  5. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
  6. FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  7. SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
  8. OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION)
  9. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
  10. TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  11. EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  12. FTDI DRIVERS MAY BE USED ONLY IN CONJUNCTION WITH PRODUCTS BASED ON FTDI PARTS.
  13. FTDI DRIVERS MAY BE DISTRIBUTED IN ANY FORM AS LONG AS LICENSE INFORMATION IS NOT MODIFIED.
  14. IF A CUSTOM VENDOR ID AND/OR PRODUCT ID OR DESCRIPTION STRING ARE USED, IT IS THE
  15. RESPONSIBILITY OF THE PRODUCT MANUFACTURER TO MAINTAIN ANY CHANGES AND SUBSEQUENT WHQL
  16. RE-CERTIFICATION AS A RESULT OF MAKING THESE CHANGES.
  17. Module Name:
  18. ftd2xx.h
  19. Abstract:
  20. Native USB device driver for FTDI FT232x, FT245x, FT2232x and FT4232x devices
  21. FTD2XX library definitions
  22. Environment:
  23. kernel & user mode
  24. --*/
  25. #ifndef FTD2XX_H
  26. #define FTD2XX_H
  27. // The following ifdef block is the standard way of creating macros
  28. // which make exporting from a DLL simpler. All files within this DLL
  29. // are compiled with the FTD2XX_EXPORTS symbol defined on the command line.
  30. // This symbol should not be defined on any project that uses this DLL.
  31. // This way any other project whose source files include this file see
  32. // FTD2XX_API functions as being imported from a DLL, whereas this DLL
  33. // sees symbols defined with this macro as being exported.
  34. #ifdef FTD2XX_EXPORTS
  35. #define FTD2XX_API __declspec(dllexport)
  36. #else
  37. #define FTD2XX_API __declspec(dllimport)
  38. #endif
  39. typedef PVOID FT_HANDLE;
  40. typedef ULONG FT_STATUS;
  41. //
  42. // Device status
  43. //
  44. enum {
  45. FT_OK,
  46. FT_INVALID_HANDLE,
  47. FT_DEVICE_NOT_FOUND,
  48. FT_DEVICE_NOT_OPENED,
  49. FT_IO_ERROR,
  50. FT_INSUFFICIENT_RESOURCES,
  51. FT_INVALID_PARAMETER,
  52. FT_INVALID_BAUD_RATE,
  53. FT_DEVICE_NOT_OPENED_FOR_ERASE,
  54. FT_DEVICE_NOT_OPENED_FOR_WRITE,
  55. FT_FAILED_TO_WRITE_DEVICE,
  56. FT_EEPROM_READ_FAILED,
  57. FT_EEPROM_WRITE_FAILED,
  58. FT_EEPROM_ERASE_FAILED,
  59. FT_EEPROM_NOT_PRESENT,
  60. FT_EEPROM_NOT_PROGRAMMED,
  61. FT_INVALID_ARGS,
  62. FT_NOT_SUPPORTED,
  63. FT_OTHER_ERROR,
  64. FT_DEVICE_LIST_NOT_READY,
  65. };
  66. #define FT_SUCCESS(status) ((status) == FT_OK)
  67. //
  68. // FT_OpenEx Flags
  69. //
  70. #define FT_OPEN_BY_SERIAL_NUMBER 1
  71. #define FT_OPEN_BY_DESCRIPTION 2
  72. #define FT_OPEN_BY_LOCATION 4
  73. //
  74. // FT_ListDevices Flags (used in conjunction with FT_OpenEx Flags
  75. //
  76. #define FT_LIST_NUMBER_ONLY 0x80000000
  77. #define FT_LIST_BY_INDEX 0x40000000
  78. #define FT_LIST_ALL 0x20000000
  79. #define FT_LIST_MASK (FT_LIST_NUMBER_ONLY|FT_LIST_BY_INDEX|FT_LIST_ALL)
  80. //
  81. // Baud Rates
  82. //
  83. #define FT_BAUD_300 300
  84. #define FT_BAUD_600 600
  85. #define FT_BAUD_1200 1200
  86. #define FT_BAUD_2400 2400
  87. #define FT_BAUD_4800 4800
  88. #define FT_BAUD_9600 9600
  89. #define FT_BAUD_14400 14400
  90. #define FT_BAUD_19200 19200
  91. #define FT_BAUD_38400 38400
  92. #define FT_BAUD_57600 57600
  93. #define FT_BAUD_115200 115200
  94. #define FT_BAUD_230400 230400
  95. #define FT_BAUD_460800 460800
  96. #define FT_BAUD_921600 921600
  97. //
  98. // Word Lengths
  99. //
  100. #define FT_BITS_8 (UCHAR) 8
  101. #define FT_BITS_7 (UCHAR) 7
  102. //
  103. // Stop Bits
  104. //
  105. #define FT_STOP_BITS_1 (UCHAR) 0
  106. #define FT_STOP_BITS_2 (UCHAR) 2
  107. //
  108. // Parity
  109. //
  110. #define FT_PARITY_NONE (UCHAR) 0
  111. #define FT_PARITY_ODD (UCHAR) 1
  112. #define FT_PARITY_EVEN (UCHAR) 2
  113. #define FT_PARITY_MARK (UCHAR) 3
  114. #define FT_PARITY_SPACE (UCHAR) 4
  115. //
  116. // Flow Control
  117. //
  118. #define FT_FLOW_NONE 0x0000
  119. #define FT_FLOW_RTS_CTS 0x0100
  120. #define FT_FLOW_DTR_DSR 0x0200
  121. #define FT_FLOW_XON_XOFF 0x0400
  122. //
  123. // Purge rx and tx buffers
  124. //
  125. #define FT_PURGE_RX 1
  126. #define FT_PURGE_TX 2
  127. //
  128. // Events
  129. //
  130. typedef void (*PFT_EVENT_HANDLER)(DWORD,DWORD);
  131. #define FT_EVENT_RXCHAR 1
  132. #define FT_EVENT_MODEM_STATUS 2
  133. #define FT_EVENT_LINE_STATUS 4
  134. //
  135. // Timeouts
  136. //
  137. #define FT_DEFAULT_RX_TIMEOUT 300
  138. #define FT_DEFAULT_TX_TIMEOUT 300
  139. //
  140. // Device types
  141. //
  142. typedef ULONG FT_DEVICE;
  143. enum {
  144. FT_DEVICE_BM,
  145. FT_DEVICE_AM,
  146. FT_DEVICE_100AX,
  147. FT_DEVICE_UNKNOWN,
  148. FT_DEVICE_2232C,
  149. FT_DEVICE_232R,
  150. FT_DEVICE_2232H,
  151. FT_DEVICE_4232H,
  152. FT_DEVICE_232H,
  153. FT_DEVICE_X_SERIES
  154. };
  155. //
  156. // Bit Modes
  157. //
  158. #define FT_BITMODE_RESET 0x00
  159. #define FT_BITMODE_ASYNC_BITBANG 0x01
  160. #define FT_BITMODE_MPSSE 0x02
  161. #define FT_BITMODE_SYNC_BITBANG 0x04
  162. #define FT_BITMODE_MCU_HOST 0x08
  163. #define FT_BITMODE_FAST_SERIAL 0x10
  164. #define FT_BITMODE_CBUS_BITBANG 0x20
  165. #define FT_BITMODE_SYNC_FIFO 0x40
  166. //
  167. // FT232R CBUS Options EEPROM values
  168. //
  169. #define FT_232R_CBUS_TXDEN 0x00 // Tx Data Enable
  170. #define FT_232R_CBUS_PWRON 0x01 // Power On
  171. #define FT_232R_CBUS_RXLED 0x02 // Rx LED
  172. #define FT_232R_CBUS_TXLED 0x03 // Tx LED
  173. #define FT_232R_CBUS_TXRXLED 0x04 // Tx and Rx LED
  174. #define FT_232R_CBUS_SLEEP 0x05 // Sleep
  175. #define FT_232R_CBUS_CLK48 0x06 // 48MHz clock
  176. #define FT_232R_CBUS_CLK24 0x07 // 24MHz clock
  177. #define FT_232R_CBUS_CLK12 0x08 // 12MHz clock
  178. #define FT_232R_CBUS_CLK6 0x09 // 6MHz clock
  179. #define FT_232R_CBUS_IOMODE 0x0A // IO Mode for CBUS bit-bang
  180. #define FT_232R_CBUS_BITBANG_WR 0x0B // Bit-bang write strobe
  181. #define FT_232R_CBUS_BITBANG_RD 0x0C // Bit-bang read strobe
  182. //
  183. // FT232H CBUS Options EEPROM values
  184. //
  185. #define FT_232H_CBUS_TRISTATE 0x00 // Tristate
  186. #define FT_232H_CBUS_TXLED 0x01 // Tx LED
  187. #define FT_232H_CBUS_RXLED 0x02 // Rx LED
  188. #define FT_232H_CBUS_TXRXLED 0x03 // Tx and Rx LED
  189. #define FT_232H_CBUS_PWREN 0x04 // Power Enable
  190. #define FT_232H_CBUS_SLEEP 0x05 // Sleep
  191. #define FT_232H_CBUS_DRIVE_0 0x06 // Drive pin to logic 0
  192. #define FT_232H_CBUS_DRIVE_1 0x07 // Drive pin to logic 1
  193. #define FT_232H_CBUS_IOMODE 0x08 // IO Mode for CBUS bit-bang
  194. #define FT_232H_CBUS_TXDEN 0x09 // Tx Data Enable
  195. #define FT_232H_CBUS_CLK30 0x0A // 30MHz clock
  196. #define FT_232H_CBUS_CLK15 0x0B // 15MHz clock
  197. #define FT_232H_CBUS_CLK7_5 0x0C // 7.5MHz clock
  198. //
  199. // FT X Series CBUS Options EEPROM values
  200. //
  201. #define FT_X_SERIES_CBUS_TRISTATE 0x00 // Tristate
  202. #define FT_X_SERIES_CBUS_RXLED 0x01 // Tx LED
  203. #define FT_X_SERIES_CBUS_TXLED 0x02 // Rx LED
  204. #define FT_X_SERIES_CBUS_TXRXLED 0x03 // Tx and Rx LED
  205. #define FT_X_SERIES_CBUS_PWREN 0x04 // Power Enable
  206. #define FT_X_SERIES_CBUS_SLEEP 0x05 // Sleep
  207. #define FT_X_SERIES_CBUS_DRIVE_0 0x06 // Drive pin to logic 0
  208. #define FT_X_SERIES_CBUS_DRIVE_1 0x07 // Drive pin to logic 1
  209. #define FT_X_SERIES_CBUS_IOMODE 0x08 // IO Mode for CBUS bit-bang
  210. #define FT_X_SERIES_CBUS_TXDEN 0x09 // Tx Data Enable
  211. #define FT_X_SERIES_CBUS_CLK24 0x0A // 24MHz clock
  212. #define FT_X_SERIES_CBUS_CLK12 0x0B // 12MHz clock
  213. #define FT_X_SERIES_CBUS_CLK6 0x0C // 6MHz clock
  214. #define FT_X_SERIES_CBUS_BCD_CHARGER 0x0D // Battery charger detected
  215. #define FT_X_SERIES_CBUS_BCD_CHARGER_N 0x0E // Battery charger detected inverted
  216. #define FT_X_SERIES_CBUS_I2C_TXE 0x0F // I2C Tx empty
  217. #define FT_X_SERIES_CBUS_I2C_RXF 0x10 // I2C Rx full
  218. #define FT_X_SERIES_CBUS_VBUS_SENSE 0x11 // Detect VBUS
  219. #define FT_X_SERIES_CBUS_BITBANG_WR 0x12 // Bit-bang write strobe
  220. #define FT_X_SERIES_CBUS_BITBANG_RD 0x13 // Bit-bang read strobe
  221. #define FT_X_SERIES_CBUS_TIMESTAMP 0x14 // Toggle output when a USB SOF token is received
  222. #define FT_X_SERIES_CBUS_KEEP_AWAKE 0x15 //
  223. // Driver types
  224. #define FT_DRIVER_TYPE_D2XX 0
  225. #define FT_DRIVER_TYPE_VCP 1
  226. #ifdef __cplusplus
  227. extern "C" {
  228. #endif
  229. FTD2XX_API
  230. FT_STATUS WINAPI FT_Open(
  231. int deviceNumber,
  232. FT_HANDLE *pHandle
  233. );
  234. FTD2XX_API
  235. FT_STATUS WINAPI FT_OpenEx(
  236. PVOID pArg1,
  237. DWORD Flags,
  238. FT_HANDLE *pHandle
  239. );
  240. FTD2XX_API
  241. FT_STATUS WINAPI FT_ListDevices(
  242. PVOID pArg1,
  243. PVOID pArg2,
  244. DWORD Flags
  245. );
  246. FTD2XX_API
  247. FT_STATUS WINAPI FT_Close(
  248. FT_HANDLE ftHandle
  249. );
  250. FTD2XX_API
  251. FT_STATUS WINAPI FT_Read(
  252. FT_HANDLE ftHandle,
  253. LPVOID lpBuffer,
  254. DWORD dwBytesToRead,
  255. LPDWORD lpBytesReturned
  256. );
  257. FTD2XX_API
  258. FT_STATUS WINAPI FT_Write(
  259. FT_HANDLE ftHandle,
  260. LPVOID lpBuffer,
  261. DWORD dwBytesToWrite,
  262. LPDWORD lpBytesWritten
  263. );
  264. FTD2XX_API
  265. FT_STATUS WINAPI FT_IoCtl(
  266. FT_HANDLE ftHandle,
  267. DWORD dwIoControlCode,
  268. LPVOID lpInBuf,
  269. DWORD nInBufSize,
  270. LPVOID lpOutBuf,
  271. DWORD nOutBufSize,
  272. LPDWORD lpBytesReturned,
  273. LPOVERLAPPED lpOverlapped
  274. );
  275. FTD2XX_API
  276. FT_STATUS WINAPI FT_SetBaudRate(
  277. FT_HANDLE ftHandle,
  278. ULONG BaudRate
  279. );
  280. FTD2XX_API
  281. FT_STATUS WINAPI FT_SetDivisor(
  282. FT_HANDLE ftHandle,
  283. USHORT Divisor
  284. );
  285. FTD2XX_API
  286. FT_STATUS WINAPI FT_SetDataCharacteristics(
  287. FT_HANDLE ftHandle,
  288. UCHAR WordLength,
  289. UCHAR StopBits,
  290. UCHAR Parity
  291. );
  292. FTD2XX_API
  293. FT_STATUS WINAPI FT_SetFlowControl(
  294. FT_HANDLE ftHandle,
  295. USHORT FlowControl,
  296. UCHAR XonChar,
  297. UCHAR XoffChar
  298. );
  299. FTD2XX_API
  300. FT_STATUS WINAPI FT_ResetDevice(
  301. FT_HANDLE ftHandle
  302. );
  303. FTD2XX_API
  304. FT_STATUS WINAPI FT_SetDtr(
  305. FT_HANDLE ftHandle
  306. );
  307. FTD2XX_API
  308. FT_STATUS WINAPI FT_ClrDtr(
  309. FT_HANDLE ftHandle
  310. );
  311. FTD2XX_API
  312. FT_STATUS WINAPI FT_SetRts(
  313. FT_HANDLE ftHandle
  314. );
  315. FTD2XX_API
  316. FT_STATUS WINAPI FT_ClrRts(
  317. FT_HANDLE ftHandle
  318. );
  319. FTD2XX_API
  320. FT_STATUS WINAPI FT_GetModemStatus(
  321. FT_HANDLE ftHandle,
  322. ULONG *pModemStatus
  323. );
  324. FTD2XX_API
  325. FT_STATUS WINAPI FT_SetChars(
  326. FT_HANDLE ftHandle,
  327. UCHAR EventChar,
  328. UCHAR EventCharEnabled,
  329. UCHAR ErrorChar,
  330. UCHAR ErrorCharEnabled
  331. );
  332. FTD2XX_API
  333. FT_STATUS WINAPI FT_Purge(
  334. FT_HANDLE ftHandle,
  335. ULONG Mask
  336. );
  337. FTD2XX_API
  338. FT_STATUS WINAPI FT_SetTimeouts(
  339. FT_HANDLE ftHandle,
  340. ULONG ReadTimeout,
  341. ULONG WriteTimeout
  342. );
  343. FTD2XX_API
  344. FT_STATUS WINAPI FT_GetQueueStatus(
  345. FT_HANDLE ftHandle,
  346. DWORD *dwRxBytes
  347. );
  348. FTD2XX_API
  349. FT_STATUS WINAPI FT_SetEventNotification(
  350. FT_HANDLE ftHandle,
  351. DWORD Mask,
  352. PVOID Param
  353. );
  354. FTD2XX_API
  355. FT_STATUS WINAPI FT_GetStatus(
  356. FT_HANDLE ftHandle,
  357. DWORD *dwRxBytes,
  358. DWORD *dwTxBytes,
  359. DWORD *dwEventDWord
  360. );
  361. FTD2XX_API
  362. FT_STATUS WINAPI FT_SetBreakOn(
  363. FT_HANDLE ftHandle
  364. );
  365. FTD2XX_API
  366. FT_STATUS WINAPI FT_SetBreakOff(
  367. FT_HANDLE ftHandle
  368. );
  369. FTD2XX_API
  370. FT_STATUS WINAPI FT_SetWaitMask(
  371. FT_HANDLE ftHandle,
  372. DWORD Mask
  373. );
  374. FTD2XX_API
  375. FT_STATUS WINAPI FT_WaitOnMask(
  376. FT_HANDLE ftHandle,
  377. DWORD *Mask
  378. );
  379. FTD2XX_API
  380. FT_STATUS WINAPI FT_GetEventStatus(
  381. FT_HANDLE ftHandle,
  382. DWORD *dwEventDWord
  383. );
  384. FTD2XX_API
  385. FT_STATUS WINAPI FT_ReadEE(
  386. FT_HANDLE ftHandle,
  387. DWORD dwWordOffset,
  388. LPWORD lpwValue
  389. );
  390. FTD2XX_API
  391. FT_STATUS WINAPI FT_WriteEE(
  392. FT_HANDLE ftHandle,
  393. DWORD dwWordOffset,
  394. WORD wValue
  395. );
  396. FTD2XX_API
  397. FT_STATUS WINAPI FT_EraseEE(
  398. FT_HANDLE ftHandle
  399. );
  400. //
  401. // structure to hold program data for FT_EE_Program, FT_EE_ProgramEx, FT_EE_Read
  402. // and FT_EE_ReadEx functions
  403. //
  404. typedef struct ft_program_data {
  405. DWORD Signature1; // Header - must be 0x00000000
  406. DWORD Signature2; // Header - must be 0xffffffff
  407. DWORD Version; // Header - FT_PROGRAM_DATA version
  408. // 0 = original
  409. // 1 = FT2232 extensions
  410. // 2 = FT232R extensions
  411. // 3 = FT2232H extensions
  412. // 4 = FT4232H extensions
  413. // 5 = FT232H extensions
  414. WORD VendorId; // 0x0403
  415. WORD ProductId; // 0x6001
  416. char *Manufacturer; // "FTDI"
  417. char *ManufacturerId; // "FT"
  418. char *Description; // "USB HS Serial Converter"
  419. char *SerialNumber; // "FT000001" if fixed, or NULL
  420. WORD MaxPower; // 0 < MaxPower <= 500
  421. WORD PnP; // 0 = disabled, 1 = enabled
  422. WORD SelfPowered; // 0 = bus powered, 1 = self powered
  423. WORD RemoteWakeup; // 0 = not capable, 1 = capable
  424. //
  425. // Rev4 (FT232B) extensions
  426. //
  427. UCHAR Rev4; // non-zero if Rev4 chip, zero otherwise
  428. UCHAR IsoIn; // non-zero if in endpoint is isochronous
  429. UCHAR IsoOut; // non-zero if out endpoint is isochronous
  430. UCHAR PullDownEnable; // non-zero if pull down enabled
  431. UCHAR SerNumEnable; // non-zero if serial number to be used
  432. UCHAR USBVersionEnable; // non-zero if chip uses USBVersion
  433. WORD USBVersion; // BCD (0x0200 => USB2)
  434. //
  435. // Rev 5 (FT2232) extensions
  436. //
  437. UCHAR Rev5; // non-zero if Rev5 chip, zero otherwise
  438. UCHAR IsoInA; // non-zero if in endpoint is isochronous
  439. UCHAR IsoInB; // non-zero if in endpoint is isochronous
  440. UCHAR IsoOutA; // non-zero if out endpoint is isochronous
  441. UCHAR IsoOutB; // non-zero if out endpoint is isochronous
  442. UCHAR PullDownEnable5; // non-zero if pull down enabled
  443. UCHAR SerNumEnable5; // non-zero if serial number to be used
  444. UCHAR USBVersionEnable5; // non-zero if chip uses USBVersion
  445. WORD USBVersion5; // BCD (0x0200 => USB2)
  446. UCHAR AIsHighCurrent; // non-zero if interface is high current
  447. UCHAR BIsHighCurrent; // non-zero if interface is high current
  448. UCHAR IFAIsFifo; // non-zero if interface is 245 FIFO
  449. UCHAR IFAIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  450. UCHAR IFAIsFastSer; // non-zero if interface is Fast serial
  451. UCHAR AIsVCP; // non-zero if interface is to use VCP drivers
  452. UCHAR IFBIsFifo; // non-zero if interface is 245 FIFO
  453. UCHAR IFBIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  454. UCHAR IFBIsFastSer; // non-zero if interface is Fast serial
  455. UCHAR BIsVCP; // non-zero if interface is to use VCP drivers
  456. //
  457. // Rev 6 (FT232R) extensions
  458. //
  459. UCHAR UseExtOsc; // Use External Oscillator
  460. UCHAR HighDriveIOs; // High Drive I/Os
  461. UCHAR EndpointSize; // Endpoint size
  462. UCHAR PullDownEnableR; // non-zero if pull down enabled
  463. UCHAR SerNumEnableR; // non-zero if serial number to be used
  464. UCHAR InvertTXD; // non-zero if invert TXD
  465. UCHAR InvertRXD; // non-zero if invert RXD
  466. UCHAR InvertRTS; // non-zero if invert RTS
  467. UCHAR InvertCTS; // non-zero if invert CTS
  468. UCHAR InvertDTR; // non-zero if invert DTR
  469. UCHAR InvertDSR; // non-zero if invert DSR
  470. UCHAR InvertDCD; // non-zero if invert DCD
  471. UCHAR InvertRI; // non-zero if invert RI
  472. UCHAR Cbus0; // Cbus Mux control
  473. UCHAR Cbus1; // Cbus Mux control
  474. UCHAR Cbus2; // Cbus Mux control
  475. UCHAR Cbus3; // Cbus Mux control
  476. UCHAR Cbus4; // Cbus Mux control
  477. UCHAR RIsD2XX; // non-zero if using D2XX driver
  478. //
  479. // Rev 7 (FT2232H) Extensions
  480. //
  481. UCHAR PullDownEnable7; // non-zero if pull down enabled
  482. UCHAR SerNumEnable7; // non-zero if serial number to be used
  483. UCHAR ALSlowSlew; // non-zero if AL pins have slow slew
  484. UCHAR ALSchmittInput; // non-zero if AL pins are Schmitt input
  485. UCHAR ALDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  486. UCHAR AHSlowSlew; // non-zero if AH pins have slow slew
  487. UCHAR AHSchmittInput; // non-zero if AH pins are Schmitt input
  488. UCHAR AHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  489. UCHAR BLSlowSlew; // non-zero if BL pins have slow slew
  490. UCHAR BLSchmittInput; // non-zero if BL pins are Schmitt input
  491. UCHAR BLDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  492. UCHAR BHSlowSlew; // non-zero if BH pins have slow slew
  493. UCHAR BHSchmittInput; // non-zero if BH pins are Schmitt input
  494. UCHAR BHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  495. UCHAR IFAIsFifo7; // non-zero if interface is 245 FIFO
  496. UCHAR IFAIsFifoTar7; // non-zero if interface is 245 FIFO CPU target
  497. UCHAR IFAIsFastSer7; // non-zero if interface is Fast serial
  498. UCHAR AIsVCP7; // non-zero if interface is to use VCP drivers
  499. UCHAR IFBIsFifo7; // non-zero if interface is 245 FIFO
  500. UCHAR IFBIsFifoTar7; // non-zero if interface is 245 FIFO CPU target
  501. UCHAR IFBIsFastSer7; // non-zero if interface is Fast serial
  502. UCHAR BIsVCP7; // non-zero if interface is to use VCP drivers
  503. UCHAR PowerSaveEnable; // non-zero if using BCBUS7 to save power for self-powered designs
  504. //
  505. // Rev 8 (FT4232H) Extensions
  506. //
  507. UCHAR PullDownEnable8; // non-zero if pull down enabled
  508. UCHAR SerNumEnable8; // non-zero if serial number to be used
  509. UCHAR ASlowSlew; // non-zero if A pins have slow slew
  510. UCHAR ASchmittInput; // non-zero if A pins are Schmitt input
  511. UCHAR ADriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  512. UCHAR BSlowSlew; // non-zero if B pins have slow slew
  513. UCHAR BSchmittInput; // non-zero if B pins are Schmitt input
  514. UCHAR BDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  515. UCHAR CSlowSlew; // non-zero if C pins have slow slew
  516. UCHAR CSchmittInput; // non-zero if C pins are Schmitt input
  517. UCHAR CDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  518. UCHAR DSlowSlew; // non-zero if D pins have slow slew
  519. UCHAR DSchmittInput; // non-zero if D pins are Schmitt input
  520. UCHAR DDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  521. UCHAR ARIIsTXDEN; // non-zero if port A uses RI as RS485 TXDEN
  522. UCHAR BRIIsTXDEN; // non-zero if port B uses RI as RS485 TXDEN
  523. UCHAR CRIIsTXDEN; // non-zero if port C uses RI as RS485 TXDEN
  524. UCHAR DRIIsTXDEN; // non-zero if port D uses RI as RS485 TXDEN
  525. UCHAR AIsVCP8; // non-zero if interface is to use VCP drivers
  526. UCHAR BIsVCP8; // non-zero if interface is to use VCP drivers
  527. UCHAR CIsVCP8; // non-zero if interface is to use VCP drivers
  528. UCHAR DIsVCP8; // non-zero if interface is to use VCP drivers
  529. //
  530. // Rev 9 (FT232H) Extensions
  531. //
  532. UCHAR PullDownEnableH; // non-zero if pull down enabled
  533. UCHAR SerNumEnableH; // non-zero if serial number to be used
  534. UCHAR ACSlowSlewH; // non-zero if AC pins have slow slew
  535. UCHAR ACSchmittInputH; // non-zero if AC pins are Schmitt input
  536. UCHAR ACDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA
  537. UCHAR ADSlowSlewH; // non-zero if AD pins have slow slew
  538. UCHAR ADSchmittInputH; // non-zero if AD pins are Schmitt input
  539. UCHAR ADDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA
  540. UCHAR Cbus0H; // Cbus Mux control
  541. UCHAR Cbus1H; // Cbus Mux control
  542. UCHAR Cbus2H; // Cbus Mux control
  543. UCHAR Cbus3H; // Cbus Mux control
  544. UCHAR Cbus4H; // Cbus Mux control
  545. UCHAR Cbus5H; // Cbus Mux control
  546. UCHAR Cbus6H; // Cbus Mux control
  547. UCHAR Cbus7H; // Cbus Mux control
  548. UCHAR Cbus8H; // Cbus Mux control
  549. UCHAR Cbus9H; // Cbus Mux control
  550. UCHAR IsFifoH; // non-zero if interface is 245 FIFO
  551. UCHAR IsFifoTarH; // non-zero if interface is 245 FIFO CPU target
  552. UCHAR IsFastSerH; // non-zero if interface is Fast serial
  553. UCHAR IsFT1248H; // non-zero if interface is FT1248
  554. UCHAR FT1248CpolH; // FT1248 clock polarity - clock idle high (1) or clock idle low (0)
  555. UCHAR FT1248LsbH; // FT1248 data is LSB (1) or MSB (0)
  556. UCHAR FT1248FlowControlH; // FT1248 flow control enable
  557. UCHAR IsVCPH; // non-zero if interface is to use VCP drivers
  558. UCHAR PowerSaveEnableH; // non-zero if using ACBUS7 to save power for self-powered designs
  559. } FT_PROGRAM_DATA, *PFT_PROGRAM_DATA;
  560. FTD2XX_API
  561. FT_STATUS WINAPI FT_EE_Program(
  562. FT_HANDLE ftHandle,
  563. PFT_PROGRAM_DATA pData
  564. );
  565. FTD2XX_API
  566. FT_STATUS WINAPI FT_EE_ProgramEx(
  567. FT_HANDLE ftHandle,
  568. PFT_PROGRAM_DATA pData,
  569. char *Manufacturer,
  570. char *ManufacturerId,
  571. char *Description,
  572. char *SerialNumber
  573. );
  574. FTD2XX_API
  575. FT_STATUS WINAPI FT_EE_Read(
  576. FT_HANDLE ftHandle,
  577. PFT_PROGRAM_DATA pData
  578. );
  579. FTD2XX_API
  580. FT_STATUS WINAPI FT_EE_ReadEx(
  581. FT_HANDLE ftHandle,
  582. PFT_PROGRAM_DATA pData,
  583. char *Manufacturer,
  584. char *ManufacturerId,
  585. char *Description,
  586. char *SerialNumber
  587. );
  588. FTD2XX_API
  589. FT_STATUS WINAPI FT_EE_UASize(
  590. FT_HANDLE ftHandle,
  591. LPDWORD lpdwSize
  592. );
  593. FTD2XX_API
  594. FT_STATUS WINAPI FT_EE_UAWrite(
  595. FT_HANDLE ftHandle,
  596. PUCHAR pucData,
  597. DWORD dwDataLen
  598. );
  599. FTD2XX_API
  600. FT_STATUS WINAPI FT_EE_UARead(
  601. FT_HANDLE ftHandle,
  602. PUCHAR pucData,
  603. DWORD dwDataLen,
  604. LPDWORD lpdwBytesRead
  605. );
  606. typedef struct ft_eeprom_header {
  607. FT_DEVICE deviceType; // FTxxxx device type to be programmed
  608. // Device descriptor options
  609. WORD VendorId; // 0x0403
  610. WORD ProductId; // 0x6001
  611. UCHAR SerNumEnable; // non-zero if serial number to be used
  612. // Config descriptor options
  613. WORD MaxPower; // 0 < MaxPower <= 500
  614. UCHAR SelfPowered; // 0 = bus powered, 1 = self powered
  615. UCHAR RemoteWakeup; // 0 = not capable, 1 = capable
  616. // Hardware options
  617. UCHAR PullDownEnable; // non-zero if pull down in suspend enabled
  618. } FT_EEPROM_HEADER, *PFT_EEPROM_HEADER;
  619. // FT232B EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  620. typedef struct ft_eeprom_232b {
  621. // Common header
  622. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  623. } FT_EEPROM_232B, *PFT_EEPROM_232B;
  624. // FT2232 EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  625. typedef struct ft_eeprom_2232 {
  626. // Common header
  627. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  628. // Drive options
  629. UCHAR AIsHighCurrent; // non-zero if interface is high current
  630. UCHAR BIsHighCurrent; // non-zero if interface is high current
  631. // Hardware options
  632. UCHAR AIsFifo; // non-zero if interface is 245 FIFO
  633. UCHAR AIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  634. UCHAR AIsFastSer; // non-zero if interface is Fast serial
  635. UCHAR BIsFifo; // non-zero if interface is 245 FIFO
  636. UCHAR BIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  637. UCHAR BIsFastSer; // non-zero if interface is Fast serial
  638. // Driver option
  639. UCHAR ADriverType; //
  640. UCHAR BDriverType; //
  641. } FT_EEPROM_2232, *PFT_EEPROM_2232;
  642. // FT232R EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  643. typedef struct ft_eeprom_232r {
  644. // Common header
  645. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  646. // Drive options
  647. UCHAR IsHighCurrent; // non-zero if interface is high current
  648. // Hardware options
  649. UCHAR UseExtOsc; // Use External Oscillator
  650. UCHAR InvertTXD; // non-zero if invert TXD
  651. UCHAR InvertRXD; // non-zero if invert RXD
  652. UCHAR InvertRTS; // non-zero if invert RTS
  653. UCHAR InvertCTS; // non-zero if invert CTS
  654. UCHAR InvertDTR; // non-zero if invert DTR
  655. UCHAR InvertDSR; // non-zero if invert DSR
  656. UCHAR InvertDCD; // non-zero if invert DCD
  657. UCHAR InvertRI; // non-zero if invert RI
  658. UCHAR Cbus0; // Cbus Mux control
  659. UCHAR Cbus1; // Cbus Mux control
  660. UCHAR Cbus2; // Cbus Mux control
  661. UCHAR Cbus3; // Cbus Mux control
  662. UCHAR Cbus4; // Cbus Mux control
  663. // Driver option
  664. UCHAR DriverType; //
  665. } FT_EEPROM_232R, *PFT_EEPROM_232R;
  666. // FT2232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  667. typedef struct ft_eeprom_2232h {
  668. // Common header
  669. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  670. // Drive options
  671. UCHAR ALSlowSlew; // non-zero if AL pins have slow slew
  672. UCHAR ALSchmittInput; // non-zero if AL pins are Schmitt input
  673. UCHAR ALDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  674. UCHAR AHSlowSlew; // non-zero if AH pins have slow slew
  675. UCHAR AHSchmittInput; // non-zero if AH pins are Schmitt input
  676. UCHAR AHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  677. UCHAR BLSlowSlew; // non-zero if BL pins have slow slew
  678. UCHAR BLSchmittInput; // non-zero if BL pins are Schmitt input
  679. UCHAR BLDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  680. UCHAR BHSlowSlew; // non-zero if BH pins have slow slew
  681. UCHAR BHSchmittInput; // non-zero if BH pins are Schmitt input
  682. UCHAR BHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  683. // Hardware options
  684. UCHAR AIsFifo; // non-zero if interface is 245 FIFO
  685. UCHAR AIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  686. UCHAR AIsFastSer; // non-zero if interface is Fast serial
  687. UCHAR BIsFifo; // non-zero if interface is 245 FIFO
  688. UCHAR BIsFifoTar; // non-zero if interface is 245 FIFO CPU target
  689. UCHAR BIsFastSer; // non-zero if interface is Fast serial
  690. UCHAR PowerSaveEnable; // non-zero if using BCBUS7 to save power for self-powered designs
  691. // Driver option
  692. UCHAR ADriverType; //
  693. UCHAR BDriverType; //
  694. } FT_EEPROM_2232H, *PFT_EEPROM_2232H;
  695. // FT4232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  696. typedef struct ft_eeprom_4232h {
  697. // Common header
  698. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  699. // Drive options
  700. UCHAR ASlowSlew; // non-zero if A pins have slow slew
  701. UCHAR ASchmittInput; // non-zero if A pins are Schmitt input
  702. UCHAR ADriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  703. UCHAR BSlowSlew; // non-zero if B pins have slow slew
  704. UCHAR BSchmittInput; // non-zero if B pins are Schmitt input
  705. UCHAR BDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  706. UCHAR CSlowSlew; // non-zero if C pins have slow slew
  707. UCHAR CSchmittInput; // non-zero if C pins are Schmitt input
  708. UCHAR CDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  709. UCHAR DSlowSlew; // non-zero if D pins have slow slew
  710. UCHAR DSchmittInput; // non-zero if D pins are Schmitt input
  711. UCHAR DDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  712. // Hardware options
  713. UCHAR ARIIsTXDEN; // non-zero if port A uses RI as RS485 TXDEN
  714. UCHAR BRIIsTXDEN; // non-zero if port B uses RI as RS485 TXDEN
  715. UCHAR CRIIsTXDEN; // non-zero if port C uses RI as RS485 TXDEN
  716. UCHAR DRIIsTXDEN; // non-zero if port D uses RI as RS485 TXDEN
  717. // Driver option
  718. UCHAR ADriverType; //
  719. UCHAR BDriverType; //
  720. UCHAR CDriverType; //
  721. UCHAR DDriverType; //
  722. } FT_EEPROM_4232H, *PFT_EEPROM_4232H;
  723. // FT232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  724. typedef struct ft_eeprom_232h {
  725. // Common header
  726. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  727. // Drive options
  728. UCHAR ACSlowSlew; // non-zero if AC bus pins have slow slew
  729. UCHAR ACSchmittInput; // non-zero if AC bus pins are Schmitt input
  730. UCHAR ACDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  731. UCHAR ADSlowSlew; // non-zero if AD bus pins have slow slew
  732. UCHAR ADSchmittInput; // non-zero if AD bus pins are Schmitt input
  733. UCHAR ADDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  734. // CBUS options
  735. UCHAR Cbus0; // Cbus Mux control
  736. UCHAR Cbus1; // Cbus Mux control
  737. UCHAR Cbus2; // Cbus Mux control
  738. UCHAR Cbus3; // Cbus Mux control
  739. UCHAR Cbus4; // Cbus Mux control
  740. UCHAR Cbus5; // Cbus Mux control
  741. UCHAR Cbus6; // Cbus Mux control
  742. UCHAR Cbus7; // Cbus Mux control
  743. UCHAR Cbus8; // Cbus Mux control
  744. UCHAR Cbus9; // Cbus Mux control
  745. // FT1248 options
  746. UCHAR FT1248Cpol; // FT1248 clock polarity - clock idle high (1) or clock idle low (0)
  747. UCHAR FT1248Lsb; // FT1248 data is LSB (1) or MSB (0)
  748. UCHAR FT1248FlowControl; // FT1248 flow control enable
  749. // Hardware options
  750. UCHAR IsFifo; // non-zero if interface is 245 FIFO
  751. UCHAR IsFifoTar; // non-zero if interface is 245 FIFO CPU target
  752. UCHAR IsFastSer; // non-zero if interface is Fast serial
  753. UCHAR IsFT1248 ; // non-zero if interface is FT1248
  754. UCHAR PowerSaveEnable; //
  755. // Driver option
  756. UCHAR DriverType; //
  757. } FT_EEPROM_232H, *PFT_EEPROM_232H;
  758. // FT X Series EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program
  759. typedef struct ft_eeprom_x_series {
  760. // Common header
  761. FT_EEPROM_HEADER common; // common elements for all device EEPROMs
  762. // Drive options
  763. UCHAR ACSlowSlew; // non-zero if AC bus pins have slow slew
  764. UCHAR ACSchmittInput; // non-zero if AC bus pins are Schmitt input
  765. UCHAR ACDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  766. UCHAR ADSlowSlew; // non-zero if AD bus pins have slow slew
  767. UCHAR ADSchmittInput; // non-zero if AD bus pins are Schmitt input
  768. UCHAR ADDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA
  769. // CBUS options
  770. UCHAR Cbus0; // Cbus Mux control
  771. UCHAR Cbus1; // Cbus Mux control
  772. UCHAR Cbus2; // Cbus Mux control
  773. UCHAR Cbus3; // Cbus Mux control
  774. UCHAR Cbus4; // Cbus Mux control
  775. UCHAR Cbus5; // Cbus Mux control
  776. UCHAR Cbus6; // Cbus Mux control
  777. // UART signal options
  778. UCHAR InvertTXD; // non-zero if invert TXD
  779. UCHAR InvertRXD; // non-zero if invert RXD
  780. UCHAR InvertRTS; // non-zero if invert RTS
  781. UCHAR InvertCTS; // non-zero if invert CTS
  782. UCHAR InvertDTR; // non-zero if invert DTR
  783. UCHAR InvertDSR; // non-zero if invert DSR
  784. UCHAR InvertDCD; // non-zero if invert DCD
  785. UCHAR InvertRI; // non-zero if invert RI
  786. // Battery Charge Detect options
  787. UCHAR BCDEnable; // Enable Battery Charger Detection
  788. UCHAR BCDForceCbusPWREN; // asserts the power enable signal on CBUS when charging port detected
  789. UCHAR BCDDisableSleep; // forces the device never to go into sleep mode
  790. // I2C options
  791. WORD I2CSlaveAddress; // I2C slave device address
  792. DWORD I2CDeviceId; // I2C device ID
  793. UCHAR I2CDisableSchmitt; // Disable I2C Schmitt trigger
  794. // FT1248 options
  795. UCHAR FT1248Cpol; // FT1248 clock polarity - clock idle high (1) or clock idle low (0)
  796. UCHAR FT1248Lsb; // FT1248 data is LSB (1) or MSB (0)
  797. UCHAR FT1248FlowControl; // FT1248 flow control enable
  798. // Hardware options
  799. UCHAR RS485EchoSuppress; //
  800. UCHAR PowerSaveEnable; //
  801. // Driver option
  802. UCHAR DriverType; //
  803. } FT_EEPROM_X_SERIES, *PFT_EEPROM_X_SERIES;
  804. FTD2XX_API
  805. FT_STATUS WINAPI FT_EEPROM_Read(
  806. FT_HANDLE ftHandle,
  807. void *eepromData,
  808. DWORD eepromDataSize,
  809. char *Manufacturer,
  810. char *ManufacturerId,
  811. char *Description,
  812. char *SerialNumber
  813. );
  814. FTD2XX_API
  815. FT_STATUS WINAPI FT_EEPROM_Program(
  816. FT_HANDLE ftHandle,
  817. void *eepromData,
  818. DWORD eepromDataSize,
  819. char *Manufacturer,
  820. char *ManufacturerId,
  821. char *Description,
  822. char *SerialNumber
  823. );
  824. FTD2XX_API
  825. FT_STATUS WINAPI FT_SetLatencyTimer(
  826. FT_HANDLE ftHandle,
  827. UCHAR ucLatency
  828. );
  829. FTD2XX_API
  830. FT_STATUS WINAPI FT_GetLatencyTimer(
  831. FT_HANDLE ftHandle,
  832. PUCHAR pucLatency
  833. );
  834. FTD2XX_API
  835. FT_STATUS WINAPI FT_SetBitMode(
  836. FT_HANDLE ftHandle,
  837. UCHAR ucMask,
  838. UCHAR ucEnable
  839. );
  840. FTD2XX_API
  841. FT_STATUS WINAPI FT_GetBitMode(
  842. FT_HANDLE ftHandle,
  843. PUCHAR pucMode
  844. );
  845. FTD2XX_API
  846. FT_STATUS WINAPI FT_SetUSBParameters(
  847. FT_HANDLE ftHandle,
  848. ULONG ulInTransferSize,
  849. ULONG ulOutTransferSize
  850. );
  851. FTD2XX_API
  852. FT_STATUS WINAPI FT_SetDeadmanTimeout(
  853. FT_HANDLE ftHandle,
  854. ULONG ulDeadmanTimeout
  855. );
  856. FTD2XX_API
  857. FT_STATUS WINAPI FT_GetDeviceInfo(
  858. FT_HANDLE ftHandle,
  859. FT_DEVICE *lpftDevice,
  860. LPDWORD lpdwID,
  861. PCHAR SerialNumber,
  862. PCHAR Description,
  863. LPVOID Dummy
  864. );
  865. FTD2XX_API
  866. FT_STATUS WINAPI FT_StopInTask(
  867. FT_HANDLE ftHandle
  868. );
  869. FTD2XX_API
  870. FT_STATUS WINAPI FT_RestartInTask(
  871. FT_HANDLE ftHandle
  872. );
  873. FTD2XX_API
  874. FT_STATUS WINAPI FT_SetResetPipeRetryCount(
  875. FT_HANDLE ftHandle,
  876. DWORD dwCount
  877. );
  878. FTD2XX_API
  879. FT_STATUS WINAPI FT_ResetPort(
  880. FT_HANDLE ftHandle
  881. );
  882. FTD2XX_API
  883. FT_STATUS WINAPI FT_CyclePort(
  884. FT_HANDLE ftHandle
  885. );
  886. //
  887. // Win32-type functions
  888. //
  889. FTD2XX_API
  890. FT_HANDLE WINAPI FT_W32_CreateFile(
  891. LPCTSTR lpszName,
  892. DWORD dwAccess,
  893. DWORD dwShareMode,
  894. LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  895. DWORD dwCreate,
  896. DWORD dwAttrsAndFlags,
  897. HANDLE hTemplate
  898. );
  899. FTD2XX_API
  900. BOOL WINAPI FT_W32_CloseHandle(
  901. FT_HANDLE ftHandle
  902. );
  903. FTD2XX_API
  904. BOOL WINAPI FT_W32_ReadFile(
  905. FT_HANDLE ftHandle,
  906. LPVOID lpBuffer,
  907. DWORD nBufferSize,
  908. LPDWORD lpBytesReturned,
  909. LPOVERLAPPED lpOverlapped
  910. );
  911. FTD2XX_API
  912. BOOL WINAPI FT_W32_WriteFile(
  913. FT_HANDLE ftHandle,
  914. LPVOID lpBuffer,
  915. DWORD nBufferSize,
  916. LPDWORD lpBytesWritten,
  917. LPOVERLAPPED lpOverlapped
  918. );
  919. FTD2XX_API
  920. DWORD WINAPI FT_W32_GetLastError(
  921. FT_HANDLE ftHandle
  922. );
  923. FTD2XX_API
  924. BOOL WINAPI FT_W32_GetOverlappedResult(
  925. FT_HANDLE ftHandle,
  926. LPOVERLAPPED lpOverlapped,
  927. LPDWORD lpdwBytesTransferred,
  928. BOOL bWait
  929. );
  930. FTD2XX_API
  931. BOOL WINAPI FT_W32_CancelIo(
  932. FT_HANDLE ftHandle
  933. );
  934. //
  935. // Win32 COMM API type functions
  936. //
  937. typedef struct _FTCOMSTAT {
  938. DWORD fCtsHold : 1;
  939. DWORD fDsrHold : 1;
  940. DWORD fRlsdHold : 1;
  941. DWORD fXoffHold : 1;
  942. DWORD fXoffSent : 1;
  943. DWORD fEof : 1;
  944. DWORD fTxim : 1;
  945. DWORD fReserved : 25;
  946. DWORD cbInQue;
  947. DWORD cbOutQue;
  948. } FTCOMSTAT, *LPFTCOMSTAT;
  949. typedef struct _FTDCB {
  950. DWORD DCBlength; /* sizeof(FTDCB) */
  951. DWORD BaudRate; /* Baudrate at which running */
  952. DWORD fBinary: 1; /* Binary Mode (skip EOF check) */
  953. DWORD fParity: 1; /* Enable parity checking */
  954. DWORD fOutxCtsFlow:1; /* CTS handshaking on output */
  955. DWORD fOutxDsrFlow:1; /* DSR handshaking on output */
  956. DWORD fDtrControl:2; /* DTR Flow control */
  957. DWORD fDsrSensitivity:1; /* DSR Sensitivity */
  958. DWORD fTXContinueOnXoff: 1; /* Continue TX when Xoff sent */
  959. DWORD fOutX: 1; /* Enable output X-ON/X-OFF */
  960. DWORD fInX: 1; /* Enable input X-ON/X-OFF */
  961. DWORD fErrorChar: 1; /* Enable Err Replacement */
  962. DWORD fNull: 1; /* Enable Null stripping */
  963. DWORD fRtsControl:2; /* Rts Flow control */
  964. DWORD fAbortOnError:1; /* Abort all reads and writes on Error */
  965. DWORD fDummy2:17; /* Reserved */
  966. WORD wReserved; /* Not currently used */
  967. WORD XonLim; /* Transmit X-ON threshold */
  968. WORD XoffLim; /* Transmit X-OFF threshold */
  969. BYTE ByteSize; /* Number of bits/byte, 4-8 */
  970. BYTE Parity; /* 0-4=None,Odd,Even,Mark,Space */
  971. BYTE StopBits; /* 0,1,2 = 1, 1.5, 2 */
  972. char XonChar; /* Tx and Rx X-ON character */
  973. char XoffChar; /* Tx and Rx X-OFF character */
  974. char ErrorChar; /* Error replacement char */
  975. char EofChar; /* End of Input character */
  976. char EvtChar; /* Received Event character */
  977. WORD wReserved1; /* Fill for now. */
  978. } FTDCB, *LPFTDCB;
  979. typedef struct _FTTIMEOUTS {
  980. DWORD ReadIntervalTimeout; /* Maximum time between read chars. */
  981. DWORD ReadTotalTimeoutMultiplier; /* Multiplier of characters. */
  982. DWORD ReadTotalTimeoutConstant; /* Constant in milliseconds. */
  983. DWORD WriteTotalTimeoutMultiplier; /* Multiplier of characters. */
  984. DWORD WriteTotalTimeoutConstant; /* Constant in milliseconds. */
  985. } FTTIMEOUTS,*LPFTTIMEOUTS;
  986. FTD2XX_API
  987. BOOL WINAPI FT_W32_ClearCommBreak(
  988. FT_HANDLE ftHandle
  989. );
  990. FTD2XX_API
  991. BOOL WINAPI FT_W32_ClearCommError(
  992. FT_HANDLE ftHandle,
  993. LPDWORD lpdwErrors,
  994. LPFTCOMSTAT lpftComstat
  995. );
  996. FTD2XX_API
  997. BOOL WINAPI FT_W32_EscapeCommFunction(
  998. FT_HANDLE ftHandle,
  999. DWORD dwFunc
  1000. );
  1001. FTD2XX_API
  1002. BOOL WINAPI FT_W32_GetCommModemStatus(
  1003. FT_HANDLE ftHandle,
  1004. LPDWORD lpdwModemStatus
  1005. );
  1006. FTD2XX_API
  1007. BOOL WINAPI FT_W32_GetCommState(
  1008. FT_HANDLE ftHandle,
  1009. LPFTDCB lpftDcb
  1010. );
  1011. FTD2XX_API
  1012. BOOL WINAPI FT_W32_GetCommTimeouts(
  1013. FT_HANDLE ftHandle,
  1014. FTTIMEOUTS *pTimeouts
  1015. );
  1016. FTD2XX_API
  1017. BOOL WINAPI FT_W32_PurgeComm(
  1018. FT_HANDLE ftHandle,
  1019. DWORD dwMask
  1020. );
  1021. FTD2XX_API
  1022. BOOL WINAPI FT_W32_SetCommBreak(
  1023. FT_HANDLE ftHandle
  1024. );
  1025. FTD2XX_API
  1026. BOOL WINAPI FT_W32_SetCommMask(
  1027. FT_HANDLE ftHandle,
  1028. ULONG ulEventMask
  1029. );
  1030. FTD2XX_API
  1031. BOOL WINAPI FT_W32_GetCommMask(
  1032. FT_HANDLE ftHandle,
  1033. LPDWORD lpdwEventMask
  1034. );
  1035. FTD2XX_API
  1036. BOOL WINAPI FT_W32_SetCommState(
  1037. FT_HANDLE ftHandle,
  1038. LPFTDCB lpftDcb
  1039. );
  1040. FTD2XX_API
  1041. BOOL WINAPI FT_W32_SetCommTimeouts(
  1042. FT_HANDLE ftHandle,
  1043. FTTIMEOUTS *pTimeouts
  1044. );
  1045. FTD2XX_API
  1046. BOOL WINAPI FT_W32_SetupComm(
  1047. FT_HANDLE ftHandle,
  1048. DWORD dwReadBufferSize,
  1049. DWORD dwWriteBufferSize
  1050. );
  1051. FTD2XX_API
  1052. BOOL WINAPI FT_W32_WaitCommEvent(
  1053. FT_HANDLE ftHandle,
  1054. PULONG pulEvent,
  1055. LPOVERLAPPED lpOverlapped
  1056. );
  1057. //
  1058. // Device information
  1059. //
  1060. typedef struct _ft_device_list_info_node {
  1061. ULONG Flags;
  1062. ULONG Type;
  1063. ULONG ID;
  1064. DWORD LocId;
  1065. char SerialNumber[16];
  1066. char Description[64];
  1067. FT_HANDLE ftHandle;
  1068. } FT_DEVICE_LIST_INFO_NODE;
  1069. // Device information flags
  1070. enum {
  1071. FT_FLAGS_OPENED = 1,
  1072. FT_FLAGS_HISPEED = 2
  1073. };
  1074. FTD2XX_API
  1075. FT_STATUS WINAPI FT_CreateDeviceInfoList(
  1076. LPDWORD lpdwNumDevs
  1077. );
  1078. FTD2XX_API
  1079. FT_STATUS WINAPI FT_GetDeviceInfoList(
  1080. FT_DEVICE_LIST_INFO_NODE *pDest,
  1081. LPDWORD lpdwNumDevs
  1082. );
  1083. FTD2XX_API
  1084. FT_STATUS WINAPI FT_GetDeviceInfoDetail(
  1085. DWORD dwIndex,
  1086. LPDWORD lpdwFlags,
  1087. LPDWORD lpdwType,
  1088. LPDWORD lpdwID,
  1089. LPDWORD lpdwLocId,
  1090. LPVOID lpSerialNumber,
  1091. LPVOID lpDescription,
  1092. FT_HANDLE *pftHandle
  1093. );
  1094. //
  1095. // Version information
  1096. //
  1097. FTD2XX_API
  1098. FT_STATUS WINAPI FT_GetDriverVersion(
  1099. FT_HANDLE ftHandle,
  1100. LPDWORD lpdwVersion
  1101. );
  1102. FTD2XX_API
  1103. FT_STATUS WINAPI FT_GetLibraryVersion(
  1104. LPDWORD lpdwVersion
  1105. );
  1106. FTD2XX_API
  1107. FT_STATUS WINAPI FT_Rescan(
  1108. void
  1109. );
  1110. FTD2XX_API
  1111. FT_STATUS WINAPI FT_Reload(
  1112. WORD wVid,
  1113. WORD wPid
  1114. );
  1115. FTD2XX_API
  1116. FT_STATUS WINAPI FT_GetComPortNumber(
  1117. FT_HANDLE ftHandle,
  1118. LPLONG lpdwComPortNumber
  1119. );
  1120. //
  1121. // FT232H additional EEPROM functions
  1122. //
  1123. FTD2XX_API
  1124. FT_STATUS WINAPI FT_EE_ReadConfig(
  1125. FT_HANDLE ftHandle,
  1126. UCHAR ucAddress,
  1127. PUCHAR pucValue
  1128. );
  1129. FTD2XX_API
  1130. FT_STATUS WINAPI FT_EE_WriteConfig(
  1131. FT_HANDLE ftHandle,
  1132. UCHAR ucAddress,
  1133. UCHAR ucValue
  1134. );
  1135. FTD2XX_API
  1136. FT_STATUS WINAPI FT_EE_ReadECC(
  1137. FT_HANDLE ftHandle,
  1138. UCHAR ucOption,
  1139. LPWORD lpwValue
  1140. );
  1141. FTD2XX_API
  1142. FT_STATUS WINAPI FT_GetQueueStatusEx(
  1143. FT_HANDLE ftHandle,
  1144. DWORD *dwRxBytes
  1145. );
  1146. #ifdef __cplusplus
  1147. }
  1148. #endif
  1149. #endif /* FTD2XX_H */