ftd2xx-sys 0.1.0

libftd2xx FFI bindings
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

# FTD2XX-SYS

This crate generates Rust FFI (Foreign Function Interface) bindings for the [FTDI D2XX library][ftdi_lib] using [bindgen][bindgen].

For its usage, the `libftd2xx` must be installed in one of the following paths:

* `/usr/lib` and `/usr/include`.
* `/usr/local/lib` and `/usr/local/include`
* Any path set in the `LD_LIBRARY_PATH` env. variable.

The `LD_LIBRARY_PATH` variable takes precedence over the system paths.

To install the library into `/usr/local/lib`, a helper script `install_d2xx.sh` is provided.

```bash
./install_d2xx.sh [path_to_decompressed_lib] [version]
```

Also, you may choose to compile the library statically or dynamically by setting the `static` feature in your Cargo.toml. By default, the library is dynamically linked.

```toml
[dependencies]
ftd2xx-sys = { version = "x.x.x", features = ["static"] }
```

<!-- External links -->
<!--Note: Lychee fails to with status code: 403 Forbidden for FTDI links -->
[ftdi_lib]: https://ftdichip.com/drivers/d2xx-drivers/
[bindgen]: https://rust-lang.github.io/rust-bindgen/