OpenLogi

0x0001 · featureSet

Enumerate a device feature table by reading its count and each 1-based feature entry.

featureSet lists the HID++ features available during one device connection. The table excludes root, which always uses index 0. Clients read the count, then read entries 1 through that count.

Spec: Logitech HID++ 2.0 — x0001 featureSet. Cross-checked: Logi Options+ 2.8 (static analysis). Used by: Supported devices.

Function reference

The FeatureSetFeature wrapper implements feature version 0.

Methods

FunctionHID++ fnSignatureReturns
count0()u8
get_feature1(index: u8)FeatureInformation

Both methods are asynchronous and return Result<…, Hidpp20Error>.

Types

FeatureInformation

get_feature returns one entry from the feature table.

FieldTypeDescription
idu16HID++ feature ID.
typFeatureTypeFeature classification flags.
versionu8Latest compatible feature version. It is 0 for older feature-table versions.

FeatureType

FeatureType uses the same type-byte bitfield as 0x0000 root. OpenLogi retains unknown bits and exposes bits 7–3 as obsolete, hidden, engineering, manufacturing_deactivatable, and compliance_deactivatable.

Events

This feature does not define events.

Wire format

Both requests use a 3-byte short payload. OpenLogi reads replies through extend_payload(), which presents a 16-byte payload.

count (fn 0)

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

ByteFieldNotes
0countNumber of feature-table entries. Root at index 0 is excluded.
1–15trailing payloadOpenLogi ignores these bytes.

get_feature (fn 1)

Request: [index, 0x00, 0x00]

ByteFieldNotes
0index1-based feature-table index. Index 0 is Root and the protocol does not allow it here. OpenLogi passes the supplied value unchanged.
1–2reservedOpenLogi writes 0x00.
ByteFieldNotes
0–1idFeature ID, BE.
2typFeature type byte. OpenLogi decodes bits 7–3 and retains other bits.
3versionLatest compatible feature version.
4–15trailing payloadOpenLogi ignores these bytes.

How OpenLogi uses it

Device::enumerate_features() first discovers 0x0001 through Root. It calls count() once, then walks 1..=count. It registers known wrappers from each returned feature ID and version.

The feature table is immutable for the connection. Therefore, count() and get_feature() may adopt an identical reply left by an abandoned request. The device layer retries a lost table entry up to four times. Each attempt has a 700 ms deadline and a 120 ms backoff.

OpenLogi uses this table during inventory probing to derive capabilities and event feature indexes. The walk does not modify device state and needs no restore operation.

Usage (Rust)

use hidpp::{device::Device, protocol::v20::Hidpp20Error};

async fn list_features(device: &mut Device) -> Result<(), Hidpp20Error> {
    let Some(features) = device.enumerate_features().await? else {
        return Ok(());
    };

    for feature in features {
        println!("0x{:04x} at index {} (v{})", feature.id, feature.index, feature.version);
    }
    Ok(())
}

On this page