OpenLogi

0x4301 · solarKeyboardDashboard

Schedule solar-keyboard light reports, control the CheckLight LED, and receive battery and ambient-light events.

SolarKeyboardDashboard serves Logitech solar keyboards, including the K750. It schedules light reports, controls the CheckLight LED, and decodes battery and light broadcasts.

Spec: Logitech HID++ 2.0 — solarKeyboardDashboard. Used by: Not used by OpenLogi outside the openlogi-hidpp wrapper.

Function reference

SolarDashboardFeature is creatable for feature version 0.

Methods

FunctionHID++ fnSignatureReturns
set_light_measure0(max_reports: u8, report_period: u8)()
set_led1(led: LedId)()
listenevent()async_channel::Receiver<SolarEvent>

set_light_measure and set_led are async. They return Result<(), Hidpp20Error>. listen comes from EmittingFeature<SolarEvent>.

Types

LedId

LedId selects the CheckLight LED color.

VariantValueDescription
Off0Turn all CheckLight LEDs off.
Red1Show red.
Orange2Show orange.
Green3Show green.

SolarStatus

Every SolarEvent contains a SolarStatus value.

FieldTypeDescription
battery_levelu8Remaining battery capacity, as a percentage.
light_levelu16Ambient light in lux, 0..=511.

Events

VariantDescription
Battery(SolarStatus)Spontaneous battery report. The light level is 0.
LightMeasure(SolarStatus)Report scheduled by set_light_measure.
CheckLightButton(SolarStatus)The user pressed the CheckLight button.

The firmware sends Battery about every 90 seconds, at power-up, and on reconnect. Call set_led within 250 ms of CheckLightButton to override the firmware display.

Wire format

set_light_measure and set_led use 3-byte short requests. OpenLogi waits for a HID++ reply, but it does not read reply bytes for either setter.

set_light_measure (fn 0)

ByteFieldNotes
0max_reportsNumber of LightMeasure reports. 0 cancels reporting.
1report_periodInterval in seconds. 0 cancels reporting.
2—Padding. OpenLogi sends 0x00.

set_led (fn 1)

ByteFieldNotes
0ledLedId: Off = 0, Red = 1, Orange = 2, Green = 3.
1–2—Padding. OpenLogi sends 0x00.

Events (fn 0–2)

Each event uses this payload. light_level is a BE u16.

ByteFieldNotes
0battery_levelRemaining battery percentage.
1–2light_levelAmbient light in lux, BE u16.
3–15—OpenLogi ignores these bytes.
HID++ fnVariant
0SolarEvent::Battery
1SolarEvent::LightMeasure
2SolarEvent::CheckLightButton

How OpenLogi uses it

The typed wrapper attaches its broadcast listener when OpenLogi creates the feature. It exposes scheduling, LED control, and decoded events to Rust callers.

OpenLogi v0.8.15 has no device-layer, agent, CLI, or user-interface caller for this feature. It does not schedule reports, override the LED, track the results, or restore feature state at exit.

Usage (Rust)

use hidpp::{
    device::Device,
    feature::{
        EmittingFeature,
        solar_dashboard::{LedId, SolarDashboardFeature, SolarEvent},
    },
};

// `device` is a discovered HID++ device.
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<SolarDashboardFeature>() {
    feature.set_light_measure(10, 30).await?;

    let events = feature.listen();
    while let Ok(event) = events.recv().await {
        if let SolarEvent::CheckLightButton(status) = event {
            println!("battery={}%, light={} lux", status.battery_level, status.light_level);
            feature.set_led(LedId::Green).await?;
        }
    }
}

On this page