libftd2xx
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
.
[]
= "~0.27.0"
# statically link the vendor library, defaults to dynamic if not set
# this will make things "just work" on Linux
# not recommended on Windows due to legacy library requirements
= ["static"]
This is a basic example to get your started. Check the source code or documentation for more examples.
use ;
let mut ft = new?;
let info = ft.device_info?;
println!;
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:
Linking
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.
Static Linking on Linux
No special considerations are needed, the static library is distributed with permission from FTDI in the libftd2xx-ffi crate.
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 Windows
You must set the "LIBMSVC_PATH" environment variable to link with
legacy_stdio_definitions.lib
(vendor library requirement).
See libftd2xx-ffi for more information.
References
Troubleshooting
Unknown Device on Linux
Remove the VCP FTDI driver.
See FTDI Drivers Installation Guide for Linux for more details.