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

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

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

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

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

==速查==

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


{| class="wikitable"
! 动画 !! 指示灯 !! 含义
|-
| [[File:Pcat2-led-orange-breathing-v2.gif|52px|link=]] || 🟠 黄色呼吸 || 正在充电，系统运行中
|-
| [[File:Pcat2-led-orange-solid-v2.gif|52px|link=]] || 🟠 黄色常亮 || 正在充电，系统已关机
|-
| [[File:Pcat2-led-green-breathing-v2.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-v2.gif|44px|link=]] || 🟠 黄色 || 呼吸（开机） || 渐亮 2.8 s / 渐暗 2.8 s / 熄灭 0.24 s，周期约 5.84 s
|-
| 充电中，任意电量 || 已插入 || [[File:Pcat2-led-orange-solid-v2.gif|44px|link=]] || 🟠 黄色 || 常亮（关机） || 持续
|-
| 已充满或达充电上限 || 已插入 || [[File:Pcat2-led-green-breathing-v2.gif|44px|link=]] || 🟢 绿色 || 呼吸（开机） || 同为 5.84 s 周期，延迟 10 s 后生效
|-
| 已充满或达充电上限 || 已插入 || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 绿色 || 常亮（关机） || 持续，延迟 10 s 后生效
|-
| 低于 6600 mV，DC ≥ 8 V 且无充电电流 || 已插入 || [[File:Pcat2-led-orange-solid-v2.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，持续到松开或电压回升
|-
| 拔出充电器且关机 || 未插入 || [[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-v2.gif|44px|link=]] || 🟠 黄色 || 快闪 || 周期约 0.5 s
|-
| 复位 / 恢复出厂模式 || [[File:Pcat2-led-orange-blink-slow-v2.gif|44px|link=]] || 🟠 黄色 || 慢闪 || 周期约 1 s
|}

==低电量红灯==

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

{| class="wikitable"
! 项目 !! 说明
|-
| 触发条件 || 电池电压低于 '''6500 mV'''（2S 电池组，约 3.25 V/节），且'''未插充电器'''
|-
| 闪烁节奏 || 亮 1 秒 / 灭 1 秒
|-
| 闪烁次数 || '''持续闪烁'''，直到电压回升或插上充电器
|-
| 开机状态下 || 电压持续低于门限 '''60 秒'''后才开始闪
|-
| 短按电源键 || 电压低时短按一下可立即触发红闪（约 0.5 秒防抖）
|-
| 绿灯会怎样 || 红灯期间绿色心跳会停止，两者不会同时亮
|}

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

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

==充电上限==

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

==说明==

* 呼吸的峰值亮度（25 % 占空）低于常亮（50 %），因此同色下呼吸看起来更暗。
* 🔴 红色仅用于低电量提示，会持续闪烁直到电压回升或接入充电器。
* 指示灯可通过上位机协议整体关闭，关闭后所有状态均不亮灯。
* 指示灯依据的电量是怎么算出来的，见 [[Photonicat 2 SOC 计算]]。

[[Category:Photonicat 2]]