OpenLogi

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

FunctionHID++ fnSignatureReturns
get_feature_info0()HostsInfoFeatureInfo
get_host_info1(host: HostIndex)HostInfo
get_host_descriptor2(host: HostIndex, page: u8)HostDescriptorPage
get_host_friendly_name3(host: HostIndex, offset: u8)HostNameChunk
set_host_friendly_name4(host: HostIndex, offset: u8, bytes: [u8; HOST_NAME_CHUNK_LEN])()
get_host_os_version7(host: HostIndex)HostOsVersion

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

Types

HostsInfoFeatureInfo

Function 0 returns static information for this feature.

FieldTypeDescription
capabilitiesHostsInfoCapabilitiesHigh byte of the wire capability mask.
descriptor_capabilitiesHostDescriptorCapabilitiesLow byte of the wire capability mask.
host_countu8Number of host channels.
current_hostHostIndexCurrent host selector or Current.

HostInfo

Function 1 returns one host-channel record.

FieldTypeDescription
host_indexHostIndexSelector echoed by the device.
statusHostSlotStatusEmpty or paired state.
bus_typeHostBusTypeConnection type.
page_countu8Number of descriptor pages.
name_lenu8Current host-name length in bytes.
name_max_lenu8Maximum host-name length in bytes.

HostDescriptorPage

Function 2 returns one raw descriptor page.

FieldTypeDescription
host_indexHostIndexSelector echoed by the device.
bus_typeHostBusTypeOpenLogi's decode of the header's high nibble.
page_indexu8OpenLogi's decode of the header's low nibble.
body[u8; 14]Raw descriptor bytes.

HostNameChunk

Function 3 returns a fixed name chunk.

FieldTypeDescription
host_indexHostIndexSelector echoed by the device.
offsetu8Byte 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.

FieldTypeDescription
host_indexHostIndexSelector echoed by the device.
os_typeHostOsTypeRecorded operating-system type.
majoru8Major version.
minoru16Minor version, decoded as BE.
patchu16Patch version, decoded as BE.

HostIndex

VariantValueDescription
Current0xFFDevice-selected current host channel.
Slot(u8)0–254Explicit zero-based host channel.

HostSlotStatus

VariantValueDescription
Empty0Channel has no paired host.
Paired1Channel has a paired host.

HostBusType

VariantValueDescription
Undefined0Undefined or unknown connection.
Equad1eQuad wireless connection.
Usb2USB connection.
Bt3Bluetooth Classic connection.
Ble4Bluetooth Low Energy connection.
BlePro5BLE Pro / Logi Bolt connection.

HostOsType

VariantValueDescription
Unknown0No recorded operating system.
Windows1Windows.
WindowsEmbedded2Windows Embedded.
Linux3Linux.
Chrome4ChromeOS.
Android5Android.
MacOs6macOS.
Ios7iOS or iPadOS.
WebOs8webOS.
Tizen9Tizen.

HostsInfoCapabilities

These named flags occupy the high byte of the BE capability mask.

FlagBit/ValueDescription
GET_NAME1 << 0 / 0x0100Host names can be read. Solaar cross-checks this flag.
SET_NAME1 << 1 / 0x0200Host names can be written. Options+ 2.8 gates renaming on this flag.
MOVE_HOST1 << 2 / 0x0400Host slots can be moved. Options+ 2.8 gates function 5 on this flag.
DELETE_HOST1 << 3 / 0x0800Host slots can be deleted. Options+ 2.8 gates function 6 on this flag.
SET_OS_VERSION1 << 4 / 0x1000Host 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.

FlagBit/ValueDescription
EQUAD1 << 0 / 0x0001OpenLogi's eQuad descriptor-family flag.
USB1 << 1 / 0x0002OpenLogi's USB descriptor-family flag.
BT1 << 2 / 0x0004OpenLogi's Bluetooth Classic descriptor-family flag.
BLE1 << 3 / 0x0008OpenLogi'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].

ByteFieldNotes
0–1capability_maskOne BE u16. OpenLogi exposes byte 0 and byte 1 as separate bitflags.
0capabilitiesHigh byte of capability_mask. Unknown bits are retained.
1descriptor_capabilitiesLow byte of capability_mask. Unknown bits are retained.
2host_countNumber of host channels.
3current_host0xFF 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.

ByteFieldNotes
0host_indexEchoed selector.
1status0 is Empty; 1 is Paired. Other values fail decoding.
2bus_type0=Undefined, 1=Equad, 2=Usb, 3=Bt, 4=Ble, 5=BlePro. Other values fail decoding.
3page_countNumber of descriptor pages.
4name_lenCurrent host-name length in bytes.
5name_max_lenMaximum host-name length in bytes.

get_host_descriptor (fn 2)

Request: [host, page, 0x00].

ByteFieldNotes
0host_indexEchoed selector.
1, bits 7–4bus_typeOpenLogi decodes the high nibble as HostBusType. This meaning is unverified.
1, bits 3–0page_indexOpenLogi decodes the low nibble as the page index. This meaning is unverified.
2–15bodyFourteen raw descriptor bytes.

get_host_friendly_name (fn 3)

Request: [host, offset, 0x00]. offset is a byte offset, not a page number.

ByteFieldNotes
0host_indexEchoed selector.
1offsetEchoed byte offset.
2–15bytesUp 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.

ByteFieldNotes
0hostExplicit zero-based host channel.
1offsetByte offset into the host-name buffer.
2–15bytesExactly 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.

ByteFieldNotes
0source hostSource host channel. Options+ 2.8.
1destination hostDestination 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.

ByteFieldNotes
0hostHost 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].

ByteFieldNotes
0host_indexEchoed selector.
1os_typeHostOsType value. Unknown values fail decoding.
2majorMajor OS version.
3–4minorBE u16.
5–6patchBE u16.

set_host_os_version (fn 8)

OpenLogi v0.8.15 does not expose this function. Options+ 2.8 writes the following seven bytes.

ByteFieldNotes
0hostHost channel. Options+ 2.8.
1os_typeOperating-system type. Options+ 2.8.
2majorMajor OS version. Options+ 2.8.
3–4minorBE u16. Options+ 2.8.
5–6patchBE 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);
        }
    }
}

On this page