
November 9, 2026

**Install the correct library on the Raspberry Pi 5**

1. Go to the FTDI D2XX drivers page and download the **ARMv8** package (Raspberry Pi 5 is 64-bit ARM / aarch64). Current versions are in the 1.4.x series.

2. Extract it, then (from the `build` directory) as root:
   sudo cp libftd2xx.* /usr/local/lib
   sudo chmod 0755 /usr/local/lib/libftd2xx.so.*
   sudo ln -sf /usr/local/lib/libftd2xx.so.* /usr/local/lib/libftd2xx.so
   sudo ldconfig
   
3. Also copy `ftd2xx.h` and `WinTypes.h` into `/usr/local/include` if you need them for reference.


**Runtime requirements**

- The kernel's virtual COM port driver (`ftdi_sio`) conflicts with D2XX. Before running your program unload it:
  sudo rmmod ftdi_sio usbserial
  
  (You can blacklist it permanently if you never need the VCP interface.)
  
- For non-root access, add a udev rule (example for common FTDI VID/PID pairs) under `/etc/udev/rules.d/` and reload the rules.