summaryrefslogtreecommitdiffstats
path: root/python/nxt-python/README
diff options
context:
space:
mode:
Diffstat (limited to 'python/nxt-python/README')
-rw-r--r--python/nxt-python/README28
1 files changed, 28 insertions, 0 deletions
diff --git a/python/nxt-python/README b/python/nxt-python/README
new file mode 100644
index 0000000000..19157be329
--- /dev/null
+++ b/python/nxt-python/README
@@ -0,0 +1,28 @@
+nxt-python is a python 2.x driver/interface for the Lego Mindstorms NXT robot.
+
+Setup
+------
+
+In order to use nxt-python with an NXT kit, you should add a 'lego' group to your system, and add yourself to that group:
+
+# groupadd lego
+# usermod -a -G lego YourUserName
+
+You will also want to set up a udev rule to identify NXT hardware and grant the 'lego' group permission to use it.
+
+A sample rule is included for you in /usr/share/nxt-python, but you may want to verify the vendor code of the NXT unit.
+
+To verify the vendor code, connect the NXT hardware to your computer and then run:
+
+lsusb
+
+Look at the ID for the Lego device; it will probably be 0694, but if not, then change the value in the sample udev rule to match.
+
+Save the sample udev rule (70-lego.rules) to /etc/udev/rules.d/
+
+Log out and log back in, and you should now have full control, via Python, over your NXT hardware.
+
+Requires at least one of these
+-------------------------------
+pyusb (for USB communication)
+pybluez (for bluetooth communication)