Enum DeviceRoute 

pub enum DeviceRoute {
    Bolt {
        receiver_uid: String,
        slot: u8,
    },
    Unifying {
        receiver_uid: String,
        slot: u8,
    },
    Direct {
        vendor_id: u16,
        product_id: u16,
    },
}

How to reach a controllable HID++ device.

Crosses the agent↔GUI IPC (every per-device RPC takes one), so variant and field order are wire format — changes require a PROTOCOL_VERSION bump (guarded by openlogi-agent-core/tests/wire_format.rs).

Variants

Bolt

Paired to a Logi Bolt receiver. receiver_uid disambiguates multiple plugged-in receivers; slot is the device’s pairing slot (1..=6).

Fields

receiver_uid: String

slot: u8

Unifying

Paired to a Logi Unifying receiver. Same addressing structure as Bolt (receiver channel + pairing slot) but the receiver speaks HID++ 1.0.

Fields

receiver_uid: String

slot: u8

Direct

Attached straight to the host over USB cable or Bluetooth, addressed at the HID++ self-index. Re-found by matching the HID node’s vendor/product id — two identical mice on one host are indistinguishable here, so the first match wins (acceptable for v0).

Fields

vendor_id: u16

product_id: u16

Implementations

impl DeviceRoute

pub fn device_index(&self) -> u8

The HID++ device index features are addressed at for this route: the pairing slot for a Bolt device, the self-index for a direct one.

pub fn device_route_for(inv: &DeviceInventory, slot: u8) -> Option<Self>

Build the route that reaches a paired device from a receiver inventory.

Picks DeviceRoute::Unifying or DeviceRoute::Bolt based on the receiver’s product ID using the canonical UNIFYING_PIDS / BOLT_PIDS lists. Any receiver PID not in UNIFYING_PIDS — including future Bolt variants whose PID isn’t yet in BOLT_PIDS — defaults to DeviceRoute::Bolt so writes keep working rather than silently dropping. DeviceRoute::Direct is used for directly-attached devices (slot == DIRECT_DEVICE_INDEX with no receiver UID). Returns None when the receiver UID is unknown (writes are skipped, not mis-routed).

Trait Implementations

impl Clone for DeviceRoute

fn clone(&self) -> DeviceRoute

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceRoute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DeviceRoute

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DeviceRoute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for DeviceRoute

impl PartialEq for DeviceRoute

fn eq(&self, other: &DeviceRoute) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DeviceRoute

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DeviceRoute