This page contains backlight behaviors supported by ZMK.
Backlight Action Defines
Backlight actions defines are provided through the
which is added at the top of the keymap file:
This will allow you to reference the actions defined in this header such as
Here is a table describing the action for each define:
|Turn on backlight|
|Turn off backlight|
|Toggle backlight on and off|
|Set a specific brightness|
- Parameter #1: The backlight action define, e.g.
- Parameter #2: Only applies to
BL_SETand is the brightness value
Toggle backlight on/off
Sets a specific brightness
&bl BL_SET 50
Backlight behaviors are global: This means that when triggered, they affect both the central and peripheral side of split keyboards.