Heater PID closed-loop on PB12 (HEAT_EN) with safety protections

2026-10-10 10:04:48 +08:00
parent 6246a87c3c
commit 30540d884d
8 changed files with 276 additions and 40 deletions
@@ -0,0 +1,47 @@
+#ifndef HEAT_H
+#define HEAT_H
+
+#include "gd32f4xx.h"
+#include "board_config.h"
+#include <stdbool.h>
+
+/**
+ * @brief 初始化加热输出（PB12 推挽输出低 = 加热关）。
+ */
+void heat_init(void);
+
+/**
+ * @brief 加热控制任务（在主循环中周期调用，主循环周期 10ms）。
+ * @details 内部包含：慢 PWM 载波（1s 周期、10% 步进，脉宽恒 >=100ms）、
+ *          PID 计算（500ms 周期，输出量化到占空档位）、安全保护
+ *          （传感器故障强制关断 / 过温滞回保护 / 未使能强制关断）。
+ */
+void heat_task(void);
+
+/**
+ * @brief 使能/关闭加热（对应 M3S1/M3S0）。
+ * @note 关闭时立即输出低并复位 PID 积分。
+ */
+void heat_set_enable(bool on);
+
+/**
+ * @brief 查询加热使能状态。
+ */
+bool heat_get_enable(void);
+
+/**
+ * @brief 设定目标温度（摄氏度，对应 M4S）。
+ */
+void heat_set_target(float temp_c);
+
+/**
+ * @brief 查询目标温度（摄氏度）。
+ */
+float heat_get_target(void);
+
+/**
+ * @brief 查询当前量化占空比档位（0~10，对应 0~100%，10% 步进）。
+ */
+uint8_t heat_get_duty(void);
+
+#endif // HEAT_H