Add battery changed callbacks (#25207)

1 files changed, 22 insertions, 0 deletions

diff --git a/docs/drivers/battery.md b/docs/drivers/battery.md
index b1f75c1156..0bc8e5aec9 100644
--- a/docs/drivers/battery.md
+++ b/docs/drivers/battery.md
@@ -49,3 +49,25 @@ Sample battery level.
 #### Return Value {#api-battery-get-percent-return}
 
 The battery percentage, in the range 0-100.
+
+## Callbacks
+
+### `void battery_percent_changed_user(uint8_t level)` {#api-battery-percent-changed-user}
+
+User hook called when battery level changed.
+
+### Arguments {#api-battery-percent-changed-user-arguments}
+
+ - `uint8_t level`  
+   The battery percentage, in the range 0-100.
+
+---
+
+### `void battery_percent_changed_kb(uint8_t level)` {#api-battery-percent-changed-kb}
+
+Keyboard hook called when battery level changed.
+
+### Arguments {#api-battery-percent-changed-kb-arguments}
+
+ - `uint8_t level`  
+   The battery percentage, in the range 0-100.