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. On Linux the static library is distributed in the [libftd2xx-ffi] crate with permission from FTDI.

toml [dependencies] libftd2xx = "~0.23.0"

This is a basic example to get your started. Check the source code or documentation for more examples. ```rust use libftd2xx::{Ftdi, FtdiCommon};

let mut ft = Ftdi::new()?; let info = ft.device_info()?; println!("Device information: {:?}", info); ```

One-time Linux Setup

To access the FTDI USB device as a regular user you need to update the [udev] rules.

Create a file called /etc/udev/rules.d/99-ftdi.rules with: SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6001", GROUP="dialout", MODE="0664" SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6010", GROUP="dialout", MODE="0664" SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6011", GROUP="dialout", MODE="0664" SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6014", GROUP="dialout", MODE="0664" SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6015", GROUP="dialout", MODE="0664"

Then, reload the rules: bash sudo udevadm control --reload-rules sudo udevadm trigger

You will also need to be part of the dialout group: bash sudo adduser "$USER" dialout

One-time Windows Setup

Unlike Linux the Windows vendor driver is dynamically linked. The FTD2XX DLL must exist on your system PATH. The easiest way to install this is with the vendor provided [setup executable].

References

• [D2XX Programmers Guide V1.4]
• [D2XX Drivers Download Page]

Troubleshooting

Unknown Device on Linux

Remove the VCP FTDI driver. bash sudo rmmod ftdi_sio sudo rmmod usbserial See [FTDI Drivers Installation Guide for Linux] for more details.