OpenLogi

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

FunctionHID++ fnSignatureReturns
get_eq_info0(&self)EqInfo
get_frequencies1(&self, band_count: u8)Vec<u16>
get_frequency_gains2(&self, location: GainLocation, band_count: u8)Vec<i8>
set_frequency_gains3(&self, persistence: GainPersistence, gains: &[i8])Vec<i8>
get_mic_noise_reduction4(&self)bool
set_mic_noise_reduction5(&self, enabled: bool)()

Types

EqInfo

FieldTypeDescription
band_countu8Number of frequency bands.
db_rangeu8Symmetric gain range, in dB, when both explicit bounds are zero.
capabilitiesEqCapabilitiesHow the device stores equalizer values.
db_mini8Minimum gain, in dB, or 0 for the symmetric-range shorthand.
db_maxi8Maximum 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

FlagBitDescription
STORED_AS_GAINS0The device stores equalizer values as gains.
STORED_AS_COEFFICIENTS1The device stores equalizer values as coefficients.

The wrapper retains unknown capability bits when it reads this u8 bitfield.

GainLocation

VariantValueDescription
Eeprom0Read the custom equalizer stored in EEPROM.
Ram1Read the active equalizer in RAM.

GainLocation is #[non_exhaustive].

GainPersistence

VariantValueDescription
Volatile0Apply gains to RAM only.
VolatileAndNonVolatile1Apply gains to RAM and EEPROM.
NonVolatileOnly2Apply 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].

ByteFieldNotes
0band_countNumber of frequency bands.
1db_rangeSymmetric range, in dB, when bytes 3–4 are zero.
2capabilitiesEqCapabilities flags.
3db_minSigned i8 minimum gain, in dB.
4db_maxSigned 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].

ByteFieldNotes
0start_indexIndex of the first requested band.
Response byteFieldNotes
0echoed start_indexOpenLogi returns UnsupportedResponse if this differs.
1–2frequency 0BE u16, in Hz.
3–4frequency 1BE u16, in Hz.
5–14frequencies 2–6Five further BE u16 values when the page needs them.
15unusedOpenLogi ignores this byte.

get_frequency_gains (fn 2)

Request: [location, 0x00, 0x00].

ByteFieldNotes
0locationGainLocation: 0 for Eeprom; 1 for Ram.
Response byteFieldNotes
0 onwardgainsOne signed i8 per requested band.

set_frequency_gains (fn 3)

The request is a 16-byte long payload. OpenLogi rejects more than 15 gains.

ByteFieldNotes
0persistenceGainPersistence: 0, 1, or 2.
1–15gainsSigned 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].

ByteFieldNotes
0enabledZero is false; any non-zero value is true.

set_mic_noise_reduction (fn 5)

Request: [enabled, 0x00, 0x00].

ByteFieldNotes
0enabledOpenLogi writes 0 for false and 1 for true.
1–2paddingOpenLogi 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
}

On this page