fix: 修复 main.c/event.c/lcd.c 的中文注释乱码，统一为 UTF-8 编码

lcd.c 原本整体是 GBK 编码，直接转码即可。main.c 与 event.c 曾被 Keil 环境以错误编码保存导致部分注释损坏，本次以历史提交中未损坏的版本为基底恢复正确注释文本，并将其后新增的真实代码改动（RGB 三色诊断指令、SOS 按键状态机解锁）对应的注释一并还原，不涉及任何代码逻辑变更。
2026-07-31 09:22:07 +08:00
parent 41bb78aa59
commit d8df5d49d3
4 changed files with 308 additions and 301 deletions
--- a/App/event.c
+++ b/App/event.c
@@ -6,17 +6,17 @@
 #include "xtell.h"
 #include "../Drivers/adc.h"

-// 定义事件<EFBFBD><EFBFBD>形队列的<EFBFBD><EFBFBD>大深度为 8
+// 定义事件环形队列的最大深度为 8
 #define EVENT_QUEUE_DEPTH 8

-// <EFBFBD><EFBFBD>形队列存储数<EFBFBD><EFBFBD> (存放在单片机 xdata 拓展 RAM区中)
+// 环形队列存储数组 (存放在单片机 xdata 拓展 RAM区中)
 static SystemEvent xdata event_queue[EVENT_QUEUE_DEPTH];
-static u8 queue_head = 0;   // 队<EFBFBD><EFBFBD><EFBFBD><EFBFBD>指<EFBFBD><EFBFBD>
-static u8 queue_tail = 0;   // 队尾写指<EFBFBD><EFBFBD>
-static u8 queue_count = 0;  // 当前队列内有效事件<EFBFBD><EFBFBD>数
+static u8 queue_head = 0;   // 队首读指针
+static u8 queue_tail = 0;   // 队尾写指针
+static u8 queue_count = 0;  // 当前队列内有效事件总数

 /**
- * @brief 初<EFBFBD><EFBFBD>化/清空事件队列
+ * @brief 初始化/清空事件队列
 */
 void EventQueue_Init(void)
 {
@@ -26,63 +26,63 @@ void EventQueue_Init(void)
 }

 /**
- * @brief 将普通事件压入队<EFBFBD><EFBFBD>
- * @param evt 输入的系统事<EFBFBD><EFBFBD>
- * @return bit 1-成功<EFBFBD><EFBFBD>0-失败
+ * @brief 将普通事件压入队尾
+ * @param evt 输入的系统事件
+ * @return bit 1-成功，0-失败
 */
 bit EventQueue_Push(SystemEvent evt)
 {
    if (queue_count >= EVENT_QUEUE_DEPTH) return 0; // 队列满，丢弃事件
-    EA = 0; // 关闭全局<EFBFBD><EFBFBD><EFBFBD><EFBFBD>，保护临界区操作的原子<EFBFBD>
+    EA = 0; // 关闭全局中断，保护临界区操作的原子性
    event_queue[queue_tail] = evt; // 存入队尾
-    queue_tail = (queue_tail + 1) % EVENT_QUEUE_DEPTH; // 尾指针向后移<EFBFBD><EFBFBD>，回<EFBFBD><EFBFBD>
-    queue_count++; // 有效计数<EFBFBD><EFBFBD> 1
-    EA = 1; // 恢<EFBFBD><EFBFBD>全<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
+    queue_tail = (queue_tail + 1) % EVENT_QUEUE_DEPTH; // 尾指针向后移动，回环
+    queue_count++; // 有效计数加 1
+    EA = 1; // 恢复全局中断
    return 1;
 }

 /**
- * @brief 将高优先<EFBFBD><EFBFBD>/紧<><E7B4A7>事件强行插到队<EFBFBD><EFBFBD>
- * @param evt 输入的系统事<EFBFBD><EFBFBD>
- * @return bit 1-成功<EFBFBD><EFBFBD>0-失败
+ * @brief 将高优先级/紧急事件强行插到队首
+ * @param evt 输入的系统事件
+ * @return bit 1-成功，0-失败
 */
 bit EventQueue_InsertFront(SystemEvent evt)
 {
    if (queue_count >= EVENT_QUEUE_DEPTH) return 0; // 队列满，插队失败
-    EA = 0; // 屏蔽<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-    // 头指针向前移动一位（带回<EFBFBD><EFBFBD>防溢出）
+    EA = 0; // 屏蔽中断
+    // 头指针向前移动一位（带回环防溢出）
    queue_head = (queue_head - 1 + EVENT_QUEUE_DEPTH) % EVENT_QUEUE_DEPTH;
-    event_queue[queue_head] = evt; // 存入腾出的队首位<EFBFBD><EFBFBD>
-    queue_count++; // 计数<EFBFBD><EFBFBD> 1
-    EA = 1; // 恢<EFBFBD><EFBFBD>中<EFBFBD><EFBFBD>
+    event_queue[queue_head] = evt; // 存入腾出的队首位置
+    queue_count++; // 计数加 1
+    EA = 1; // 恢复中断
    return 1;
 }

 /**
- * @brief 从队首弹出一<EFBFBD><EFBFBD>缓冲事件
- * @return SystemEvent 返回弹出的事件<EFBFBD><EFBFBD>若空返回空闲事<EFBFBD><EFBFBD>
+ * @brief 从队首弹出一个缓冲事件
+ * @return SystemEvent 返回弹出的事件。若空返回空闲事件
 */
 SystemEvent EventQueue_Pop(void)
 {
    SystemEvent evt;
-    // 默<EFBFBD><EFBFBD>空事件属<EFBFBD>
+    // 默认空事件属性
    evt.key_event = KEY_EVENT_NONE;
        evt.priority = EVENT_PRIORITY_NORMAL;
    evt.extra_data = 0;
    evt.extra_size = 0;
-    
-    if (queue_count == 0) return evt; // 队空，直接返回空闲事<EFBFBD><EFBFBD>
-    
-    EA = 0; // 屏蔽<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-    evt = event_queue[queue_head]; // 读取队<EFBFBD><EFBFBD>数<EFBFBD><EFBFBD>
-    queue_head = (queue_head + 1) % EVENT_QUEUE_DEPTH; // 头指针向后移<EFBFBD><EFBFBD>，回<EFBFBD><EFBFBD>
-    queue_count--; // 有效计数<EFBFBD><EFBFBD> 1
-    EA = 1; // 恢<EFBFBD><EFBFBD>中<EFBFBD><EFBFBD>
+
+    if (queue_count == 0) return evt; // 队空，直接返回空闲事件
+
+    EA = 0; // 屏蔽中断
+    evt = event_queue[queue_head]; // 读取队首数据
+    queue_head = (queue_head + 1) % EVENT_QUEUE_DEPTH; // 头指针向后移动，回环
+    queue_count--; // 有效计数减 1
+    EA = 1; // 恢复中断
    return evt;
 }

 /**
- * @brief 判断队列<EFBFBD><EFBFBD>否为<EFBFBD><EFBFBD>
+ * @brief 判断队列是否为空
 */
 bit EventQueue_IsEmpty(void)
 {
@@ -90,7 +90,7 @@ bit EventQueue_IsEmpty(void)
 }

 /**
- * @brief 判断队列<EFBFBD><EFBFBD>否已<EFBFBD><EFBFBD>
+ * @brief 判断队列是否已满
 */
 bit EventQueue_IsFull(void)
 {
@@ -98,7 +98,7 @@ bit EventQueue_IsFull(void)
 }

 /**
- * @brief 获取当前队列<EFBFBD><EFBFBD>的事件<EFBFBD><EFBFBD>数
+ * @brief 获取当前队列中的事件总数
 */
 u8 EventQueue_GetCount(void)
 {
@@ -106,98 +106,98 @@ u8 EventQueue_GetCount(void)
 }

 /**
- * @brief 事件分发器核心轮询<EFBFBD><EFBFBD>辑
- * @details 逐一处理队列<EFBFBD><EFBFBD>的事件，并根<EFBFBD><EFBFBD>系统当前的运行模式进行拦<EFBFBD><EFBFBD>、跳<EFBFBD><EFBFBD>或下发派发<EFBFBD>
+ * @brief 事件分发器核心轮询逻辑
+ * @details 逐一处理队列中的事件，并根据系统当前的运行模式进行拦截、跳转或下发派发。
 */
 void Event_Dispatcher_Loop(void)
 {
-    SystemEvent evt = EventQueue_Pop(); // 弹出<EFBFBD><EFBFBD><EFBFBD><EFBFBD>事件
-    
-    // 如果<EFBFBD><EFBFBD>无事发生的空事件，直接<EFBFBD><EFBFBD><EFBFBD>
+    SystemEvent evt = EventQueue_Pop(); // 弹出一个事件
+
+    // 如果是无事发生的空事件，直接退出
    if (evt.key_event == KEY_EVENT_NONE && evt.extra_size == 0) {
        return;
    }
-    
-    inactivity_timer = 0; // 捕获到有效事件，清零休眠计时<EFBFBD><EFBFBD>，重<EFBFBD><EFBFBD>闲置超时
-    
+
+    inactivity_timer = 0; // 捕获到有效事件，清零休眠计时器，重置闲置超时
+
    // 串口打印调试信息
    XTELL_LOG("[EVENT] key=");
    XTELL_LOG_HEX8((u8)evt.key_event);
    XTELL_LOG("\r\n");

-    // SOS 按键紧<EFBFBD><EFBFBD><EFBFBD><EFBFBD>理：若当前前台不为 SOS 应用，接收到 SOS <EFBFBD><EFBFBD>动作，立即强行切入到 SOS_APP 并执行求<EFBFBD><EFBFBD>
+    // SOS 按键紧急处理：若当前前台不为 SOS 应用，接收到 SOS 键动作，立即强行切入到 SOS_APP 并执行求救
    if ((evt.key_event == KEY_EVENT_SOS_CLICK || evt.key_event == KEY_EVENT_SOS_LONG) &&
        AppManager_GetActiveAppID() != APP_ID_SOS) {
        AppManager_StartApp(APP_ID_SOS);
        return;
    }

-    // 关机事件处理：捕获到长按关机指令，直接调<EFBFBD><EFBFBD> Power_Off 关断电源
+    // 关机事件处理：捕获到长按关机指令，直接调用 Power_Off 关断电源
    if (evt.key_event == KEY_EVENT_POWER_OFF) {
        Power_Off();
        return;
    }

-    // 常<EFBFBD><EFBFBD>事件（如普通的按键点击）直接<EFBFBD><EFBFBD>传分发给当前<EFBFBD><EFBFBD>于前台活跃的应<EFBFBD><EFBFBD>
+    // 常规事件（如普通的按键点击）直接透传分发给当前处于前台活跃的应用
    AppManager_DispatchEvent(evt);
 }

 /**
- * @brief 定时<EFBFBD><EFBFBD> 1 初<EFBFBD><EFBFBD>化，<EFBFBD><EFBFBD>定 1ms <EFBFBD><EFBFBD><EFBFBD><EFBFBD>周期
+ * @brief 定时器 1 初始化，设定 1ms 中断周期
 */
 void Timer1_Init(void)
 {
-    AUXR |= 0x40; // 设定定时<EFBFBD><EFBFBD> 1 <EFBFBD><EFBFBD> 1T 模式 (无分频，主<EFBFBD><EFBFBD>直接输<EFBFBD><EFBFBD>)
-    TMOD &= 0x0F; // 设置定时<EFBFBD><EFBFBD> 1 模式寄存<EFBFBD><EFBFBD>，保留低四位 (定时<EFBFBD><EFBFBD>0配置)
+    AUXR |= 0x40; // 设定定时器 1 为 1T 模式 (无分频，主频直接输入)
+    TMOD &= 0x0F; // 设置定时器 1 模式寄存器，保留低四位 (定时器0配置)
    {
-        // 按照系统主<EFBFBD> (MAIN_Fosc) 计算 1ms 对应的重装载<EFBFBD><EFBFBD>
+        // 按照系统主频 (MAIN_Fosc) 计算 1ms 对应的重装载值
        u16 reload = (u16)(65536UL - (MAIN_Fosc / 1000UL));
-        TL1 = (u8)reload;       // 载入<EFBFBD><EFBFBD> 8 <EFBFBD><EFBFBD>
-        TH1 = (u8)(reload >> 8);// 载入<EFBFBD><EFBFBD> 8 <EFBFBD><EFBFBD>
+        TL1 = (u8)reload;       // 载入低 8 位
+        TH1 = (u8)(reload >> 8);// 载入高 8 位
    }
-    ET1 = 1; // <EFBFBD><EFBFBD><EFBFBD><EFBFBD>定时<EFBFBD><EFBFBD> 1 <20><><EFBFBD><EFBFBD>允<EFBFBD>
-    TR1 = 1; // <EFBFBD><EFBFBD>动定时器 1 计数
-    EA = 1;  // <EFBFBD><EFBFBD><EFBFBD><EFBFBD>全局<EFBFBD><EFBFBD><EFBFBD><EFBFBD>允<EFBFBD>
+    ET1 = 1; // 开启定时器 1 中断允许
+    TR1 = 1; // 启动定时器 1 计数
+    EA = 1;  // 开启全局中断允许
 }

-// 全局按键<EFBFBD><EFBFBD>描触发标<EFBFBD><EFBFBD>
+// 全局按键扫描触发标志
 volatile bit key_scan_flag = 0;

 /**
- * @brief 定时<EFBFBD><EFBFBD> 1 <EFBFBD><EFBFBD><EFBFBD><EFBFBD>服务程序 (<EFBFBD><EFBFBD> 1ms 触发<EFBFBD><EFBFBD><EFBFBD><EFBFBD>)
- * @details 承担系统<EFBFBD><EFBFBD>时钟计算，并<EFBFBD><EFBFBD> 10ms <EFBFBD><EFBFBD>位主<EFBFBD><EFBFBD><EFBFBD><EFBFBD>按键<EFBFBD><EFBFBD>描标志，不直接在<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>进<EFBFBD> ADC 多<EFBFBD><EFBFBD>采样<EFBFBD>
+ * @brief 定时器 1 中断服务程序 (每 1ms 触发一次)
+ * @details 承担系统软时钟计算，并每 10ms 置位主循环按键扫描标志，不直接在中断中进行 ADC 多次采样。
 */
 void Timer1_Isr(void) interrupt 3
 {
-    // 1ms 定时更新<EFBFBD><EFBFBD>时钟
+    // 1ms 定时更新软时钟
    Clock_IncMS();

-    // 报<EFBFBD><EFBFBD>屏幕红边<EFBFBD><EFBFBD>以 100ms 周期<EFBFBD><EFBFBD><EFBFBD><EFBFBD>，进行<EFBFBD><EFBFBD>色爆闪指示
+    // 报警屏幕红边框以 100ms 周期亮灭，进行颜色爆闪指示
    alarm_flash_flag = (ms_tick / 100) % 2;

-    /* 物理按键定时计数 (<EFBFBD><EFBFBD> 10ms <EFBFBD><EFBFBD>位一次标志位) */
+    /* 物理按键定时计数 (每 10ms 置位一次标志位) */
    key_scan_timer++;
    if (key_scan_timer >= 10) {
-        key_scan_timer = 0; // 重置<EFBFBD><EFBFBD>描分频<EFBFBD><EFBFBD>数<EFBFBD><EFBFBD>
-        key_scan_flag = 1;  // 仅在<EFBFBD><EFBFBD><EFBFBD><EFBFBD>里置起标志位，留待主<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>执<EFBFBD><EFBFBD>实际<EFBFBD><EFBFBD>取与消<EFBFBD><EFBFBD>
+        key_scan_timer = 0; // 重置扫描分频计数器
+        key_scan_flag = 1;  // 仅在中断里置起标志位，留待主循环中执行实际读取与消抖
    }
 }

 /**
- * @brief 主循<EFBFBD><EFBFBD>按键<EFBFBD><EFBFBD>描与消抖处理函数
- * @details 由主<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 10ms <EFBFBD><EFBFBD>查并执<EFBFBD><EFBFBD>，完全在主线程<EFBFBD><EFBFBD>运<EFBFBD><EFBFBD>，绝无<EFBFBD><EFBFBD><EFBFBD><EFBFBD>重入冲突<EFBFBD><EFBFBD>
+ * @brief 主循环按键扫描与消抖处理函数
+ * @details 由主循环每 10ms 检查并执行，完全在主线程中运行，绝无中断重入冲突。
 */
 void Event_KeyScan_Poll(void)
 {
    SystemEvent evt;
-    // 读取按键的电平信<EFBFBD><EFBFBD> (KEY_UP, KEY_CONFIRM 为低电平有效)
+    // 读取按键的电平信号 (KEY_UP, KEY_CONFIRM 为低电平有效)
    u8 raw_up      = !KEY_UP;
-    u8 raw_down    = ADC_IsKeyDown(); // KEY_DOWN 通过 P0.3 ADC 通道判定 (常<EFBFBD> 2.0V, 按下 3.7V)
+    u8 raw_down    = ADC_IsKeyDown(); // KEY_DOWN 通过 P0.3 ADC 通道判定 (常态 2.0V, 按下 3.7V)
    u8 raw_confirm = !KEY_CONFIRM;
-    u8 raw_sos     = !KEY_SOS; // 恢<EFBFBD> SOS 物理按键电平<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-    key_scan_timer = 0; // 重置<EFBFBD><EFBFBD>描分频<EFBFBD><EFBFBD>数<EFBFBD><EFBFBD>
+    u8 raw_sos     = !KEY_SOS; // 恢复 SOS 物理按键电平检测
+    key_scan_timer = 0; // 重置扫描分频计数器

-    // 【SOS 按键电平实时诊断<EFBFBD><EFBFBD>
+    // 【SOS 按键电平实时诊断】
    {
        static u8 last_raw_sos = 99;
        if (raw_sos != last_raw_sos) {
@@ -210,7 +210,7 @@ void Event_KeyScan_Poll(void)
        }
    }

-    // 按键调试诊断：若按键 ADC 值有变化或<EFBFBD><EFBFBD>于高电平，串口输出真实 ADC <EFBFBD><EFBFBD>
+    // 按键调试诊断：若按键 ADC 值有变化或处于高电平，串口输出真实 ADC 值
    {
        u16 down_val = ADC_ReadFiltered(ADC_CHANNEL_KEY_DOWN);
        if (down_val > 2800) {
@@ -223,35 +223,35 @@ void Event_KeyScan_Poll(void)
        }
    }

-    // <EFBFBD><EFBFBD>测到有任意按<EFBFBD><EFBFBD>处于下压状<EFBFBD><EFBFBD>，立即将无操作闲置休眠计时器归<EFBFBD><EFBFBD>
+    // 检测到有任意按键处于下压状态，立即将无操作闲置休眠计时器归零
        if (raw_up || raw_down || raw_confirm || raw_sos) {
            inactivity_timer = 0;
        } else {
-            // 如果在常态下（非休眠、非报<EFBFBD><EFBFBD><EFBFBD><EFBFBD>非紧<EFBFBD><EFBFBD>求救），累加闲<EFBFBD><EFBFBD>时间
+            // 如果在常态下（非休眠、非报警、非紧急求救），累加闲置时间
            if (current_state != STATE_SLEEP && current_state != STATE_ALARM && current_state != STATE_SOS_EMITTED) {
                inactivity_timer++;
            }
        }

-        // 默<EFBFBD><EFBFBD>将派发事件重置为空
+        // 默认将派发事件重置为空
        evt.key_event = KEY_EVENT_NONE;
        evt.priority = EVENT_PRIORITY_NORMAL;
        evt.extra_data = 0;
        evt.extra_size = 0;

-        // 双键组合判定：▲ <EFBFBD><EFBFBD> and <EFBFBD><EFBFBD> <20><>同时按下的消抖与生成
+        // 双键组合判定：▲ 键 and ▼ 键同时按下的消抖与生成
        if (raw_up && raw_down) {
            comb_hold++;
-            if (comb_hold == 300) { // 持续按下<EFBFBD><EFBFBD> 3 <EFBFBD><EFBFBD> (300 * 10ms = 3s)
+            if (comb_hold == 300) { // 持续按下达 3 秒 (300 * 10ms = 3s)
                evt.key_event = KEY_EVENT_UP_DOWN_COMB;
                EventQueue_Push(evt); // 压入队列
            }
-            key_up_hold = 0;   // 清零单个按键计数，防止双击事件干<EFBFBD><EFBFBD>
+            key_up_hold = 0;   // 清零单个按键计数，防止双击事件干扰
            key_down_hold = 0;
        } else {
-            comb_hold = 0; // 组合<EFBFBD><EFBFBD>松开归零
+            comb_hold = 0; // 组合键松开归零

-            // <EFBFBD><EFBFBD> (KEY_UP) 按键状<EFBFBD><EFBFBD>机
+            // ▲ (KEY_UP) 按键状态机
            if (raw_up) {
                key_up_hold++;
                if (key_up_hold == 300) { // 达到 3 秒判定为长按
@@ -259,7 +259,7 @@ void Event_KeyScan_Poll(void)
                    EventQueue_Push(evt);
                }
            } else {
-                // 如果松开时按下<EFBFBD><EFBFBD>数在消抖阈值（20ms）至长按阈<EFBFBD><EFBFBD>（3s）之间，则判定为<EFBFBD><EFBFBD>次短<EFBFBD><EFBFBD>
+                // 如果松开时按下计数在消抖阈值（20ms）至长按阈值（3s）之间，则判定为一次短按
                if (key_up_hold >= 2 && key_up_hold < 300) {
                    evt.key_event = KEY_EVENT_UP_CLICK;
                    EventQueue_Push(evt);
@@ -267,15 +267,15 @@ void Event_KeyScan_Poll(void)
                key_up_hold = 0; // 释放归零
            }

-            // <EFBFBD><EFBFBD> (KEY_DOWN / <EFBFBD><EFBFBD>关机) 按键状<EFBFBD><EFBFBD>机
+            // ▼ (KEY_DOWN / 开关机) 按键状态机
            if (raw_down) {
                key_down_hold++;
-                if (key_down_hold == 100) { // 长按 1 <EFBFBD><EFBFBD> (100 * 10ms = 1000ms = 1s) 触发关机事件
+                if (key_down_hold == 100) { // 长按 1 秒 (100 * 10ms = 1000ms = 1s) 触发关机事件
                    evt.key_event = KEY_EVENT_POWER_OFF;
                    EventQueue_Push(evt);
                }
            } else {
-                // 如果松开时按下时长在 20ms <EFBFBD><EFBFBD> 1s 之间，触发短按下<EFBFBD><EFBFBD>/选择事件
+                // 如果松开时按下时长在 20ms 至 1s 之间，触发短按下翻/选择事件
                if (key_down_hold >= 2 && key_down_hold < 100) {
                    evt.key_event = KEY_EVENT_DOWN_CLICK;
                    EventQueue_Push(evt);
@@ -283,10 +283,10 @@ void Event_KeyScan_Poll(void)
                key_down_hold = 0; // 释放归零
            }

-            // <EFBFBD><EFBFBD> (KEY_CONFIRM) <EFBFBD><EFBFBD>认按<EFBFBD><EFBFBD>状<EFBFBD><EFBFBD>机
+            // ■ (KEY_CONFIRM) 确认按键状态机
            if (raw_confirm) {
                key_confirm_hold++;
-                if (key_confirm_hold == 300) { // 长按 3 秒打<EFBFBD><EFBFBD>主菜<EFBFBD><EFBFBD>
+                if (key_confirm_hold == 300) { // 长按 3 秒打开主菜单
                    evt.key_event = KEY_EVENT_CONFIRM_LONG;
                    EventQueue_Push(evt);
                }
@@ -298,23 +298,23 @@ void Event_KeyScan_Poll(void)
                key_confirm_hold = 0; // 释放归零
            }

-            // SOS <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȱ<EFBFBD><EFBFBD><EFBFBD>״̬<EFBFBD><EFBFBD> (<28>ѽ<EFBFBD><D1BD><EFBFBD>)
+            // SOS 物理求救按键状态机 (已解锁)
            if (raw_sos) {
                key_sos_hold++;
-                if (key_sos_hold == 300) { // <EFBFBD><EFBFBD><EFBFBD><EFBFBD> 3 <20>룬<EFBFBD><EBA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȣ<EFBFBD><C8A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
+                if (key_sos_hold == 300) { // 长按 3 秒，发出求救，插入队首
                    evt.key_event = KEY_EVENT_SOS_LONG;
                    evt.priority = EVENT_PRIORITY_URGENT;
                    EventQueue_InsertFront(evt);
                    Uart_SendString("[KEY-DIAG] SOS Long Press Dispatched!\r\n");
                }
            } else {
-                if (key_sos_hold >= 2 && key_sos_hold < 300) { // <EFBFBD>̰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȣ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
+                if (key_sos_hold >= 2 && key_sos_hold < 300) { // 短按即呼救，插入队首
                    evt.key_event = KEY_EVENT_SOS_CLICK;
                    evt.priority = EVENT_PRIORITY_URGENT;
                    EventQueue_InsertFront(evt);
                    Uart_SendString("[KEY-DIAG] SOS Click Dispatched!\r\n");
                }
-                key_sos_hold = 0; // <EFBFBD>ͷŹ<EFBFBD><EFBFBD><EFBFBD>
+                key_sos_hold = 0; // 释放归零
            }
        }
 }