终版

Hardware/LightSensor.c

@@ -6,6 +6,7 @@ static uint8_t g_fill_light_on = 0;
 /**
  * @brief 初始化光敏电阻ADC和补光灯GPIO
  */
+/* 函数作用：初始化光敏电阻 ADC 输入和补光灯 GPIO 输出。 */
 void LightSensor_Init(void)
 {
     GPIO_InitTypeDef GPIO_InitStructure;
@@ -60,6 +61,7 @@ void LightSensor_Init(void)
  * @brief 获取光敏电阻ADC值
  * @return ADC值 (0-4095)，值越大表示光线越暗（电阻越大）
  */
+/* 函数作用：采集一次光敏电阻 ADC 数值。 */
 uint16_t LightSensor_GetValue(void)
 {
     // 启动ADC转换
@@ -76,6 +78,7 @@ uint16_t LightSensor_GetValue(void)
  * @brief 更新补光灯状态（在主循环中定期调用）
  *        使用迟滞控制避免灯光频繁开关
  */
+/* 函数作用：根据环境光强自动打开或关闭补光灯。 */
 void LightSensor_Update(void)
 {
     uint16_t light_value = LightSensor_GetValue();
@@ -100,6 +103,7 @@ void LightSensor_Update(void)
  * @brief 获取补光灯当前状态
  * @return 1=亮，0=灭
  */
+/* 函数作用：返回补光灯当前开关状态。 */
 uint8_t LightSensor_IsLightOn(void)
 {
     return g_fill_light_on;