luke
/
openFPGALoader
mirror of https://github.com/trabucayre/openFPGALoader.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc/guide/troubleshooting.rst: added section about Linux access right

This commit is contained in:
Gwenhael Goavec-Merou 2026-02-20 09:02:11 +01:00
parent 3fb7fcbf98
commit bf311f15c2
1 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/guide/troubleshooting.rst
View File

@ -50,3 +50,29 @@ Unable to open FTDI device: -4 (usb_open() failed) (issue `#245 <https://github.
Edit your `/etc/udev/rules.d/99-ftdi.rules` file exchanging your programming device permissions.
For more information, check the udev section from `this guide <install.rst>`_
Converter cannot be opened: `fails to open device` (issue `#626 <https://github.com/trabucayre/openFPGALoader/issues/626>`_)
============================================================================================================================
This is usually a permissions issue on Linux.
Check your current groups:
.. code:: bash
id $USER
Verify device node access rights:
.. code:: bash
ls -l /dev/ttyUSB* /dev/ttyACM*
Then verify udev rules are installed correctly (``70-openfpgaloader.rules`` or
``99-openfpgaloader.rules``), and that your user is in the expected group
(``dialout`` or ``plugdev``).
After changing groups or rules, reload udev rules, then unplug/replug the
converter and log out/login again.
Reference: `install guide (udev rules section) <https://trabucayre.github.io/openFPGALoader/guide/install.html#udev-rules>`_.