1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
//! Decoded `RESP(CAPS)` — unified capabilities of the whole cloned device (§4.4).
use super::{KbdCaps, MouseCaps};
use crate::protocol::opcode::{
CAP_REPORT_ID, CAP_WHEEL, CAP_X, CAP_Y, CAPS_CD_KBD, CAPS_CD_MOUSE, KBC_CONSUMER, KBC_NKRO,
KBC_REPORT_ID, KBC_SYSTEM,
};
/// A semantic capability summary of the whole cloned device, mouse and keyboard, from one
/// [`caps()`](crate::Device::caps) query. Counts and booleans only — never raw HID bit offsets. A class
/// that is not present reads all-zero/false. Use it for feature detection: an `inject` for a usage the
/// device lacks is a silent no-op, so the counts tell you what is real.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
pub struct Caps {
/// Mouse capabilities (all-zero when no mouse is bound).
pub mouse: MouseCaps,
/// Keyboard capabilities (all-zero when no keyboard is bound).
pub keyboard: KbdCaps,
/// The mouse class is change-driven. Always `false`: mouse motion is continuous, so its
/// [`Rate`](crate::Rate) carries a learned native cadence.
pub mouse_change_driven: bool,
/// The keyboard/media class is change-driven. `true` when a keyboard is bound: it reports only on a
/// key change, so its [`Rate`](crate::Rate) has no continuous cadence (`native_hz` is structurally
/// `None`, not not-yet-learned).
pub kbd_change_driven: bool,
}
impl Caps {
/// Whether a mouse interface is bound.
pub fn has_mouse(&self) -> bool {
self.mouse.n_buttons > 0 || self.mouse.has_x || self.mouse.has_y || self.mouse.has_wheel
}
/// Whether a keyboard interface is bound.
pub fn has_keyboard(&self) -> bool {
self.keyboard.n_keys > 0 || self.keyboard.has_consumer || self.keyboard.has_system
}
/// Whether the clone is a composite (multi-HID-interface) device.
pub fn is_composite(&self) -> bool {
self.mouse.n_hid > 1
}
/// Decode a `RESP(CAPS)` payload (§4.4):
/// `[what][n_buttons][axis_flags][n_hid][n_keys][kbd_flags][change_driven]`.
pub(crate) fn from_payload(p: &[u8]) -> Option<Caps> {
if p.len() < 7 {
return None;
}
let axis = p[2];
let kf = p[5];
let cd = p[6];
Some(Caps {
mouse: MouseCaps {
n_buttons: p[1],
has_x: axis & CAP_X != 0,
has_y: axis & CAP_Y != 0,
has_wheel: axis & CAP_WHEEL != 0,
has_report_id: axis & CAP_REPORT_ID != 0,
n_hid: p[3],
},
keyboard: KbdCaps {
n_keys: p[4],
nkro: kf & KBC_NKRO != 0,
has_consumer: kf & KBC_CONSUMER != 0,
has_system: kf & KBC_SYSTEM != 0,
has_report_id: kf & KBC_REPORT_ID != 0,
},
mouse_change_driven: cd & CAPS_CD_MOUSE != 0,
kbd_change_driven: cd & CAPS_CD_KBD != 0,
})
}
}