OpenLogi
功能（Features）

0x0003 · deviceInformation

读取设备静态元数据——固件实体数量与版本、单元 ID、型号 ID、传输协议标志以及可选的序列号。

设备的静态元数据：固件**实体（entities）**的数量，以及每个实体的类型（主固件、引导程序、硬件）与版本。较新版本还会暴露单元 ID、型号 ID 与序列号。

OpenLogi 读取这些信息以识别已连接的设备，并在 assets.openlogi.org 上查找其渲染图与热点元数据。

规格： Logitech HID++ 2.0 —— x0003 deviceInformation（v4）。

Function reference

The DeviceInformationFeature wrapper (0x0003) exposes:

Methods

FunctionHID++ fnSignatureReturns
get_device_info0()DeviceInformation
get_fw_info1(entity_index: u8)DeviceEntityFirmwareInfo
get_serial_number2()String

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

Types

DeviceInformation

General information about the device and its capabilities, as returned by get_device_info.

FieldTypeDescription
entity_countu8The number of firmware entities whose version information can be retrieved via get_fw_info.
unit_id[u8; 4]A 4-byte random value serving as a unique identifier (among all devices with the same model_id) for the unit. Always 0 on feature version 0.
transportDeviceTransportA bitfield stating which transport protocols the device supports. Always 0 on feature version 0.
model_id[u16; 3]A 6-byte array serving as the identifier for the device model, containing the application PIDs of the supported transports. Always 0 on feature version 0.
extended_model_idu8An additional configurable production-line attribute (e.g. device colour). Always 0 on feature version < 2.
capabilitiesDeviceInformationCapabilitiesAdditional capability flags of this feature. All capabilities flagged as unsupported on feature version < 4.

DeviceTransport

Bitfield stating which transport protocols the device supports (added in feature version 1).

FieldTypeDescription
usbboolWhether the device supports USB.
e_quadboolWhether the device supports eQuad, the protocol used by the Unifying Receiver.
btleboolWhether the device supports Bluetooth Low Energy as used by the Bolt Receiver.
bluetoothboolWhether the device supports Bluetooth.

DeviceInformationCapabilities

Bitfield stating which additional capabilities of the 0x0003 feature are supported (added in feature version 4).

FieldTypeDescription
serial_numberboolWhether serial number retrieval via get_serial_number is supported. Always false on feature version < 4.

DeviceEntityFirmwareInfo

Firmware and version information for a single device entity, as returned by get_fw_info.

FieldTypeDescription
entity_typeDeviceEntityTypeThe type of the described entity.
firmware_prefixStringA 3-letter prefix for the firmware name.
firmware_numberu8The firmware number (decoded from packed BCD).
revisionu8The firmware revision (decoded from packed BCD).
buildu16The firmware build number (decoded from packed BCD).
activeboolWhether this entity is the responding and active one. Exactly one entity is active at any given time.
transport_pidu16The transport protocol PID. Set to the actual PID for the active entity; may be zero for inactive entities.
extra_version[u8; 5]Optional extra versioning information.

DeviceEntityType

The type of a firmware entity within the device.

VariantValueDescription
MainApplication0Main application firmware entity.
Bootloader1Bootloader firmware entity.
Hardware2Hardware entity.
Touchpad3Touchpad firmware/entity.
OpticalSensor4Optical sensor entity.
Softdevice5Bluetooth SoftDevice entity.
RfCompanionMcu6RF companion MCU entity.
FactoryApplication7Factory application firmware entity.
RgbCustomEffect8RGB custom effect entity.
MotorDrive9Motor drive entity.

Wire format

All three functions use a 3-byte request payload and return a 16-byte long payload (read via extend_payload()). There are no events for this feature.

get_device_info (fn 0)

Request: [0x00, 0x00, 0x00]

Response (byte → field):

ByteFieldNotes
0entity_countNumber of firmware entities
1–4unit_id4-byte unique unit identifier; [0,0,0,0] on feature version 0
5(reserved)Not read by the implementation
6transportBitfield: bit 3 = USB, bit 2 = eQuad, bit 1 = BTLE, bit 0 = Bluetooth
7–8model_id[0]Big-endian u16; first transport PID
9–10model_id[1]Big-endian u16; second transport PID
11–12model_id[2]Big-endian u16; third transport PID
13extended_model_idProduction-line attribute (e.g. colour); 0 on feature version < 2
14capabilitiesBitfield: bit 0 = serial_number; 0 on feature version < 4

get_fw_info (fn 1)

Request: [entity_index, 0x00, 0x00]

Response (byte → field):

ByteFieldNotes
0entity_typeDeviceEntityType enum value (u8)
1–3firmware_prefix3-byte ASCII prefix of the firmware name
4firmware_numberPacked BCD u8; decoded automatically
5revisionPacked BCD u8; decoded automatically
6–7buildBig-endian u16 in packed BCD; decoded automatically
8activeBit 0: true if this entity is currently active
9–10transport_pidBig-endian u16; actual PID for the active entity, may be zero for inactive
11–15extra_version5-byte optional extra versioning information

get_serial_number (fn 2)

Request: [0x00, 0x00, 0x00]

Response (byte → field):

ByteFieldNotes
0–11serial number12-byte UTF-8 string

Check DeviceInformationCapabilities::serial_number before calling; the function is only present in feature version 4 and later.

Usage (Rust)

use hidpp::{device::Device, feature::device_information::DeviceInformationFeature};

// mut device: Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<DeviceInformationFeature>() {
    let info = feat.get_device_info().await?;
    println!("entity_count={}, unit_id={:02x?}", info.entity_count, info.unit_id);

    for i in 0..info.entity_count {
        let fw = feat.get_fw_info(i).await?;
        println!("[{}] {:?} {}{:02}.{:02} build={}", i, fw.entity_type,
            fw.firmware_prefix, fw.firmware_number, fw.revision, fw.build);
    }

    if info.capabilities.serial_number {
        let serial = feat.get_serial_number().await?;
        println!("serial={}", serial);
    }
}

0x0001 · featureSet

枚举设备实现的所有功能——读取功能总数，并按索引查询每个功能的 ID、类型标志和版本。

0x0005 · deviceTypeAndName

读取设备的市场分类（鼠标、键盘、轨迹球……）及其完整市场名称（分块读取）。

本页目录

Function referenceMethodsTypesDeviceInformationDeviceTransportDeviceInformationCapabilitiesDeviceEntityFirmwareInfoDeviceEntityTypeWire formatget_device_info (fn 0)get_fw_info (fn 1)get_serial_number (fn 2)Usage (Rust)