Docs: Aula F75 (258a:010c) & tri-mode keyboards — troubleshooting + hidraw rules

[ritchegerona]

Summary

Suggesting a docs/FAQ entry for supporting tri-mode keyboards like the Aula F75 (VID 258a:010c). A very common failure mode — where the keyboard seems "dead" after a reconnect or mode toggle — is not an Omarchy/software bug, and having a short troubleshooting note would save others time.

What happened

• OS: Omarchy 4.0.2, Hyprland 0.56.2, kernel 7.1.9-arch1-2
• Hardware: Aula F75 (BY Tech), connected via USB-C cable
• After an update/replug, the keyboard enumerated on USB but sent no keystrokes at all
• Kernel/HID/Hyprland were all healthy: all input nodes created, layout "us", zero driver errors
• It was the keyboard's own firmware, not the OS. Fix = physical Fn+Esc held for ~5s (factory reset) — keyboard lit up and typed again immediately, with zero config changes needed.

Note: the Aula F75 is a tri-mode keyboard with a physical toggle switch (left = 2.4G, center = WIRED, right = BT). When the switch isn't centered (or the deep USB-C connector isn't fully seated), it enumerates/charges but won't send keystrokes over USB even while plugged in.

Suggested documentation

Add an FAQ / keyboard-troubleshooting note to the Omarchy docs:

1. If a wired keyboard is detected by the system but sends no keystrokes, first check physical mode/connection (toggle switch, cable fully seated) and try the keyboard's own factory reset (typically Fn+Esc held ~5s).
2. For the Aula F75 / 258a:010c specifically, hid-generic handles it out of the box — no driver needed. Per-key RGB/config can be done via OpenRGB or a WebHID configurator (which requires hidraw udev rules).

Optional udev rules (for RGB / config tools)

For non-root access to the keyboard's raw HID interface (OpenRGB / WebHID configurators):

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="258a", ATTRS{idProduct}=="010c", MODE="0660", GROUP="input", TAG+="uaccess"

System details (for reference)

• CPU: 11th Gen Intel i5-1135G7
• GPU: Intel Iris Xe (TigerLake-LP)
• RAM: 7.5 GiB
• Kernel: 7.1.9-arch1-2
• Omarchy: 4.0.2-1