Module init

Expand description

Backlight task initialization. Backlight task initialization and runtime loop.

Structs§

BacklightState 🔒: Full backlight state, kept in one place so any path can do a consistent redraw without losing information.

CALIB_ALL_DONE_BLINK_COUNT 🔒: Number of on/off cycles in the “all keys accepted” blink animation.
CALIB_ALL_DONE_BLINK_HALF_MS 🔒: Duration of each on and each off half-period of the blink (milliseconds).
CALIB_AMBER 🔒: Background colour during the zero-travel calibration phase and the EEPROM-write-failure signal (amber).
CALIB_DONE_HOLD_MS 🔒: Duration in milliseconds to hold the solid-green display after calibration is successfully stored, before returning to normal white backlight.
CALIB_GREEN 🔒: Solid colour used for the post-calibration success hold and for each individually confirmed key during the full-travel pass (green).
CAPS_LOCK_LED_INDEX 🔒: LED index for the Caps Lock indicator key.
INDICATOR_BRIGHTNESS 🔒: Brightness percentage applied to indicator LEDs (0–100).
INDICATOR_OFF 🔒: RGB color for a disabled indicator (off).
INDICATOR_RED 🔒: RGB color for the active-lock indicator state (red).
INDICATOR_WHITE 🔒: RGB color for the inactive-lock indicator state (white).
NUM_LOCK_LED_INDEX 🔒: LED index for the Num Lock indicator key.
SOFTSTART_RAMP_MS 🔒: Total duration of the soft-start ramp in milliseconds.
SOFTSTART_STEPS 🔒: Number of brightness steps in the soft-start ramp.
THERMAL_POLL 🔒: Interval between thermal register polls.
THERMAL_THROTTLE_BRIGHTNESS 🔒: Brightness percentage applied when a driver chip reports temperature ≥ 70 °C.

backlight_runner: Runs the backlight controller loop.
correct 🔒: Apply brightness scaling and gamma correction to an RGB colour.
correct_color 🔒: Apply correct to a pre-packaged (R, G, B) colour tuple.
fill_all_leds 🔒: Paint every LED with color at brightness and flush to hardware.
render_all 🔒: Writes every LED to hardware according to state.
render_calib 🔒: Render the full-travel calibration frame.
render_indicators 🔒: Writes only the two indicator LEDs according to state.
scale 🔒: Scale value by brightness_percent (0–100), rounding to nearest.
softstart 🔒: Performs a soft-start brightness ramp on all LEDs at initialization.