Skip to content

docs(readme): describe HID errors and device selection accurately - #12

Merged
softmaxe merged 1 commit into
mainfrom
docs/readme-accuracy
Oct 27, 2026
Merged

softmaxe merged 1 commit into
mainfrom
docs/readme-accuracy

Conversation

@softmaxe

Copy link
Copy Markdown
Owner

Summary

 Troubleshooting
-  `Could not initialize HID access` or an access error
+  `Could not initialize HID access` or `Could not read battery level: HID access failed`   # #11 folded probe errors into this prefix
 How it works
-  There is no device selector for setups with multiple mice.
+  Filters only by Logitech vendor ID, so it may read another mouse, keyboard, or headset. No device selector.
-  HID access errors and incomplete writes stop the read.
+  Once a battery feature is found, they stop the read; during discovery a failing interface is skipped
+  and its error is reported only if nothing else finds the mouse or reports it offline.

Same changes in README.zh-CN.md.

Evidence

  • Before: README implies any HID error aborts.
    After: matches read_battery_from in src/hidpp.rs (probe errors stored as last_error; offline wins; read_feature(...)? aborts).

Merge Danger

Door: two-way

Blast Radius: docs

@softmaxe
softmaxe merged commit 3533599 into main Oct 27, 2026
4 checks passed
@softmaxe
softmaxe deleted the docs/readme-accuracy branch October 27, 2026 13:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant