查看“︁Photonicat 2 LED Indicator”︁的源代码

'''Photonicat 2''' has a single two-colour indicator LED (red + green). Yellow/orange is produced by lighting both colours together; there is no blue.

The indicator follows a MacBook-style scheme:
* '''Colour tells you the charge state''' — 🟠 yellow = charging, 🟢 green = charged.
* '''Motion tells you the machine state''' — breathing = system running, steady = system off.

Applies to firmware '''RA2E1260726001''' and later. Earlier firmware did not distinguish system on/off while charging or charged.

中文版见 [[Photonicat 2 LED 指示灯]]. For buzzer tones see [[Photonicat 2 Sound Guide]].

==Quick reference==

The animations below are illustrative; their timing matches the firmware (5.84 s breathing cycle, 2 s heartbeat).


{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v2.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v2.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v2.gif|52px|link=]] || 🟢 Green, breathing || Fully charged (or at charge limit), system running
|-
| [[File:Pcat2-led-green-solid-v2.gif|52px|link=]] || 🟢 Green, steady || Fully charged (or at charge limit), system off
|-
| [[File:Pcat2-led-green-heartbeat-v2.gif|52px|link=]] || 🟢 Green, heartbeat pulse || Running on battery, charge level normal
|-
| [[File:Pcat2-led-red-lowbatt-v2.gif|52px|link=]] || 🔴 Red, 3 flashes || Low battery (below 6500 mV, 3 flashes only — see [[#Low battery red light|Low battery red light]])
|-
| [[File:Pcat2-led-off-v2.gif|52px|link=]] || ⚫ Off || Idle on battery, system off
|}

==Full state table==

Battery thresholds are firmware defaults and can be overridden by the host. Values are for the 2S pack: full 8280 mV, low warning 6500 mV, minimum boot 6600 mV, hard shutdown 6300 mV.

{| class="wikitable"
! Power level !! Charger !! Animation !! Colour !! Pattern !! Timing
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-breathing-v2.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.24 s off, ≈5.84 s cycle
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v2.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v2.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same 5.84 s cycle, after 10 s delay
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 Green || Steady (system off) || Constant, after 10 s delay
|-
| Below 6600 mV, DC ≥ 8 V, no charge current || Connected || [[File:Pcat2-led-orange-solid-v2.gif|44px|link=]] || 🟠 Yellow || Steady || Constant
|-
| Above 6500 mV, system on || None || [[File:Pcat2-led-green-heartbeat-v2.gif|44px|link=]] || 🟢 Green || Heartbeat pulse || 2 s period
|-
| Above 6500 mV, system starting || None || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 Green || Steady || Constant
|-
| Above 6600 mV, system off || None || [[File:Pcat2-led-green-solid-v2.gif|44px|link=]] || 🟢 Green || Steady || Constant
|-
| Below 6500 mV, system on || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, 3 flashes, begins after 60 s
|-
| Below 6500 mV, short press || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, 3 flashes
|-
| Charger removed, system off || None || [[File:Pcat2-led-off-v2.gif|44px|link=]] || colspan="2" | ⚫ Off
|}

==Service and transitional states==

These override the states above.

{| class="wikitable"
! State !! Animation !! Colour !! Pattern !! Timing
|-
| Shutting down || [[File:Pcat2-led-green-blink-shutdown-v2.gif|44px|link=]] || 🟢 Green || Blink || ≈0.5 s on / 1.5 s off
|-
| Firmware download mode || [[File:Pcat2-led-orange-blink-fast-v2.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v2.gif|44px|link=]] || 🟠 Yellow || Slow blink || ≈1 s period
|}

==Low battery red light==

When the battery runs low the indicator turns 🔴 '''flashing red'''. This is the only situation in which red is used.

{| class="wikitable"
! Item !! Detail
|-
| Trigger || Battery below '''6500 mV''' (2S pack, about 3.25 V per cell) with '''no charger connected'''
|-
| Rhythm || 1 second on / 1 second off
|-
| Repeats || '''Stops after 3 flashes''' — it does not keep flashing
|-
| While running || Starts only after the voltage has stayed below the threshold for '''60 seconds'''
|-
| Short press || With a low battery, a short press of the power button shows it immediately (3 flashes after a 0.5 s debounce)
|-
| Effect on green || The green heartbeat stops while red is active; the two never show together
|}

'''⚠️ Important'''

* The red warning '''stops after 3 flashes'''. If you miss it, there is no further light warning before the device shuts down.
* To check the level again, '''press the power button once''' to re-trigger the warning.
* The red threshold (6500 mV) is only '''200 mV above the hard shutdown point (6300 mV)'''. That is a very steep part of the 2S li-ion discharge curve, so connect a charger promptly once you see red.
* The trigger is '''voltage, not a percentage'''. Under heavy load the voltage sags and the warning can appear while a useful charge remains; when the load drops the voltage recovers and the warning stops.

==Charge limit==

If a charge limit is configured (for example 80 %), the charger is switched off once the pack reaches it. Charge current drops to zero, so the device treats this as fully charged and shows 🟢 '''green'''. The pack then powers the load and slowly discharges until it falls below the resume threshold, at which point charging restarts and the indicator returns to 🟠 yellow. Each transition is delayed by about 10 seconds.

==Notes==

* Breathing runs at a lower peak brightness (25 % duty) than steady (50 %), so a breathing indicator looks dimmer than a steady one of the same colour.
* 🔴 Red is only ever used for low battery, and stops after three flashes rather than flashing continuously.
* The indicator can be disabled entirely through the host protocol, in which case it stays off in all states.

[[Category:Photonicat 2]]