diff --git a/tutorials/dev/dev.png b/tutorials/dev/dev.png new file mode 100644 index 0000000..79bca1b Binary files /dev/null and b/tutorials/dev/dev.png differ diff --git a/tutorials/dev/index.md b/tutorials/dev/index.md new file mode 100644 index 0000000..3f8a62c --- /dev/null +++ b/tutorials/dev/index.md @@ -0,0 +1,5 @@ +--- +title: "Development tips and tricks" +layout: theme +description: "Theme description" +--- diff --git a/tutorials/dev/tools/index.md b/tutorials/dev/tools/index.md new file mode 100644 index 0000000..a6083e8 --- /dev/null +++ b/tutorials/dev/tools/index.md @@ -0,0 +1,7 @@ +--- +title: "Installing extra Pybricks tools" +image: + local: "../dev.png" +layout: set +description: "Add set description" +--- diff --git a/tutorials/dev/tools/linux/index.md b/tutorials/dev/tools/linux/index.md new file mode 100644 index 0000000..f15ca11 --- /dev/null +++ b/tutorials/dev/tools/linux/index.md @@ -0,0 +1,35 @@ +--- +title: "Using Pybricks on Linux" +maintainer: + user: "pybricks" + name: "The Pybricks Team" +image: + local: "../../dev.png" +description: + "Configure udev and browser tools to use Pybricks." +--- + +# Adding udev rules on Linux + +By default, Linux does not allow the use of unknown USB devices, so you need to add `udev` rules for your hubs. Pybricks provides a couple of ways to do this. + +If you are using an Ubuntu-based Linux distro, you can install the `pbrick-rules` package from the Pybricks PPA. This method has the advantage of automatic updates. + +{% include copy-code.html %} +``` +sudo add-apt-repository --update ppa:pybricks/ppa +sudo apt install pbrick-rules +``` + +You can alternately install the rules using the `pybricksdev` command line tool: + +{% include copy-code.html %} +``` +pipx run pybricksdev udev | sudo tee /etc/udev/rules.d/99-pybricksdev.rules +``` + +If neither of these options is suitable, you can manually copy [this file](https://github.com/pybricks/pybricksdev/blob/master/pybricksdev/resources/99-pybricksdev.rules) to `/etc/udev/rules.d/99-pybricksdev.rules`. + +After installing the `udev` rules, disconnect any affected devices and plug them back in. + +If this doesn't seem to work, try rebooting.