libftd3xx 0.0.1

Rust safe wrapper around the libftd3xx-ffi crate.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

[![crates.io](https://img.shields.io/crates/v/libftd3xx.svg)](https://crates.io/crates/libftd3xx)
[![docs.rs](https://docs.rs/libftd3xx/badge.svg)](https://docs.rs/libftd3xx/)
[![CI](https://github.com/ftdi-rs/libftd3xx/workflows/CI/badge.svg)](https://github.com/ftdi-rs/libftd3xx/actions)

# libftd3xx


Rust safe wrapper for the [FTDI D3XX drivers].

This takes the [libftd3xx-ffi] C bindings crate and extends it with rust
safe wrappers.

## Usage

Simply add this crate as a dependency in your `Cargo.toml`.

```toml
[dependencies.libftd3xx]
version = "0.0.1"
# statically link the vendor library, defaults to dynamic if not set

# this will make things "just work" on Linux and Windows

features = ["static"]
```

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

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

This crate is just a wrapper around the FTD3XX driver; I2C, SPI, and GPIO
examples using the [`embedded-hal`] traits can be found in
[`ftdi-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:
```bash
sudo udevadm control --reload-rules
sudo udevadm trigger
```

### 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 `libftd3xx.so` must exist on your system.
See [FTDI Drivers Installation Guide for Linux] for instructions.

#### Dynamic Linking on Windows


The FTD3XX 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 [libftd3xx-ffi] crate.

## References


* [D3XX Programmers Guide V1.4]
* [D3XX 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.

[D3XX Drivers Download Page]: https://www.ftdichip.com/Drivers/D3XX.htm
[D3XX Programmers Guide V1.4]: https://ftdichip.com/document/programming-guides/
[FTDI D3XX drivers]: https://www.ftdichip.com/Drivers/D3XX.htm
[FTDI Drivers Installation Guide for Linux]: http://www.ftdichip.cn/Support/Documents/AppNotes/AN_220_FTDI_Drivers_Installation_Guide_for_Linux.pdf
[libftd3xx-ffi]: https://github.com/ftdi-rs/libftd3xx-ffi
[udev]: https://en.wikipedia.org/wiki/Udev
[`ftdi-embedded-hal`]: https://github.com/ftdi-rs/ftdi-embedded-hal
[`embedded-hal`]: https://crates.io/crates/embedded-hal