Chart VoidKontrol wayfinding and correct current hidraw evidence

2026-09-21 05:06:05 +00:00
parent 700b34fb60
commit f90df8aba1
5 changed files with 197 additions and 7 deletions
@@ -0,0 +1,43 @@
+# VoidKontrol
+
+VoidKontrol manages the verified customization capabilities of a Kreo Swarm 75
+keyboard while preserving its ordinary typing and media controls.
+
+## Language
+
+**Driver-declared capability**:
+A customization advertised by the vendor's software for a keyboard model,
+whose behavior on the connected keyboard has not necessarily been verified.
+_Avoid_: Verified capability, working feature
+
+**Verified capability**:
+A customization whose behavior has been demonstrated on an identified keyboard
+and connection mode, including the readback needed to confirm an update.
+_Avoid_: Driver-declared capability
+
+**Device layer**:
+One of the keyboard's Base, Fn, Fn1, or Fn2 sets of key assignments.
+_Avoid_: Profile
+
+**Macro**:
+A named sequence of key press/release actions and delays assigned to a keyboard
+macro slot, with an execution behavior supported by the device.
+
+**Desired configuration**:
+The settings the user intends the keyboard to use; they may differ from the
+settings currently confirmed on the keyboard.
+_Avoid_: Device readback
+
+**Device readback**:
+Settings obtained from the keyboard and used as evidence of its current state.
+_Avoid_: Desired configuration, successful request
+
+**Configuration backup**:
+A saved, complete configuration read from the keyboard before changes, intended
+to support restoration to that known state.
+_Avoid_: Raw packet recording
+
+**Restore**:
+An explicit operation that reapplies a compatible configuration backup and
+verifies the resulting keyboard state.
+_Avoid_: Factory reset