0x1815 · hostsInfo
Inspect Easy-Switch host slots, names, and operating systems, and rename a paired host when the device permits it.
hostsInfo describes the host channels stored by a multi-host device. It reports channel pairing, connection type, name metadata, and raw descriptor pages. It also provides paged host-name and operating-system data. OpenLogi v0.8.15 reads this data and can rename a paired channel.
Spec: No public Logitech specification. Layout reverse-engineered from Logi Options+ 2.8 (static analysis). Cross-checked: Solaar. Used by: Easy-Switch.
Function reference
HostsInfoFeature requires advertised feature version 2. It implements functions 0–4 and 7. Functions 5, 6, and 8 have no v0.8.15 wrapper.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_feature_info | 0 | () | HostsInfoFeatureInfo |
get_host_info | 1 | (host: HostIndex) | HostInfo |
get_host_descriptor | 2 | (host: HostIndex, page: u8) | HostDescriptorPage |
get_host_friendly_name | 3 | (host: HostIndex, offset: u8) | HostNameChunk |
set_host_friendly_name | 4 | (host: HostIndex, offset: u8, bytes: [u8; HOST_NAME_CHUNK_LEN]) | () |
get_host_os_version | 7 | (host: HostIndex) | HostOsVersion |
All methods are async and return Result<…, Hidpp20Error>.
Types
HostsInfoFeatureInfo
Function 0 returns static information for this feature.
| Field | Type | Description |
|---|---|---|
capabilities | HostsInfoCapabilities | High byte of the wire capability mask. |
descriptor_capabilities | HostDescriptorCapabilities | Low byte of the wire capability mask. |
host_count | u8 | Number of host channels. |
current_host | HostIndex | Current host selector or Current. |
HostInfo
Function 1 returns one host-channel record.
| Field | Type | Description |
|---|---|---|
host_index | HostIndex | Selector echoed by the device. |
status | HostSlotStatus | Empty or paired state. |
bus_type | HostBusType | Connection type. |
page_count | u8 | Number of descriptor pages. |
name_len | u8 | Current host-name length in bytes. |
name_max_len | u8 | Maximum host-name length in bytes. |
HostDescriptorPage
Function 2 returns one raw descriptor page.
| Field | Type | Description |
|---|---|---|
host_index | HostIndex | Selector echoed by the device. |
bus_type | HostBusType | OpenLogi's decode of the header's high nibble. |
page_index | u8 | OpenLogi's decode of the header's low nibble. |
body | [u8; 14] | Raw descriptor bytes. |
HostNameChunk
Function 3 returns a fixed name chunk.
| Field | Type | Description |
|---|---|---|
host_index | HostIndex | Selector echoed by the device. |
offset | u8 | Byte offset echoed by the device. |
bytes | [u8; 14] | Name bytes and any trailing padding. |
HOST_NAME_CHUNK_LEN is 14.
HostOsVersion
Function 7 returns the recorded operating system and version.
| Field | Type | Description |
|---|---|---|
host_index | HostIndex | Selector echoed by the device. |
os_type | HostOsType | Recorded operating-system type. |
major | u8 | Major version. |
minor | u16 | Minor version, decoded as BE. |
patch | u16 | Patch version, decoded as BE. |
HostIndex
| Variant | Value | Description |
|---|---|---|
Current | 0xFF | Device-selected current host channel. |
Slot(u8) | 0–254 | Explicit zero-based host channel. |
HostSlotStatus
| Variant | Value | Description |
|---|---|---|
Empty | 0 | Channel has no paired host. |
Paired | 1 | Channel has a paired host. |
HostBusType
| Variant | Value | Description |
|---|---|---|
Undefined | 0 | Undefined or unknown connection. |
Equad | 1 | eQuad wireless connection. |
Usb | 2 | USB connection. |
Bt | 3 | Bluetooth Classic connection. |
Ble | 4 | Bluetooth Low Energy connection. |
BlePro | 5 | BLE Pro / Logi Bolt connection. |
HostOsType
| Variant | Value | Description |
|---|---|---|
Unknown | 0 | No recorded operating system. |
Windows | 1 | Windows. |
WindowsEmbedded | 2 | Windows Embedded. |
Linux | 3 | Linux. |
Chrome | 4 | ChromeOS. |
Android | 5 | Android. |
MacOs | 6 | macOS. |
Ios | 7 | iOS or iPadOS. |
WebOs | 8 | webOS. |
Tizen | 9 | Tizen. |
HostsInfoCapabilities
These named flags occupy the high byte of the BE capability mask.
| Flag | Bit/Value | Description |
|---|---|---|
GET_NAME | 1 << 0 / 0x0100 | Host names can be read. Solaar cross-checks this flag. |
SET_NAME | 1 << 1 / 0x0200 | Host names can be written. Options+ 2.8 gates renaming on this flag. |
MOVE_HOST | 1 << 2 / 0x0400 | Host slots can be moved. Options+ 2.8 gates function 5 on this flag. |
DELETE_HOST | 1 << 3 / 0x0800 | Host slots can be deleted. Options+ 2.8 gates function 6 on this flag. |
SET_OS_VERSION | 1 << 4 / 0x1000 | Host OS versions can be written. Options+ 2.8 gates function 8 on this flag. |
HostDescriptorCapabilities
OpenLogi assigns these flags to the capability mask's low byte.
| Flag | Bit/Value | Description |
|---|---|---|
EQUAD | 1 << 0 / 0x0001 | OpenLogi's eQuad descriptor-family flag. |
USB | 1 << 1 / 0x0002 | OpenLogi's USB descriptor-family flag. |
BT | 1 << 2 / 0x0004 | OpenLogi's Bluetooth Classic descriptor-family flag. |
BLE | 1 << 3 / 0x0008 | OpenLogi's Bluetooth Low Energy descriptor-family flag. |
The low-byte names are not independently confirmed by a public specification.
Events
OpenLogi v0.8.15 exposes no typed HostsInfo events. The reviewed evidence establishes no unsolicited 0x1815 report layout.
Wire format
The feature uses three-byte short requests except function 4. Function 4 uses a 16-byte long request. OpenLogi reads replies through extend_payload().
get_feature_info (fn 0)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0–1 | capability_mask | One BE u16. OpenLogi exposes byte 0 and byte 1 as separate bitflags. |
| 0 | capabilities | High byte of capability_mask. Unknown bits are retained. |
| 1 | descriptor_capabilities | Low byte of capability_mask. Unknown bits are retained. |
| 2 | host_count | Number of host channels. |
| 3 | current_host | 0xFF becomes HostIndex::Current; every other value becomes Slot(n). |
The OpenLogi fields preserve the complete mask. Reconstruct it with u16::from_be_bytes([capabilities.bits(), descriptor_capabilities.bits()]).
get_host_info (fn 1)
Request: [host, 0x00, 0x00]. host is 0xFF for HostIndex::Current, or a zero-based channel number.
| Byte | Field | Notes |
|---|---|---|
| 0 | host_index | Echoed selector. |
| 1 | status | 0 is Empty; 1 is Paired. Other values fail decoding. |
| 2 | bus_type | 0=Undefined, 1=Equad, 2=Usb, 3=Bt, 4=Ble, 5=BlePro. Other values fail decoding. |
| 3 | page_count | Number of descriptor pages. |
| 4 | name_len | Current host-name length in bytes. |
| 5 | name_max_len | Maximum host-name length in bytes. |
get_host_descriptor (fn 2)
Request: [host, page, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | host_index | Echoed selector. |
| 1, bits 7–4 | bus_type | OpenLogi decodes the high nibble as HostBusType. This meaning is unverified. |
| 1, bits 3–0 | page_index | OpenLogi decodes the low nibble as the page index. This meaning is unverified. |
| 2–15 | body | Fourteen raw descriptor bytes. |
get_host_friendly_name (fn 3)
Request: [host, offset, 0x00]. offset is a byte offset, not a page number.
| Byte | Field | Notes |
|---|---|---|
| 0 | host_index | Echoed selector. |
| 1 | offset | Echoed byte offset. |
| 2–15 | bytes | Up to 14 name bytes, followed by padding when necessary. |
The wrapper returns all 14 bytes. The device layer reads chunks until name_len. It verifies the returned selector and offset before joining chunks.
set_host_friendly_name (fn 4)
OpenLogi sends a 16-byte long request and awaits the acknowledgement.
| Byte | Field | Notes |
|---|---|---|
| 0 | host | Explicit zero-based host channel. |
| 1 | offset | Byte offset into the host-name buffer. |
| 2–15 | bytes | Exactly 14 name or padding bytes. |
The raw wrapper writes the supplied bytes unchanged. The device layer writes every name_max_len byte in 14-byte chunks. It pads the final chunk with zero bytes, which clears an older name tail.
move_host (fn 5)
OpenLogi v0.8.15 does not expose this function. Options+ 2.8 uses two request bytes for the host move.
| Byte | Field | Notes |
|---|---|---|
| 0 | source host | Source host channel. Options+ 2.8. |
| 1 | destination host | Destination host channel. Options+ 2.8. |
| 2 | / | No meaning was recovered. |
Options+ 2.8 gates this operation on mask bit 0x0400. The acknowledgement layout was not recovered.
delete_host (fn 6)
OpenLogi v0.8.15 does not expose this function. Options+ 2.8 deletes one host channel.
| Byte | Field | Notes |
|---|---|---|
| 0 | host | Host channel to delete. Options+ 2.8. |
| 1–2 | / | No meaning was recovered. |
Options+ 2.8 gates this operation on mask bit 0x0800. The acknowledgement layout was not recovered.
get_host_os_version (fn 7)
Request: [host, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | host_index | Echoed selector. |
| 1 | os_type | HostOsType value. Unknown values fail decoding. |
| 2 | major | Major OS version. |
| 3–4 | minor | BE u16. |
| 5–6 | patch | BE u16. |
set_host_os_version (fn 8)
OpenLogi v0.8.15 does not expose this function. Options+ 2.8 writes the following seven bytes.
| Byte | Field | Notes |
|---|---|---|
| 0 | host | Host channel. Options+ 2.8. |
| 1 | os_type | Operating-system type. Options+ 2.8. |
| 2 | major | Major OS version. Options+ 2.8. |
| 3–4 | minor | BE u16. Options+ 2.8. |
| 5–6 | patch | BE u16. Options+ 2.8. |
| 7… | / | No layout was recovered. |
Options+ 2.8 gates this operation on mask bit 0x1000.
How OpenLogi uses it
OpenLogi requires HostsInfo version 2 before it creates the wrapper. For an Easy-Switch read, it gets function 0 and reads function 1 for every index in 0..host_count. It reads functions 3 and 7 only for paired channels. It maps the bus type to the user-facing connection type.
A device can decline functions 3 or 7. OpenLogi then leaves the name or operating system absent. A timeout, a transport failure, or a mismatched function-3 or function-7 echo fails the complete read.
A rename first reads the complete channel table. OpenLogi requires SET_NAME, a paired target channel, a non-empty trimmed UTF-8 name, and a byte length within name_max_len. It writes the full zero-padded name buffer with function 4. It then reads the table again and rejects a name that the device did not keep.
OpenLogi never automatically writes a host name or OS version. It does not call functions 5, 6, or 8. The user-facing Easy-Switch page describes the card and Automation API.
Open questions
Options+ 2.8 reads bytes 0–1 of function 0 as one BE u16 mask. OpenLogi exposes the same two bytes as two u8 bitflag sets, so no wire bits are lost. The semantic names for the low-byte descriptor flags remain unverified.
OpenLogi decodes the function-2 header as a bus-type nibble and a page-index nibble. The reviewed static evidence does not independently establish those nibble meanings.
Options+ 2.8 establishes functions 5, 6, and 8 and their observed request fields. No public specification or hardware capture confirms their remaining bytes, acknowledgements, or device support. OpenLogi intentionally leaves these persistent operations unavailable.
Usage (Rust)
use hidpp::feature::hosts_info::{HostIndex, HostSlotStatus, HostsInfoFeature};
// `device` is an initialized mutable HID++ device.
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<HostsInfoFeature>() {
let feature_info = feature.get_feature_info().await?;
for slot in 0..feature_info.host_count {
let host = feature.get_host_info(HostIndex::Slot(slot)).await?;
if host.status == HostSlotStatus::Paired {
let name = feature
.get_host_friendly_name(HostIndex::Slot(slot), 0)
.await?;
let os = feature.get_host_os_version(HostIndex::Slot(slot)).await?;
println!("slot {slot}: {:?}, {:?}", name.bytes, os.os_type);
}
}
}