diff --git a/docs/platforms/atmelavr.rst b/docs/platforms/atmelavr.rst index 6ba7a7d3..090149c6 100644 --- a/docs/platforms/atmelavr.rst +++ b/docs/platforms/atmelavr.rst @@ -37,9 +37,9 @@ Packages - See below in :ref:`atmelavr_frameworks` -.. note:: - You can install ``atmelavr`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _atmelavr_frameworks: diff --git a/docs/platforms/atmelsam.rst b/docs/platforms/atmelsam.rst index 796d9188..9070424f 100644 --- a/docs/platforms/atmelsam.rst +++ b/docs/platforms/atmelsam.rst @@ -31,9 +31,9 @@ Packages - See below in :ref:`atmelsam_frameworks` -.. note:: - You can install ``atmelsam`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _atmelsam_frameworks: diff --git a/docs/platforms/stm32.rst b/docs/platforms/stm32.rst index ab4000c3..4748f6a9 100644 --- a/docs/platforms/stm32.rst +++ b/docs/platforms/stm32.rst @@ -35,9 +35,9 @@ Packages - - See below in :ref:`stm32_frameworks` -.. note:: - You can install ``stm32`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _stm32_frameworks: diff --git a/docs/platforms/teensy.rst b/docs/platforms/teensy.rst index a60b6d02..37f172c6 100644 --- a/docs/platforms/teensy.rst +++ b/docs/platforms/teensy.rst @@ -34,9 +34,9 @@ Packages - See below in :ref:`teensy_frameworks` -.. note:: - You can install ``teensy`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _teensy_frameworks: diff --git a/docs/platforms/timsp430.rst b/docs/platforms/timsp430.rst index f10d1578..256f9f36 100644 --- a/docs/platforms/timsp430.rst +++ b/docs/platforms/timsp430.rst @@ -31,9 +31,9 @@ Packages - See below in :ref:`timsp430_frameworks` -.. note:: - You can install ``atmelavr`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _timsp430_frameworks: diff --git a/docs/platforms/titiva.rst b/docs/platforms/titiva.rst index b9d822b9..208742d9 100644 --- a/docs/platforms/titiva.rst +++ b/docs/platforms/titiva.rst @@ -34,9 +34,9 @@ Packages - - See below in :ref:`titiva_frameworks` -.. note:: - You can install ``titiva`` platform with these packages - via :ref:`cmd_install` command. +.. warning:: + **Linux Users:** Don't forget to install "udev" rules file + `99-platformio-udev.rules `_ (an instruction is located in the file). .. _titiva_frameworks: diff --git a/scripts/99-platformio-udev.rules b/scripts/99-platformio-udev.rules new file mode 100644 index 00000000..34045ef3 --- /dev/null +++ b/scripts/99-platformio-udev.rules @@ -0,0 +1,57 @@ +# Copyright (C) Ivan Kravets +# See LICENSE for details. + +# UDEV Rules for PlatformIO supproted boards, http://platformio.org/#!/boards +# +# The latest version of this file may be found at: +# https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules +# +# This file must be placed at: +# /etc/udev/rules.d/99-platformio-udev.rules (preferred location) +# or +# /lib/udev/rules.d/99-platformio-udev.rules (req'd on some broken systems) +# +# To install, type this command in a terminal: +# sudo cp 99-platformio-udev.rules /etc/udev/rules.d/99-platformio-udev.rules +# +# Restart "udev" management tool: +# sudo service udev restart +# or +# sudo udevadm control --reload-rules +# sudo udevadm trigger +# +# After this file is installed, physically unplug and reconnect your board. + +# CP210X USB UART +SUBSYSTEMS=="usb", ATTRS{idVendor}=="10c4", ATTRS{idProduct}=="ea60", MODE:="0666" + +# FT232R USB UART +SUBSYSTEMS=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE:="0666" + +# Prolific Technology, Inc. PL2303 Serial Port +SUBSYSTEMS=="usb", ATTRS{idVendor}=="067b", ATTRS{idProduct}=="2303", MODE:="0666" + +# ARDUINO UNO +SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0043", MODE:="0666" + +# Digistump boards +SUBSYSTEMS=="usb", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0753", MODE:="0666" +KERNEL=="ttyACM*", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0753", MODE:="0666", ENV{ID_MM_DEVICE_IGNORE}="1" + +# STM32 discovery boards, with onboard st/linkv2 +SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3748", MODE:="0666" + +# USBtiny +SUBSYSTEMS=="usb", ATTRS{idProduct}=="0c9f", ATTRS{idVendor}=="1781", MODE="0666" + +# Teensy boards +ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="04[789]?", ENV{ID_MM_DEVICE_IGNORE}="1" +ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="04[789]?", ENV{MTP_NO_PROBE}="1" +SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="04[789]?", MODE:="0666" +KERNEL=="ttyACM*", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="04[789]?", MODE:="0666" + +#TI Stellaris Launchpad +SUBSYSTEMS=="usb", ATTRS{idVendor}=="1cbe", ATTRS{idProduct}=="00fd", MODE="0666" + +#TI MSP430 Launchpad +SUBSYSTEMS=="usb", ATTRS{idVendor}=="0451", ATTRS{idProduct}=="f432", MODE="0666"