Add instructions for udev, to set USB permissions on Linux

schodet · schodet · commit 03ab8a68c212 · 2022-03-16T17:41:02.000+01:00
Refs #110
diff --git a/contrib/60-libnxt.rules b/contrib/60-libnxt.rules
@@ -0,0 +1,3 @@
+# Allow access to the NXT brick.
+SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="0694", ATTR{idProduct}=="0002", \
+    MODE="0660", GROUP="plugdev", TAG+="uaccess"
diff --git a/docs/installation.rst b/docs/installation.rst
@@ -34,6 +34,21 @@ PyUSB requires libusb or OpenUSB running on your system.
 .. _libusb website: http://www.libusb.info
 
 
+USB access permissions for Linux
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You need to allow connection to the NXT brick for your user. If you install
+any package interacting with the NXT brick from your distribution, this is
+usually already done for you (for example, nbc, or libnxt).
+
+In other cases, copy `contrib/60-libnxt.rules` from the NXT-Python source
+distribution to your `/etc/udev/rules.d` directory, then make sure that udev
+see the change: restart your computer or use the following commands::
+
+    sudo udevadm control --reload
+    sudo udevadm trigger
+
+
 Bluetooth
 ---------
 

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Allow access to the NXT brick.`
	`2`	`+SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="0694", ATTR{idProduct}=="0002", \`
	`3`	`+ MODE="0660", GROUP="plugdev", TAG+="uaccess"`