Skip to content

Latest commit

 

History

History
56 lines (37 loc) · 1.41 KB

File metadata and controls

56 lines (37 loc) · 1.41 KB

uinput troubleshooting

vboard now uses uinput as its only input backend. This document covers common device and permission issues.

If vboard.py fails with:

OSError: [Errno 19] Failed to open the uinput device: No such device

it usually means the Linux uinput kernel module is not loaded, or the current user cannot access /dev/uinput.

Fixes

  1. Check whether the module is loaded:
lsmod | grep uinput
  1. Load it if needed:
sudo modprobe uinput
  1. Check that the device exists and inspect its permissions:
ls -l /dev/uinput
  1. For system installs of vboard, the package now installs /etc/udev/rules.d/70-vboard-uinput.rules automatically. If permissions are still restrictive, reload the rule or log out/in:
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=misc --sysname-match=uinput
  1. If your distro does not grant access through uaccess, add your user to the input group and log out/in:
sudo usermod -a -G input $USER
newgrp input
  1. To load uinput automatically at boot:
echo 'uinput' | sudo tee /etc/modules-load.d/uinput.conf

Notes

  • On some systems, installing the relevant package may also be required, such as python3-uinput.
  • If the device still cannot be opened after loading the module, verify that your distro exposes /dev/uinput and that no udev rule is blocking access.