功能:集成SU-03T语音模块,完善UI代码文档

- 在CMakeLists.txt中添加SU-03T语音模块依赖。
- 在main.cpp中实现SU-03T接收回调函数,处理接收消息。
- 完善各UI源文件文档,包括动作、屏幕和字体,明确模块作用与数据流向。
- 更新主应用逻辑,初始化并启动SU-03T接收器。
- 修改过程中确保兼容性,保留原有接口。
This commit is contained in:
Wang Beihong
2026-04-22 01:06:10 +08:00
parent 65de57a49c
commit ffdb7065e3
46 changed files with 1341 additions and 12 deletions

View File

@@ -1,3 +1,12 @@
/*
* 文件: components/fire_sensor/fire_sensor.c
* 角色: 火焰传感器 ADC 采样与危险判定
* 说明:
* - 本文件用于实现当前模块的核心功能或接口定义。
* - 修改前请先确认该模块与其它任务/外设之间的数据流关系。
* - 涉及协议与硬件时,优先保持现有接口兼容,避免联调回归。
*/
#include "fire_sensor.h"
#include "MQ-2.h"
@@ -13,6 +22,10 @@ static const char *TAG = "fire_sensor";
static adc_oneshot_unit_handle_t s_adc_handle = NULL;
static bool s_inited = false;
/* 函数: fire_sensor_init
* 作用: 执行模块内与函数名对应的业务逻辑。
* 重点: 关注输入合法性、返回码与并发安全。
*/
esp_err_t fire_sensor_init(void)
{
if (s_inited) {
@@ -35,6 +48,10 @@ esp_err_t fire_sensor_init(void)
return ESP_OK;
}
/* 函数: fire_sensor_read_raw
* 作用: 执行模块内与函数名对应的业务逻辑。
* 重点: 关注输入合法性、返回码与并发安全。
*/
esp_err_t fire_sensor_read_raw(int *raw_out)
{
ESP_RETURN_ON_FALSE(raw_out != NULL, ESP_ERR_INVALID_ARG, TAG, "raw_out is null");
@@ -52,6 +69,10 @@ esp_err_t fire_sensor_read_raw(int *raw_out)
return ESP_OK;
}
/* 函数: fire_sensor_read_percent
* 作用: 执行模块内与函数名对应的业务逻辑。
* 重点: 关注输入合法性、返回码与并发安全。
*/
esp_err_t fire_sensor_read_percent(float *percent_out)
{
ESP_RETURN_ON_FALSE(percent_out != NULL, ESP_ERR_INVALID_ARG, TAG, "percent_out is null");
@@ -71,6 +92,10 @@ esp_err_t fire_sensor_read_percent(float *percent_out)
return ESP_OK;
}
/* 函数: fire_sensor_is_danger
* 作用: 执行模块内与函数名对应的业务逻辑。
* 重点: 关注输入合法性、返回码与并发安全。
*/
bool fire_sensor_is_danger(float percent, float threshold_percent)
{
return percent >= threshold_percent;

View File

@@ -1,3 +1,12 @@
/*
* 文件: components/fire_sensor/include/fire_sensor.h
* 角色: 火焰传感器 ADC 采样与危险判定
* 说明:
* - 本文件用于实现当前模块的核心功能或接口定义。
* - 修改前请先确认该模块与其它任务/外设之间的数据流关系。
* - 涉及协议与硬件时,优先保持现有接口兼容,避免联调回归。
*/
#pragma once
#include <stdbool.h>