# Docs - Documentation - [Introduction](/en/docs/introduction): A native, local-first alternative to Logitech Options+, written in Rust — no account, no telemetry. - Getting Started - [Getting Started](/en/docs/getting-started): Overview of the three steps needed to install, connect, and start using OpenLogi. - [Installation](/en/docs/getting-started/installation): How to install OpenLogi on macOS, Linux, or Windows via Homebrew, package manager, or direct download. - [Connect a device](/en/docs/getting-started/connect-device): How to connect a Logitech mouse via receiver, Bluetooth, or USB and verify it appears in OpenLogi. - [Quick tour](/en/docs/getting-started/quick-tour): A brief walkthrough of the OpenLogi GUI — device carousel, button mapping, DPI presets, and per-app profiles. - Guide - [Guide](/en/docs/guide): An overview of OpenLogi's features with links to each user-guide section. - [Remap buttons](/en/docs/guide/remap-buttons): Reassign mouse buttons to any of 41 built-in actions via the interactive diagram or config file. - [DPI presets](/en/docs/guide/dpi): Set pointer resolution and manage an ordered DPI preset list that cycles from a hardware button. - [SmartShift](/en/docs/guide/smartshift): Control scroll-wheel mode between ratchet and free-spin, set the auto-release threshold, and bind the toggle to a button. - [Lighting](/en/docs/guide/lighting): Set a static RGB color and brightness on wired Logitech G-series keyboards. - [Per-app profiles](/en/docs/guide/profiles): Automatically swap button bindings based on the frontmost app by authoring per-app overlays in config.toml. - [Configuration](/en/docs/guide/configuration): Reference for the TOML config file — location, schema, all keys, actions, and gesture bindings. - Project - [Architecture](/en/docs/project/architecture): An overview of OpenLogi's components — GUI, agent, CLI, HID++ crate, and asset host. - [Roadmap](/en/docs/project/roadmap): A feature-by-feature status table showing what OpenLogi supports today and what is still in progress. - [Contributing](/en/docs/project/contributing): How to get the source, build from it, and contribute testing or code to OpenLogi. - [Changelog](/en/docs/changelog): Every OpenLogi release, pulled from the project's GitHub Releases. - HID++ Reference - [HID++ Reference](/en/hidpp): Logitech's vendor protocol for configuring mice, keyboards, and receivers over USB HID — the same protocol Options+ uses, spoken directly by OpenLogi. - [Receivers](/en/hidpp/receivers): The USB dongles that wireless Logitech devices pair to, driven through HID++ 1.0 registers and identified by USB vendor/product ID. - Features - [Features](/en/hidpp/features): The catalogue of HID++ 2.0 features, each identified by a 16-bit ID, with per-feature support status in OpenLogi. - [0x0000 · root](/en/hidpp/features/x0000-root): The HID++ 2.0 entry point — map a feature ID to its session index and verify the link with a ping. - [0x0001 · featureSet](/en/hidpp/features/x0001-featureset): Enumerate all features a device implements — read the count and look up each feature's ID, type flags, and version by index. - [0x0003 · deviceInformation](/en/hidpp/features/x0003-device-information): Read static device metadata — firmware entity count and version per entity, unit ID, model ID, transport flags, and optional serial number. - [0x0005 · deviceTypeAndName](/en/hidpp/features/x0005-device-type-and-name): Read a device's marketing category (mouse, keyboard, trackball, …) and its full marketing name, retrieved in chunks. - [0x0007 · deviceFriendlyName](/en/hidpp/features/x0007-device-friendly-name): Read or write the user-assigned friendly name of a device, and reset it to the factory default. - [0x00c2 · dfuControlSigned](/en/hidpp/features/x00c2-dfu-control-signed): Gate entry into DFU mode with a cryptographic signature check before a firmware image transfer can begin. - [0x00d0 · dfu](/en/hidpp/features/x00d0-dfu): Stream a signed firmware image to a device already in DFU mode — write chunks, track progress, and trigger verification and restart. - [0x1000 · batteryStatus](/en/hidpp/features/x1000-battery-status): Query a wireless device's battery charge level and charging status — a legacy alternative to the newer 0x1004 unifiedBattery feature. - [0x1001 · batteryVoltage](/en/hidpp/features/x1001-battery-voltage): Legacy battery feature that exposes raw voltage and a coarse charge level — superseded by 0x1004 unifiedBattery. - [0x1004 · unifiedBattery](/en/hidpp/features/x1004-unified-battery): Modern unified battery feature — query charge percentage, coarse level, and charging status, with live push events. - [0x1010 · chargingControl](/en/hidpp/features/x1010-charging-control): Read and configure a rechargeable device's charging behaviour — including charge-limit modes that cap the maximum charge level for battery health. - [0x1802 · deviceReset](/en/hidpp/features/x1802-device-reset): Trigger a firmware soft reset on a HID++ 2.0 peripheral — equivalent to a power cycle, used in firmware-update and recovery workflows. - [0x1805 · oobState](/en/hidpp/features/x1805-oob-state): Query or restore a device's out-of-box (factory-default) state — useful for detecting first-run devices or resetting provisioning state. - [0x1814 · changeHost](/en/hidpp/features/x1814-change-host): Query the number of host slots on a multi-host device and switch the active connection — with per-slot cookie management for enhanced fallback behaviour. - [0x1815 · hostsInfo](/en/hidpp/features/x1815-hosts-info): Rich multi-host management for Bolt/BLE/eQuad devices — enumerate host slots, query pairing status and bus type, and read raw transport descriptors. - [0x1981 · backlight](/en/hidpp/features/x1981-backlight1): First-generation keyboard backlight control — query and set the on/off state, brightness level, and ambient-light sensor mode. - [0x1982 · backlight](/en/hidpp/features/x1982-backlight): Full keyboard backlight control — read or write persistent config (mode, brightness, effects, fade-out timers) and subscribe to hardware change events. - [0x1990 · illumination](/en/hidpp/features/x1990-illumination): Device illumination control — toggle the light on or off and independently read or write brightness (Lumens) and color temperature (Kelvin). - [0x1a00 · presenterControl](/en/hidpp/features/x1a00-presenter-control): Presenter remote control interface — enumerate slide-navigation buttons and divert their events to host software instead of default HID reports. - [0x1b00 · reprogControls](/en/hidpp/features/x1b00-reprog-controls): Early-generation control enumeration and diversion — query the device's programmable button table and redirect individual controls to HID++ events. - [0x1B04 · specialKeysMSEButtons](/en/hidpp/features/x1b04-special-keys-mse-buttons): Full control enumeration and diversion — enumerate every button and key, then divert, persistently remap, or stream raw pointer and wheel events per control. - [0x1C00 · persistentRemappableAction](/en/hidpp/features/x1c00-persistent-remappable-action): Non-volatile control remapping — read or write per-control, per-host action assignments (keys, mouse buttons, consumer codes, internal functions) stored in device memory. - [0x1D4B · wirelessDeviceStatus](/en/hidpp/features/x1d4b-wireless-device-status): Event-only feature that fires a status broadcast when the wireless link changes — signalling reconnection and optionally requesting a host software reconfiguration. - [0x2001 · swapLeftRightButton](/en/hidpp/features/x2001-swap-left-right-button): Swap the primary and secondary mouse buttons at the firmware level — making the device behave as a left-handed mouse without any OS-level remapping. - [0x2100 · verticalScrolling](/en/hidpp/features/x2100-vertical-scrolling): Read the physical characteristics of the vertical scroll wheel — roller type, ratchets per turn, and the device's preferred scroll quantum. - [0x2110 · smartShift](/en/hidpp/features/x2110-smartshift): Read or write the scroll wheel mode (free-spin or ratchet) and the speed threshold at which the wheel automatically disengages into free-spin. - [0x2111 · smartShiftEnhanced](/en/hidpp/features/x2111-smartshift-enhanced): Enhanced SmartShift — read or write the wheel mode, auto-disengage speed threshold, and tunable ratchet torque on current MX-line mice. - [0x2120 · highResolutionScrolling](/en/hidpp/features/x2120-high-resolution-scrolling): Older feature for querying and enabling fine-grained high-resolution wheel reporting — a predecessor to 0x2121 hiResWheel without ratchet-mode switching. - [0x2121 · hiResWheel](/en/hidpp/features/x2121-hires-wheel): High-resolution scroll wheel — read capabilities, get or set the wheel mode (resolution, ratchet vs. free-spin, event routing), and listen for diverted scroll and ratchet-switch events. - [0x2150 · thumbwheel](/en/hidpp/features/x2150-thumbwheel): Horizontal thumb-wheel control — query capabilities, divert rotation events from HID to HID++, and read touch and tap status. - [0x2200 · mousePointer](/en/hidpp/features/x2200-mouse-pointer): Read optical-sensor resolution and pointer-tuning hints — acceleration curve, OS-ballistics preference, and vertical-tuning suggestion. - [0x2201 · adjustableDpi](/en/hidpp/features/x2201-adjustable-dpi): Per-sensor pointer resolution — read the sensor count, enumerate supported DPI values, and read or write the active DPI. - [0x2202 · extendedAdjustableDpi](/en/hidpp/features/x2202-extended-adjustable-dpi): Extended per-sensor DPI control — independent X/Y resolution, lift-off distance, DPI-status LED, and firmware or host-side calibration. - [0x40a0 · fnInversion](/en/hidpp/features/x40a0-fn-inversion): Earliest Fn-lock feature — read or write whether F-row keys act as function keys or secondary media/action keys by default. - [0x40A2 · fnInversionWithDefaultState](/en/hidpp/features/x40a2-fn-inversion): Single-host Fn-lock toggle — read or write the global function-key inversion state alongside the device's factory default. - [0x40A3 · fnInversionMultiHost](/en/hidpp/features/x40a3-fn-inversion-multi-host): Per-host-slot Fn-lock control — read or write the function-key inversion state independently for each paired host slot. - [0x4301 · solarKeyboardDashboard](/en/hidpp/features/x4301-solar-keyboard-dashboard): Battery and ambient-light monitoring for solar keyboards — schedule periodic light-measure reports, override the CheckLight LED color, and receive battery and lux broadcast events. - [0x4520 · keyboardLayout](/en/hidpp/features/x4520-keyboard-layout): Query or override the physical keyboard locale — identifies the regional key-cap arrangement (QWERTY, AZERTY, QWERTZ, etc.) stored in the device. - [0x4521 · disableKeys](/en/hidpp/features/x4521-disable-keys): Selectively disable a fixed set of lock and system keys — query device capabilities, read the active disabled-key mask, and atomically replace it. - [0x4522 · disableKeysByUsage](/en/hidpp/features/x4522-disable-keys-by-usage): Disable or re-enable arbitrary keyboard keys by HID usage code — cumulatively add or remove usages from the disabled set, or clear all at once. - [0x4530 · dualPlatform](/en/hidpp/features/x4530-dual-platform): Persist and switch a device's HID key-code table between two OS families (iOS/macOS vs. Android/Windows) — read or write the selection and receive hardware-button change events. - [0x4531 · multiPlatform](/en/hidpp/features/x4531-multi-platform): Associate each host slot with an OS platform on a multi-host device — query feature capabilities and platform descriptors, and read the platform assigned to any host slot. - [0x4600 · crown](/en/hidpp/features/x4600-crown): Control the MX Master rotary crown — query hardware capabilities, read or write reporting and ratchet mode, and receive diverted rotation, touch, gesture, and button events. - [0x6020 · tapEnable](/en/hidpp/features/x6020-tap-enable): Read or write the tap-to-click enabled state of an integrated or standalone touchpad. - [0x6100 · touchpadRawXY](/en/hidpp/features/x6100-touchpad-raw-xy): Stream raw multi-touch finger coordinates from an integrated touchpad — query pad dimensions and DPI, configure report flags, and receive per-frame touch events. - [0x6110 · touchMouseRawTouchPoints](/en/hidpp/features/x6110-touch-mouse-raw): Access raw touch-point data from a touch mouse — query pad geometry, select a raw reporting mode, and receive up to four simultaneous finger contacts per event. - [0x6500 · gestures](/en/hidpp/features/x6500-gestures1): First-generation touch-gesture API — enumerate supported gesture types, enable or disable gesture delivery, and receive classified gesture events from a touch surface. - [0x6501 · gestures2](/en/hidpp/features/x6501-gestures2): Second-generation touch-gesture configuration — enumerate, enable, disable, and tune individual gesture types with per-gesture thresholds and notification routing. - [0x8010 · gamingGKeys](/en/hidpp/features/x8010-gaming-g-keys): Query and configure the programmable G-keys on a Logitech gaming keyboard — read the key count, read or write per-key assignments, and receive G-key press events. - [0x8020 · gamingMKeys](/en/hidpp/features/x8020-gaming-m-keys): Control the M-key macro-bank buttons on a Logitech gaming keyboard — query or set the active profile bank and receive bank-change events from the device. - [0x8030 · macroRecord](/en/hidpp/features/x8030-macro-record): On-the-fly macro recording for gaming keyboards — start and stop capture sessions, target a G-key slot, and store timed keystroke sequences in onboard memory. - [0x8040 · brightnessControl](/en/hidpp/features/x8040-brightness-control): Device backlight brightness control — read the supported range and step count, get or set the brightness level, and independently toggle illumination on or off. - [0x8060 · adjustableReportRate](/en/hidpp/features/x8060-report-rate): Legacy HID report rate control — enumerate supported polling intervals from 1 ms to 8 ms, then read or write the active interval. - [0x8061 · extendedAdjustableReportRate](/en/hidpp/features/x8061-extended-report-rate): High-frequency polling control — query supported rates up to 8000 Hz per connection type (wired or gaming wireless), then read or set the active rate. - [0x8070 · colorLedEffects](/en/hidpp/features/x8070-color-led-effects): Per-zone RGB effect engine — enumerate LED zones and their supported effects, apply effects with configurable persistence, and synchronize timing with the host. - [0x8071 · rgbEffects](/en/hidpp/features/x8071-rgb-effects): Modern per-cluster RGB effect engine — claim software control, apply effects with volatile or persistent storage per cluster, and manage power modes and sync events. - [0x8080 · perKeyLighting](/en/hidpp/features/x8080-per-key-lighting): Legacy per-key RGB lighting control — query populated zone IDs, stage per-zone colours, and commit a frame to the display with optional non-volatile persistence. - [0x8081 · perKeyLighting](/en/hidpp/features/x8081-per-key-lighting): Per-key (per-zone) RGB lighting control — stage colours across up to 256 individually addressed zones and commit them with frame timing and optional EEPROM persistence. - [0x8090 · modeStatus](/en/hidpp/features/x8090-mode-status): Read or write a device's operating mode — toggling between performance and endurance via a bitmask-controlled status register, with hardware and software switch capability discovery. - [0x8100 · onboardProfiles](/en/hidpp/features/x8100-onboard-profiles): Full host access to onboard flash profiles — enumerate, activate, read, write, and factory-reset named slots storing DPI levels, button remappings, and lighting preferences. - [0x8110 · mouseButtonFilter](/en/hidpp/features/x8110-mouse-button-filter): Control which physical mouse buttons are forwarded to the OS as HID reports — selectively suppress individual buttons at the firmware level so host software can handle them instead. - [0x8111 · latencyMonitoring](/en/hidpp/features/x8111-latency-monitoring): On-device end-to-end input latency measurement — trigger or read firmware-recorded round-trip timing from physical input event to USB or wireless report delivery. - [0x8123 · forceFeedback](/en/hidpp/features/x8123-force-feedback): Host-side control over force-feedback actuators in gaming peripherals — discover supported effect types, create and manage effects, and control playback gain and autocenter strength. - [0x8300 · sidetone](/en/hidpp/features/x8300-sidetone): Headset sidetone control — read or write the microphone-to-ear playback level (0–100) and per-channel mute state so wearers can hear their own voice while speaking. - [0x8310 · equalizer](/en/hidpp/features/x8310-equalizer): Per-band audio equalizer and microphone noise reduction for HID++ headsets — query band count and gain limits, read or write per-band gains with configurable persistence, and toggle noise reduction. # Docs - 使用文档 - [介绍](/zh/docs/introduction): 原生、本地优先的 Logitech Options+ 替代品，使用 Rust 编写——无需账号，无遥测。 - 快速开始 - [快速开始](/zh/docs/getting-started): 概述安装、连接设备并开始使用 OpenLogi 所需的三个步骤。 - [安装](/zh/docs/getting-started/installation): 介绍如何通过 Homebrew、包管理器或直接下载在 macOS、Linux 或 Windows 上安装 OpenLogi。 - [连接设备](/zh/docs/getting-started/connect-device): 介绍如何通过接收器、蓝牙或 USB 连接 Logitech 鼠标，并确认设备在 OpenLogi 中正确显示。 - [快速上手](/zh/docs/getting-started/quick-tour): 简要介绍 OpenLogi GUI 的核心界面——设备轮播、按键映射、DPI 预设与按应用配置。 - 使用指南 - [使用指南](/zh/docs/guide): OpenLogi 各项功能的概览，附各章节链接。 - [重映射按键](/zh/docs/guide/remap-buttons): 通过交互式示意图或配置文件，将鼠标按键重新指定为 41 个内置动作中的任意一个。 - [DPI 预设](/zh/docs/guide/dpi): 设置鼠标指针分辨率，并管理一份可由硬件按键循环切换的有序 DPI 预设列表。 - [SmartShift](/zh/docs/guide/smartshift): 在棘轮与自由滚动之间切换滚轮模式，调整自动脱开阈值，并可将切换动作绑定到硬件按键。 - [灯效](/zh/docs/guide/lighting): 为有线 Logitech G 系列键盘设置静态 RGB 颜色与亮度。 - [按应用配置](/zh/docs/guide/profiles): 在 config.toml 中编写按应用覆盖层，让 OpenLogi 根据前台应用自动切换按键绑定。 - [配置](/zh/docs/guide/configuration): TOML 配置文件的完整参考——文件位置、结构、所有字段、动作列表与手势绑定说明。 - 项目 - [架构](/zh/docs/project/architecture): 概述 OpenLogi 的各组成部分——GUI、agent、CLI、HID++ crate 及静态资源服务。 - [路线图](/zh/docs/project/roadmap): 按功能逐项列出 OpenLogi 当前的支持状态与仍在开发中的能力。 - [参与贡献](/zh/docs/project/contributing): 如何获取源码、本地构建，以及通过测试或代码向 OpenLogi 贡献力量。 - [更新日志](/zh/docs/changelog): OpenLogi 每个版本的发布记录，自动从项目的 GitHub Releases 生成。 - HID++ 参考 - [HID++ 参考](/zh/hidpp): Logitech 用于通过 USB HID 配置鼠标、键盘与接收器的厂商协议——与 Options+ 相同，OpenLogi 直接使用它。 - [Receivers](/zh/hidpp/receivers): 无线 Logitech 设备配对所用的 USB 接收器，通过 HID++ 1.0 寄存器驱动，以 USB 厂商/产品 ID 识别。 - 功能（Features） - [Features](/zh/hidpp/features): OpenLogi 识别的 HID++ 2.0 功能目录，每个功能由 16 位 ID 标识，并附支持状态。 - [0x0000 · root](/zh/hidpp/features/x0000-root): HID++ 2.0 的入口——将功能 ID 映射为会话索引，并通过 ping 验证链路是否正常。 - [0x0001 · featureSet](/zh/hidpp/features/x0001-featureset): 枚举设备实现的所有功能——读取功能总数，并按索引查询每个功能的 ID、类型标志和版本。 - [0x0003 · deviceInformation](/zh/hidpp/features/x0003-device-information): 读取设备静态元数据——固件实体数量与版本、单元 ID、型号 ID、传输协议标志以及可选的序列号。 - [0x0005 · deviceTypeAndName](/zh/hidpp/features/x0005-device-type-and-name): 读取设备的市场分类（鼠标、键盘、轨迹球……）及其完整市场名称（分块读取）。 - [0x0007 · deviceFriendlyName](/zh/hidpp/features/x0007-device-friendly-name): 读取或写入设备的用户自定义名称，并支持将其重置为出厂默认名称。 - [0x1004 · unifiedBattery](/zh/hidpp/features/x1004-unified-battery): 现代统一电量功能——一次调用即可读取充电百分比、粗略等级与充电状态，并支持设备主动推送实时更新。 - [0x1814 · changeHost](/zh/hidpp/features/x1814-change-host): 查询多主机设备的槽位数量并切换当前连接，同时支持每槽 cookie 管理以实现增强型连接失败回退。 - [0x1815 · hostsInfo](/zh/hidpp/features/x1815-hosts-info): 适用于 Bolt/BLE/eQuad 设备的完整多主机管理——枚举槽位、查询配对状态与总线类型并读取原始传输描述符。 - [0x1982 · backlight](/zh/hidpp/features/x1982-backlight): 完整的键盘背光控制——读写持久化配置（模式、亮度、特效、淡出时长）并订阅硬件背光变更事件。 - [0x1990 · illumination](/zh/hidpp/features/x1990-illumination): 设备照明灯控制——整体开关照明，并独立读写亮度（流明）与色温（开尔文）。 - [0x1b00 · reprogControls](/zh/hidpp/features/x1b00-reprog-controls): 早期版本的控件枚举与转发——查询设备可编程按键表，并将指定控件的报告重定向为 HID++ 事件。 - [0x1B04 · specialKeysMSEButtons](/zh/hidpp/features/x1b04-special-keys-mse-buttons): 完整的控件枚举与转发——枚举所有按键和按钮，并对每个控件进行临时转发、持久重映射或原始指针/滚轮事件流订阅。 - [0x1C00 · persistentRemappableAction](/zh/hidpp/features/x1c00-persistent-remappable-action): 非易失性控件重映射——按控件和主机槽读写持久化动作配置（按键、鼠标按键、消费者控制码、内部函数），映射存储于设备存储中。 - [0x1D4B · wirelessDeviceStatus](/zh/hidpp/features/x1d4b-wireless-device-status): 纯事件功能，当设备无线链路变化（如重连）时发出状态广播，并可请求主机软件重新加载配置。 - [0x2001 · swapLeftRightButton](/zh/hidpp/features/x2001-swap-left-right-button): 在固件层面互换鼠标主键与副键的角色，使设备无需操作系统配置即可作为左手鼠标使用，且设置持久保存于设备中。 - [0x2100 · verticalScrolling](/zh/hidpp/features/x2100-vertical-scrolling): 读取设备垂直滚轮的物理特性——滚轮类型、每圈棘齿数，以及设备首选的滚动量（系统默认、固定行数或整页）。 - [0x2110 · smartShift](/zh/hidpp/features/x2110-smartshift): 读取或写入滚轮模式（自由滚动或棘轮）及滚轮自动脱开进入自由滚动的速度阈值。 - [0x2111 · smartShiftEnhanced](/zh/hidpp/features/x2111-smartshift-enhanced): 增强版 SmartShift——读取或写入当代 MX 系列鼠标的滚轮模式、自动脱开速度阈值与可调棘轮扭矩。 - [0x2120 · highResolutionScrolling](/zh/hidpp/features/x2120-high-resolution-scrolling): 较早的高分辨率滚轮功能，可查询并启用细粒度滚轮上报，是 0x2121 hiResWheel 的前身，不支持棘轮模式切换。 - [0x2121 · hiResWheel](/zh/hidpp/features/x2121-hires-wheel): 高分辨率滚轮——读取硬件能力、获取或设置滚轮模式（分辨率、棘轮或自由滚动、事件路由），并可监听转发的滚动与棘轮切换事件。 - [0x2150 · thumbwheel](/zh/hidpp/features/x2150-thumbwheel): 横向拇指轮控制——查询能力、将滚轮转动事件从 HID 转向 HID++，并读取触摸与轻点状态。 - [0x2200 · mousePointer](/zh/hidpp/features/x2200-mouse-pointer): 读取光学传感器分辨率与指针调校提示——包括加速曲线建议、系统弹道偏好及垂直方向微调标志。 - [0x2201 · adjustableDpi](/zh/hidpp/features/x2201-adjustable-dpi): 逐传感器的指针分辨率——读取传感器数量、枚举支持的 DPI 值并读写当前 DPI。 - [0x2202 · extendedAdjustableDpi](/zh/hidpp/features/x2202-extended-adjustable-dpi): 扩展的逐传感器 DPI 控制——独立 X/Y 分辨率、离地距离调节、DPI 状态 LED 管理，以及固件或主机侧校准流程。 - [0x40A2 · fnInversionWithDefaultState](/zh/hidpp/features/x40a2-fn-inversion): 单主机 Fn 锁开关——读取或写入全局功能键翻转状态，同时返回设备的出厂默认值。 - [0x40A3 · fnInversionMultiHost](/zh/hidpp/features/x40a3-fn-inversion-multi-host): 多主机槽位 Fn 锁控制——为每个已配对的主机槽位独立读取或写入功能键翻转状态。 - [0x4301 · solarKeyboardDashboard](/zh/hidpp/features/x4301-solar-keyboard-dashboard): 太阳能键盘的电池与环境光监测——调度周期性光照报告、覆盖 CheckLight LED 颜色，并接收包含电量与勒克斯值的广播事件。 - [0x4521 · disableKeys](/zh/hidpp/features/x4521-disable-keys): 选择性禁用固定的锁定键与系统键——查询设备能力、读取当前禁用掩码并原子地替换它。 - [0x4522 · disableKeysByUsage](/zh/hidpp/features/x4522-disable-keys-by-usage): 通过 HID Usage 码禁用或重新启用任意键盘按键——累积地向禁用集合添加或移除 Usage，或一次性全部清除。 - [0x4530 · dualPlatform](/zh/hidpp/features/x4530-dual-platform): 在两种操作系统族（iOS/macOS 与 Android/Windows）之间持久化并切换设备的 HID 键码表——读写当前选择并接收硬件按钮切换事件。 - [0x4531 · multiPlatform](/zh/hidpp/features/x4531-multi-platform): 为多主机设备的每个主机槽关联操作系统平台——查询功能能力与平台描述符，并读取任意主机槽当前分配的平台及其选择来源。 - [0x4600 · crown](/zh/hidpp/features/x4600-crown): 控制 MX Master 旋转表冠——查询硬件能力、读写上报模式与棘轮模式，并接收转发的旋转、触摸、手势与按钮事件。 - [0x6100 · touchpadRawXY](/zh/hidpp/features/x6100-touchpad-raw-xy): 从集成触控板流式获取原始多点触控坐标——查询触摸板尺寸与 DPI、配置上报标志并接收逐帧触点事件。 - [0x6110 · touchMouseRawTouchPoints](/zh/hidpp/features/x6110-touch-mouse-raw): 获取触控鼠标的原始触点数据——查询触摸板几何参数、选择原始上报模式并接收每帧最多四个同步触点。 - [0x8040 · brightnessControl](/zh/hidpp/features/x8040-brightness-control): 设备背光亮度控制——读取支持的亮度范围与步数、读写当前亮度值，并可独立开关背光照明。 - [0x8060 · adjustableReportRate](/zh/hidpp/features/x8060-report-rate): 旧版 HID 报告率控制——枚举设备支持的 1 ms 至 8 ms 轮询间隔，并读写当前活动间隔。 - [0x8061 · extendedAdjustableReportRate](/zh/hidpp/features/x8061-extended-report-rate): 高频率轮询控制——按连接类型（有线或游戏无线）查询最高 8000 Hz 的支持轮询率，并读写当前活动轮询率。 - [0x8070 · colorLedEffects](/zh/hidpp/features/x8070-color-led-effects): 逐区域 RGB 效果引擎——枚举 LED 区域及其支持的效果、以可选持久化方式应用效果，并与主机进行时序同步。 - [0x8071 · rgbEffects](/zh/hidpp/features/x8071-rgb-effects): 现代的按集群 RGB 效果引擎——取得软件控制权、以易失或持久化方式为各集群应用效果，并管理电源模式与同步事件。 - [0x8080 · perKeyLighting](/zh/hidpp/features/x8080-per-key-lighting): 旧版逐键 RGB 灯光控制——查询已启用的区域 ID、暂存各区域颜色，并将帧提交至显示端（可选写入非易失性存储）。 - [0x8081 · perKeyLighting](/zh/hidpp/features/x8081-per-key-lighting): 逐键（逐区域）RGB 灯光控制——通过六种 setter 函数暂存最多 256 个区域的颜色，再由 frame_end 统一提交并可选择持久化到 EEPROM。 - [0x8090 · modeStatus](/zh/hidpp/features/x8090-mode-status): 读写设备工作模式——通过位掩码控制的状态寄存器在性能模式与续航模式之间切换，并查询硬件与软件切换能力。 - [0x8300 · sidetone](/zh/hidpp/features/x8300-sidetone): 耳机旁音控制——读写麦克风回听音量（0–100）及各通道静音状态，使佩戴者在说话时能听到自己的声音。 - [0x8310 · equalizer](/zh/hidpp/features/x8310-equalizer): HID++ 耳机的逐频段音频均衡器与麦克风降噪——查询频段数量和增益范围、按可配置的持久化策略读写各频段增益，并切换降噪开关。