0x8310 · equalizer
Per-band headset equalizer and microphone-noise-reduction control in the HID++ 0x8310 protocol wrapper.
0x8310 controls an audio device's per-band equalizer and microphone noise reduction. OpenLogi provides a version-2 typed wrapper. OpenLogi does not connect this feature to a device, agent, CLI, or desktop control path.
Spec: Logitech HID++ 2.0 — x8310 equalizer. Cross-checked: G HUB 2026.6 (static analysis). Used by: Typed wrapper in
openlogi-hidpp; no device-layer path.
Function reference
EqualizerFeature implements HID++ 0x8310 from version 2. Every method is asynchronous and returns Result<…, Hidpp20Error>.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_eq_info | 0 | (&self) | EqInfo |
get_frequencies | 1 | (&self, band_count: u8) | Vec<u16> |
get_frequency_gains | 2 | (&self, location: GainLocation, band_count: u8) | Vec<i8> |
set_frequency_gains | 3 | (&self, persistence: GainPersistence, gains: &[i8]) | Vec<i8> |
get_mic_noise_reduction | 4 | (&self) | bool |
set_mic_noise_reduction | 5 | (&self, enabled: bool) | () |
Types
EqInfo
| Field | Type | Description |
|---|---|---|
band_count | u8 | Number of frequency bands. |
db_range | u8 | Symmetric gain range, in dB, when both explicit bounds are zero. |
capabilities | EqCapabilities | How the device stores equalizer values. |
db_min | i8 | Minimum gain, in dB, or 0 for the symmetric-range shorthand. |
db_max | i8 | Maximum gain, in dB, or 0 for the symmetric-range shorthand. |
EqInfo is #[non_exhaustive]. effective_range(&self) -> (i8, i8) returns (-db_range, db_range) when both explicit bounds are 0.
EqCapabilities
| Flag | Bit | Description |
|---|---|---|
STORED_AS_GAINS | 0 | The device stores equalizer values as gains. |
STORED_AS_COEFFICIENTS | 1 | The device stores equalizer values as coefficients. |
The wrapper retains unknown capability bits when it reads this u8 bitfield.
GainLocation
| Variant | Value | Description |
|---|---|---|
Eeprom | 0 | Read the custom equalizer stored in EEPROM. |
Ram | 1 | Read the active equalizer in RAM. |
GainLocation is #[non_exhaustive].
GainPersistence
| Variant | Value | Description |
|---|---|---|
Volatile | 0 | Apply gains to RAM only. |
VolatileAndNonVolatile | 1 | Apply gains to RAM and EEPROM. |
NonVolatileOnly | 2 | Apply gains to EEPROM only. |
GainPersistence is #[non_exhaustive].
Events
OpenLogi v0.8.15 defines no equalizer event type and EqualizerFeature does not implement EmittingFeature.
Wire format
Functions 0, 1, 2, 4, and 5 send 3-byte short requests. Function 3 sends a 16-byte long request. The wrapper converts every response to a 16-byte buffer, zero-extending a short reply.
Frequencies are BE u16 values. Gains are signed i8 values. The wrapper checks the echoed page index for function 1. It does not validate an echoed persistence selector for function 3.
get_eq_info (fn 0)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | band_count | Number of frequency bands. |
| 1 | db_range | Symmetric range, in dB, when bytes 3–4 are zero. |
| 2 | capabilities | EqCapabilities flags. |
| 3 | db_min | Signed i8 minimum gain, in dB. |
| 4 | db_max | Signed i8 maximum gain, in dB. |
get_frequencies (fn 1)
The wrapper sends one request per page. A page contains at most seven frequencies.
Request: [start_index, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | start_index | Index of the first requested band. |
| Response byte | Field | Notes |
|---|---|---|
| 0 | echoed start_index | OpenLogi returns UnsupportedResponse if this differs. |
| 1–2 | frequency 0 | BE u16, in Hz. |
| 3–4 | frequency 1 | BE u16, in Hz. |
| 5–14 | frequencies 2–6 | Five further BE u16 values when the page needs them. |
| 15 | unused | OpenLogi ignores this byte. |
get_frequency_gains (fn 2)
Request: [location, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | location | GainLocation: 0 for Eeprom; 1 for Ram. |
| Response byte | Field | Notes |
|---|---|---|
| 0 onward | gains | One signed i8 per requested band. |
set_frequency_gains (fn 3)
The request is a 16-byte long payload. OpenLogi rejects more than 15 gains.
| Byte | Field | Notes |
|---|---|---|
| 0 | persistence | GainPersistence: 0, 1, or 2. |
| 1–15 | gains | Signed i8 values encoded as raw bytes. |
The wrapper skips response byte 0 and returns as many signed gain bytes as the request supplied. It does not compare the skipped byte with persistence.
get_mic_noise_reduction (fn 4)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | enabled | Zero is false; any non-zero value is true. |
set_mic_noise_reduction (fn 5)
Request: [enabled, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | enabled | OpenLogi writes 0 for false and 1 for true. |
| 1–2 | padding | OpenLogi writes zero. |
OpenLogi awaits the response and ignores its payload.
How OpenLogi uses it
The feature registry creates EqualizerFeature for 0x8310 version 2 and later. No v0.8.15 device-layer, agent, CLI, or desktop path opens the wrapper. OpenLogi therefore has no equalizer 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 the same six getter and setter names, plus an event handler. The available evidence does not identify function IDs, event sub-IDs, response widths, or the full protocol layout. Hardware captures or a feature-specific Logitech specification are required to verify them.
OpenLogi zero-extends short replies for every equalizer getter. This is an implementation fact, not proof that a short reply is valid for a multi-byte response. The available evidence does not establish the required response lengths.
Usage (Rust)
use hidpp::{
feature::equalizer::{EqualizerFeature, GainLocation},
protocol::v20::Hidpp20Error,
};
async fn active_gains(feature: &EqualizerFeature) -> Result<Vec<i8>, Hidpp20Error> {
let info = feature.get_eq_info().await?;
feature
.get_frequency_gains(GainLocation::Ram, info.band_count)
.await
}