0x1815 · hostsInfo

适用于可同时与多台主机配对的 Bolt / BLE / eQuad 设备的多主机管理功能。getFeatureInfo（function 0）返回主机槽总数、当前活跃槽以及两个能力位掩码。getHostInfo（function 1）查询任意槽的配对状态、总线类型与友好名称元数据。getHostDescriptor（function 2）读取该槽传输连接的原始描述符中的单页内容。

• HostIndex——Current（设备自选，线缆值 0xFF）或 Slot(n)（零起始）。
• HostSlotStatus——Empty 或 Paired。
• HostBusType——Equad、Usb、Bt、Ble、BlePro（Logi Bolt）或 Undefined。
• HostsInfoCapabilities——位标志，表明设备对 GET_NAME、SET_NAME、MOVE_HOST、DELETE_HOST、SET_OS_VERSION 的支持情况。
• HostDescriptorCapabilities——支持的描述符系列位标志：EQUAD、USB、BT、BLE。

规格： Logitech HID++ 2.0 —— hostsInfo。用于： openlogi-hidpp 中的类型化封装。

Function reference

The HostsInfoFeature wrapper (0x1815) exposes:

Methods

All methods are async and return Result<…, Hidpp20Error>.

Types

HostsInfoFeatureInfo

Static information about the HostsInfo feature.

HostInfo

Information about one host slot.

HostDescriptorPage

Raw host descriptor page.

HostIndex

A host slot selector.

HostSlotStatus

Pairing status for a host slot.

HostBusType

Bus type associated with a host slot.

HostsInfoCapabilities

Host-management capabilities.

HostDescriptorCapabilities

Supported host descriptor families.

Wire format

All three functions use a 3-byte request payload and return a 16-byte long response payload (accessed via extend_payload()).

get_feature_info (fn 0)

Request: [0x00, 0x00, 0x00] (no parameters)

Response (byte → field):

get_host_info (fn 1)

Request: [host, 0x00, 0x00] — byte 0 = HostIndex as u8 (0xFF for Current, slot index otherwise)

Response (byte → field):

get_host_descriptor (fn 2)

Request: [host, page, 0x00] — byte 0 = HostIndex as u8, byte 1 = descriptor page index

Response (byte → field):

Usage (Rust)

use hidpp::{device::Device, feature::hosts_info::{HostsInfoFeature, HostIndex}};

// mut device: Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<HostsInfoFeature>() {
    let info = feat.get_feature_info().await?;
    println!("slots: {}, current: {:?}", info.host_count, info.current_host);

    for slot in 0..info.host_count {
        let host = feat.get_host_info(HostIndex::Slot(slot)).await?;
        println!("slot {slot}: {:?} via {:?}", host.status, host.bus_type);

        for page in 0..host.page_count {
            let desc = feat.get_host_descriptor(HostIndex::Slot(slot), page).await?;
            println!("  page {}: bus={:?} body={:?}", desc.page_index, desc.bus_type, desc.body);
        }
    }
}