Component: FTDI (FTD2XX) (Third Party): Difference between revisions

Latest revision as of 14:23, 13 July 2026

Author	Matrix Ltd
Version	1.0
Category	Third Party

FTDI (FTD2XX) component

Simulation only interface to allow communications with a FTDI USB 232 IC connected to the system. For more details refer to the D2XX_Programmers_Guide from FTDI.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_ftd2xx_232.fcsx

Please click here to view the component source code (Beta): FC_Comp_Source_ftd2xx_232.fcsx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

FT_Close

	FT_Close
Close an open device.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_ClrDtr

	FT_ClrDtr
This function clears the Data Terminal Ready (DTR) control signal.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_ClrRts

	FT_ClrRts
This function clears the Request To Send (RTS) control signal.
- LONG	Handle
Handle of the device.
- VOID	Return

FT_CreateDeviceInfoList

	FT_CreateDeviceInfoList
This function builds a device information list and returns the number of D2XX devices connected to the system. The list contains information about both unopen and open devices.
- LONG	DevCount
Unsigned long array used to store the number of devices connected
- BYTE	Return

FT_GetDeviceInfoDetail

	FT_GetDeviceInfoDetail
This function returns an entry from the device information list.
- ULONG	Index
Index of the entry in the device info list.
- ULONG	Flags
Pointer to unsigned long to store the flag value.
- ULONG	Type
Pointer to unsigned long to store device type.
- ULONG	ID
Pointer to unsigned long to store device ID.
- ULONG	LocID
Pointer to unsigned long to store the device location ID.
- BYTE	SerNum
Pointer to buffer to store device serial number as a null terminated string
- BYTE	Descript
Pointer to buffer to store device description as a null-terminated string
- LONG	TempHandle
Pointer to a variable of type FT_HANDLE where the handle will be stored
- BYTE	Return

FT_GetModemStatus

	FT_GetModemStatus
Gets the modem status and line status from the device.
- LONG	Handle
Handle of the device.
- LONG	ModemStatus
Pointer to a variable of type DWORD which receives the modem status and line status from the device.
- BYTE	Return

FT_GetQueueStatus

	FT_GetQueueStatus
Gets the number of bytes in the receive queue.
- LONG	Handle
Handle of the device.
- LONG	RxQueueLength
Pointer to a variable of type DWORD which receives the number of bytes in the receive queue.
- BYTE	Return

FT_GetStatus

	FT_GetStatus
Gets the device status including number of characters in the receive queue, number of characters in the transmit queue, and the current event status.
- LONG	Handle
Handle of the device.
- LONG	RxQueueLength
Pointer to a variable of type DWORD which receives the number of characters in the receive queue.
- LONG	TxQueueLength
Pointer to a variable of type DWORD which receives the number of characters in the transmit queue.
- LONG	EventStatus
Pointer to a variable of type DWORD which receives the current state of the event status.
- BYTE	Return

FT_Open

	FT_Open
Open the device and return a handle which will be used for subsequent accesses.
- INT	Device
Index of the device to open. Indices are 0 based.
- LONG	ft_Handle
Pointer to a variable of type FT_HANDLE where the handle will be stored. This handle must be used to access the device.
- BYTE	Return

FT_Purge

	FT_Purge
This function purges receive and transmit buffers in the device.
- LONG	Handle
Handle of the device.
- LONG	Mask
Used to determine which buffer to purge, 1=Rx / 2=Tx / 3=Both
- BYTE	Return

FT_Read

	FT_Read
Read data from the device.
- LONG	Handle
Handle of the device.
- BYTE	Buffer
Pointer to the buffer that receives the data from the device.
- ULONG	Bytes
Number of bytes to be read from the device.
- ULONG	Count
Pointer to a variable of type DWORD which receives the number of bytes read from the device.
- BYTE	Return

FT_ResetDevice

	FT_ResetDevice
This function sends a reset command to the device.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_SetBaudRate

	FT_SetBaudRate
This function sets the baud rate for the device.
- LONG	Handle
Handle of the device.
- ULONG	BaudRate
Baud rate.
- BYTE	Return

FT_SetBitMode

	FT_SetBitMode
Enables different chip modes.
- LONG	Handle
Handle of the device.
- BYTE	Mask
Required value for bit mode mask. This sets up which bits are inputs and outputs. A bit value of 0 sets the corresponding pin to an input, a bit value of 1 sets the corresponding pin to an output.
- BYTE	Mode
0=Reset / 1=AsyncBB / 2=MPSSE / 4=SyncBB / 8=MCUHost / 16=FastOpto / 32=CBUS / 64=SyncFIFO
- BYTE	Return

FT_SetBreakOff

	FT_SetBreakOff
Resets the BREAK condition for the device.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_SetBreakOn

	FT_SetBreakOn
Sets the BREAK condition for the device.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_SetChars

	FT_SetChars
This function sets the special characters for the device.
- LONG	Handle
Handle of the device.
- BYTE	EventCh
Event character.
- BYTE	EventChEn
0 if event character disabled, non-zero otherwise.
- BYTE	ErrorCh
Error character.
- BYTE	ErrorChEn
0 if error character disabled, non-zero otherwise.
- BYTE	Return

FT_SetDataCharacteristics

	FT_SetDataCharacteristics
This function sets the data characteristics for the device.
- LONG	Handle
Handle of the device.
- BYTE	WordLength
Number of bits per word - Must be 7 or 8
- BYTE	StopBits
Number of stop bits - Must be 1 or 2
- BYTE	Parity
Parity 0=None / 1=Odd / 2=Even / 3=Mark / 4=Space
- BYTE	Return

FT_SetDivisor

	FT_SetDivisor
This function sets the baud rate for the device. It is used to set non-standard baud rates.
- LONG	Handle
Handle of the device.
- UINT	Divisor
Divisor.
- BYTE	Return

FT_SetDtr

	FT_SetDtr
This function sets the Data Terminal Ready (DTR) control signal.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_SetFlowControl

	FT_SetFlowControl
This function sets the flow control for the device.
- LONG	Handle
Handle of the device.
- UINT	FlowControl
Flow setting 0=None, 0x0100=RTS/CTS, 0x0200=DTR/DSR, 0x0400=XON/XOFF
- BYTE	Xon
Character used to signal Xon. Only used if flow control is Xon/Xoff
- BYTE	Xoff
Character used to signal Xoff. Only used if flow control is Xon/Xoff
- BYTE	Return

FT_SetRts

	FT_SetRts
This function sets the Request To Send (RTS) control signal.
- LONG	Handle
Handle of the device.
- BYTE	Return

FT_SetTimeouts

	FT_SetTimeouts
This function sets the read and write timeouts for the device.
- LONG	Handle
Handle of the device.
- LONG	ReadTimeout
Read timeout in milliseconds.
- LONG	WriteTimeout
Write timeout in milliseconds.
- BYTE	Return

FT_Write

	FT_Write
Write data to the device.
- LONG	Handle
Handle of the device.
- BYTE	Buffer
Pointer to the buffer that contains the data to be written to the device.
- ULONG	Bytes
Number of bytes to write to the device.
- ULONG	Count
Pointer to a variable of type DWORD which receives the number of bytes written to the device.
- BYTE	Return

ScanFor232

	ScanFor232
Scans for a FTDI D2XX device, returnes true if at least one device was found.
- BOOL	Return

Property reference

	Properties
	Label
A text label for the component's panel component.

@@ Line 95: / Line 95: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_Close'''
+| width="90%" class="mtx-class-macrohead" | '''FT_Close'''
 |-
 | colspan="2" | Close an open device.&nbsp;
@@ Line 114: / Line 114: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_ClrDtr'''
+| width="90%" class="mtx-class-macrohead" | '''FT_ClrDtr'''
 |-
 | colspan="2" | This function clears the Data Terminal Ready (DTR) control signal.&nbsp;
@@ Line 133: / Line 133: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_ClrRts'''
+| width="90%" class="mtx-class-macrohead" | '''FT_ClrRts'''
 |-
 | colspan="2" | This function clears the Request To Send (RTS) control signal. &nbsp;
@@ Line 152: / Line 152: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_CreateDeviceInfoList'''
+| width="90%" class="mtx-class-macrohead" | '''FT_CreateDeviceInfoList'''
 |-
 | colspan="2" | This function builds a device information list and returns the number of D2XX devices connected to the system. The list contains information about both unopen and open devices. &nbsp;
@@ Line 171: / Line 171: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_GetDeviceInfoDetail'''
+| width="90%" class="mtx-class-macrohead" | '''FT_GetDeviceInfoDetail'''
 |-
 | colspan="2" | This function returns an entry from the device information list.&nbsp;
@@ Line 225: / Line 225: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_GetModemStatus'''
+| width="90%" class="mtx-class-macrohead" | '''FT_GetModemStatus'''
 |-
 | colspan="2" | Gets the modem status and line status from the device. &nbsp;
@@ Line 249: / Line 249: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_GetQueueStatus'''
+| width="90%" class="mtx-class-macrohead" | '''FT_GetQueueStatus'''
 |-
 | colspan="2" | Gets the number of bytes in the receive queue.&nbsp;
@@ Line 273: / Line 273: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_GetStatus'''
+| width="90%" class="mtx-class-macrohead" | '''FT_GetStatus'''
 |-
 | colspan="2" | Gets the device status including number of characters in the receive queue, number of characters in the transmit queue, and the current event status. &nbsp;
@@ Line 307: / Line 307: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_Open'''
+| width="90%" class="mtx-class-macrohead" | '''FT_Open'''
 |-
 | colspan="2" | Open the device and return a handle which will be used for subsequent accesses.&nbsp;
@@ Line 331: / Line 331: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_Purge'''
+| width="90%" class="mtx-class-macrohead" | '''FT_Purge'''
 |-
 | colspan="2" | This function purges receive and transmit buffers in the device.&nbsp;
@@ Line 355: / Line 355: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_Read'''
+| width="90%" class="mtx-class-macrohead" | '''FT_Read'''
 |-
 | colspan="2" | Read data from the device. &nbsp;
@@ Line 389: / Line 389: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_ResetDevice'''
+| width="90%" class="mtx-class-macrohead" | '''FT_ResetDevice'''
 |-
 | colspan="2" | This function sends a reset command to the device. &nbsp;
@@ Line 408: / Line 408: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetBaudRate'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetBaudRate'''
 |-
 | colspan="2" | This function sets the baud rate for the device. &nbsp;
@@ Line 432: / Line 432: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetBitMode'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetBitMode'''
 |-
 | colspan="2" | Enables different chip modes.&nbsp;
@@ Line 461: / Line 461: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetBreakOff'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetBreakOff'''
 |-
 | colspan="2" | Resets the BREAK condition for the device. &nbsp;
@@ Line 480: / Line 480: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetBreakOn'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetBreakOn'''
 |-
 | colspan="2" | Sets the BREAK condition for the device. &nbsp;
@@ Line 499: / Line 499: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetChars'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetChars'''
 |-
 | colspan="2" | This function sets the special characters for the device.&nbsp;
@@ Line 538: / Line 538: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetDataCharacteristics'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetDataCharacteristics'''
 |-
 | colspan="2" | This function sets the data characteristics for the device. &nbsp;
@@ Line 572: / Line 572: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetDivisor'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetDivisor'''
 |-
 | colspan="2" | This function sets the baud rate for the device. It is used to set non-standard baud rates. &nbsp;
@@ Line 596: / Line 596: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetDtr'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetDtr'''
 |-
 | colspan="2" | This function sets the Data Terminal Ready (DTR) control signal.&nbsp;
@@ Line 615: / Line 615: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetFlowControl'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetFlowControl'''
 |-
 | colspan="2" | This function sets the flow control for the device.&nbsp;
@@ Line 649: / Line 649: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetRts'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetRts'''
 |-
 | colspan="2" | This function sets the Request To Send (RTS) control signal.&nbsp;
@@ Line 668: / Line 668: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_SetTimeouts'''
+| width="90%" class="mtx-class-macrohead" | '''FT_SetTimeouts'''
 |-
 | colspan="2" | This function sets the read and write timeouts for the device.&nbsp;
@@ Line 697: / Line 697: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''FT_Write'''
+| width="90%" class="mtx-class-macrohead" | '''FT_Write'''
 |-
 | colspan="2" | Write data to the device. &nbsp;
@@ Line 731: / Line 731: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ScanFor232'''
+| width="90%" class="mtx-class-macrohead" | '''ScanFor232'''
 |-
 | colspan="2" | Scans for a FTDI D2XX device, returnes true if at least one device was found.&nbsp;
@@ Line 745: / Line 745: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-

SteveT (talk | contribs)