1
0
mirror of https://github.com/wfjm/w11.git synced 2026-01-31 06:02:37 +00:00
Files
wfjm.w11/tools/sys/README.md
wfjm 6b8c0633bc catch-up after a two years hiatus
- drop Travis support (now defunct)
- generic_cpp.mk: use -std=c++17 (requires gcc 7.3 or later)
- RlinkPortCuff : drop libusb_set_debug (now deprecated)
- viv_tools_config.tcl: use open_hw_manager
- vbomconv: ghdl_m: use -Wl,--no-pie (for UB 18.04 gcc)
- simlib.vhd: write{oct,hex}: fix for ghdl V0.36 -Whide warnings
2021-08-22 16:59:38 +02:00

47 lines
1.6 KiB
Markdown

This directory contains [udev](https://en.wikipedia.org/wiki/Udev) rule files
which ensure that
- FTDI based USB UARTs are operated with low latency
- Digilent FT2232C style FPGA boards receive a persistent device name
Each Digilent FT2232C style FPGA board has a unique serial number
of the USB interface. This can be used to assign a human readable alias
of the form `/dev/fpga_...` to a board.
The file [92-retro-usb-persistent.rules](92-retro-usb-persistent.rules)
contains _example rules_ valid for the boards of the author.
**This file must be adopted to the available boards before it is used.**
Use
```bash
udevadm info -q all -n /dev/ttyUSB1
#
# /dev/ttyUSB1 is correct if the FPGA board is the only USB tty device.
# If you have other USB tty devices adopt to your needs
#
```
to determine the `ID_SERIAL_SHORT` and create rules for your boards.
To setup udev rules do
```bash
cd $RETROBASE/tools/sys
# !! adopt 92-retro-usb-persistent.rules to your needs !!
sudo cp -a 91-retro-usb-latency.rules /etc/udev/rules.d/
sudo cp -a 92-retro-usb-persistent.rules /etc/udev/rules.d/
sudo chown root:root /etc/udev/rules.d/*-retro-usb-*.rules
ls -al /etc/udev/rules.d/
sudo udevadm control --reload-rules
```
to verify whether usb device has low latency use
```bash
# --> deterime the /dev/ttyUSB* device of interest
cat /sys/bus/usb-serial/devices/ttyUSB1/latency_timer
# --> should show '1' and not '16'
```
and to verify whether persistent device name are applied use
```bash
ls -al /dev/fpga_*
# output like
# lrwxrwxrwx 1 root root 7 2020-03-15 13:55 /dev/fpga_arty -> ttyUSB1
```