0x8300 · sidetone
Headset sidetone level and per-channel mute control in the HID++ 0x8300 protocol wrapper.
0x8300 controls headset sidetone: microphone audio sent back to the ear cups. OpenLogi provides a version-1 typed wrapper. OpenLogi does not connect this feature to a device, agent, CLI, or desktop control path.
Spec: Logitech HID++ 2.0 — Sidetone. Cross-checked: G HUB 2026.6 (static analysis). Used by: Typed wrapper in
openlogi-hidpp; no device-layer path.
Function reference
SidetoneFeature implements HID++ 0x8300 from version 1. Every method is asynchronous and returns Result<…, Hidpp20Error>.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_sidetone_level | 0 | (&self) | u8 |
set_sidetone_level | 1 | (&self, level: u8) | () |
get_sidetone_mute | 2 | (&self) | SidetoneMuteStatus |
set_sidetone_mute | 3 | (&self, change: SidetoneMuteChange) | () |
Types
SidetoneMuteStatus
| Field | Type | Description |
|---|---|---|
statuses | u8 | Raw mute-status bitmask. A set bit denotes a muted channel. |
SidetoneMuteStatus is #[non_exhaustive].
SidetoneMuteChange
| Field | Type | Description |
|---|---|---|
change_mask | u8 | A set bit selects the corresponding channel for update. |
statuses | u8 | A set bit requests mute for the corresponding selected channel. |
Events
OpenLogi v0.8.15 defines no sidetone event type and SidetoneFeature does not implement EmittingFeature.
Wire format
Every method sends a 3-byte short request. The wrapper calls extend_payload() before it reads a reply. A short reply is therefore zero-extended to 16 bytes by OpenLogi.
The wrapper documents the level as 0..=100, but it sends any u8 without local range validation. G HUB static analysis confirms the same named method set, but it does not verify these payload layouts or device range behavior.
get_sidetone_level (fn 0)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | level | OpenLogi returns this raw u8. The documented range is 0..=100. |
set_sidetone_level (fn 1)
Request: [level, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | level | OpenLogi sends any u8. No local range check occurs. |
| 1–2 | padding | OpenLogi writes zero. |
OpenLogi awaits the response and ignores its payload.
get_sidetone_mute (fn 2)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | SidetoneMuteStatus::statuses | Raw u8 mute-status bitmask. |
set_sidetone_mute (fn 3)
Request: [change_mask, statuses, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | SidetoneMuteChange::change_mask | Selects channel status bits to update. |
| 1 | SidetoneMuteChange::statuses | Requested status bits for selected channels. |
| 2 | padding | OpenLogi writes zero. |
OpenLogi awaits the response and ignores its payload.
How OpenLogi uses it
The feature registry creates SidetoneFeature for 0x8300 version 1 and later. No v0.8.15 device-layer, agent, CLI, or desktop path opens the wrapper. OpenLogi therefore has no sidetone state model, capability gate, read-modify-write operation, read-back check, or exit-time restore behavior.
Open questions
G HUB 2026.6 static analysis identifies sidetone level and mute get/set methods, plus an event handler. The available evidence does not identify function IDs, response widths, mute-bit assignments, event sub-IDs, or event layouts. Hardware captures or a feature-specific Logitech specification are required to verify them.
Usage (Rust)
use hidpp::{
feature::sidetone::SidetoneFeature,
protocol::v20::Hidpp20Error,
};
async fn lower_sidetone(feature: &SidetoneFeature) -> Result<(), Hidpp20Error> {
let level = feature.get_sidetone_level().await?;
feature.set_sidetone_level(level.saturating_sub(10)).await
}