小龙虾
6641ca4afd
- 移除ESP32电压监控相关代码，因为ESP32-C3无内置电压传感器 - 更新健康监控模块，从"温度+电压+WiFi RSSI监控"改为"温度+WiFi RSSI监控" - 修改OTA健康检查频率，从每次包处理改为每32个包检查一次 - 添加OTA期间WiFi RSSI采样年龄限制和更宽松的阈值 docs: 更新文档中的系统监控描述 - 从README.md、开发指南和设计文档中移除电压监控相关内容 - 更新WebUI接口文档中的状态查询描述 refactor(wifi_ota): 增加系统状态响应中的运行时间信息 - 在/system/status接口响应中添加uptime_sec字段 - 前端工具页面显示系统运行时间 feat(wifi_ota): 添加ESP32重启接口和前端控制 - 新增/restart HTTP POST接口用于重启ESP32 - 在前端界面添加重启按钮替代健康检查按钮 - 移除前端健康检查功能 perf(ota_relay): 调整OTA块大小提升传输性能 - 将OTA块大小从4096字节增加到8192字节 - 更新固件上传和存储相关的缓冲区大小配置
81 lines
2.3 KiB
C
81 lines
2.3 KiB
C
/*
|
||
* health_monitor.h - 系统健康监控头文件
|
||
*/
|
||
#pragma once
|
||
|
||
#include <stdint.h>
|
||
#include "app_config.h"
|
||
|
||
// T9.3: 健康状态等级
|
||
typedef enum {
|
||
SYS_NORMAL = 0, // 正常
|
||
SYS_WARNING = 1, // 警告
|
||
SYS_CRITICAL = 2, // 危险
|
||
SYS_SAFE_SHUTDOWN = 3 // 安全关机
|
||
} health_state_t;
|
||
|
||
typedef enum {
|
||
HEALTH_MON_OK = 0,
|
||
HEALTH_MON_WARNING = 1,
|
||
HEALTH_MON_CRITICAL = 2,
|
||
HEALTH_MON_SHUTDOWN = 3
|
||
} health_status_t;
|
||
|
||
// 外部共享状态（互斥锁保护）
|
||
extern health_state_t g_health_state;
|
||
|
||
// WiFi RSSI 阈值（来自 app_config.h）
|
||
#define WIFI_RSSI_NORMAL WIFI_RSSI_WARNING
|
||
#define WIFI_RSSI_WEAK WIFI_RSSI_CRITICAL
|
||
|
||
/**
|
||
* @brief 初始化健康监控模块，创建内部互斥锁与基础状态。
|
||
*/
|
||
void health_monitor_init(void);
|
||
|
||
/**
|
||
* @brief 健康监控任务入口，负责启动温度定时检测并周期性巡检系统状态。
|
||
* @param pvParameters FreeRTOS 任务参数，未使用。
|
||
*/
|
||
void health_monitor_task(void *pvParameters);
|
||
|
||
/**
|
||
* @brief 在 OTA 传输开始前执行健康检查，返回当前是否允许传输。
|
||
* @return 健康检查结果，决定是否允许 OTA。
|
||
*/
|
||
health_status_t health_check_before_ota(void);
|
||
|
||
/**
|
||
* @brief 记录一条健康相关事件日志，便于故障追踪与状态回溯。
|
||
* @param event 事件名称字符串。
|
||
* @param value 事件关联的数值。
|
||
*/
|
||
void health_log_event(const char *event, int value);
|
||
|
||
/**
|
||
* @brief 获取当前系统健康状态。
|
||
* @return 当前健康状态枚举值。
|
||
*/
|
||
health_state_t health_get_current(void);
|
||
|
||
/**
|
||
* @brief 根据最新 WiFi RSSI 更新健康状态，并返回对应健康检查结果。
|
||
* @param rssi 当前 WiFi 信号强度（dBm）。
|
||
* @return 健康检查结果。
|
||
*/
|
||
health_status_t health_update_from_wifi_rssi(int8_t rssi);
|
||
|
||
/**
|
||
* @brief 获取最近一次采样到的芯片温度（摄氏度）。
|
||
* @return 最近一次温度采样值（摄氏度）。
|
||
*/
|
||
float health_get_last_temperature(void);
|
||
|
||
/**
|
||
* @brief 获取最近一次健康监控采样得到的 WiFi RSSI。
|
||
* @param out_rssi 输出 RSSI。
|
||
* @param out_age_ms 输出样本距今时长（毫秒）。
|
||
* @return true 有有效样本，false 当前无有效样本。
|
||
*/
|
||
bool health_get_last_wifi_rssi(int8_t *out_rssi, uint32_t *out_age_ms);
|