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
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
count | 0 | () | u8 |
get_feature | 1 | (index: u8) | FeatureInformation |
Both methods are asynchronous and return Result<…, Hidpp20Error>.
Types
FeatureInformation
get_feature returns one entry from the feature table.
| Field | Type | Description |
|---|---|---|
id | u16 | HID++ feature ID. |
typ | FeatureType | Feature classification flags. |
version | u8 | Latest 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]
| Byte | Field | Notes |
|---|---|---|
| 0 | count | Number of feature-table entries. Root at index 0 is excluded. |
| 1–15 | trailing payload | OpenLogi ignores these bytes. |
get_feature (fn 1)
Request: [index, 0x00, 0x00]
| Byte | Field | Notes |
|---|---|---|
| 0 | index | 1-based feature-table index. Index 0 is Root and the protocol does not allow it here. OpenLogi passes the supplied value unchanged. |
| 1–2 | reserved | OpenLogi writes 0x00. |
| Byte | Field | Notes |
|---|---|---|
| 0–1 | id | Feature ID, BE. |
| 2 | typ | Feature type byte. OpenLogi decodes bits 7–3 and retains other bits. |
| 3 | version | Latest compatible feature version. |
| 4–15 | trailing payload | OpenLogi 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(())
}