docs: rework device permission topic and add info about webcam permissions provided in #155

This commit is contained in:
Markus Küffner
2024-05-09 12:17:59 +02:00
parent 35660dfb71
commit d4a9edc31e
2 changed files with 10 additions and 10 deletions

View File

@@ -7,6 +7,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
<!-- <!--
## [Unreleased] ## [Unreleased]
### Added ### Added
* docs: note about video device permissions via #155 reported by @d-graz
### Fixed ### Fixed
### Changed ### Changed
### Removed ### Removed

View File

@@ -207,19 +207,18 @@ docker compose --profile <profile> up -d
``` ```
## Advanced Topics ## Advanced Topics
### Serial device permissions ### Device permissions
It may be necessary to change the permissions of your printers serial device. Adjusting permissions for devices connected to your host may become necessary, especially if you're using a non-Debian-based distribution with varying numerical group IDs.
This is usually the case when you're on a non debian based distro which uses a different numerical groupid for the `dialout` group.
Serial devices passed into the klipper container should be assigned to groupid `20` for the permissions to work within it. You can accomplish this by crafting a udev rule tailored to your specific device on your host system. Refer to your operating system's manual for instructions on configuring udev rules.
This may be done by creating a udev rule on your host machine for your specific device, read up on how to do this on your specific OS. Typically, this involves creating a `*.rules` file within `/etc/udev/rules.d` and appending a single line to it.
Usually you'll have to create a `*.rules` file in `/etc/udev/rules.d` and add a single line like this to it. Consult the table below for the appropriate rule corresponding to your device type. Ensure to include your device's specific `idVendor` and `idProduct`, which can be identified using the `lsusb` command.
Be sure to use your devices specific `idVendor` and `idProduct`, which can be found via `lsusb`.
``` | Device Type | Group Name | GID | Udev Rule |
ACTION=="add",SUBSYSTEM=="tty",ATTRS{idVendor}=="0000",ATTRS{idProduct}=="0000",GROUP="20" |-------------|------------|------|------------------------------------------------------------------------------------------------------|
``` | Serial Port | `dialout` | `20` | `ACTION=="add",SUBSYSTEM=="tty",ATTRS{idVendor}=="0000",ATTRS{idProduct}=="0000",GROUP="20"` |
| Webcam | `video` | `44` | `ACTION=="add",SUBSYSTEM=="video4linux",ATTRS{idVendor}=="0000",ATTRS{idProduct}=="0000",GROUP="44"` |
### Input Shaper Calibration ### Input Shaper Calibration
Using input shaper requires an accelerometer. Using input shaper requires an accelerometer.