feat(power): add controlled low-battery shutdown

main/Kconfig.projbuild

@@ -1039,6 +1039,40 @@ menu "Example Configuration"
             range 1 100
             depends on TQ_BATTERY_ENABLE
 
+        config TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+            bool "Enable controlled shutdown at critically low battery"
+            default y
+            depends on TQ_BATTERY_ENABLE
+
+        config TQ_BATTERY_SHUTDOWN_VOLTAGE_MV
+            int "Controlled shutdown voltage threshold (mV)"
+            default 3450
+            range 3000 4200
+            depends on TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+
+        config TQ_BATTERY_EMERGENCY_VOLTAGE_MV
+            int "Emergency shutdown voltage threshold (mV)"
+            default 3350
+            range 3000 4200
+            depends on TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+
+        config TQ_BATTERY_WAKE_RECOVERY_VOLTAGE_MV
+            int "Minimum voltage after deep-sleep wake (mV)"
+            default 3550
+            range 3000 4200
+            depends on TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+
+        config TQ_BATTERY_SHUTDOWN_WAKE_BUTTON_GPIO
+            int "Optional active-low deep-sleep wake button GPIO (-1 to disable)"
+            default -1
+            range -1 48
+            depends on TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+
+        config TQ_BATTERY_SHUTDOWN_PROMPT_FILE
+            string "Critical-battery shutdown prompt file"
+            default "/littlefs/audio_prompts/shutdown_power_empty.opus"
+            depends on TQ_BATTERY_CONTROLLED_SHUTDOWN_ENABLE
+
     endmenu
 
     menu "Wi-Fi Provisioning"