0x4600 · crown

Crown 功能控制 MX Master 系列上的旋转表冠。get_info 返回硬件的 CrownControlCapabilities（按钮、长按、机械棘轮、可配置旋转超时、短长按阈值与双击速度）以及 CrownSensorCapabilities（近接、触摸、单击与双击手势），同时给出每圈的槽位数与棘轮数。 get_mode 与 set_mode 读取和写入当前的 CrownMode：事件是通过原生 HID 通道传送还是转发到 HID++（ReportingMode）、棘轮与自由旋转的选择（RatchetMode），以及三个可配置时间参数——旋转超时、短长按阈值和双击速度，均以 10 ms 为步进。SetCrownMode 的每个字段均以零 / NoChange 为"保持不变"标记，可在不影响其他参数的情况下单独更新某项设置。

转发模式下，表冠会发出单一的 CrownEvent::Update，其中携带一个 CrownUpdate 快照：

• rotation_state / relative_slot_rotation / relative_ratchet_rotation / speed —— RotationState 阶段、带符号的槽位与棘轮增量，以及当前速度（槽位/秒）。
• proximity / touch —— ActivityState 生命周期阶段（Start → Active → Stop）。
• gesture —— CrownGesture：Tap、DoubleTap 或 None。
• button —— ButtonState：Inactive、Press、ShortPressActive、LongPress、LongPressActive 或 Release。

规格： Logitech HID++ 2.0 —— 0x4600 crown。用于： openlogi-hidpp 中的类型化包装器。

Function reference

The CrownFeature wrapper (0x4600) exposes:

Methods

get_info, get_mode, and set_mode are async and return Result<…, Hidpp20Error>. listen is synchronous and returns an async_channel::Receiver<CrownEvent> directly.

Types

CrownInfo

Crown capabilities and hardware constants returned by get_info.

CrownControlCapabilities

Crown control capabilities, from get_info.

CrownSensorCapabilities

Crown sensor capabilities, from get_info.

CrownMode

The crown's current mode, returned by get_mode and echoed by set_mode.

SetCrownMode

Mode settings written by set_mode. Every field uses 0 / ReportingMode::NoChange / RatchetMode::NoChange as a "leave unchanged" sentinel. The rotation timeout is clipped to 0x40.

ReportingMode

How crown events are reported.

RatchetMode

The crown's ratchet mode.

RotationState

Rotation phase reported in a CrownUpdate.

ActivityState

Proximity or touch activity phase reported in a CrownUpdate.

CrownGesture

Touch gesture reported in a CrownUpdate.

ButtonState

Crown button state reported in a CrownUpdate.

Events

CrownFeature implements EmittingFeature<CrownEvent>; call listen() to receive a channel of CrownEvent values. Events are only delivered while the crown is diverted (ReportingMode::Diverted).

CrownEvent

CrownUpdate

Payload of CrownEvent::Update.

Wire format

Getter requests carry a 3-byte zero payload (call). set_mode uses a 16-byte long payload (call_long). All responses are read from the 16-byte extended payload returned by extend_payload(). Events arrive as unsolicited 16-byte messages on function index 0.

get_info (fn 0)

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

Response (byte → field):

get_mode (fn 1)

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

Response (byte → field):

set_mode (fn 2)

Request (16-byte long payload — bytes 5–15 are 0x00):

Response: same layout as get_mode — the device echoes the resulting active mode.

CrownEvent::Update (event fn 0)

Unsolicited event emitted while the crown is diverted:

Usage (Rust)

use hidpp::{
    device::Device,
    feature::crown::{CrownFeature, ReportingMode, RatchetMode, SetCrownMode},
};

// device: &mut Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<CrownFeature>() {
    let info = feat.get_info().await?;
    println!("slots/rev={}, ratchets/rev={}", info.slots, info.ratchets);

    // Divert crown events to HID++ and switch to ratchet mode
    let mode = feat.set_mode(SetCrownMode {
        diverting: ReportingMode::Diverted,
        ratchet_mode: RatchetMode::Ratchet,
        rotation_timeout: 0,    // leave unchanged
        short_long_timeout: 0,  // leave unchanged
        double_tap_speed: 0,    // leave unchanged
    }).await?;
    println!("active mode: {:?}", mode.diverting);

    // Receive crown events
    let rx = feat.listen();
    while let Ok(event) = rx.recv().await {
        println!("{:?}", event);
    }
}