700e9b264f
docs: Move battery sensing hardware integration to new page docs: Refactor lighting hardware integrations to new category docs: Link to pin control page from lighting pages docs: Consolidate lighting feature pages docs: Remove incorrect redirect docs: Consolidate lighting config pages
1.1 KiB
title, sidebar_label
| title | sidebar_label |
|---|---|
| Battery Level | Battery Level |
If your keyboard has a battery sensor, ZMK will report its battery level to the connected bluetooth host and show it on the keyboard's display, if it has one.
For split keyboards, only the battery level of the central (usually left) side is reported over bluetooth by default. ZMK can be configured to report the battery levels for peripherals, but not many host systems will display this information without additional configuration or the use of third party utilities.
:::note
Windows may not properly ask the keyboard to notify it of changes in battery level, so the level shown may be out of date.
:::
Adding a Battery Sensor to a Board
If your keyboard is using one of the boards supported in ZMK it will already be configured to sense and report battery levels. If you are using a custom board, see battery sensing hardware integration page to add support.