feat(runtime): add diagnostic and network recovery controls

2026-08-12 16:32:40 +08:00
parent a94df9545d
commit 1c32d9f0e7
11 changed files with 868 additions and 0 deletions
@@ -110,6 +110,77 @@ menu "Example Configuration"
            help
                Maximum FreeRTOS task entries captured per report.

+        config TQ_MEMORY_MONITOR_ENABLE
+            bool "Enable runtime heap watermark monitor"
+            default y
+            help
+                Track internal RAM, DMA-capable RAM, and PSRAM watermarks.
+                Allocation failures and low contiguous DMA memory are logged
+                together with the current voice-session state.
+
+        config TQ_MEMORY_MONITOR_SAMPLE_INTERVAL_MS
+            int "Memory monitor sample interval (ms)"
+            default 1000
+            range 100 60000
+            depends on TQ_MEMORY_MONITOR_ENABLE
+            help
+                Sampling interval for heap watermarks. Periodic reports are
+                emitted less frequently to avoid flooding the log.
+
+        config TQ_MEMORY_MONITOR_REPORT_INTERVAL_MS
+            int "Memory monitor periodic report interval (ms)"
+            default 30000
+            range 5000 600000
+            depends on TQ_MEMORY_MONITOR_ENABLE
+            help
+                Interval for normal heap watermark reports. Pressure changes
+                and allocation failures are reported immediately.
+
+        config TQ_MEMORY_MONITOR_INTERNAL_WARN_BYTES
+            int "Internal RAM warning threshold (bytes)"
+            default 16384
+            range 4096 262144
+            depends on TQ_MEMORY_MONITOR_ENABLE
+            help
+                Emit a pressure warning when free 8-bit internal RAM falls
+                below this value.
+
+        config TQ_MEMORY_MONITOR_DMA_LARGEST_WARN_BYTES
+            int "Largest DMA block warning threshold (bytes)"
+            default 4096
+            range 1024 65536
+            depends on TQ_MEMORY_MONITOR_ENABLE
+            help
+                Emit a pressure warning when the largest contiguous
+                DMA-capable allocation falls below this value.
+
+        config TQ_NETWORK_DIAGNOSTICS_ENABLE
+            bool "Enable detailed network diagnostics"
+            default y
+            help
+                Collect detailed DNS, Wi-Fi, heap, ping, and cached-endpoint
+                TCP probe data when HTTPS name resolution fails. The probes
+                can add up to roughly two seconds to a failed DNS attempt, so
+                disable this option for production builds after diagnosis.
+
+        config TQ_MULTIMODAL_DIAGNOSTICS_ENABLE
+            bool "Enable detailed multimodal session diagnostics"
+            default y
+            help
+                Log multimodal session generations, transport cleanup stages,
+                and network failure streaks.
+                Functional recovery warnings remain visible when disabled.
+
+        config TQ_NETWORK_AUTO_REASSOCIATION_ENABLE
+            bool "Enable automatic Wi-Fi reassociation after HTTPS failures"
+            default n
+            help
+                After two consecutive multimodal HTTPS connection failures,
+                disconnect and reconnect the Wi-Fi station before retrying.
+                This interrupts all device network traffic while reassociation
+                is in progress. Keep disabled unless field testing shows that
+                reconnecting only the multimodal transport is insufficient.
+
        config TQ_SYSTEM_EVENT_ENABLE
            bool "Enable control-plane system event task"
            default y