Yoctopuce Yocto-GPS, User Manual

Page: 561 / 572

21. Troubleshooting
21.1. Linux and USB
To work correctly under Linux, the the library needs to have write access to all the Yoctopuce USB
peripherals. However, by default under Linux, USB privileges of the non-root users are limited to read
access. To avoid having to run the
VirtualHub as root, you need to create a new udev rule to
authorize one or several users to have write access to the Yoctopuce peripherals.
To add a new udev rule to your installation, you must add a file with a name following the "
##-
arbitraryName.rules
" format, in the "
/etc/udev/rules.d
" directory. When the system is
starting, udev reads all the files with a "
.rules
" extension in this directory, respecting the
alphabetical order (for example, the "
51-custom.rules
" file is interpreted AFTER the "
50-
udev-default.rules
" file).
The "
50-udev-default
" file contains the system default udev rules. To modify the default
behavior, you therefore need to create a file with a name that starts with a number larger than 50,
that will override the system default rules. Note that to add a rule, you need a root access on the
system.
In the
udev_conf
directory of the VirtualHub for Linux
1
archive, there are two rule examples which
you can use as a basis.
Example 1: 51-yoctopuce.rules
This rule provides all the users with read and write access to the Yoctopuce USB peripherals. Access
rights for all other peripherals are not modified. If this scenario suits you, you only need to copy the
"
51-yoctopuce_all.rules
" file into the "
/etc/udev/rules.d
" directory and to restart your
system.
# udev rules to allow write access to all users
# for Yoctopuce USB devices
SUBSYSTEM=="usb", ATTR{idVendor}=="24e0", MODE="0666"
Example 2: 51-yoctopuce_group.rules
This rule authorizes the "yoctogroup" group to have read and write access to Yoctopuce USB
peripherals. Access rights for all other peripherals are not modified. If this scenario suits you, you
1
http://www.yoctopuce.com/FR/virtualhub.php
www.yoctopuce.com 555