0x4531 · multiPlatform

MultiPlatform 将主机槽映射到键盘 OS 平台。它上报平台描述符，读取每个主机选择值，并可为主机持久设置选定平台。

**规格：**Logitech HID++ 2.0——multiPlatform（v1）。**交叉核对：**Logi Options+ 2.8（静态分析）、Solaar。用于：键盘功能。

函数参考

MultiPlatformFeature 只能为功能版本 1 创建。

方法

每个方法都是 async 方法，并返回 Result<…, Hidpp20Error>。

类型

MultiPlatformInfo

MultiPlatformCapabilities

能力字是 BE u16。

PlatformDescriptor

OsMask

OsMask 是描述符字节 2–3 中的 BE u16。OpenLogi 会保留未命名位。

HostPlatform

PlatformSource

HostIndex

事件

MultiPlatformFeature 没有 listen() 方法。PlatformChange::decode 为库存事件路径解码原始报告。

线格式

每个函数使用 3 字节短请求。OpenLogi 将每个响应规范化为 16 字节，再解码响应。

get_feature_infos（fn 0）

请求：0x00, 0x00, 0x00。

get_platform_descriptor（fn 1）

请求：[descriptor_index, 0x00, 0x00]。

get_host_platform（fn 2）

请求：[u8::from(host), 0x00, 0x00]。

set_host_platform（fn 3）

请求：[u8::from(host), platform_index, 0x00]。

OpenLogi 等待 HID++ 响应，但不会解析响应字节。调用 get_host_platform，可以确认持久选择值。

PlatformChange 事件

公开 v1 规格将此事件列为 0。Logi Options+ 和 OpenLogi 的库存路径会在功能索引与软件 ID 检查后，接受此功能的任意非请求函数。

OpenLogi 的用法

从 v0.8.14 起，保持 OS 布局设置使用此功能。键盘声明 SET_HOST_PLATFORM 时，此设置默认开启。

OpenLogi 读取功能信息，并要求当前主机是 host_count 范围内的编号槽。它读取全部描述符，选择覆盖主机 OS 的平台，并拒绝超出 platform_count 的索引。

OpenLogi 会在写入前读取当前槽。仅当选定平台不同时，OpenLogi 才会写入。之后，OpenLogi 会再次读取该槽，并将不匹配报告为错误。

主机 OS 可以是 macOS、Windows 或 Linux。无法取得 OS 版本时，OpenLogi 只接受没有上限版本的描述符。

库存路径会识别软件 ID 为 0 的平台变化报告，增加 settings_revision 并请求重新协调。如果保持 OS 布局仍开启，代理会在设备端变化后重新检查并恢复主机布局。

此选择会持久保存。OpenLogi 不会在退出时恢复旧平台。关闭设置会停止后续写入，但不会还原当前选择。

未确认的细节

v1 规格将事件标识为 0，而 Options+ 接受任意函数的报告。OpenLogi 的库存路径使用 Options+ 的宽松规则。

尚无硬件抓包可以确定键盘是否发送非零函数报告。OpenLogi 将每个有效的 3 字节报告视为变化提示，并重新读取权威状态。

Rust 用法

use hidpp::{
    device::Device,
    feature::{
        hosts_info::HostIndex,
        multi_platform::{MultiPlatformCapabilities, MultiPlatformFeature},
    },
};

// `device` is a discovered HID++ device.
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<MultiPlatformFeature>() {
    let info = feature.get_feature_infos().await?;
    let host = HostIndex::Current;
    let before = feature.get_host_platform(host).await?;

    if info
        .capabilities
        .contains(MultiPlatformCapabilities::SET_HOST_PLATFORM)
    {
        // The caller must obtain this index from a compatible descriptor.
        feature.set_host_platform(host, 0).await?;
        let after = feature.get_host_platform(host).await?;
        println!("{before:?} -> {after:?}");
    }
}