0x1C00 · persistentRemappableAction
Read or write non-volatile, per-control and per-host HID action assignments.
persistentRemappableAction (0x1c00) stores a control's HID action in device
non-volatile memory. It supports a separate mapping for each control and host
slot. Its ControlId values are shared with 0x1b04.
When both features exist, a live 0x1b04 diversion takes precedence over this
persistent mapping. The feature is relevant to
Keyboard, but OpenLogi has no device, agent, CLI, or
GUI consumer for it in v0.8.15.
Spec: No public Logitech specification. Layout reverse-engineered from Logi Options+ 2.8 (static analysis). Cross-checked: Solaar. Used by: Not used by OpenLogi.
Function reference
PersistentRemappableActionFeature implements 0x1c00.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_feature_info | 0 | () | RemappableCapabilities |
get_count | 1 | () | RemappableInfo |
get_cid_info | 2 | (index: u8, host: HostIndex) | ControlId |
get_persistent_action | 3 | (cid: ControlId, host: HostIndex) | PersistentAction |
set_persistent_action | 4 | (cid: ControlId, host: HostIndex, config: PersistentActionConfig) | () |
reset_persistent_action | 5 | (cid: ControlId, host: HostIndex) | () |
reset_to_factory_settings | 6 | (hosts: HostMask) | () |
All methods are async. They return Result<…, Hidpp20Error>.
Types
RemappableCapabilities
| Flag | Bit | Description |
|---|---|---|
KEYBOARD_REPORT | 1 << 0 | Keyboard or keypad output. |
MOUSE_BUTTONS | 1 << 1 | Mouse-button output. |
X_DISPLACEMENT | 1 << 2 | Mouse X displacement. |
Y_DISPLACEMENT | 1 << 3 | Mouse Y displacement. |
VERTICAL_ROLLER | 1 << 4 | Vertical-roller output. |
HORIZONTAL_ROLLER | 1 << 5 | Horizontal-roller or AC-pan output. |
CONSUMER_CONTROL | 1 << 6 | Consumer-control output. |
INTERNAL_FUNCTION | 1 << 7 | Internal-function output. |
POWER_KEY | 1 << 8 | Power-key output. |
RemappableInfo and HostIndex
| Type | Field or variant | Description |
|---|---|---|
RemappableInfo | count: u8 | Number of control IDs. |
RemappableInfo | host_count: u8 | Number of device host slots. |
HostIndex | Current | Current device host. Encodes as 0xff. |
HostIndex | Slot(u8) | Zero-based host slot. |
PersistentAction
| Field | Type | Description |
|---|---|---|
cid | ControlId | Control whose action was read. |
host | HostIndex | Host slot for this mapping. |
action_id | ActionId | Action type. |
value | u16 | Usage, displacement, or internal-function index. |
modifier_mask | ModifierMask | Keyboard modifiers for keyboard actions. |
status | PersistentActionStatus | Complete response status byte. |
PersistentAction::is_remapped() tests status bit 0.
PersistentActionConfig
| Field | Type | Description |
|---|---|---|
action_id | ActionId | Action to store. |
value | u16 | Usage, displacement, or internal-function index. |
modifier_mask | ModifierMask | Keyboard modifiers for keyboard actions. |
ActionId
| Variant | Value | Description |
|---|---|---|
Empty | 0x00 | No output. A read response reports zero value and modifiers. |
SendKeyboard | 0x01 | Keyboard or keypad report, HID usage page 7. |
SendMouseButton | 0x02 | Mouse-button report, HID usage page 9. |
SendXDisplacement | 0x03 | Mouse X displacement, usage page 1 code 0x30. |
SendYDisplacement | 0x04 | Mouse Y displacement, usage page 1 code 0x31. |
SendVerticalRoller | 0x05 | Vertical roller, usage page 1 code 0x38. |
SendHorizontalRoller | 0x06 | Horizontal roller or AC pan, usage page 12 code 0x0238. |
SendConsumerControl | 0x07 | Consumer-control report, HID usage page 12. |
ExecuteInternalFunction | 0x08 | Internal function. value is its index. |
SendPowerKey | 0x09 | Power-key report, HID usage page 1. |
ModifierMask
| Flag | Bit | Description |
|---|---|---|
LEFT_CTRL | 1 << 0 | Left Control. |
LEFT_SHIFT | 1 << 1 | Left Shift. |
LEFT_ALT | 1 << 2 | Left Alt. |
LEFT_GUI | 1 << 3 | Left GUI. |
RIGHT_CTRL | 1 << 4 | Right Control. |
RIGHT_SHIFT | 1 << 5 | Right Shift. |
RIGHT_ALT | 1 << 6 | Right Alt. |
RIGHT_GUI | 1 << 7 | Right GUI. |
PersistentActionStatus
| Flag | Bit | Description |
|---|---|---|
REMAPPED | 1 << 0 | Action differs from its factory default. |
PersistentActionStatus retains bits 1–7. Their meanings are unknown.
HostMask
| Flag | Bit | Description |
|---|---|---|
HOST_1 | 1 << 0 | Host 1. |
HOST_2 | 1 << 1 | Host 2. |
HOST_3 | 1 << 2 | Host 3. |
Events
PersistentRemappableActionFeature does not implement an event listener.
Wire format
The tables use logical HID++ payload bytes. OpenLogi sends 3-byte short requests except for fn 4, which uses a 16-byte long request. Readers use an extended 16-byte response view and ignore bytes without a modeled field.
get_feature_info (fn 0)
Request: [0x00, 0x00, 0x00].
| Byte(s) | Field | Notes |
|---|---|---|
| 0–1 | RemappableCapabilities | BE u16 bitfield. |
| 2–15 | — | No field is parsed by OpenLogi. |
get_count (fn 1)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | count | Number of control IDs. |
| 1 | host_count | Number of host slots. |
| 2–15 | — | No field is parsed by OpenLogi. |
get_cid_info (fn 2)
Request: [index, host, 0x00]. host is HostIndex as u8; Current is
0xff and Slot(n) is n.
| Byte(s) | Field | Notes |
|---|---|---|
| 0–1 | cid | BE ControlId. |
| 2–15 | — | No field is parsed by OpenLogi. |
get_persistent_action (fn 3)
Request: [cid_hi, cid_lo, host], where cid_hi,cid_lo are the ControlId as
BE u16.
| Byte(s) | Field | Notes |
|---|---|---|
| 0–1 | cid | BE ControlId. |
| 2 | host | HostIndex byte. |
| 3 | action_id | ActionId, including Empty = 0x00. |
| 4–5 | value | BE u16. |
| 6 | modifier_mask | ModifierMask bits. |
| 7 bit 0 | REMAPPED | Known PersistentActionStatus bit. Options+ 2.8; Solaar. |
| 7 bits 1–7 | unknown status | Retained by PersistentActionStatus; meaning is unverified. Options+ 2.8; Solaar. |
| 8–15 | — | No field is parsed by OpenLogi. |
set_persistent_action (fn 4)
OpenLogi sends a 16-byte long request. It writes zero padding in bytes 7–15.
| Byte(s) | Field | Notes |
|---|---|---|
| 0–1 | cid | BE ControlId. |
| 2 | host | HostIndex byte. |
| 3 | action_id | ActionId. |
| 4–5 | value | BE u16. |
| 6 | modifier_mask | ModifierMask bits. |
| 7–15 | — | OpenLogi writes fixed zero padding. |
OpenLogi returns () after the request succeeds. It does not parse a response
body or read the action back.
reset_persistent_action (fn 5)
Request: [cid_hi, cid_lo, host], with ControlId in BE order. OpenLogi
returns () and does not parse a response body.
reset_to_factory_settings (fn 6)
Request: [hosts_bits, 0x00, 0x00]. hosts_bits is HostMask; bits 0, 1, and
2 select HOST_1, HOST_2, and HOST_3. OpenLogi returns () and does not
parse a response body.
How OpenLogi uses it
OpenLogi registers a typed wrapper for 0x1c00. It does not call this wrapper
from openlogi-device, the agent, the CLI, or the GUI in v0.8.15. OpenLogi
therefore does not write, reset, restore, or read back persistent actions.
Direct Rust callers must choose a supported action from
RemappableCapabilities. They must also select the intended HostIndex.
OpenLogi does not add a capability gate, a read-modify-write layer, or a
post-write read-back around the wrapper.
Open questions
Only status bit 0 has a recovered meaning. Options+ 2.8 and Solaar retain the
complete status byte, but they do not establish meanings for bits 1–7. OpenLogi
preserves those unknown bits in PersistentActionStatus.
The protocol evidence is static. No hardware trace verifies status-bit meanings,
the 0xff current-host sentinel, or device treatment of fn 4 padding.
Usage (Rust)
use hidpp::{
device::Device,
feature::{
hosts_info::HostIndex,
persistent_remappable_action::{
ActionId, ModifierMask, PersistentActionConfig,
PersistentRemappableActionFeature, RemappableCapabilities,
},
},
protocol::v20::Hidpp20Error,
};
async fn map_first_control(mut device: Device) -> Result<(), Hidpp20Error> {
device.enumerate_features().await?;
let Some(feature) = device.get_feature::<PersistentRemappableActionFeature>() else {
return Ok(());
};
let caps = feature.get_feature_info().await?;
if !caps.contains(RemappableCapabilities::KEYBOARD_REPORT) {
return Ok(());
}
let info = feature.get_count().await?;
if info.count == 0 {
return Ok(());
}
let host = HostIndex::Current;
let cid = feature.get_cid_info(0, host).await?;
let config = PersistentActionConfig {
action_id: ActionId::SendKeyboard,
value: 0x0006, // HID keycode for C.
modifier_mask: ModifierMask::LEFT_CTRL,
};
feature.set_persistent_action(cid, host, config).await?;
Ok(())
}