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-hidppwrapper.
Function reference
SolarDashboardFeature is creatable for feature version 0.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
set_light_measure | 0 | (max_reports: u8, report_period: u8) | () |
set_led | 1 | (led: LedId) | () |
listen | event | () | 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.
| Variant | Value | Description |
|---|---|---|
Off | 0 | Turn all CheckLight LEDs off. |
Red | 1 | Show red. |
Orange | 2 | Show orange. |
Green | 3 | Show green. |
SolarStatus
Every SolarEvent contains a SolarStatus value.
| Field | Type | Description |
|---|---|---|
battery_level | u8 | Remaining battery capacity, as a percentage. |
light_level | u16 | Ambient light in lux, 0..=511. |
Events
| Variant | Description |
|---|---|
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)
| Byte | Field | Notes |
|---|---|---|
| 0 | max_reports | Number of LightMeasure reports. 0 cancels reporting. |
| 1 | report_period | Interval in seconds. 0 cancels reporting. |
| 2 | — | Padding. OpenLogi sends 0x00. |
set_led (fn 1)
| Byte | Field | Notes |
|---|---|---|
| 0 | led | LedId: 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.
| Byte | Field | Notes |
|---|---|---|
| 0 | battery_level | Remaining battery percentage. |
| 1–2 | light_level | Ambient light in lux, BE u16. |
| 3–15 | — | OpenLogi ignores these bytes. |
| HID++ fn | Variant |
|---|---|
| 0 | SolarEvent::Battery |
| 1 | SolarEvent::LightMeasure |
| 2 | SolarEvent::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?;
}
}
}