diff --git a/scripts/debug/41-udev.rules b/scripts/debug/41-flipper.rules similarity index 72% rename from scripts/debug/41-udev.rules rename to scripts/debug/41-flipper.rules index 6b4b37b92..8663e99ab 100644 --- a/scripts/debug/41-udev.rules +++ b/scripts/debug/41-flipper.rules @@ -1,10 +1,17 @@ -#Flipper Zero serial port +# Flipper Zero serial port SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", ATTRS{manufacturer}=="Flipper Devices Inc.", TAG+="uaccess", GROUP="dialout" -#Flipper Zero DFU + +# Flipper Zero DFU SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", ATTRS{manufacturer}=="STMicroelectronics", TAG+="uaccess", GROUP="dialout" -#Flipper ESP32s2 BlackMagic + +# Flipper ESP32s2 BlackMagic SUBSYSTEMS=="usb", ATTRS{idVendor}=="303a", ATTRS{idProduct}=="40??", ATTRS{manufacturer}=="Flipper Devices Inc.", TAG+="uaccess", GROUP="dialout" -#Flipper U2F + +# Flipper ESP32s2 in DAP mode +SUBSYSTEMS=="usb", ATTRS{idVendor}=="303a", ATTRS{idProduct}=="40??", ATTRS{manufacturer}=="CMSIS-DAP", TAG+="uaccess", GROUP="dialout" + +# Flipper U2F SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5741", ATTRS{manufacturer}=="Flipper Devices Inc.", ENV{ID_SECURITY_TOKEN}="1" -#ST-Link-V3 + +# ST-Link-V3 SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="37??", ATTRS{manufacturer}=="STMicroelectronics", TAG+="uaccess", GROUP="dialout" diff --git a/scripts/debug/README.md b/scripts/debug/README.md new file mode 100644 index 000000000..59f2bf0c1 --- /dev/null +++ b/scripts/debug/README.md @@ -0,0 +1,19 @@ +## Installing udev rules + +On Linux, unprivileged users need to be in the `dialout` group to access serial ports and other USB devices. + +To add your user to the `dialout` group, run the following command: + +```bash +sudo usermod -a -G dialout $USER +``` + +To install the udev rules needed for debugging & CLI access to Flipper, run the following command: + +```bash +sudo cp 41-flipper.rules /etc/udev/rules.d/ +sudo udevadm control --reload-rules +sudo udevadm trigger +``` + +Note that not all possible debug interfaces are listed the `41-flipper.rules` file. If your interface is not supported out of the box, you may need to add a a rule for it. You can do so by adding a new line to the file according to udev rules syntax. Use `lsusb -v` to find the vendor and product IDs of your device. \ No newline at end of file