Merge pull request #619 from Dasharo/novacustom-battery

NovaCustom battery management
Dasharo · Jul 27, 2023 · 7b87b07 · 7b87b07
2 parents ffa5990 + 2586194
commit 7b87b07
Show file tree

Hide file tree

Showing 5 changed files with 42 additions and 0 deletions.
diff --git a/docs/images/battery_block_popup.jpg b/docs/images/battery_block_popup.jpg
diff --git a/docs/images/battery_connection.jpg b/docs/images/battery_connection.jpg
diff --git a/docs/images/power_error.jpg b/docs/images/power_error.jpg
diff --git a/docs/unified/novacustom/battery-management.md b/docs/unified/novacustom/battery-management.md
@@ -0,0 +1,41 @@
+# NovaCustom power and battery subsystem
+
+NovaCustom laptops equipped with Dasharo firmware provide several battery
+management mechanisms to optimize user experience and further prolong the
+battery's lifespan.
+
+## Boot  blocking when the battery is low
+
+To prevent corruption of the bootloader, which may occur due to sudden power cut
+off during the OS boot process, booting the OS is blocked when the battery level
+sits below 5%. When trying to boot the OS with the battery level below the
+defined threshold, following message will be displayed on screen:
+
+![](images/boot_block_popup.jpg)
+
+## Disconnected battery warning
+
+When the firmware encounters problems with detecting the battery, following
+message will appear suggesting checking the physical connection between the
+battery and mainboard:
+
+![](images/battery_connection.jpg)
+
+## Power information error
+
+When the firmware encounters problems with retrieving information about AC and
+battery state, following error message will be displayed:
+
+![](images/power_error.jpg)
+
+## Charge thresholds
+
+Dasharo firmware implements battery charge thresholds, which aim to extend the
+lifespan of the battery:
+
+- charging will only start when the battery level is below 95%
+
+- charging will stop once the battery level reaches 98%
+
+Custom charge thresholds can be configured using the Dasharo setup menu or using
+third-party software like [tlp](https://linrunner.de/tlp/faq/battery.html).
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -92,6 +92,7 @@ nav:
           - 'Post-installation setup': unified/clevo/post-install.md
           - 'RGB keyboard': unified/novacustom/rgb-keyboard.md
           - 'Fn lock hotkey': unified/novacustom/fn-lock-hotkey.md
+          - 'Battery management': unified/novacustom/battery-management.md
           - 'Fan profiles': unified/novacustom/fan-profiles.md
           - 'Firmware update using fwupd': unified/novacustom/fwupd-usage.md
           - 'NV4x 12th Gen':