medius 2.1.0

Host control library for the medius transparent mouse passthrough box
Documentation 
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

use crate::error::Result;
use crate::protocol::FrameType;
use crate::protocol::command::inject_payload;
use crate::protocol::opcode::INJ_BTN;
use crate::types::{Action, Button};

use super::Device;

impl Device {
    /// `INJECT` (button) — set an injection override for one button.
    pub fn button(&self, button: Button, action: Action) -> Result<()> {
        self.link.desired().lock().apply(button, action);
        self.link.send(
            FrameType::Inject,
            &inject_payload(INJ_BTN, button.as_id() as u16, action.as_u8()),
        )
    }

    /// Press (hold down) a button.
    pub fn press(&self, button: Button) -> Result<()> {
        self.button(button, Action::Press)
    }

    /// Soft-release a button — clears our injected press; a physical hold is left intact.
    pub fn soft_release(&self, button: Button) -> Result<()> {
        self.button(button, Action::SoftRelease)
    }

    /// Force-release a button — forces the bit clear, masking a physical hold too.
    pub fn force_release(&self, button: Button) -> Result<()> {
        self.button(button, Action::ForceRelease)
    }

    /// `RESET` — return to pure passthrough immediately. Clears injection and ends any open catch
    /// stream (its [`EventStream`](crate::EventStream) `recv()` returns `Err`), matching the firmware,
    /// which drops every PC-owned state on the same `RESET`.
    pub fn reset(&self) -> Result<()> {
        self.link.desired().lock().clear();
        self.link.catch_disconnect_all();
        self.link.send(FrameType::Reset, &[])
    }
}