查看“︁Photonicat 2 LED 指示灯”︁的源代码

'''光影猫2''' 只有一颗双色指示灯（红 + 绿）。黄色（橙色）由红绿同时点亮合成，没有蓝色。

指示灯采用 MacBook 式的表示方式：
* '''颜色表示充电状态''' —— 🟠 黄色 = 正在充电，🟢 绿色 = 已充满。
* '''呼吸与否表示主机状态''' —— 呼吸 = 系统运行中，常亮 = 系统已关机。

适用于固件 '''RA2E1260726001''' 及之后版本。较早的固件在充电和充满时不区分开关机状态。

自 '''RA2E1260731011''' 起：充电橙色更暖（红 60 % / 绿 24 %，原为 55 %/35 %）；呼吸只降到约峰值 1/12 的暗橙再进入谷底熄灭——旧固件呼吸首尾极暗处会显得像纯红——谷底熄灭保持由 0.24 s 加长到 0.5 s（周期约 6.1 s）。

自 '''RA2E1260802000''' 起：电池耗尽或电压过低时尝试开机，会立刻红灯'''闪 3 次'''（更早的固件此时什么都不显示，空电设备看起来像变砖）；关机状态下短按遇到低电同样闪 3 次。持续红闪仅在系统运行中使用。长按开关机时长改为 1.5 秒。

'''RA2E1260805000''' 修复：RA2E1260802000–RA2E1260802001 存在缺陷——设备关机待机时短按电源键，'''即使电池满电'''也可能红灯闪 3 次。原因是待机唤醒瞬间电压传感器短暂读到 0 mV，被误判为低电量。现在只有真实的低电压读数才会触发红灯。

自 '''RA2E1260808001''' 起：关机状态下电池低于最低开机电压（6600 mV）时，'''任何'''按键都会在按下约 0.1 秒时立即红灯闪 3 次——判定发生在给主机供电之前，主机电源轨完全不动——闪完后设备回到深度睡眠，把最后的电量留给内置时钟走时。RA2E1260802000–RA2E1260808000 上，开机被拒的红闪要按满 1.5 秒长按并松手后才出现，短按在松手前没有任何提示。

英文版见 [[Photonicat 2 LED Indicator]]。提示音说明见 [[Photonicat 2 提示音说明]]。

==速查==

以下动画为示意，节奏与实际固件一致（呼吸周期约 6.1 秒、心跳周期 2 秒）。


{| class="wikitable"
! 动画 !! 指示灯 !! 含义
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 黄色呼吸 || 正在充电，系统运行中
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 黄色常亮 || 正在充电，系统已关机
|-
| [[File:Pcat2-led-green-breathing-v3.gif|52px|link=]] || 🟢 绿色呼吸 || 已充满（或已达充电上限），系统运行中
|-
| [[File:Pcat2-led-green-solid-v2.gif|52px|link=]] || 🟢 绿色常亮 || 已充满（或已达充电上限），系统已关机
|-
| [[File:Pcat2-led-green-heartbeat-v2.gif|52px|link=]] || 🟢 绿色心跳脉冲 || 电池供电运行中，电量正常
|-
| [[File:Pcat2-led-red-lowbatt-v2.gif|52px|link=]] || 🔴 红色持续闪烁 || 电量低（低于 6500 mV，详见下方[[#低电量红灯|低电量红灯]]）
|-
| [[File:Pcat2-led-off-v2.gif|52px|link=]] || ⚫ 熄灭 || 电池供电待机，系统已关机
|}

==完整状态表==

电压门限为固件默认值，可由上位机覆盖。以下为 2S 电池组数值：满电 8280 mV、低电告警 6500 mV、最低开机 6600 mV、强制关机 6300 mV。

{| class="wikitable"
! 电量 !! 充电器 !! 动画 !! 颜色 !! 形态 !! 节奏
|-
| 充电中，任意电量 || 已插入 || [[File:Pcat2-led-orange-breathing-v3.gif|44px|link=]] || 🟠 黄色 || 呼吸（开机） || 渐亮 2.8 s / 渐暗 2.8 s / 熄灭 0.5 s，周期约 6.1 s；谷底降到约峰值 1/12 的暗橙，不会出现纯红
|-
| 充电中，任意电量 || 已插入 || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 黄色 || 常亮（关机） || 持续
|-
| 已充满或达充电上限 || 已插入 || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 绿色 || 呼吸（开机） || 同为约 6.1 s 周期，延迟 10 s 后生效
|-
| 已充满或达充电上限 || 已插入 || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 绿色 || 常亮（关机） || 持续，延迟 10 s 后生效
|-
| 低于 6600 mV，DC ≥ 8 V 且无充电电流 || 已插入 || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 黄色 || 常亮 || 持续
|-
| 高于 6500 mV，开机 || 未插入 || [[File:Pcat2-led-green-heartbeat-v2.gif|44px|link=]] || 🟢 绿色 || 心跳脉冲 || 周期 2 s
|-
| 高于 6500 mV，正在开机 || 未插入 || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 绿色 || 常亮 || 持续
|-
| 高于 6600 mV，关机 || 未插入 || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 绿色 || 常亮 || 持续
|-
| 低于 6500 mV，开机 || 未插入 || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 红色 || 持续闪烁 || 亮 1 s / 灭 1 s，60 s 后开始，持续到电压回升
|-
| 低于 6500 mV（有效读数），关机短按一次 || 未插入 || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 红色 || 闪烁 || 亮 1 s / 灭 1 s，'''闪 3 次'''，首次立即亮（约 0.5 s 防抖）
|-
| 低于 6600 mV，关机时按下任意按键 || 未插入 || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 红色 || 闪烁 || '''闪 3 次'''，按下约 0.1 s 即开始（'''RA2E1260808001''' 起；旧固件要按满 1.5 s 长按并松手才闪）。主机电源轨不会上电，闪完后设备回到深度睡眠
|-
| 拔出充电器且关机 || 未插入 || [[File:Pcat2-led-off-v2.gif|44px|link=]] || colspan="2" | ⚫ 熄灭
|}

==服务与过渡状态==

以下状态优先级高于上表。

{| class="wikitable"
! 状态 !! 动画 !! 颜色 !! 形态 !! 节奏
|-
| 正在关机 || [[File:Pcat2-led-green-blink-shutdown-v2.gif|44px|link=]] || 🟢 绿色 || 闪烁 || 约亮 0.5 s / 灭 1.5 s
|-
| 固件烧录模式 || [[File:Pcat2-led-orange-blink-fast-v3.gif|44px|link=]] || 🟠 黄色 || 快闪 || 周期约 0.5 s
|-
| 复位 / 恢复出厂模式 || [[File:Pcat2-led-orange-blink-slow-v3.gif|44px|link=]] || 🟠 黄色 || 慢闪 || 周期约 1 s
|}

==低电量红灯==

电量过低时指示灯会变为 🔴 '''红色闪烁'''，这是唯一使用红色的场合。

{| class="wikitable"
! 项目 !! 说明
|-
| 触发条件 || 电池电压低于 '''6500 mV'''（2S 电池组，约 3.25 V/节），且'''未插充电器'''
|-
| 闪烁节奏 || 亮 1 秒 / 灭 1 秒
|-
| 闪烁次数 || '''开机状态：'''持续闪烁，直到电压回升或插上充电器。'''关机状态'''（按下任意按键）：只'''闪 3 次'''，随后设备回到深度睡眠
|-
| 开机状态下 || 电压持续低于门限 '''60 秒'''后才开始闪
|-
| 关机时按任意键 || 电池低于开机门限时，任何按键都会在按下约 0.1 秒时红灯闪 3 次（'''RA2E1260808001''' 起），闪完后设备回到深度睡眠。待机唤醒瞬间传感器的 0 mV 预热读数不会触发——固件会先补采一次真实电压再判定（'''RA2E1260805000''' 起）
|-
| 绿灯会怎样 || 红灯期间绿色心跳会停止，两者不会同时亮
|}

'''⚠️ 重要提醒'''

* 系统运行中，红灯会'''一直闪到电压回升或接入充电器'''，不会自行停止。（RA2E1260726003 之前的固件只闪 3 次就不再提示。）系统关机时，短按或开机被拒只闪 3 次，随后 MCU 回到待机。
* 红灯触发点（6500 mV）与'''强制关机点（6300 mV）只差 200 mV'''，在 2S 锂电的放电末端属于很陡的一段，看到红灯应尽快接入充电器。
* 判据是'''电压不是百分比'''：大负载下电压会被拉低，可能在剩余电量还不算太少时就提前告警；负载减轻后电压回升，告警也会随之消失。

==充电上限==

若设置了充电上限（例如 80 %），电量达到上限后会断开充电，充电电流归零，设备据此按“已充满”处理并显示 🟢 '''绿色'''。此后由电池给负载供电并缓慢放电，低于恢复门限后重新开始充电，指示灯回到 🟠 黄色。每次切换约有 10 秒延迟。

==说明==

* 绿色呼吸峰值 25 % 占空、绿色常亮 50 %，所以绿色呼吸比常亮更暗；橙色呼吸峰值与橙色常亮相同（红 60 % / 绿 24 %）。
* 🔴 红色仅用于低电量提示：系统运行中持续闪烁直到电压回升或接入充电器；系统关机时只闪 3 次。
* 指示灯可通过上位机协议整体关闭，关闭后所有状态均不亮灯。
* 指示灯依据的电量是怎么算出来的，见 [[Photonicat 2 SOC 计算]]。

[[Category:Photonicat 2]]