Crate libftd2xx[−][src]
Expand description
Rust safe wrapper for the FTDI D2XX drivers.
This takes the libftd2xx-ffi C bindings crate and extends it with rust safe wrappers.
Usage
Simply add this crate as a dependency in your Cargo.toml.
[dependencies.libftd2xx]
version = "0.32"
features = ["static"]This is a basic example to get your started. Check the source code or documentation for more examples.
use libftd2xx::{Ftdi, FtdiCommon};
let mut ft = Ftdi::new()?;
let info = ft.device_info()?;
println!("Device information: {:?}", info);This crate is just a wrapper around the FTD2XX driver; I2C, SPI, and GPIO
examples using the embedded-hal traits can be found in
ftd2xx-embedded-hal.
udev rules
To access the FTDI USB device as a regular user on Linux you need to update the udev rules.
Create a file called /etc/udev/rules.d/99-ftdi.rules with:
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6011", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015", MODE="0666"Then, reload the rules:
sudo udevadm control --reload-rules
sudo udevadm triggerLinking
By default this crate with use dynamic linking for the vendor library.
Use the static feature flag to enable static linking.
Dynamic Linking on Linux
The shared object libftd2xx.so must exist on your system.
See FTDI Drivers Installation Guide for Linux for instructions.
Dynamic Linking on Windows
The FTD2XX DLL must exist on your system PATH. The easiest way to install this is with the vendor provided setup executable.
Static Linking on Linux or Windows
No special considerations are needed, the static library is distributed with permission from FTDI in the libftd2xx-ffi crate.
References
Troubleshooting
Unknown Device on Linux
Remove the VCP FTDI driver.
sudo rmmod ftdi_sio
sudo rmmod usbserialSee FTDI Drivers Installation Guide for Linux for more details.
Structs
FTDI device information.
FTDI device status.
EEPROM structure for the FT232H.
EEPROM structure for the FT2232H.
EEPROM structure for the FT4232H.
FTDI EEPROM header common to all FTDI devices.
EEPROM strings structure.
EEPROM strings error.
EEPROM value error.
FT232H device.
FT2232H device.
FT4232H device.
Generic FTDI device.
FTDI modem status.
FTDI Multi-Protocol Synchronous Serial Engine (MPSSE) command builder.
Initialization settings for the MPSSE.
D2XX version structure.
Enums
BitModes for the FTDI ports.
Bits per word.
FT1248 byte order.
FT232H CBUS options.
FT232R CBUS options.
FT X Series CBUS options.
Modes for clocking data bits in and out of the FTDI device.
Modes for clocking data bits into the FTDI device.
Modes for clocking bits out of the FTDI device.
Modes for clocking data in and out of the FTDI device.
Modes for clocking data into the FTDI device.
Modes for clocking data out of the FTDI device.
FT1248 clock polarity
FTDI device types.
Device type errors.
FTDI pin drive currents.
FTDI driver type.
These are the C API error codes.
MPSSE opcodes.
Serial parity bits.
USB device speed.
Stop bits.
FTDI timeout errors.
Constants
FTDI USB vendor id.
Traits
FTD2XX functions common to all devices.
FTDI device-specific EEPROM trait.
FTDI Multi-Protocol Synchronous Serial Engine (MPSSE).
This contains MPSSE commands that are only available on the the FT232H, FT2232H, and FT4232H devices.
FTDI MPSSE configurator and executor
Functions
Returns the version of the underlying C library.
This function returns a device information vector with information about the D2XX devices connected to the system.
Lists FTDI devices using the Linux file system.
Returns the number of FTDI devices connected to the system.
Rescan devices on the system.
A command to include a custom VID and PID combination within the internal device list table.
A command to retrieve the current VID and PID combination from within the internal device list table.