aboutsummaryrefslogtreecommitdiffstats
path: root/ch57x-keyboard-tool/README
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-02 17:02:41 +0200
committerDanilo M. <danix@danix.xyz>2026-10-02 17:02:41 +0200
commit0c5f4df2088d1d132ee38aa4c75727d86daf9c48 (patch)
tree531cac5fad864edc73324ce3d07211a0bd629023 /ch57x-keyboard-tool/README
parentad16f2cf10c3cb8c66e7e8204f8cc2f3417427ad (diff)
downloadmy-slackbuilds-0c5f4df2088d1d132ee38aa4c75727d86daf9c48.tar.gz
my-slackbuilds-0c5f4df2088d1d132ee38aa4c75727d86daf9c48.zip
ch57x-keyboard-tool: add version 1.7.0
Utility to program CH57x USB macro keypads (1189:8840/8842/8850/8890) by uploading a YAML key/knob mapping to the device. Rust crates are listed in DOWNLOAD and vendored for an offline cargo build. Ships a uaccess udev rule so the logged-in user can program the keypad. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'ch57x-keyboard-tool/README')
-rw-r--r--ch57x-keyboard-tool/README10
1 files changed, 10 insertions, 0 deletions
diff --git a/ch57x-keyboard-tool/README b/ch57x-keyboard-tool/README
new file mode 100644
index 0000000..6f915ab
--- /dev/null
+++ b/ch57x-keyboard-tool/README
@@ -0,0 +1,10 @@
+ch57x-keyboard-tool is a utility to program the cheap Chinese USB
+macro keypads with keys and rotary knobs, built on the CH57x chip
+(USB ID 1189:8840, 1189:8842, 1189:8850, 1189:8890).
+
+Key and knob bindings are described in a YAML file and uploaded to the
+device, which then works as a plain USB keyboard with no daemon.
+See /usr/doc/ch57x-keyboard-tool-*/example-mapping.yaml.
+
+A udev rule is installed so the logged-in user can program the keypad
+without root. Replug the device after installing.