From df27504a64f3840caff7a77525111ca2f0aafac3 Mon Sep 17 00:00:00 2001 From: Lazorne Date: Tue, 12 Dec 2023 09:55:54 +0100 Subject: [PATCH] WIKI: Img & text fixes --- wiki-rtd/docs/wiki_controllers/about-udev.md | 35 ++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/wiki-rtd/docs/wiki_controllers/about-udev.md b/wiki-rtd/docs/wiki_controllers/about-udev.md index ad90f250..21768116 100644 --- a/wiki-rtd/docs/wiki_controllers/about-udev.md +++ b/wiki-rtd/docs/wiki_controllers/about-udev.md @@ -1,6 +1,37 @@ -# About Udev rules +# About udev -For these controllers to being recognized byt the system and so by RetroDECK is needed to set their own udev rule on SteamOS. +udev is a device manager for the Linux kernel that gives the system access to various running hardware via device `.rules` files also known as `udev rules`. + +## Important directories + +`/lib/udev/rules.d/`
+ +This directory contains the default `.rules file` shipped by your system. They should generally not be edited. + +`/etc/udev/rules.d/` or `/run/udev/rules.d` (depending on the system)
+ +This directory contains custom `.rules file` additions to those shipped in `/lib/udev/rules.d/` and the administrator can add more rules into this directory. + +If a `.rules file` exist for the same device under `/lib/udev/rules.d/` and `/etc/udev/rules.d/` the `/etc` version will always take preset over the `lib` version. + +## Example of a .rules file + +The content of a Merlin UTMS modem .rules file. +``` +ATTRS{prod_id2}=="Merlin UMTS Modem", ATTRS{prod_id1}=="Novatel Wireless", SYMLINK+="MerlinUMTS" +``` + +A .rules file can also contain more the one devices example multiple 8Bitdo controllers: +``` +# 8Bitdo F30 P1 +SUBSYSTEM=="input", ATTRS{name}=="8Bitdo FC30 GamePad", ENV{ID_INPUT_JOYSTICK}="1", TAG+="uaccess" + +# 8Bitdo F30 P2 +SUBSYSTEM=="input", ATTRS{name}=="8Bitdo FC30 II", ENV{ID_INPUT_JOYSTICK}="1", TAG+="uaccess" +``` + +## Adding Controllers +For these controllers to being recognized but the system and so by RetroDECK is needed to set their own udev rule on SteamOS. Udev rules are used to allow and manage the access to a specific third party usb device, so without a proper udev rule some devices such as the following ones could not be used by RetroDECK nor by the system.