Photonicat Wiki - 用户贡献 [zh-cn]

Photonicat 2 固件 Changelog

2026-11-10T08:24:28Z

C2h2：/* MCU Changes */

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Improved upstream Wi-Fi — more stable''' — your own network name and password are kept across a reboot and restored when you turn the relay off.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

== 2026-08-14 r7907 ==

* '''LXC containers''' — containers now survive a firmware upgrade; added container backup/restore, image downloads that recover from a flaky CDN, self-healing of the network bridge on start, and a Proxmox-style resizable console popup; fixed CPU/memory bars showing empty.
* '''GPS''' — trip odometer on the web GPS page and the mini display, and map tiles fall back to mirror servers when the main tile server is blocked.
* '''Web terminal''' — /terminal is now a real WebSocket console (via granian ASGI) instead of polling, with a cleaner full-screen console popup.
* '''Safer firmware updates''' — the web UI can no longer reboot the device mid-flash, the update screen shows a realistic 3–5 minute estimate with a restarting overlay, and power-off is available from the user menu.
* '''Networking fixes''' — upstream WiFi gets a boot grace period so one failed probe right after boot no longer bounces the egress; the connectivity probe now works behind transparent proxies (e.g. OpenClash); cellular interfaces dialled manually through netifd are left alone; hotspot settings survive the firmware regenerating the config.
* '''Smaller root filesystem''' — multimedia applications, Realtek wireless drivers and other rarely-used packages are now optional modules instead of preinstalled, more kernel modules are available to install, and the BPF traffic scheduler (<code>kmod-sched-bpf</code>) is enabled.
* '''RK3576 platform fixes''' — backported upstream device-tree fixes for Photonicat 2 and added the missing CPU cache-hierarchy description.
* '''LED/beeper schedules''' — schedule delivery to the MCU is now verified end-to-end, degrading gracefully instead of failing silently.
* '''Mini display and screen''' — a proxy's fake-IP DNS answers no longer fail both LCD ping rows; auto-dim delays can be edited in seconds, minutes or hours; the live screen preview refreshes at 1 Hz and can no longer freeze; car mode shows the configured timeout instead of a made-up 10 minutes.
* '''Bluetooth''' — the AIC8800's Bluetooth is now built in BlueZ mode so a standard HCI adapter appears, and a new Bluetooth panel on the /dev page can diagnose the adapter and scan for nearby devices.
=== MCU Changes ===
Latest MCU firmware version: <code>RA2E1260813002</code>.

* '''Raise-to-wake now responds in 1–2 seconds''' — confirmation uses a leaky integrator, so hand tremor no longer restarts the detection pipeline; a knock on the desk no longer fakes a pick-up.
* '''Car mode''' — a manual shutdown with DC power still plugged in no longer bounces straight back on.
* '''Battery groundwork''' — added a coulomb-meter test harness and machine-learned LFP state-of-charge work, groundwork for further battery-percentage accuracy improvements.

== 2026-10-01 r7924 ==

* '''Settings survive an upgrade''' — power mode, menus, fan, SMS, call history, traffic stats, power schedules, car mode, the charge limit and the APN are now in keep.d, so sysupgrade no longer wipes them. Login sessions and the map caches are still cleared.
* '''Power schedules run on local time''' — pcat-manager treated local time as UTC, so CST was 8 hours late and events at 00:00–07:59 fell on the wrong day. It now reads /etc/TZ and shifts the weekday with the clock. The saved schedule is readable from the MCU right after boot.
* '''Plug in a cable and the port works immediately''' — eth-powersave now uses the RTL8211F's own ALDPS, instead of switching the port off and probing it on a timer. An idle PHY sleeps on its own and wakes as soon as a cable is inserted, including after a cold boot. The default is on; a per-port choice you made is left alone.
* '''LAN clients get a public IPv6 address on cellular''' — the cellular interfaces set extendprefix (RFC 7278) and hand the bearer's /64 to the LAN. The firewall still rejects inbound connections. Wired WAN is unchanged. An upgrade that keeps a network or firewall config you edited will not switch to this on its own.
* '''FM350 5G SA connects and stays up''' — data is dialled on cid 5 with the real APN, instead of sitting on LTE and redialling on a timer. A drop in weak signal reconnects immediately, and the network mode and bands from the web UI are written and applied.
* '''Wi-Fi''' — boot no longer deletes the upstream STA as a duplicate USB radio, and a changed SSID and password are no longer wiped. The WCN7850 firmware is no longer stripped at install, so the PCIe card is detected and recovers in about 20 seconds after a brief dropout. Upstream Wi-Fi accepts a chosen MAC. The Device Control switches take effect, and WPA3-SAE is offered where the radio supports it. Idle shutdown does not start counting down when the client count cannot be read.
* '''A hotel portal can be signed in''' — when another uplink is already online, tap "login required" in the priority table and that cable becomes the egress for 15 minutes, so its login page can open.
* '''The statistics page is rebuilt''' — a throughput chart of the last 5 minutes, wired and cellular side by side, per-core CPU, memory, eMMC / SD / NVMe / USB, and every DHCP client.
* '''The LED and beeper follow the hours you set''' — the MCU clock is set every hour, and the schedule is checked every 10 minutes and pushed again if it does not match. Each of the two checks on the small screen can be ICMP, TCP, HTTP or HTTPS.
* '''dnsmasq is updated to 2.93''', including the DNSSEC KeyTrap fix. Wired or Wi-Fi has to stay up or down for about 9 seconds before cellular is stopped or brought back.

== 2026-11-03 MCU update==
=== MCU Changes ===
Latest MCU firmware version: <code>RA2E1261103004</code>.

* '''Fix failed to update MCU by OTA in some situations'''

== APK version ==
* Under testing, releasing soon.

Photonicat 2 固件更新日志

2026-11-10T08:23:54Z

C2h2：

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''上游 WiFi 功能改进,更加稳定''' —— 重启后仍保留您自己的网络名称和密码,关闭中继后也会自动恢复。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

== 2026-08-17 r7908 ==

* '''LXC 容器''' —— 容器现在可以在固件升级后保留；新增容器备份/恢复，下载镜像时可从不稳定的 CDN 自动恢复，容器启动时自动修复网络桥接，并提供 Proxmox 风格、可调整大小的控制台弹窗；修复 CPU/内存占用条一直显示为空的问题。
* '''GPS''' —— 网页 GPS 页面与迷你显示屏新增行程里程表；主地图瓦片服务器被屏蔽时自动切换到镜像服务器。
* '''网页终端''' —— /terminal 改为基于 granian ASGI 的真正 WebSocket 控制台，不再使用轮询，控制台弹窗界面也更简洁。
* '''更安全的固件更新''' —— 网页界面不会再在刷写过程中重启设备；更新页面给出更真实的 3–5 分钟预估并显示重启中遮罩；用户菜单中新增关机选项。
* '''网络修复''' —— 上级 WiFi 增加开机宽限期，开机后第一次探测失败不再导致出口切换；连通性探测在透明代理（如 OpenClash）环境下也能正常工作；不再干预用户通过 netifd 手动拨号的蜂窝接口；热点设置在固件重新生成配置后依然保留。
* '''更小的根文件系统''' —— 多媒体应用、Realtek 无线驱动等不常用软件包改为可选模块，不再预装；提供更多可安装的内核模块；默认启用 BPF 流量调度器（<code>kmod-sched-bpf</code>）。
* '''RK3576 平台修复''' —— 合入上游针对 Photonicat 2 的设备树修复，并补上缺失的 CPU 缓存层级描述。
* '''LED/蜂鸣器定时计划''' —— 定时计划下发到 MCU 现在有端到端校验，失败时逐级降级而不是静默失败。
* '''迷你显示屏与屏幕设置''' —— 代理的 fake-IP DNS 应答不再导致 LCD 两行 ping 同时失败；自动熄屏延时可按秒、分钟或小时设置；屏幕实时预览以 1 Hz 刷新且不再卡死；车载模式显示实际配置的超时时间，而不是虚构的 10 分钟。
* '''蓝牙''' —— AIC8800 的蓝牙现在以 BlueZ 模式构建，系统中会出现标准 HCI 适配器；/dev 页面新增蓝牙面板，可诊断适配器并扫描附近设备。

=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1260813002</code>。

* '''抬起唤醒响应缩短到 1–2 秒''' —— 确认逻辑改用漏积分器，手部抖动不再重置检测流程；敲桌子也不会再被误判为拿起。
* '''车载模式''' —— DC 电源仍插着时手动关机，设备不会再自动重新开机。
* '''电池基础工作''' —— 新增库仑计测试工具与基于机器学习的磷酸铁锂（LFP）电量估算研究，为进一步提升电量百分比精度打基础。

== 2026-10-01 r7924 ==

* '''升级后保留设置''' —— 电源模式、菜单、风扇、短信、通话记录、流量统计、定时开关机、车载模式、充电上限和 APN 现在列入 keep.d，sysupgrade 不再清掉。登录会话和地图缓存仍会清空。
* '''定时开关机按本地时间执行''' —— pcat-manager 以前把本地时间当成 UTC，东八区晚 8 小时，00:00–07:59 的计划还会错一天。现在读取 /etc/TZ 并换算星期。开机后马上能读到 MCU 上的计划。
* '''插上网线，网口马上可用''' —— eth-powersave 改为使用 RTL8211F 自带的 ALDPS，不再自己关断网口再定时探测。空闲 PHY 自己休眠，插线后马上唤醒，冷启动也不再像网口坏了。默认改为启用；单独设置过的网口保持原样。
* '''蜂窝下局域网拿到公网 IPv6''' —— 蜂窝接口启用 extendprefix（RFC 7278），把承载的 /64 分给 LAN。防火墙默认仍拒绝入站。有线 WAN 不变。改过网络或防火墙的升级不会自动套用。
* '''FM350 的 5G SA 会拨上并保持''' —— 数据改在带正确 APN 的 cid 5 上建立，不再停在 LTE 再周期性拆掉重拨。信号边缘掉线后马上重连，网页里的网络模式和频段会写入并生效。
* '''WiFi''' —— 开机不再把上级 STA 当成多余的 USB 网卡删掉，改过的 SSID 和密码也不会被清掉。WCN7850 固件不再在安装时被 strip，PCIe 卡能识别，短暂掉线后约 20 秒恢复。上级 WiFi 可指定 MAC。设备控制里的开关会生效，支持的射频可选 WPA3-SAE。读不到在线客户端时，空闲关机不再倒计时。
* '''酒店门户可以登录''' —— 另一条上行已经在线时，点优先级表的“需要登录”，这条网线会临时成为出口 15 分钟，登录页才能打开。
* '''流量页重做''' —— 最近 5 分钟的吞吐曲线，有线与蜂窝并排，每核 CPU、内存、eMMC / SD / NVMe / USB，以及全部 DHCP 客户端。
* '''LED 和蜂鸣器按设定时间开关''' —— 每小时对一次 MCU 时钟，每 10 分钟核对定时并在不一致时重下发。小屏幕两行检测可选 ICMP、TCP、HTTP 或 HTTPS。
* '''dnsmasq 升级到 2.93'''，含 DNSSEC KeyTrap 修复。有线或 WiFi 要连续在线或断开约 9 秒，才会停下或重新拉起蜂窝。

== 2026-11-03 MCU update==
=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1261103004</code>。

* '''修复一部分MCU更新失败的问题'''

== APK 版本 ==
* 正在测试，即将发布。

Photonicat 2 固件 Changelog

2026-10-02T14:38:53Z

C2h2：r7924: note RTL8211F ALDPS, slightly more detail

Photonicat 2 固件更新日志

2026-10-02T14:38:50Z

C2h2：r7924: note RTL8211F ALDPS, slightly more detail

Photonicat 2 固件 Changelog

2026-10-02T14:30:44Z

C2h2：r7924 date 2026-10-01; APK build still in testing

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Improved upstream Wi-Fi — more stable''' — your own network name and password are kept across a reboot and restored when you turn the relay off.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

== 2026-08-14 r7907 ==

* '''LXC containers''' — containers now survive a firmware upgrade; added container backup/restore, image downloads that recover from a flaky CDN, self-healing of the network bridge on start, and a Proxmox-style resizable console popup; fixed CPU/memory bars showing empty.
* '''GPS''' — trip odometer on the web GPS page and the mini display, and map tiles fall back to mirror servers when the main tile server is blocked.
* '''Web terminal''' — /terminal is now a real WebSocket console (via granian ASGI) instead of polling, with a cleaner full-screen console popup.
* '''Safer firmware updates''' — the web UI can no longer reboot the device mid-flash, the update screen shows a realistic 3–5 minute estimate with a restarting overlay, and power-off is available from the user menu.
* '''Networking fixes''' — upstream WiFi gets a boot grace period so one failed probe right after boot no longer bounces the egress; the connectivity probe now works behind transparent proxies (e.g. OpenClash); cellular interfaces dialled manually through netifd are left alone; hotspot settings survive the firmware regenerating the config.
* '''Smaller root filesystem''' — multimedia applications, Realtek wireless drivers and other rarely-used packages are now optional modules instead of preinstalled, more kernel modules are available to install, and the BPF traffic scheduler (<code>kmod-sched-bpf</code>) is enabled.
* '''RK3576 platform fixes''' — backported upstream device-tree fixes for Photonicat 2 and added the missing CPU cache-hierarchy description.
* '''LED/beeper schedules''' — schedule delivery to the MCU is now verified end-to-end, degrading gracefully instead of failing silently.
* '''Mini display and screen''' — a proxy's fake-IP DNS answers no longer fail both LCD ping rows; auto-dim delays can be edited in seconds, minutes or hours; the live screen preview refreshes at 1 Hz and can no longer freeze; car mode shows the configured timeout instead of a made-up 10 minutes.
* '''Bluetooth''' — the AIC8800's Bluetooth is now built in BlueZ mode so a standard HCI adapter appears, and a new Bluetooth panel on the /dev page can diagnose the adapter and scan for nearby devices.
=== MCU Changes ===
Latest MCU firmware version: <code>RA2E1260813002</code>.

* '''Raise-to-wake now responds in 1–2 seconds''' — confirmation uses a leaky integrator, so hand tremor no longer restarts the detection pipeline; a knock on the desk no longer fakes a pick-up.
* '''Car mode''' — a manual shutdown with DC power still plugged in no longer bounces straight back on.
* '''Battery groundwork''' — added a coulomb-meter test harness and machine-learned LFP state-of-charge work, groundwork for further battery-percentage accuracy improvements.

== 2026-10-01 r7924 ==

* '''Your settings survive an upgrade''' — power mode, menus, fan, SMS, call history, traffic stats, power schedules, car mode, the charge limit and the modem's access settings are kept. You are still logged out, and the large map caches are still cleared.
* '''Power schedules run at the time you set''' — no longer 8 hours late in CST, early-morning events fall on the right day, and the list shows up right after boot.
* '''Plug in a cable and the port works immediately''' — a cold boot no longer looks like a dead port. The default is now always on; a per-port choice you made is left alone.
* '''On mobile data, devices behind the router get a public IPv6 address.''' Incoming connections stay blocked until you allow them. An upgrade that keeps a network config you edited will not switch to this on its own.
* '''FM350 5G connects and stays up''' — a drop in weak signal reconnects immediately, and the network mode and bands you pick in the web UI take effect.
* '''Wi-Fi''' — upstream Wi-Fi, and a hotspot name and password you changed, are still there after a reboot. The PCIe card is detected again and recovers in about 20 seconds after a brief dropout. Upstream Wi-Fi accepts a MAC address you choose. The switches on Device Control work, and WPA3 is offered when the card supports it. Idle shutdown no longer powers off while devices are connected.
* '''A hotel cable can be signed in''' — when another connection already has internet, tap "login required" in the priority table to give that cable 15 minutes to open its login page.
* '''The statistics page is rebuilt''' — live speed, wired and mobile side by side, CPU, memory, disks, and every device online.
* '''The light and beeper follow the hours you set.''' Each of the two checks on the small screen can be a connection test or a web test, not only ping.
* '''The DNS program is updated to 2.93''', including security fixes. Wired or Wi-Fi has to stay up or down for about 9 seconds before mobile data is stopped or started.

== APK version ==
* Under testing, releasing soon.

Photonicat 2 固件更新日志

2026-10-02T14:30:42Z

C2h2：r7924 date 2026-10-01; APK build still in testing

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''上游 WiFi 功能改进,更加稳定''' —— 重启后仍保留您自己的网络名称和密码,关闭中继后也会自动恢复。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

== 2026-08-17 r7908 ==

* '''LXC 容器''' —— 容器现在可以在固件升级后保留；新增容器备份/恢复，下载镜像时可从不稳定的 CDN 自动恢复，容器启动时自动修复网络桥接，并提供 Proxmox 风格、可调整大小的控制台弹窗；修复 CPU/内存占用条一直显示为空的问题。
* '''GPS''' —— 网页 GPS 页面与迷你显示屏新增行程里程表；主地图瓦片服务器被屏蔽时自动切换到镜像服务器。
* '''网页终端''' —— /terminal 改为基于 granian ASGI 的真正 WebSocket 控制台，不再使用轮询，控制台弹窗界面也更简洁。
* '''更安全的固件更新''' —— 网页界面不会再在刷写过程中重启设备；更新页面给出更真实的 3–5 分钟预估并显示重启中遮罩；用户菜单中新增关机选项。
* '''网络修复''' —— 上级 WiFi 增加开机宽限期，开机后第一次探测失败不再导致出口切换；连通性探测在透明代理（如 OpenClash）环境下也能正常工作；不再干预用户通过 netifd 手动拨号的蜂窝接口；热点设置在固件重新生成配置后依然保留。
* '''更小的根文件系统''' —— 多媒体应用、Realtek 无线驱动等不常用软件包改为可选模块，不再预装；提供更多可安装的内核模块；默认启用 BPF 流量调度器（<code>kmod-sched-bpf</code>）。
* '''RK3576 平台修复''' —— 合入上游针对 Photonicat 2 的设备树修复，并补上缺失的 CPU 缓存层级描述。
* '''LED/蜂鸣器定时计划''' —— 定时计划下发到 MCU 现在有端到端校验，失败时逐级降级而不是静默失败。
* '''迷你显示屏与屏幕设置''' —— 代理的 fake-IP DNS 应答不再导致 LCD 两行 ping 同时失败；自动熄屏延时可按秒、分钟或小时设置；屏幕实时预览以 1 Hz 刷新且不再卡死；车载模式显示实际配置的超时时间，而不是虚构的 10 分钟。
* '''蓝牙''' —— AIC8800 的蓝牙现在以 BlueZ 模式构建，系统中会出现标准 HCI 适配器；/dev 页面新增蓝牙面板，可诊断适配器并扫描附近设备。

=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1260813002</code>。

* '''抬起唤醒响应缩短到 1–2 秒''' —— 确认逻辑改用漏积分器，手部抖动不再重置检测流程；敲桌子也不会再被误判为拿起。
* '''车载模式''' —— DC 电源仍插着时手动关机，设备不会再自动重新开机。
* '''电池基础工作''' —— 新增库仑计测试工具与基于机器学习的磷酸铁锂（LFP）电量估算研究，为进一步提升电量百分比精度打基础。

== 2026-10-01 r7924 ==

* '''升级后保留设置''' —— 电源模式、菜单、风扇、短信、通话记录、流量统计、定时开关机、车载模式、充电上限和模块上网参数都会留下来。登录状态和大体积的地图缓存仍会清空。
* '''定时开关机按您设定的时间执行''' —— 东八区不再晚 8 小时，凌晨的计划落在正确的那一天，开机后马上能在页面上看到。
* '''插上网线，网口马上可用''' —— 冷启动不再像网口坏了。默认改为一直启用；您单独设置过的网口保持原样。
* '''只用蜂窝时，下面的设备能拿到公网 IPv6 地址。''' 防火墙默认仍挡住外面连进来。升级若保留了您改过的网络配置，则不会自动换成这套设置。
* '''FM350 的 5G 会连上并保持''' —— 信号不好掉线后马上重连，网页里选的网络模式和频段会生效。
* '''WiFi''' —— 上级 WiFi，以及您改过的热点名称和密码，重启后还在。PCIe 无线卡能正常识别，短暂掉线后大约 20 秒恢复。上级 WiFi 可以填写指定的 MAC。设备控制里的开关会生效，支持 WPA3 的网卡可以选用。还有设备连着时，空闲关机不会把机器关掉。
* '''酒店网线可以登录了''' —— 另一条网络已经能上网时，在优先级表点“需要登录”，会给这条网线 15 分钟去打开登录页。
* '''流量统计页重做''' —— 实时速度、有线与蜂窝、CPU、内存、磁盘，以及所有在线设备。
* '''指示灯和蜂鸣器按您设定的时间开关。''' 小屏幕上的两行检测可以改成连接测试或网页测试，不再只能 ping。
* '''DNS 程序升级到 2.93'''，包含安全修复。有线或 WiFi 要稳定大约 9 秒，才会停下或重新打开蜂窝。

== APK 版本 ==
* 正在测试，即将发布。

Photonicat 2 固件 Changelog

2026-10-02T14:28:22Z

C2h2：Changelog: Photonicat 2 r7924

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Improved upstream Wi-Fi — more stable''' — your own network name and password are kept across a reboot and restored when you turn the relay off.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

== 2026-08-14 r7907 ==

* '''LXC containers''' — containers now survive a firmware upgrade; added container backup/restore, image downloads that recover from a flaky CDN, self-healing of the network bridge on start, and a Proxmox-style resizable console popup; fixed CPU/memory bars showing empty.
* '''GPS''' — trip odometer on the web GPS page and the mini display, and map tiles fall back to mirror servers when the main tile server is blocked.
* '''Web terminal''' — /terminal is now a real WebSocket console (via granian ASGI) instead of polling, with a cleaner full-screen console popup.
* '''Safer firmware updates''' — the web UI can no longer reboot the device mid-flash, the update screen shows a realistic 3–5 minute estimate with a restarting overlay, and power-off is available from the user menu.
* '''Networking fixes''' — upstream WiFi gets a boot grace period so one failed probe right after boot no longer bounces the egress; the connectivity probe now works behind transparent proxies (e.g. OpenClash); cellular interfaces dialled manually through netifd are left alone; hotspot settings survive the firmware regenerating the config.
* '''Smaller root filesystem''' — multimedia applications, Realtek wireless drivers and other rarely-used packages are now optional modules instead of preinstalled, more kernel modules are available to install, and the BPF traffic scheduler (<code>kmod-sched-bpf</code>) is enabled.
* '''RK3576 platform fixes''' — backported upstream device-tree fixes for Photonicat 2 and added the missing CPU cache-hierarchy description.
* '''LED/beeper schedules''' — schedule delivery to the MCU is now verified end-to-end, degrading gracefully instead of failing silently.
* '''Mini display and screen''' — a proxy's fake-IP DNS answers no longer fail both LCD ping rows; auto-dim delays can be edited in seconds, minutes or hours; the live screen preview refreshes at 1 Hz and can no longer freeze; car mode shows the configured timeout instead of a made-up 10 minutes.
* '''Bluetooth''' — the AIC8800's Bluetooth is now built in BlueZ mode so a standard HCI adapter appears, and a new Bluetooth panel on the /dev page can diagnose the adapter and scan for nearby devices.
=== MCU Changes ===
Latest MCU firmware version: <code>RA2E1260813002</code>.

* '''Raise-to-wake now responds in 1–2 seconds''' — confirmation uses a leaky integrator, so hand tremor no longer restarts the detection pipeline; a knock on the desk no longer fakes a pick-up.
* '''Car mode''' — a manual shutdown with DC power still plugged in no longer bounces straight back on.
* '''Battery groundwork''' — added a coulomb-meter test harness and machine-learned LFP state-of-charge work, groundwork for further battery-percentage accuracy improvements.

== 2026-10-02 r7924 ==

* '''Your settings survive an upgrade''' — power mode, menus, fan, SMS, call history, traffic stats, power schedules, car mode, the charge limit and the modem's access settings are kept. You are still logged out, and the large map caches are still cleared.
* '''Power schedules run at the time you set''' — no longer 8 hours late in CST, early-morning events fall on the right day, and the list shows up right after boot.
* '''Plug in a cable and the port works immediately''' — a cold boot no longer looks like a dead port. The default is now always on; a per-port choice you made is left alone.
* '''On mobile data, devices behind the router get a public IPv6 address.''' Incoming connections stay blocked until you allow them. An upgrade that keeps a network config you edited will not switch to this on its own.
* '''FM350 5G connects and stays up''' — a drop in weak signal reconnects immediately, and the network mode and bands you pick in the web UI take effect.
* '''Wi-Fi''' — upstream Wi-Fi, and a hotspot name and password you changed, are still there after a reboot. The PCIe card is detected again and recovers in about 20 seconds after a brief dropout. Upstream Wi-Fi accepts a MAC address you choose. The switches on Device Control work, and WPA3 is offered when the card supports it. Idle shutdown no longer powers off while devices are connected.
* '''A hotel cable can be signed in''' — when another connection already has internet, tap "login required" in the priority table to give that cable 15 minutes to open its login page.
* '''The statistics page is rebuilt''' — live speed, wired and mobile side by side, CPU, memory, disks, and every device online.
* '''The light and beeper follow the hours you set.''' Each of the two checks on the small screen can be a connection test or a web test, not only ping.
* '''The DNS program is updated to 2.93''', including security fixes. Wired or Wi-Fi has to stay up or down for about 9 seconds before mobile data is stopped or started.

== 2026-08-14 r7902 (26.10.0) ==
* '''OpenWRT base system''' - Update to 26.10.0，completely migrate to OpenWRT 25.12 as base system. Install fw4 as default firewall. Package management system now switches to APK (IPK packages are not supported since this release).
* '''Backport photonicat (v1) support''' - Now all photonicat products use the same source tree.
* '''Kernel''' - Update to 6.12.103. Update ath12k firmware, AIC8800 driver. Backport mainline DFI (RK3576) and SGMII (RK3568) driver.
* '''pcat-manager''' - Fix incorrect timezone calculation in schedule tasks.

Photonicat 2 固件更新日志

2026-10-02T14:28:19Z

C2h2：Changelog: Photonicat 2 r7924

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''上游 WiFi 功能改进,更加稳定''' —— 重启后仍保留您自己的网络名称和密码,关闭中继后也会自动恢复。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

== 2026-08-17 r7908 ==

* '''LXC 容器''' —— 容器现在可以在固件升级后保留；新增容器备份/恢复，下载镜像时可从不稳定的 CDN 自动恢复，容器启动时自动修复网络桥接，并提供 Proxmox 风格、可调整大小的控制台弹窗；修复 CPU/内存占用条一直显示为空的问题。
* '''GPS''' —— 网页 GPS 页面与迷你显示屏新增行程里程表；主地图瓦片服务器被屏蔽时自动切换到镜像服务器。
* '''网页终端''' —— /terminal 改为基于 granian ASGI 的真正 WebSocket 控制台，不再使用轮询，控制台弹窗界面也更简洁。
* '''更安全的固件更新''' —— 网页界面不会再在刷写过程中重启设备；更新页面给出更真实的 3–5 分钟预估并显示重启中遮罩；用户菜单中新增关机选项。
* '''网络修复''' —— 上级 WiFi 增加开机宽限期，开机后第一次探测失败不再导致出口切换；连通性探测在透明代理（如 OpenClash）环境下也能正常工作；不再干预用户通过 netifd 手动拨号的蜂窝接口；热点设置在固件重新生成配置后依然保留。
* '''更小的根文件系统''' —— 多媒体应用、Realtek 无线驱动等不常用软件包改为可选模块，不再预装；提供更多可安装的内核模块；默认启用 BPF 流量调度器（<code>kmod-sched-bpf</code>）。
* '''RK3576 平台修复''' —— 合入上游针对 Photonicat 2 的设备树修复，并补上缺失的 CPU 缓存层级描述。
* '''LED/蜂鸣器定时计划''' —— 定时计划下发到 MCU 现在有端到端校验，失败时逐级降级而不是静默失败。
* '''迷你显示屏与屏幕设置''' —— 代理的 fake-IP DNS 应答不再导致 LCD 两行 ping 同时失败；自动熄屏延时可按秒、分钟或小时设置；屏幕实时预览以 1 Hz 刷新且不再卡死；车载模式显示实际配置的超时时间，而不是虚构的 10 分钟。
* '''蓝牙''' —— AIC8800 的蓝牙现在以 BlueZ 模式构建，系统中会出现标准 HCI 适配器；/dev 页面新增蓝牙面板，可诊断适配器并扫描附近设备。

=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1260813002</code>。

* '''抬起唤醒响应缩短到 1–2 秒''' —— 确认逻辑改用漏积分器，手部抖动不再重置检测流程；敲桌子也不会再被误判为拿起。
* '''车载模式''' —— DC 电源仍插着时手动关机，设备不会再自动重新开机。
* '''电池基础工作''' —— 新增库仑计测试工具与基于机器学习的磷酸铁锂（LFP）电量估算研究，为进一步提升电量百分比精度打基础。

== 2026-10-02 r7924 ==

* '''升级后保留设置''' —— 电源模式、菜单、风扇、短信、通话记录、流量统计、定时开关机、车载模式、充电上限和模块上网参数都会留下来。登录状态和大体积的地图缓存仍会清空。
* '''定时开关机按您设定的时间执行''' —— 东八区不再晚 8 小时，凌晨的计划落在正确的那一天，开机后马上能在页面上看到。
* '''插上网线，网口马上可用''' —— 冷启动不再像网口坏了。默认改为一直启用；您单独设置过的网口保持原样。
* '''只用蜂窝时，下面的设备能拿到公网 IPv6 地址。''' 防火墙默认仍挡住外面连进来。升级若保留了您改过的网络配置，则不会自动换成这套设置。
* '''FM350 的 5G 会连上并保持''' —— 信号不好掉线后马上重连，网页里选的网络模式和频段会生效。
* '''WiFi''' —— 上级 WiFi，以及您改过的热点名称和密码，重启后还在。PCIe 无线卡能正常识别，短暂掉线后大约 20 秒恢复。上级 WiFi 可以填写指定的 MAC。设备控制里的开关会生效，支持 WPA3 的网卡可以选用。还有设备连着时，空闲关机不会把机器关掉。
* '''酒店网线可以登录了''' —— 另一条网络已经能上网时，在优先级表点“需要登录”，会给这条网线 15 分钟去打开登录页。
* '''流量统计页重做''' —— 实时速度、有线与蜂窝、CPU、内存、磁盘，以及所有在线设备。
* '''指示灯和蜂鸣器按您设定的时间开关。''' 小屏幕上的两行检测可以改成连接测试或网页测试，不再只能 ping。
* '''DNS 程序升级到 2.93'''，包含安全修复。有线或 WiFi 要稳定大约 9 秒，才会停下或重新打开蜂窝。

== 2026-08-14 r7902 (26.10.0) [测试beta] ==
* '''OpenWRT 基础系统''' —— 更新到26.10.0，全面切换至 OpenWRT 25.12 分支为基础。默认防火墙切换为 fw4。包管理切换为APK (同时失去对IPK包的支持)。
* '''移植 photonicat (v1)''' —— 至此本系列产品使用相同的代码树进行构建。
* '''内核''' —— 更新到6.12.103，更新ath12k固件，更新AIC8800驱动，移植内核上游DFI (RK3576)及SGMII (RK3568)相关驱动。
* '''pcat-manager''' —— 修复定时任务时区计算错误问题。

Photonicat 2 固件更新日志

2026-10-01T12:19:26Z

C2h2：/* 2026-08-14 r7902 (26.10.0) */

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''上游 WiFi 功能改进,更加稳定''' —— 重启后仍保留您自己的网络名称和密码,关闭中继后也会自动恢复。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

== 2026-08-17 r7908 ==

* '''LXC 容器''' —— 容器现在可以在固件升级后保留；新增容器备份/恢复，下载镜像时可从不稳定的 CDN 自动恢复，容器启动时自动修复网络桥接，并提供 Proxmox 风格、可调整大小的控制台弹窗；修复 CPU/内存占用条一直显示为空的问题。
* '''GPS''' —— 网页 GPS 页面与迷你显示屏新增行程里程表；主地图瓦片服务器被屏蔽时自动切换到镜像服务器。
* '''网页终端''' —— /terminal 改为基于 granian ASGI 的真正 WebSocket 控制台，不再使用轮询，控制台弹窗界面也更简洁。
* '''更安全的固件更新''' —— 网页界面不会再在刷写过程中重启设备；更新页面给出更真实的 3–5 分钟预估并显示重启中遮罩；用户菜单中新增关机选项。
* '''网络修复''' —— 上级 WiFi 增加开机宽限期，开机后第一次探测失败不再导致出口切换；连通性探测在透明代理（如 OpenClash）环境下也能正常工作；不再干预用户通过 netifd 手动拨号的蜂窝接口；热点设置在固件重新生成配置后依然保留。
* '''更小的根文件系统''' —— 多媒体应用、Realtek 无线驱动等不常用软件包改为可选模块，不再预装；提供更多可安装的内核模块；默认启用 BPF 流量调度器（<code>kmod-sched-bpf</code>）。
* '''RK3576 平台修复''' —— 合入上游针对 Photonicat 2 的设备树修复，并补上缺失的 CPU 缓存层级描述。
* '''LED/蜂鸣器定时计划''' —— 定时计划下发到 MCU 现在有端到端校验，失败时逐级降级而不是静默失败。
* '''迷你显示屏与屏幕设置''' —— 代理的 fake-IP DNS 应答不再导致 LCD 两行 ping 同时失败；自动熄屏延时可按秒、分钟或小时设置；屏幕实时预览以 1 Hz 刷新且不再卡死；车载模式显示实际配置的超时时间，而不是虚构的 10 分钟。
* '''蓝牙''' —— AIC8800 的蓝牙现在以 BlueZ 模式构建，系统中会出现标准 HCI 适配器；/dev 页面新增蓝牙面板，可诊断适配器并扫描附近设备。

=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1260813002</code>。

* '''抬起唤醒响应缩短到 1–2 秒''' —— 确认逻辑改用漏积分器，手部抖动不再重置检测流程；敲桌子也不会再被误判为拿起。
* '''车载模式''' —— DC 电源仍插着时手动关机，设备不会再自动重新开机。
* '''电池基础工作''' —— 新增库仑计测试工具与基于机器学习的磷酸铁锂（LFP）电量估算研究，为进一步提升电量百分比精度打基础。

== 2026-08-14 r7902 (26.10.0) [测试beta] ==
* '''OpenWRT 基础系统''' —— 更新到26.10.0，全面切换至 OpenWRT 25.12 分支为基础。默认防火墙切换为 fw4。包管理切换为APK (同时失去对IPK包的支持)。
* '''移植 photonicat (v1)''' —— 至此本系列产品使用相同的代码树进行构建。
* '''内核''' —— 更新到6.12.103，更新ath12k固件，更新AIC8800驱动，移植内核上游DFI (RK3576)及SGMII (RK3568)相关驱动。
* '''pcat-manager''' —— 修复定时任务时区计算错误问题。

Photonicat 2 固件更新日志

2026-08-14T11:13:14Z

C2h2：新增 2026-08-14 r7907 更新说明（含 MCU 更新与最新 MCU 固件版本）

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''上游 WiFi 功能改进,更加稳定''' —— 重启后仍保留您自己的网络名称和密码,关闭中继后也会自动恢复。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

== 2026-08-14 r7907 ==

* '''LXC 容器''' —— 容器现在可以在固件升级后保留；新增容器备份/恢复，下载镜像时可从不稳定的 CDN 自动恢复，容器启动时自动修复网络桥接，并提供 Proxmox 风格、可调整大小的控制台弹窗；修复 CPU/内存占用条一直显示为空的问题。
* '''GPS''' —— 网页 GPS 页面与迷你显示屏新增行程里程表；主地图瓦片服务器被屏蔽时自动切换到镜像服务器。
* '''网页终端''' —— /terminal 改为基于 granian ASGI 的真正 WebSocket 控制台，不再使用轮询，控制台弹窗界面也更简洁。
* '''更安全的固件更新''' —— 网页界面不会再在刷写过程中重启设备；更新页面给出更真实的 3–5 分钟预估并显示重启中遮罩；用户菜单中新增关机选项。
* '''网络修复''' —— 上级 WiFi 增加开机宽限期，开机后第一次探测失败不再导致出口切换；连通性探测在透明代理（如 OpenClash）环境下也能正常工作；不再干预用户通过 netifd 手动拨号的蜂窝接口；热点设置在固件重新生成配置后依然保留。
* '''更小的根文件系统''' —— 多媒体应用、Realtek 无线驱动等不常用软件包改为可选模块，不再预装；提供更多可安装的内核模块；默认启用 BPF 流量调度器（<code>kmod-sched-bpf</code>）。
* '''RK3576 平台修复''' —— 合入上游针对 Photonicat 2 的设备树修复，并补上缺失的 CPU 缓存层级描述。
* '''LED/蜂鸣器定时计划''' —— 定时计划下发到 MCU 现在有端到端校验，失败时逐级降级而不是静默失败。
* '''迷你显示屏与屏幕设置''' —— 代理的 fake-IP DNS 应答不再导致 LCD 两行 ping 同时失败；自动熄屏延时可按秒、分钟或小时设置；屏幕实时预览以 1 Hz 刷新且不再卡死；车载模式显示实际配置的超时时间，而不是虚构的 10 分钟。
* '''蓝牙''' —— AIC8800 的蓝牙现在以 BlueZ 模式构建，系统中会出现标准 HCI 适配器；/dev 页面新增蓝牙面板，可诊断适配器并扫描附近设备。

=== MCU 更新 ===
最新 MCU 固件版本：<code>RA2E1260813002</code>。

* '''抬起唤醒响应缩短到 1–2 秒''' —— 确认逻辑改用漏积分器，手部抖动不再重置检测流程；敲桌子也不会再被误判为拿起。
* '''车载模式''' —— DC 电源仍插着时手动关机，设备不会再自动重新开机。
* '''电池基础工作''' —— 新增库仑计测试工具与基于机器学习的磷酸铁锂（LFP）电量估算研究，为进一步提升电量百分比精度打基础。

Photonicat 2 固件 Changelog

2026-08-14T11:12:38Z

C2h2：r7907 MCU Changes: state latest MCU firmware version RA2E1260813002

Photonicat 2 固件 Changelog

2026-08-14T11:05:08Z

C2h2：r7907: add MCU Changes subsection

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Improved upstream Wi-Fi — more stable''' — your own network name and password are kept across a reboot and restored when you turn the relay off.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

== 2026-08-14 r7907 ==

* '''LXC containers''' — containers now survive a firmware upgrade; added container backup/restore, image downloads that recover from a flaky CDN, self-healing of the network bridge on start, and a Proxmox-style resizable console popup; fixed CPU/memory bars showing empty.
* '''GPS''' — trip odometer on the web GPS page and the mini display, and map tiles fall back to mirror servers when the main tile server is blocked.
* '''Web terminal''' — /terminal is now a real WebSocket console (via granian ASGI) instead of polling, with a cleaner full-screen console popup.
* '''Safer firmware updates''' — the web UI can no longer reboot the device mid-flash, the update screen shows a realistic 3–5 minute estimate with a restarting overlay, and power-off is available from the user menu.
* '''Networking fixes''' — upstream WiFi gets a boot grace period so one failed probe right after boot no longer bounces the egress; the connectivity probe now works behind transparent proxies (e.g. OpenClash); cellular interfaces dialled manually through netifd are left alone; hotspot settings survive the firmware regenerating the config.
* '''Smaller root filesystem''' — multimedia applications, Realtek wireless drivers and other rarely-used packages are now optional modules instead of preinstalled, more kernel modules are available to install, and the BPF traffic scheduler (<code>kmod-sched-bpf</code>) is enabled.
* '''RK3576 platform fixes''' — backported upstream device-tree fixes for Photonicat 2 and added the missing CPU cache-hierarchy description.
* '''LED/beeper schedules''' — schedule delivery to the MCU is now verified end-to-end, degrading gracefully instead of failing silently.
* '''Mini display and screen''' — a proxy's fake-IP DNS answers no longer fail both LCD ping rows; auto-dim delays can be edited in seconds, minutes or hours; the live screen preview refreshes at 1 Hz and can no longer freeze; car mode shows the configured timeout instead of a made-up 10 minutes.
* '''Bluetooth''' — the AIC8800's Bluetooth is now built in BlueZ mode so a standard HCI adapter appears, and a new Bluetooth panel on the /dev page can diagnose the adapter and scan for nearby devices.
=== MCU Changes ===

* '''Raise-to-wake now responds in 1–2 seconds''' — confirmation uses a leaky integrator, so hand tremor no longer restarts the detection pipeline; a knock on the desk no longer fakes a pick-up.
* '''Car mode''' — a manual shutdown with DC power still plugged in no longer bounces straight back on.
* '''Battery groundwork''' — added a coulomb-meter test harness and machine-learned LFP state-of-charge work, groundwork for further battery-percentage accuracy improvements.

Photonicat 2 固件 Changelog

2026-08-14T11:02:46Z

C2h2：/* 2026-08-14 r7907 */

Photonicat 2 固件 Changelog

2026-08-14T11:00:29Z

C2h2：Add 2026-08-14 r7907 release notes (r7897 → r7907)

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Improved upstream Wi-Fi — more stable''' — your own network name and password are kept across a reboot and restored when you turn the relay off.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

== 2026-08-14 r7907 ==

* '''Bluetooth (early support)''' — the AIC8800's Bluetooth is now built in BlueZ mode so a standard HCI adapter appears, and a new Bluetooth panel on the /dev page can diagnose the adapter and scan for nearby devices.
* '''LXC containers''' — containers now survive a firmware upgrade; added container backup/restore, image downloads that recover from a flaky CDN, self-healing of the network bridge on start, and a Proxmox-style resizable console popup; fixed CPU/memory bars showing empty.
* '''GPS''' — trip odometer on the web GPS page and the mini display, and map tiles fall back to mirror servers when the main tile server is blocked.
* '''Web terminal''' — /terminal is now a real WebSocket console (via granian ASGI) instead of polling, with a cleaner full-screen console popup.
* '''Safer firmware updates''' — the web UI can no longer reboot the device mid-flash, the update screen shows a realistic 3–5 minute estimate with a restarting overlay, and power-off is available from the user menu.
* '''Networking fixes''' — upstream WiFi gets a boot grace period so one failed probe right after boot no longer bounces the egress; the connectivity probe now works behind transparent proxies (e.g. OpenClash); cellular interfaces dialled manually through netifd are left alone; hotspot settings survive the firmware regenerating the config.
* '''Smaller root filesystem''' — multimedia applications, Realtek wireless drivers and other rarely-used packages are now optional modules instead of preinstalled, more kernel modules are available to install, and the BPF traffic scheduler (<code>kmod-sched-bpf</code>) is enabled.
* '''RK3576 platform fixes''' — backported upstream device-tree fixes for Photonicat 2 and added the missing CPU cache-hierarchy description.
* '''LED/beeper schedules''' — schedule delivery to the MCU is now verified end-to-end, degrading gracefully instead of failing silently.
* '''Mini display and screen''' — a proxy's fake-IP DNS answers no longer fail both LCD ping rows; auto-dim delays can be edited in seconds, minutes or hours; the live screen preview refreshes at 1 Hz and can no longer freeze; car mode shows the configured timeout instead of a made-up 10 minutes.

Photonicat 2 固件更新日志

2026-08-11T11:42:15Z

C2h2：说明上游 WiFi 功能改进

Photonicat 2 固件 Changelog

2026-08-11T11:42:08Z

C2h2：Note improved upstream Wi-Fi stability

Photonicat 2 固件更新日志

2026-08-11T11:39:31Z

C2h2：网页界面：说明 werkzeug 迁移到 granian

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''您的网络名称和密码不再丢失''' —— 使用上游 WiFi 中继后不再丢失,关闭后也会恢复原有名称。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''网页服务器由 werkzeug 开发服务器改为 granian''',其 HTTP 解析由 Rust 实现 —— 页面和文件加载速度提升数倍,静态文件无需进入 Python 即可直接返回。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

Photonicat 2 固件 Changelog

2026-08-11T11:39:18Z

C2h2：Web interface: note werkzeug to granian migration

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Switched from the werkzeug development server to granian''', which parses HTTP in Rust — pages and files load several times faster, and static files are served without entering Python at all.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

Photonicat 2 固件更新日志

2026-08-11T11:38:12Z

C2h2：精简电池与 MCU 部分

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''您的网络名称和密码不再丢失''' —— 使用上游 WiFi 中继后不再丢失,关闭后也会恢复原有名称。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''电量百分比与健康度估算改进''' —— 读数稳定后才显示,不再在插电后或首次放电后跳变。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数''' —— 电池内阻、MCU 运行时长和主板版本。

=== 网页界面 ===

* '''速度大幅提升''',不再每约 25 秒卡顿 18–24 秒。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

Photonicat 2 固件 Changelog

2026-08-11T11:38:03Z

C2h2：Condense Battery and MCU section

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Improved battery percentage and health estimates''' — both now settle before they are shown, instead of jumping after you plug in or after a single discharge.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings''' — internal resistance, MCU uptime and board revision.

=== Web interface ===

* '''Much faster, and no longer freezes''' for 18–24 seconds every 25 seconds.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

Photonicat 2 固件更新日志

2026-08-11T11:35:44Z

C2h2：更新 r7897 说明

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭,可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包,可下载区域地图,并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''您的网络名称和密码不再丢失''' —— 使用上游 WiFi 中继后不再丢失,关闭后也会恢复原有名称。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。仅支持 RM500U 和 RM500Q,EM05 待支持。

=== 电池与 MCU ===

* '''剩余时间与健康度仅在读数可靠后显示''',不再在插拔电源后或首次放电后显示异常数值。
* '''可查看本次放电已使用电池运行的时长''',中途重启也不会丢失。
* '''电池历史记录不再无限增长''' —— 30 天清理机制此前从未真正删除过数据。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数与命令''' —— 电池内阻、MCU 运行时长、主板版本、电量计诊断和 MCU 恢复出厂设置。

=== 网页界面 ===

* '''速度大幅提升''',不再每约 25 秒卡顿 18–24 秒。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== NAS 与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。

Photonicat 2 固件 Changelog

2026-08-11T11:35:28Z

C2h2：Update r7897 release notes

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending.

=== Battery and MCU ===

* '''Time-remaining and health readings are now shown only once trustworthy''', instead of false numbers after plugging in or a single discharge.
* '''See how long you have been running on battery''', surviving a reboot mid-discharge.
* '''Battery history no longer grows without limit''' — the 30-day cleanup had never deleted anything.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings and commands''' — internal resistance, MCU uptime, board revision, gauge diagnostics and MCU factory reset.

=== Web interface ===

* '''Much faster, and no longer freezes''' for 18–24 seconds every 25 seconds.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

Photonicat 2 固件 Changelog

2026-08-11T11:34:19Z

C2h2：/* Storage and sharing */

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending

=== Battery and MCU ===

* '''Time-remaining and health readings are now shown only once trustworthy''', instead of false numbers after plugging in or a single discharge.
* '''See how long you have been running on battery''', surviving a reboot mid-discharge.
* '''Battery history no longer grows without limit''' — the 30-day cleanup had never deleted anything.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings and commands''' — internal resistance, MCU uptime, board revision, gauge diagnostics and MCU factory reset.

=== Web interface ===

* '''Much faster, and no longer freezes''' for 18–24 seconds every 25 seconds.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== NAS and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.

Photonicat 2 固件 Changelog

2026-08-11T11:33:08Z

C2h2：/* Phone (in development) */

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default. ONLY support RM500U and RM500Q. EM05 pending

=== Battery and MCU ===

* '''Time-remaining and health readings are now shown only once trustworthy''', instead of false numbers after plugging in or a single discharge.
* '''See how long you have been running on battery''', surviving a reboot mid-discharge.
* '''Battery history no longer grows without limit''' — the 30-day cleanup had never deleted anything.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings and commands''' — internal resistance, MCU uptime, board revision, gauge diagnostics and MCU factory reset.

=== Web interface ===

* '''Much faster, and no longer freezes''' for 18–24 seconds every 25 seconds.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== Storage and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.
* '''A failed checksum now stops a firmware flash.'''

Photonicat 2 固件更新日志

2026-08-11T11:32:16Z

C2h2：精简 r7897 更新说明

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 地图定位、精度、速度、航向和各卫星信号。默认关闭，可在"通用设置"中开启。
* '''离线地图与轨迹记录''' —— 内置世界地图包，可下载区域地图，并可记录和回放行驶轨迹。
* '''可在 GPS 之外启用 GLONASS、北斗和伽利略。'''

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''',不再出现显示已连接、实际不通、必须重启的情况。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''',且不再覆盖您的路由优先级。
* '''未安装模块的设备不再显示"无服务"。'''

=== 网络与 WiFi ===

* '''默认设置下故障切换现在真正生效''' —— 此前大部分设备从未迁移到当前的路由机制。
* '''您的网络名称和密码不再丢失''' —— 使用上游 WiFi 中继后不再丢失,关闭后也会恢复原有名称。
* '''刷机后外接 PCIe WiFi 网卡即可使用''',无需额外重启或手动开启。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话''',包含通话音频、拨号盘、联系人和语音信箱。默认关闭。

=== 电池与 MCU ===

* '''剩余时间与健康度仅在读数可靠后显示''',不再在插拔电源后或首次放电后显示异常数值。
* '''可查看本次放电已使用电池运行的时长''',中途重启也不会丢失。
* '''电池历史记录不再无限增长''' —— 30 天清理机制此前从未真正删除过数据。
* '''充电上限在 MCU 重启后保留''',休眠期间 LED 与蜂鸣器定时计划继续运行。
* '''新增读数与命令''' —— 电池内阻、MCU 运行时长、主板版本、电量计诊断和 MCU 恢复出厂设置。

=== 网页界面 ===

* '''速度大幅提升''',不再每约 25 秒卡顿 18–24 秒。
* '''语言与浅色/深色改为设备级设置''',不再随浏览器变化,并新增恢复默认按钮。
* '''显示屏主题新增取色器''',重启页面在设备恢复后自动刷新。

=== 迷你显示屏 ===

* '''新增 GPS 页面''',仅在支持 GPS 的模块上显示。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条,布局更清晰。
* '''刷新更智能,新增配色主题与公网 IP 实时跟踪''',唤醒后时钟和电量不再是旧值。

=== 存储与共享 ===

* '''现在可以挂载 SMB 共享''',NFS 服务器也能真正导出共享。
* '''修复 eMMC 分区失败问题''',NTFS 磁盘现在也能正常挂载。
* '''修复 AIC8800 WiFi 的单客户端流量统计''',并可在网页界面查看。
* '''校验和失败时会中止固件刷写。'''

Photonicat 2 固件 Changelog

2026-08-11T11:32:08Z

C2h2：Condense r7897 release notes

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — position on a map, accuracy, speed, heading and per-satellite signal. Off by default; enable in General Settings.
* '''Offline maps and track logging''' — a world map pack ships built in, regions can be downloaded, and routes can be recorded and replayed.
* '''GLONASS, BeiDou and Galileo''' can now be added to GPS.

=== Cellular ===

* '''A 5G connection that stops passing traffic now recovers on its own''', instead of looking connected until you reboot.
* '''Fixed a startup race that could leave cellular dead''', and cellular no longer overrides your routing priority.
* '''Devices with no modem fitted no longer show "No Service".'''

=== Network and Wi-Fi ===

* '''Failover now works on the default setting''' — most devices had never migrated to the current routing system.
* '''Your network name and password no longer disappear''' after using the upstream Wi-Fi relay, and turning it off restores your own name.
* '''Add-on PCIe Wi-Fi cards work straight after a flash''', with no extra reboots or manual enabling.

=== Phone (in development) ===

* '''Early support for calls from the web interface''', with audio, dialer, contacts and voicemail. Off by default.

=== Battery and MCU ===

* '''Time-remaining and health readings are now shown only once trustworthy''', instead of false numbers after plugging in or a single discharge.
* '''See how long you have been running on battery''', surviving a reboot mid-discharge.
* '''Battery history no longer grows without limit''' — the 30-day cleanup had never deleted anything.
* '''The charge limit survives an MCU restart''', and LED and beeper schedules keep running while the device sleeps.
* '''New readings and commands''' — internal resistance, MCU uptime, board revision, gauge diagnostics and MCU factory reset.

=== Web interface ===

* '''Much faster, and no longer freezes''' for 18–24 seconds every 25 seconds.
* '''Language and light/dark are now device-wide''', not per browser, with a reset button.
* '''Colour picker for display themes''', and the reboot screen now reloads itself when the device is back.

=== Mini display ===

* '''New GPS page''', shown only on GPS-capable modems.
* '''Storage page rebuilt''' — separate eMMC, NVMe and SD bars and a clearer layout.
* '''Smarter refresh, colour themes and live public IP''' — the clock and battery are no longer stale on wake.

=== Storage and sharing ===

* '''You can now mount an SMB share''', and the NFS server can actually export one.
* '''Fixed eMMC partitioning failures''', and NTFS drives now mount correctly.
* '''Fixed per-client traffic statistics on AIC8800 Wi-Fi''', now also visible in the web UI.
* '''A failed checksum now stops a firmware flash.'''

Photonicat 2 固件更新日志

2026-08-11T11:29:32Z

C2h2：添加 2026-08-11 r7897 更新说明

English version: [[Photonicat 2 固件 Changelog]].

==2025-08-22==
* 首个正式版本。

==2025-09-19 r7612==
* 简化多 WAN 路由，停用 <code>mwan3</code>。
* 默认内置 Docker 相关软件包。
* 内核升级至 6.12.45。
* 合入上游 PCIe 补丁。
* 增加 USB Hub 复位时序与看门狗。
* 状态指示灯与蜂鸣器可由用户关闭。
* 提升小屏幕显示性能。
* 增加 LED、蜂鸣器与风扇控制，并加入过温保护算法。
* 简化网络 WAN 接口选择：<code>auto</code>、<code>eth_only</code>、<code>cell_only</code>、<code>all_off</code>。
* 新增 /update 管理界面。
* MCU：优化库仑计算法。
* MCU：修复充电指示灯偶尔不亮的问题。

== 2025-12-12 r7618 ==
* 去掉不必要的网络复位，加快开机速度。
* 更新 OpenWrt <code>netifd</code>，改善 NFA765 无线模块兼容性。
* 改进风扇控制策略与整体散热表现。
* 优化智能调速逻辑：<code>smart_quiet</code>、<code>smart_cool</code>、<code>manual</code>。
* 修复网络模式设为 '''仅蜂窝网络''' 时界面崩溃的问题。
* 修复界面不显示 4G/5G 频段信息的问题。
* 修复部分 5G 模块信息页面内容缺失的问题。
* 修复 5G 信号不显示的问题。
* 修复重启后 '''记住我''' 登录选项失效的问题。

== 2026-03-06 r7660 ==
* '''内核与系统更新''' —— 内核升级至 6.12.74，mac80211 升级至 6.12.61，python3 升级至 3.13.9 并同步更新相关软件包（改用基于 PAM 的认证，替代已废弃的 <code>spwd</code>），系统版本升级至 26.04，修复多个 CVE。
* '''支持广和通 FM350-GL 5G 模块''' —— 完整支持信号强度、温度监控、IMEI、运营商显示、服务小区信息、漫游偏好、4G/5G 网络模式与频段选择、通过 rfkill 关闭 WWAN 供电、流量统计，以及十六进制编码运营商名称的解码。
* '''短信可靠性''' —— 所有模块统一改用 PDU 模式，修复 FM350-GL 的串口处理、提示符检测与响应超时问题。
* '''网页终端''' —— 新增网页终端（<code>/terminal</code>），支持持久 PTY 会话、全屏切换、断开/重连、JetBrains Mono 字体与移动端视口优化。
* '''直流供电模式与 TCP BBR v3''' —— 新增开机模式选项，适用于无电池及需要快速响应的场景（接入适配器即自动开机，无需电池）。新增 TCP BBR v3 支持，可在常规设置中配置拥塞控制算法。
* '''电池历史与电源事件记录''' —— 新增基于 SQLite 存储的电池历史曲线，固定电压刻度、区域填充、功率显示，以及开关机事件时间轴。持久记录电源事件，包含电压、电流、电量数据与 DC 插拔跟踪。
* '''空闲与低电量关机''' —— 空闲关机倒计时实时显示、低电量自动关机、WiFi 客户端空闲监测（OR 模式）、仅电池供电时自动关机选项，以及电量估算跳变 2% 的容差处理。
* '''常规设置与定时页面重做''' —— 新增常规设置页面，可设置语言、时区、主机名并与 LuCI 同步。定时页面改为现代化的左右分栏布局，面板更紧凑并占满宽度，车载/UPS 模式说明更清晰。
* '''仪表盘与顶栏改进''' —— 优先显示当前活动 WAN、公网 IPv6 检测、模块温度显示、网络图标行中的 5G/4G 标识、按状态渲染、网关下划线，以及移动端顶栏布局优化。
* '''性能与界面细节打磨''' —— 原生 Python ubus/uci 封装、非阻塞 IO 缓存、CPU 省电模式下关闭大核（A72）、静态资源缓存 3 个月、温度与功率曲线图、刷新后保留标签页状态、通知只用单一语言、图标改进、页脚新增 Wiki 与社区按钮、智能手机号格式化，以及更详细的固件升级进度显示。

== 2026-06-15 r7714 ==
* '''内核与系统更新''' —— 内核升级至 6.12.91，修复近期若干严重安全问题。mac80211 升级至 6.18.26，修复多个 CVE。
* '''OpenWRT 基础系统''' —— 基础系统与 LuCI 升级至 25.12。新增 IEEE 802.11be 支持（可在 QCNCM865 与 MT7925 上启用 6GHz 信道）。
* '''Smart WAN（WiFi 当作 WAN）''' —— 新增 Smart WAN 模式，把板载无线变成上级 WiFi 客户端，并在以太网 → WiFi → 蜂窝之间自动故障切换。像手机一样自动重连已知的上级 WiFi，扫描设备解析更稳健，切换前会有确认对话框。被停用的 STA 射频现在会正确显示为独立的 "WAN (WiFi)" 状态。
* '''WiFi 7（802.11be）与 WPA3''' —— PCIe 网卡新增 WiFi 7（BE）与 WPA3-SAE 支持，正确处理 5GHz BE 与 6GHz BE 的 htmode/信道，支持 PCIe 卡型号识别，并统一了界面中的加密方式取值。
* '''仪表盘与顶栏改进''' —— 当前出口实时高亮（只有正在使用的 WAN 行会亮起）；显示 WiFi 信号、当前出口与网络模式；网络图标随状态变化，带网关下划线、准确的 WAN 下划线、被禁用链路的红叉与提示文字。新增公网 IPv6 / 公网 IP 别名。
* '''电池与充电控制''' —— 在设备控制页面新增电池充电限制滑块（80–100%），以充电限制作为唯一数据源，修正电池图标显示真实电量百分比，并在从未设置过时稳妥地默认为 100%。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''小屏幕可视化编辑器''' —— 新增 Figma 风格的屏幕布局可视化编辑器，与 JSON 视图合并为同一个"编辑器"标签页。支持增删页面、单个元素位置重置、居中与吸附工具、恢复默认布局、JSON 实时差异对比、标签/数据键画布切换，并修正了编辑器坐标到设备显示区域的映射。修复设备端 graph 元素类型的渲染问题。
* '''小屏幕自定义数据源''' —— 编辑器中新增自定义指标（command / uci / env / json_file / HTTPS），附带设备端示例、一键保存并重启、刷新时实时预览取值、重复键名警告、更清晰的 data_key 说明、通过官方 Photonicat 行情 API 提供的黄金/AAPL 示例，以及无闪烁的实时预览。
* '''设备控制与网络模式''' —— 重新排列网络模式并使用组合式 WAN 图标；把充电限制设置统一收纳到设备控制页面。
* '''FM350-GL 漫游''' —— 通过 <code>AT+COPS=0</code> 启用自动漫游，并隐藏了实际无法生效的"禁止漫游"选项；修复轮询刷新会覆盖频段选择的问题；移除会导致 LAN/WAN 失效的 USB 3.12 10Gbps 选项。
* '''安全加固''' —— 为 WebSocket 端点增加 <code>socketio_auth_required</code> 装饰器，为 <code>/switch_locale</code> 与低电量关机相关路由增加鉴权，并移除未使用或权限过高的 API 端点。
* '''性能''' —— 降低空闲 CPU 占用（默认只写文件日志、减少 select 唤醒与 uci 进程调用），缓存 <code>data_stats.json</code> 并让仪表盘缓存与屏幕轮询对齐，去掉一个空转的屏幕线程，改为直接从 sysfs 读取 WWAN rfkill 状态。
* '''小屏幕性能''' —— 显示循环 CPU 占用大幅下降（静态页面约 3.2% → 约 1.4%，降低约 55%）：通过数据版本门控跳过画面无变化时的重绘与 SPI 传输，传输前先做字节比较，并把各类轮询频率减半。字体（包括约 37MB 的中日韩字体集）改为只解析一次并缓存预加载，网络信息查询（无线 SSID、iwinfo 客户端枚举、公网 IP）也做了缓存，进程调用从约 3.8 次/秒降到约 1.7 次/秒。

== 2026-06-16 r7715 ==
* '''小屏幕 SPI 时钟可靠性''' —— 将屏幕 SPI 时钟从 120 MHz 降到 50 MHz，消除高频率下的画面异常或显示问题；保守的时序只带来可忽略的刷新延迟，换来稳定无杂点的画面。
* '''序列号校验修复''' —— 有效的设备序列号在设备上被错误显示为 <code>(invalid)</code>，原因是签名校验依赖 <code>cryptography</code> 模块，而目标 OpenWrt 固件中并未安装该模块。

== 2026-06-23 r7720 ==
* '''OpenWRT 基础系统''' —— 路由与电话相关软件包更新至 OpenWRT 25.12 分支。默认防火墙切换为 fw4。

== 2026-07-31 r7854 ==
* '''开机时间缩短 59% —— 17.4 秒 → 7.2 秒''' —— 完整重启一次现在只需 16.6 秒，之前是 28.0 秒。最大的单一原因是一条多余的 <code>fstab</code> 条目，导致每次开机所有服务都要等待一块根本没有装的硬盘。此外：根文件系统压缩从 <code>xz</code> 改为 <code>zstd</code>，squashfs 重新调整为 256 KiB 块并启用直接读取，U-Boot 不再扫描 USB 与网络寻找启动介质，开机 Logo 改为一次 SPI 传输完成（此前是 110,080 次单字节传输），failsafe 等待窗口从 1 秒缩短到 300 毫秒。
* '''可选服务出厂不再自启''' —— Docker、Samba、collectd、aria2、nlbwmon、watchcat、frp、filebrowser、rclone、adbyby、OpenAppFilter、Tailscale 与 ZeroTier 仍然预装，但不再开机自启（运行中的服务从 73 个降到 59 个）；需要时在 '''系统 → 启动项''' 中一键启用即可。<code>vnstat</code> 与网页终端有意保持运行。
* '''WAN 优先级表取代 Smart WAN 模式''' —— r7714 的 '''Smart WAN''' 开关改为基于路由 metric 的'''优先级表'''，按固定槽位顺序列出所有已启用的上行链路 —— 以太网、上级 WiFi、PPPoE 与蜂窝 —— 并逐级向下切换。它完全取代了 <code>mwan3</code>。有线 WAN 现在在链路断开时立即切换，而不用等探测超时；PPPoE 也能被正确识别为当前出口。
* '''上级 WiFi（WiFi 当作 WAN）''' —— 同一 SSID 同时广播 2.4G 与 5G 时自动接入信号更强的频段；已连接状态下也会漫游到重新进入范围的已保存网络；漫游离开后能更快重新接入已知网络；实时显示关联与待机状态并带有各射频的图标；附近没有已保存网络时降低扫描频率。
* '''全新 /dev 诊断页面''' —— 由内置 G-sensor 驱动的实时 3D 设备模型，并提供引导式姿态校准；显示各段电压的 2S2P 18650 电池组示意图；MCU 电量计日志；以及模块拨号日志查看器。还有内置蜂鸣器的音调测试与 MIDI 播放。
* '''广和通 FM350-GL 5G 模块''' —— 拨号程序由 Python 重写为原生 C 实现，可靠性更高。现在会遵循网页界面中设置的网络模式偏好，需要时锁定 4G 并在 5G 可用时自动回到 5G，5G 拨号失败会回退到 LTE，并监控数据面以发现"连接已建立但不通流量"的情况。修复了仅支持 4G 的 SIM 卡导致模块无限重启上电的问题，以及自动模式被误报为 5G 的问题。现在会显示模块固件版本，并提供固件更新对话框。
* '''模块拨号日志''' —— 最近 16 MB 的拨号活动会保存在内存中并可在网页界面查看，便于事后排查间歇性的连接问题。
* '''电池充电限制''' —— 1% 精度的滑块，带防抖保存并同步给 MCU，同时实时回读，界面始终反映硬件实际执行的限制值。该限制现在在 MCU 重启后依然保留。
** '''硬件要求：'''充电限制功能仅 '''A3 版本 PCB''' 的机器支持，更早的 PCB 版本不支持该功能。
* '''固件与 MCU 更新流程''' —— 版本下拉框中可查看各版本更新说明并支持降级；MCU 与固件更新不能再同时进行；当已安装的 MCU 版本比服务器上的更新时不再提示更新；OTA 默认使用 <code>sysupgrade -c -p</code>，各个参数以勾选框形式开放。
* '''PhotonDNS''' —— 全新的高性能 DNS 转发器，使用 Rust 编写：分片 LRU 缓存、过期仍可用（serve-stale）、预取、缓存持久化，支持 UDP/TCP/DoT/DoH 上游与并发竞速故障切换，并对每个上游做健康跟踪，另附国内域名列表与广告列表辅助功能。自带 LuCI 页面，但'''默认关闭'''。
* '''安全加固''' —— 强制启用 CSRF 校验，LuCI 密码不再泄露到页面中，所有 API 路由都需要鉴权，状态变更只允许 POST，开发者端点受到限制，修复了一处开放重定向，'''记住我''' 改用基于 SQLite 的正规令牌实现。
* '''访客门户（Captive Portal）''' —— 一键接受、无需 DNS 也能打开的门户地址、带品牌样式的错误页、启用/停用操作串行化（快速反复切换不会留下半配置状态），失败会明确提示而不是静默忽略。
* '''更低空闲 CPU 与更少闪存写入''' —— 只有打开模块页面时才执行较重的 AT 查询，使用统计批量写入闪存并带保留期与索引，PMU 设置改为每 60 秒轮询一次而非持续轮询，公网 IP 探测采用退避策略，浏览器标签页隐藏时完全停止轮询。
* '''小屏幕''' —— 全新的猫咪苏醒开机动画。改为按页面设置刷新率（时钟与 CPU 页面 2 Hz，ping 时 1 Hz），不再是统一固定刷新率。新增每核心 CPU 条、数值内嵌的内存条、各磁盘占用条与滚动的 SSID 跑马灯。iStat 风格的进度条采用超采样抗锯齿，文字更柔和。新增电池剩余时间栏位、WAN 模式行、可配置的公网 IP 查询、亮度为 0 时真正的物理全黑背光，以及上级链路未关联时进入待机。
* '''WiFi 修复''' —— 修复开机后 AP 已启动却不广播 SSID 的间歇性问题，以及新版 OpenWrt 下的 WLAN 启用状态判断（射频需要接口与设备同时启用才会工作）。新增 '''恢复 WiFi 默认设置''' 按钮，便于从错误配置中恢复。
* '''eMMC 兼容性''' —— 内部存储在 bootloader 与内核中都固定为 HS200 @ 52 MHz，消除了一类间歇性存储错误。
* '''其他修复''' —— CPU 省电设置重启后保持生效；手动风扇转速在页面刷新后保留；通过 USB Type-C 为外部设备供电时电池能正确显示为放电状态；PPPoE keepalive 放宽为 <code>5 5</code>，避免误断线；移除 <code>irqbalance</code>，改为静态绑定以太网中断（此前发现它会把两个网口中断都放到同一个核心上）；补齐缺失的英文字符串；Alpine.js 升级至 3.15.12。

=== MCU 更新 ===
* '''待机功耗更低''' —— 待机电流从约 2.6 mA 降到 1.1 mA，关机状态下充满电的电池组可以保持数周而不是几天。电流监测芯片、加速度计与闪存现在会正确断电，主板关闭时风扇也会真正停转。
* '''更准确的电量百分比''' —— 电量计从头到尾重做，加入温度补偿、内阻自学习与周期性重新锚定。读数不再跳变（例如固件更新后从 40% 跳到 80%），能在重启与固件更新后保持，并可上报学习到的真实容量与循环次数。整体表现已经非常接近手机。
* '''全新指示灯行为''' —— MacBook 式指示灯：颜色表示充电状态，动态表示设备状态，充电时为平滑的伽马校正呼吸效果，低电量时持续红色闪烁。修复了开机时以及电池充满时出现的多次误报纯红闪烁。
* '''抬起唤醒改进''' —— 重写为真正的手势识别，和手机一样。设备竖立静置时不会再自行唤醒，而真正拿起时响应更快。
* '''稳定性与开机速度''' —— 修复长时间运行后的随机死机，以及较少见的、只能通过取出电池才能恢复的永久性死锁。开机更快：按键按住 200 毫秒后主板即上电，与长按判定窗口重叠进行。修正蜂鸣器时序，包括插入充电器后可能延迟 40–50 秒才响的提示音；复位与更新操作现在会播放一小段确认旋律。

== 2026-08-11 r7897 ==

=== GPS ===

* '''新增 GPS 页面''' —— 完整的 GNSS 接收机页面 <code>/gps</code>：地图实时定位、定位质量与精度、速度与航向，以及各卫星系统的信号强度图。默认隐藏，可在"通用设置"中开启；该选项仅在支持 GNSS 的模块（EM05、RM500Q、EM520）上显示。
* '''无需联网即可使用地图''' —— 固件内置世界地图包，可下载更高精度的区域地图供离线使用；仍然缺失的瓦片会通过路由器获取并保存，下次直接使用。
* '''可选择使用哪些卫星系统''' —— GPS 始终跟踪，可另外启用 GLONASS、北斗和伽利略。此前模块虽然跟踪这些系统，却从不上报，导致页面上的星空比实际更空。
* '''轨迹记录，支持查看与回放''' —— 可按固定间隔记录，也可使用智能模式（移动和转向时记录）；轨迹保存在内部存储或 SD/NVMe 卡上并可设置容量上限，旧文件自动轮转与压缩。

=== 蜂窝网络 ===

* '''5G 连接中断后可自行恢复''' —— 此前信号显示正常、状态显示已连接，实际却没有任何数据通过，且必须重启设备或手动复位模块才能恢复。现在设备会自行发现并重新连接，待网络恢复后自动回到 5G。
* '''始终无法传输数据的连接会被迅速断开'''，而不再被无限期信任，因此恢复更快，并少一次电源循环。
* '''蜂窝网络不再覆盖您的路由优先级''' —— 此前模块在每次连接时强制写入固定的路由优先级，可能在您不知情的情况下让蜂窝网络排在有线 WAN 之前或之后。现在会遵循您的设置。
* '''修复可能导致蜂窝网络完全不通的启动时序问题''' —— 拨号程序可能先于负责配置它的管理程序启动。现在管理程序优先启动；连接失败时会明确报错并干净地重启，而不是留下一条表面正常、实际已失效的链路。
* '''没有模块的设备不再显示存在模块''' —— 未安装模块的设备此前在顶栏显示"无服务"，模块页面则一直停留在检测状态。已存储的短信在任何情况下仍可查看。

=== 网络 ===

* '''默认设置下故障切换现在真正生效''' —— 此前的迁移仅对使用过已废弃的 Smart WAN 模式的设备生效，因此大部分处于默认设置的设备从未迁移到当前的路由机制：没有故障切换、没有健康检查，路由优先级也是陈旧的。现在所有设备都会完成迁移，且迁移过程中不会改变任何流量的路径。
* '''仪表板可区分本机热点与所连接的上游热点''' —— 此前两行 WiFi 使用相同图标，现在上游连接有独立的标识和图标。

=== WiFi ===

* '''您的网络名称和密码不再丢失''' —— 使用上游 WiFi 中继后重启，可能导致板载无线电在所有界面中消失，并以出厂的"OpenWrt"名称、无密码的状态恢复。
* '''关闭上游 WiFi 后会恢复您自己的网络名称'''，而不再让热点继续广播出厂默认名称。
* '''刷机后外接 WiFi 网卡即可使用''' —— 此前 PCIe 网卡处于关闭状态，需要重启两次并手动点击才能开始工作。
* '''修复部分设备上接入点名称重复出现 "-5g" 的问题'''。

=== 电话功能（开发中） ===

* '''初步支持在网页界面拨打和接听电话'''，包含通话音频、拨号盘、联系人和语音信箱。默认关闭，可在设置中开启。该功能仍在积极开发中。

=== 电池与 MCU ===

* '''插拔电源后剩余时间估算不再显示异常数值''' —— 现在会先等读数稳定，其间显示"-"，而不会在电量接近充满时显示"剩余 10 分钟"之类的结果。
* '''电池健康度在读数可靠之前不再显示''' —— 此前经过一次放电即显示，而此时数值波动很大，跳变时看起来像电量计故障。
* '''可查看本次放电已使用电池运行的时长''',中途重启也不会丢失。
* '''电池历史记录不再无限增长''' —— 30 天清理机制此前从未真正删除过任何数据，导致数据库在设备存储上持续增大。
* '''电池充电上限会被记住''' —— MCU 重启后依然保留，并在每次读取时重新确认，因此显示值始终与实际生效值一致。
* '''设备休眠期间 LED 与蜂鸣器定时计划继续运行'''（需较新的 MCU 固件，由 MCU 自行维护每日定时）。
* '''新增电池内阻显示''',区分总内阻与电芯内阻。
* '''新增 MCU 运行时长与距上次休眠时间。'''
* '''可从 MCU 导出电量计诊断日志'''用于排查问题，命令为 <code>soc-log-get</code>。
* '''新增 MCU 恢复出厂设置命令'''：<code>pcat-pmu-updater --wipe-nvs</code>。
* '''可读取 MCU 主板版本'''（<code>pmu-hw-version-get</code>），技术支持无需拆机即可识别硬件版本。

=== 网页界面 ===

* '''管理界面速度大幅提升''' —— 高并发下页面和文件的响应速度提升数倍，静态文件的最长等待时间从数秒降至百分之几秒。
* '''修复界面每约 25 秒卡顿 18–24 秒的问题''' —— 每个打开的浏览器标签页都会长期占用设备四个请求处理槽位中的一个。
* '''语言现在是设备属性，而非浏览器属性''' —— 此前两个浏览器可能显示两种语言，在一台设备上选择的语言对其他人无效。
* '''浅色/深色外观同样为设备级设置''',并新增恢复默认按钮。
* '''显示屏主题新增取色器''' —— 可为各元素选择精确颜色并实时预览，也可随机生成配色后手动微调。
* '''重启页面提供真实的时间估算并自动刷新''',设备恢复后自动重新载入，不再只有一个需要自己盯着并手动刷新的计时器。
* '''刚刷机的设备即可直接使用容器功能''',无需进入设置页或重启。
* '''各页面拥有独立的浏览器标签标题''',网站图标跟随显示屏主题配色。

=== 迷你显示屏 ===

* '''新增 GPS 页面''' —— 显示速度、航向、海拔、精度、定位类型和卫星数量。仅在安装支持 GPS 的模块时出现，其他设备不会看到空白页面。
* '''存储页面重新设计''' —— eMMC、NVMe 和 SD 各自独立的进度条，以 CPU 芯片图标取代竖排文字，内存占用直接标注在进度条内，图表布局更清晰。
* '''刷新频率按需分配''' —— 第一页和时钟每秒刷新两次，正在查看时 ping 每秒刷新一次，其余页面保持低频。数据在后台保持更新，因此屏幕唤醒后时钟和电量不再是旧值。
* '''新的唤醒动画''' —— 小猫融入第一页，取代原有的启动进度条；启动较慢时同样会播放。
* '''配色主题''' —— 背景、图标着色和进度条颜色从主题文件读取，无需重新编译固件即可更换配色。
* '''实时跟踪公网 IP''',链路恢复后快速重新探测，WAN 变更后不再显示旧地址。
* '''WiFi 按每个无线电显示一行 SSID''',上游未关联时进入待机。
* '''文字更清晰平滑''' —— 抗锯齿渲染、滚动更流畅；时区未确定前时钟显示 <code>--:--</code> 而不是先猜一个。
* '''启动更快，画面更流畅''' —— 面板点亮前各项数据采集已全部启动，ping 或测速较慢时不再拖慢刷新，画面未变化的部分不再重绘。
* '''RM500Q 模块现在会显示蜂窝信号图标''',此前该图标为空白。

=== 存储与共享 ===

* '''修复 AIC8800 WiFi 的单客户端流量统计''' —— 已连接设备的字节数和数据包计数此前读数错误或为零，导致单设备流量数据不可信。
* '''现在可以挂载 SMB 共享''' —— 来自 Windows 电脑或 NAS。此前设备可以通过 SMB 共享自己的文件，却无法连接他人的共享。
* '''NFS 服务器现在可以真正导出共享''' —— 此前该功能虽已编译进系统，但缺少导出所需的工具，因此始终无法使用。Linux 和 macOS 客户端现在有了比 SMB 更快的选择。
* '''修复 eMMC 分区失败的问题''' —— 此前因缺少必要工具，创建分区可能中途失败。重复使用的分区不再残留旧的文件系统签名。NTFS 磁盘现在也能正常挂载。
* '''流量统计可在网页界面查看''' —— 数据此前已在采集，但只能通过命令行查看。
* '''校验和失败时会中止固件刷写''',而不再继续执行。

Photonicat 2 固件 Changelog

2026-08-11T11:29:25Z

C2h2：Add 2026-08-11 r7897 release notes

中文版见 [[Photonicat 2 固件更新日志]].

==2025-08-22==
* initial release

==2025-09-19 r7612==
* Simplified multi-WAN routing, disabled <code>mwan3</code>.
* Built-in Docker packages by default.
* Bumped kernel version to 6.12.45.
* Applied PCIe patches from upstream.
* Added USB hub reset timing and watchdog.
* Status LED and beeper can be disabled by the user.
* Improved mini display performance.
* Added LED, beeper, and fan control with over-temperature protection algorithm.
* Simplified network WAN interface selection: <code>auto</code>, <code>eth_only</code>, <code>cell_only</code>, <code>all_off</code>.
* Added /update management interface.
* MCU: Optimized coulomb counting algorithm.
* MCU: Fixed occasional issue where charging indicator light did not display.

== 2025-12-12 r7618 ==
* Improved bootup speed by removing unnecessary network resets.
* Updated OpenWrt <code>netifd</code> to improve NFA765 wifi module compatibility.
* Improved fan control strategy and overall thermal behavior.
* Improved intelligent fan speed adjustment logic. <code>smart_quiet</code>, <code>smart_cool</code>, <code>manual</code>.
* Fixed UI crash when network mode was set to '''Cellular Only'''.
* Fixed an issue where 4G/5G band information was not displayed in the UI.
* Fixed missing information in the with some 5G module information page.
* Fixed 5G Signal not displaying error.
* Fixed the '''Remember Me''' login option not working after a system restart.

== 2026-03-06 r7660 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.74, mac80211 to 6.12.61, python3 to 3.13.9 with related packages (PAM-based auth replacing deprecated <code>spwd</code>), and system version to 26.04, fixed several CVEs.
* '''Fibocom FM350-GL 5G modem support''' — Full support including signal strength, temperature monitoring, IMEI, carrier/operator display, serving cell info, roaming preference, 4G/5G network mode and band selection, WWAN power off toggle via rfkill, network stats tracking, and hex-encoded operator name decoding.
* '''SMS reliability''' — Switched to PDU mode for all modems, fixed FM350-GL serial port handling, prompt detection, and response timeouts.
* '''Web terminal''' — Added web-based terminal (<code>/terminal</code>) with persistent PTY sessions, fullscreen toggle, disconnect/reconnect, JetBrains Mono font, and mobile viewport optimization.
* '''Direct Power Mode & TCP BBR v3''' — Added power-on mode options for battery-free and quick-response applications (auto power-on when adapter connected, no battery required). Added TCP BBR v3 support with congestion control configuration in General Settings.
* '''Battery history & power event logging''' — Battery history chart with SQLite storage, fixed voltage scale, area fill, watt display, and power on/off event timeline. Persistent power event logging with voltage, current, SOC data, and DC plug/unplug tracking.
* '''Idle & low battery shutdown''' — Live idle shutdown countdown timer, low battery shutdown support, WiFi client idle monitoring (OR mode), battery-only auto-shutdown option, and 2% SOC tolerance for SOC estimation jumps.
* '''General Settings & timer page redesign''' — New General Settings page with language, timezone, hostname, and LuCI sync. Redesigned timer page with modern split-panel layout, compact full-width panes, and clarified Car/UPS mode descriptions.
* '''Dashboard & header improvements''' — Active WAN shown first, public IPv6 detection, modem temperature display, 5G/4G indicator in network icon row, status-aware rendering, gateway underline, and optimized mobile header layout.
* '''Performance & UI/UX polish''' — Native Python ubus/uci wrappers, non-blocking IO caching, CPU powersave disabling big cores (A72), 3-month static asset caching, temperature and wattage charts, tab state preserved across refresh, single-language notifications, improved icons, Wiki and Community footer buttons, smart phone formatting, and verbose firmware upgrade progress.

== 2026-06-15 r7714 ==
* '''Kernel & system updates''' — Updated kernel to 6.12.91, fixed some recent critical security problems. Updated mac80211 to 6.18.26. fixed several CVEs.
* '''OpenWRT base system''' - Updated base system and LuCI to 25.12. Added IEEE80211.BE support (Allow to enable 6GHz channels on QCNCM865 and MT7925).
* '''Smart WAN (WiFi-as-WAN)''' — New Smart WAN mode turns the onboard radio into an upstream WiFi client with automatic Ethernet → WiFi → Cellular failover. Phone-like auto-reconnect to known upstream WiFi, robust scan-device resolution, and a confirmation dialog before switching. The disabled STA radio is shown correctly with a dedicated "WAN (WiFi)" status.
* '''WiFi 7 (802.11be) & WPA3''' — Added WiFi 7 (BE) and WPA3-SAE support for PCIe cards, with correct htmode/channel handling for 5GHz BE and 6GHz BE, PCIe card-name detection, and normalized encryption values in the UI.
* '''Dashboard & header improvements''' — Active egress is now highlighted live (only the active WAN row lights up); exposes WiFisignal, active egress, and network mode; status-aware network icons with gateway underline, accurate WAN underline, red-cross for disabled links, and tooltips. Added public IPv6 / public-IP aliases.
* '''Battery & charge control''' — Added a battery charge-limit slider (80–100%) on the Device Control page, made charge-limit the single source of truth, fixed the battery icon to show the true charge percentage, and robustly default to 100% when never set.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Screen visual editor''' — New Figma-style visual layout editor for the device display, merged with the JSON view into a single Editor tab. Add/remove pages, per-element position reset, center & snap tools, reset-layout, live JSON diff, label/data-key canvas toggle, and a coordinate fix mapping editor coords to the device content region. Fixed the graph element type rendering on device.
* '''Screen custom data sources''' — Added custom metrics (command / uci / env / json_file / HTTPS) in the editor with on-device examples, one-click Save & Restart, live value preview on Refresh, duplicate-key warnings, clearer data_key guidance, Gold/AAPL examples via the official Photonicat market API, and flicker-free live preview.
* '''Device Control & network modes''' — Reordered network modes with composite WAN icons; consolidated the charge-limit setting onto the Device Control page.
* '''FM350-GL roaming''' — Enabled automatic roaming via <code>AT+COPS=0</code> and hid the unenforceable "no roaming" option; fixed band selection being overwritten by polling refresh; removed the USB 3.12 10Gbps option that caused LAN/WAN failures.
* '''Security hardening''' — Added a <code>socketio_auth_required</code> decorator for WebSocket endpoints, added auth to <code>/switch_locale</code> and low-battery-shutdown routes, and removed unused/over-permissioned API endpoints.
* '''Performance''' — Reduced idle CPU usage (file-only logging by default, fewer select wakeups and uci forks), cached <code>data_stats.json</code> and aligned dashboard caching to the display poll, dropped a no-op screen thread, and read WWAN rfkill state directly from sysfs.
* '''Mini-display performance''' — Major CPU reduction on the display loop (static-page CPU ~3.2% → ~1.4%, roughly 55% less): skip re-render/SPI blit on unchanged frames via a data-epoch gate, byte-compare before transferring pixels, and halve polling cadences. Fonts (incl. the ~37MB CJK collection) are now parsed once and cached/preloaded, and network lookups (wireless SSID, iwinfo client enumeration, public IP) are cached to cut process forks (~3.8/s → ~1.7/s).

== 2026-06-16 r7715 ==
* '''Mini-display SPI clock reliability''' — Lowered the display SPI clock from 120 MHz to 50 MHz to eliminate visual glitches or display problems at the higher rate; the conservative timing trades a negligible refresh-latency increase for a stable, artifact-free image.
* '''Serial-number validation fix''' — Valid device serials were incorrectly shown as <code>(invalid)</code> on-device because the signature check depended on the <code>cryptography</code> module, which is not installed on the target OpenWrt image.

== 2026-06-23 r7720 ==
* '''OpenWRT base system''' — Updated routing and telephony packages to OpenWRT 25.12 branch. Switch default firewall to fw4.

== 2026-07-31 r7853 ==
* '''Boot time cut by 59% — 17.4 s → 7.2 s''' — A full reboot cycle is now 16.6 s instead of 28.0 s. The biggest single cause was a phantom <code>fstab</code> entry that made every unit wait each boot for a disk that was never fitted. Also: root filesystem recompressed from <code>xz</code> to <code>zstd</code>, squashfs re-tuned to 256 KiB blocks with direct reads, U-Boot no longer scans USB and the network for boot media, the boot logo is painted in one SPI transfer instead of 110,080 one-byte ones, and the failsafe window is 300 ms instead of 1 s.
* '''Optional services now ship idle''' — Docker, Samba, collectd, aria2, nlbwmon, watchcat, frp, filebrowser, rclone, adbyby, OpenAppFilter, Tailscale and ZeroTier are still installed but no longer autostart (73 → 59 running services); enable any of them with one click in '''System → Startup'''. <code>vnstat</code> and the web terminal are deliberately left running.
* '''WAN priority table replaces Smart WAN mode''' — The '''Smart WAN''' switch from r7714 is now a single metric-based '''priority table''' listing every enabled uplink — Ethernet, upstream WiFi, PPPoE and Cellular — in a fixed slot order, falling back down the list. It replaces <code>mwan3</code> entirely. Wired WAN now fails over immediately on carrier loss instead of waiting for a probe to time out, and PPPoE is correctly reported as the active egress.
* '''Upstream WiFi (WiFi-as-WAN)''' — Joins the stronger band automatically when one SSID is broadcast on both 2.4 and 5 GHz; roams to a saved network that comes back into range while still associated; rejoins known networks faster after roaming away; reports live association and standby state with per-radio icons; and scans less aggressively when no saved network is nearby.
* '''New /dev diagnostics page''' — A live 3D model of the device driven by the built-in G-sensor, with guided orientation calibration; a 2S2P 18650 pack diagram showing per-stage voltages; the MCU fuel-gauge log; and a modem dial log viewer. Tone tests and MIDI playback for the internal beeper.
* '''Fibocom FM350-GL 5G modem''' — The dialer is rewritten from Python to native C for reliability. It now honours the network-mode preference set in the web UI, locks to 4G when asked and climbs back to 5G when available, falls back to LTE if a 5G dial fails, and watches the data plane to catch a connection that is up but not passing traffic. Fixed a 4G-only SIM causing an endless modem power-cycle, and automatic mode being reported as 5G when it was not. Modem firmware version is now shown, with a firmware-update dialog.
* '''Modem dial log''' — The last 16 MB of dialling activity is kept in memory and viewable from the web UI, so an intermittent connection problem can be diagnosed after the fact.
* '''Battery charge limit''' — 1% resolution slider, synchronised to the MCU with debounced saves and re-read live so the UI always reflects what the hardware is enforcing. The limit now survives an MCU restart.
** '''Hardware requirement:''' the battery charge limit is only supported on '''PCB revision A3''' boards. Earlier board revisions do not support it.
* '''Firmware and MCU update flow''' — Version dropdowns with per-version changelogs and downgrade support; MCU and firmware updates can no longer run at the same time; no update is offered when the installed MCU is newer than the server's; and OTA now defaults to <code>sysupgrade -c -p</code>, with the individual flags exposed as tick boxes.
* '''PhotonDNS''' — A new high-performance DNS forwarder written in Rust: sharded LRU cache, serve-stale, prefetching, cache persistence, UDP/TCP/DoT/DoH upstreams and hedged-racing failover with per-upstream health tracking, plus China-list and ad-list helpers. Ships with its own LuCI page but '''disabled by default'''.
* '''Security hardening''' — CSRF is now enforced, the LuCI password is no longer leaked to the page, all API routes require authentication, state changes are POST-only, developer endpoints are gated, an open-redirect was closed, and '''Remember Me''' now uses proper SQLite-backed tokens.
* '''Captive portal''' — One-tap accept, portal URLs that work without DNS, branded error pages, serialised enable/disable so rapid toggling cannot leave it half-configured, and failures are surfaced instead of silently ignored.
* '''Lower idle CPU and less flash wear''' — Heavy modem AT queries only run when the modem page is open, usage statistics are batched to flash with retention and indexing, PMU settings poll every 60 s instead of continuously, public-IP probes back off, and hidden browser tabs stop polling altogether.
* '''Mini display''' — New cat wake-up boot animation. Per-page refresh rates (2 Hz on the clock and CPU pages, 1 Hz while pinging) instead of one fixed rate. Per-core CPU bars, a memory bar with the value inside, per-disk usage bars and a scrolling SSID ticker. iStat-style bars with supersampled anti-aliasing and softer text. Battery remaining-time slot, WAN mode line, configurable public-IP lookup, true physical-zero backlight at brightness 0, and standby when the upstream link is not associated.
* '''WiFi fixes''' — Fixed the intermittent failure where the access point came up but did not broadcast its SSID after boot, and WLAN-enabled detection under the new OpenWrt, where a radio only works if both the interface and the device are enabled. Added a '''reset WiFi to defaults''' button to recover from a bad configuration.
* '''eMMC compatibility''' — Internal storage is now pinned to HS200 at 52 MHz in both the bootloader and the kernel, eliminating a class of intermittent storage errors.
* '''Assorted fixes''' — CPU powersave setting now persists across reboot; manual fan speed survives a page refresh; the battery correctly shows as discharging while powering an external device over USB Type-C; PPPoE keepalive relaxed to <code>5 5</code> to stop spurious drops; <code>irqbalance</code> removed in favour of static Ethernet IRQ pinning after it was found parking both NIC interrupts on one core; missing English strings added; Alpine.js updated to 3.15.12.

=== MCU Changes ===
* '''Less standby power''' — Standby current drops from about 2.6 mA to 1.1 mA, so a charged pack holds its charge for weeks rather than days when the device is off. The current monitor, accelerometer and flash now power down properly, and the fan actually stops when the main board is off.
* '''A more accurate battery percentage''' — The fuel gauge has been reworked end to end with temperature compensation, self-learned internal resistance and periodic re-anchoring. The reading no longer jumps (for example 40% to 80% after a firmware update), survives reboots and firmware updates, and reports true learned capacity and cycle count. Behaviour is now much closer to a phone's.
* '''New LED behaviour''' — MacBook-style indicator: the colour tells you the charge state and the motion tells you what the device is doing, with smooth gamma-corrected breathing while charging and a continuous red flash when the battery is low. Several false pure-red flashes at power-on and when the pack was full have been fixed.
* '''Raise-to-wake improved''' — Rebuilt as proper gesture detection, like a phone's. It no longer wakes by itself when the device is stood upright and left alone, and responds faster when you do pick it up.
* '''Stability and power-on speed''' — Fixed the random freeze after extended running and the rarer permanent lockup that could only be cleared by removing the battery. Power-on is quicker: the main board powers as soon as the button has been held 200 ms, overlapping the long-press window. Beeper timing is corrected, including the charger-plugged beep that could arrive 40–50 s late, and reset and update operations now play a short confirmation melody.

== 2026-08-11 r7897 ==

=== GPS ===

* '''New GPS page''' — a full GNSS receiver page at <code>/gps</code>: live position on a map, fix quality and accuracy, speed and heading, and a per-satellite signal chart across constellations. Hidden by default; turn it on in General Settings, where the option appears only on GNSS-capable modems (EM05, RM500Q, EM520).
* '''Maps work without an internet connection''' — a world map pack ships with the firmware, you can download higher-detail regions for offline use, and anything still missing is fetched through the router and kept for next time.
* '''Choose which satellite systems to use''' — GPS is always tracked; GLONASS, BeiDou and Galileo can be added. Previously the module tracked those systems but never reported them, so the sky looked emptier than it was.
* '''Position logger with track viewer and replay''' — records your track at fixed intervals or smart profiles that log on movement and turns, stores it on internal storage or an SD/NVMe card with a size cap, and rotates and compresses old files automatically.

=== Cellular ===

* '''A 5G connection that stops working now fixes itself''' — the signal could look fine and show as connected while nothing actually got through, and it stayed that way until you rebooted or reset the modem by hand. The box now notices, reconnects on its own, and returns to 5G once service is back.
* '''A connection that never carries traffic is dropped quickly''' instead of being trusted indefinitely, so recovery starts sooner and takes one less power cycle.
* '''Cellular no longer overrides your routing priority''' — the modem forced a fixed route priority on every connection, which could quietly put cellular ahead of or behind WAN regardless of how you had configured it. It now respects your setting.
* '''Fixed a startup race that could leave cellular dead''' — the dialer could start before the manager that configures it was ready. The manager now starts first, and a failed connection attempt now reports the failure and restarts cleanly instead of silently sitting there as a dead link.
* '''Devices without a modem no longer pretend to have one''' — the header showed "No Service" and the modem page waited forever on units with no module fitted. Stored SMS messages remain readable either way.

=== Network ===

* '''Failover now actually works on the default setting''' — a migration only ever ran on boxes that had used the retired Smart WAN mode, so most devices, sitting on the default, never moved onto the current routing system at all: no failover, no health checking, and stale route priorities. Every device now migrates, and no traffic changes path in the process.
* '''The dashboard tells your own hotspot apart from the one you connect to''' — both Wi-Fi rows carried the same icon; the upstream connection now has its own badge and icon.

=== Wi-Fi ===

* '''Your network name and password no longer disappear''' — using the upstream Wi-Fi relay and rebooting could make the onboard radio vanish from every screen and come back as a factory "OpenWrt" network with no password.
* '''Turning off upstream Wi-Fi restores your own network name''' instead of leaving the hotspot advertising the factory default.
* '''Add-on Wi-Fi cards work straight after a flash''' — a PCIe card was left switched off, needing two reboots and a manual click before it would go on air.
* '''Fixed access point names gaining a second "-5g"''' on some units.

=== Phone (in development) ===

* '''Early support for making and taking calls from the web interface''', with in-call audio, a dialer, contacts and voicemail. Off by default — turn it on in Settings. Still in active development.

=== Battery and MCU ===

* '''Battery time-remaining estimates no longer show nonsense''' right after you plug or unplug power — the reading now settles first, showing "-" for a few seconds instead of "10 minutes left" on a nearly full battery.
* '''Battery health is hidden until the reading is trustworthy''' — it appeared after a single discharge, when the figure still swings widely, and looked like a broken gauge when it jumped.
* '''See how long you have been running on battery''' for the current discharge, surviving a reboot mid-run.
* '''Battery history no longer grows without limit''' — the 30-day cleanup had never actually deleted anything, so the database grew forever on device storage.
* '''Your battery charge limit is remembered''' — it survives an MCU restart, and is re-checked whenever it is read, so the value shown always matches the one in effect.
* '''LED and beeper schedules keep running while the device sleeps''' on newer MCU firmware, which now owns the daily timer itself.
* '''Battery internal resistance is now reported''', split into total and cell-only.
* '''MCU uptime and time-since-last-sleep are now available.'''
* '''Battery gauge diagnostics can be pulled off the MCU''' for troubleshooting, via <code>soc-log-get</code>.
* '''New factory-reset command''' for the MCU: <code>pcat-pmu-updater --wipe-nvs</code>.
* '''MCU board revision is now readable''' via <code>pmu-hw-version-get</code>, so support can identify hardware variants without opening the case.

=== Web interface ===

* '''The management interface is much faster''' — pages and files now serve several times quicker under load, and the worst-case wait on a static file dropped from seconds to hundredths of a second.
* '''Fixed the interface freezing for 18-24 seconds about every 25 seconds''' — each open browser tab permanently occupied one of the device's four request slots.
* '''Language is now a property of the device, not the browser''' — two browsers showed two different languages, and a choice made on one machine reverted for everyone else.
* '''Light/dark appearance is device-wide too''', with a reset-to-default button.
* '''Colour picker for display themes''' — choose exact colours per element with a live preview, or roll a random palette and fine-tune it by hand.
* '''The reboot screen gives a real time estimate and reloads itself''' when the device is back, instead of a bare counter you had to watch and refresh manually.
* '''Containers work on a freshly flashed device''' without visiting a setup tab or rebooting.
* '''Browser tab titles per page''', and the site icon follows your display theme.

=== Mini display ===

* '''New GPS page''' — speed, heading, altitude, accuracy, fix type and satellite count. It only appears when a GPS-capable modem is fitted, so other units do not get an empty screen.
* '''Storage page rebuilt''' — separate bars for eMMC, NVMe and SD, a CPU chip icon in place of the vertical CPU text, memory labelled inside its bar, and a clearer chart layout.
* '''The display refreshes where it matters''' — the first page and the clock update twice a second, ping once a second while you are watching it, and slower pages stay slow. Data is kept warm in the background, so the clock and battery are no longer stale when the screen wakes.
* '''New wake-up animation''' — the cat dissolves into the first page, replacing the old boot bar. It plays on slow boots too.
* '''Colour themes''' — background, icon tinting and bar colours are read from a theme file, so the panel can be recoloured without rebuilding firmware.
* '''Public IP is tracked live''', with a fast re-probe when the link comes back, so it no longer shows a stale address after a WAN change.
* '''Wi-Fi shows one SSID row per radio''', and goes to standby when the upstream is not associated.
* '''Sharper, smoother text''' — antialiased rendering, smoother scrolling, and the clock shows <code>--:--</code> until the timezone is actually known rather than guessing.
* '''Faster startup and smoother updates''' — every collector starts before the panel comes up, a slow ping or speed test no longer stalls the refresh, and unchanged parts of the screen are not redrawn.
* '''Cellular signal icon now shows on RM500Q modems''', where it had been blank.

=== Storage and sharing ===

* '''Per-client traffic statistics fixed on AIC8800 Wi-Fi''' — connected-device byte and packet counters read wrong or zero, so per-device traffic was not trustworthy.
* '''You can now mount an SMB share''' from a Windows PC or a NAS. The box could already share its own files over SMB but could not connect to someone else's.
* '''The NFS server can actually export a share now''' — it was built into the system but the tools needed to export anything were missing, so it could never be used. Linux and macOS clients now have a faster alternative to SMB.
* '''Fixed partitioning failures on eMMC''' — creating a partition could fail partway through because a required tool was missing. Reused partitions no longer carry a leftover filesystem signature. NTFS drives also mount correctly now.
* '''Traffic statistics are visible in the web UI''' — the data was already being collected but could only be seen from a shell.
* '''A failed checksum now stops a firmware flash''' instead of letting it proceed.

Photonicat 2 LED 指示灯

2026-08-08T12:44:13Z

C2h2：RA2E1260808001: 低电红色告警不受关灯设置影响（系统级告警）

'''光影猫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 秒长按并松手后才出现，短按在松手前没有任何提示。本版本同时修复：若系统关机（包括 6300 mV 自动关机）时持续低电红闪正在进行，旧固件不会将其停掉——系统已关机红灯却一直闪个不停，还挡住控制器进入休眠，白白耗尽剩余电量。现在关机即停。

英文版见 [[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 次。
* 指示灯可通过上位机协议关闭，关闭后绿色/黄色各状态均不亮灯。🔴 低电红色告警自 '''RA2E1260808001''' 起例外：它属于系统级告警，即使指示灯已关闭也照样闪红，保证亏电拒开机的设备不会看起来像坏了。（此前版本关灯连红色告警一起关掉。）
* 指示灯依据的电量是怎么算出来的，见 [[Photonicat 2 SOC 计算]]。

[[Category:Photonicat 2]]

Photonicat 2 LED Indicator

2026-08-08T12:44:12Z

C2h2：RA2E1260808001: low-battery red warning exempt from LED-disable (system-level alert)

'''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.

Since '''RA2E1260731011''' the charging orange is warmer (R60 %/G24 % instead of R55 %/G35 %), the breath fades only to a dim-orange floor (≈1/12 of peak) before the valley off — on earlier firmware the dim ends of each breath cycle could look pure red — and the valley off hold is 0.5 s instead of 0.24 s (cycle ≈6.1 s).

Since '''RA2E1260802000''': trying to power on with a flat or too-low pack flashes red '''three times''' immediately (earlier firmware showed nothing, so a flat device looked bricked), and a short press while off with a low pack shows the same three flashes. Continuous red flashing is only used while the system is running. The power-button long press is now 1.5 s.

Fixed in '''RA2E1260805000''': on RA2E1260802000–RA2E1260802001 a short press while the device was off in standby could flash red three times '''even with a full battery''' — the voltage sensor briefly reads 0 mV while waking from standby and this was miscounted as low battery. Red now requires a genuine low-voltage reading.

Since '''RA2E1260808001''': with the system off and the battery below the minimum boot voltage (6600 mV), '''any''' press of the power button answers with the three red flashes right away — about 0.1 s into the press, before the system power rail is touched — and the device then drops back into deep sleep to preserve the last battery reserve for the built-in clock. On RA2E1260802000–RA2E1260808000 the refused-boot flashes only appeared after holding the full 1.5 s long press and releasing; a shorter press showed nothing until release. Also fixed in this version: if the continuous low-battery warning was flashing when the system shut down (including the automatic 6300 mV shutdown), earlier firmware never cancelled it — the red kept flashing indefinitely after the system was off and prevented the controller from sleeping, draining the remaining battery. It now stops at shutdown.

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

==Quick reference==

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

{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v3.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, flashing || Low battery (below 6500 mV — 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-v3.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.5 s off, ≈6.1 s cycle; fades to a dim-orange floor (≈peak/12), never pure red
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same ≈6.1 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-v3.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 || Continuous flashing || 1 s on / 1 s off, begins after 60 s, until the voltage recovers
|-
| Below 6500 mV (valid reading), short press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, '''3 flashes''', first flash immediate (0.5 s debounce)
|-
| Below 6600 mV, any power-button press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || '''3 flashes''', first flash ≈0.1 s into the press (since '''RA2E1260808001'''; earlier firmware flashed only after releasing a full 1.5 s long press). The system power rail is never touched; the device returns to deep sleep afterwards
|-
| 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-v3.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v3.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 || '''System running:''' flashes continuously until the voltage recovers or a charger is connected. '''System off''' (any power-button press): exactly '''3 flashes''', then the device goes back to deep sleep
|-
| While running || Starts only after the voltage has stayed below the threshold for '''60 seconds'''
|-
| Any press while off || With the battery below the boot threshold, any press of the power button flashes red three times, starting about 0.1 s into the press (since '''RA2E1260808001'''); the device then returns to deep sleep. A 0 mV sensor warm-up reading right after standby wake does not count — the firmware takes a fresh voltage sample before deciding (since '''RA2E1260805000''')
|-
| Effect on green || The green heartbeat stops while red is active; the two never show together
|}

'''⚠️ Important'''

* While the system is running, the red warning '''keeps flashing until the voltage recovers or a charger is connected'''; it does not stop on its own. (Firmware before RA2E1260726003 flashed only 3 times and then went quiet.) While the system is off, short press and refused power-up flash exactly 3 times so the MCU can return to standby.
* 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==

* Green breathing peaks at 25 % duty while steady green is 50 %, so breathing green looks dimmer than steady green. Orange breathing peaks at the same R60 %/G24 % mix as steady orange.
* 🔴 Red is only ever used for low battery. While the system is running it keeps flashing until the voltage recovers or a charger is connected; while off it flashes exactly three times.
* The indicator can be disabled through the host protocol, in which case all green/yellow states stay off. The 🔴 low-battery red warning is exempt since '''RA2E1260808001''': it is a system-level alert and flashes even with the indicator disabled, so a flat pack refusing to boot never looks dead. (Before that version, disabling the indicator silenced red too.)
* For how the charge level behind these indications is computed, see [[Photonicat 2 SOC Calculation]].

[[Category:Photonicat 2]]

Photonicat 2 LED 指示灯

2026-08-08T12:39:55Z

C2h2：RA2E1260808001: 持续低电红闪关机即停（原来关机后一直闪且挡住休眠）

'''光影猫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 秒长按并松手后才出现，短按在松手前没有任何提示。本版本同时修复：若系统关机（包括 6300 mV 自动关机）时持续低电红闪正在进行，旧固件不会将其停掉——系统已关机红灯却一直闪个不停，还挡住控制器进入休眠，白白耗尽剩余电量。现在关机即停。

英文版见 [[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]]

Photonicat 2 LED Indicator

2026-08-08T12:39:54Z

C2h2：RA2E1260808001: continuous low-batt red now stops at shutdown (was flashing forever, blocked standby)

'''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.

Since '''RA2E1260731011''' the charging orange is warmer (R60 %/G24 % instead of R55 %/G35 %), the breath fades only to a dim-orange floor (≈1/12 of peak) before the valley off — on earlier firmware the dim ends of each breath cycle could look pure red — and the valley off hold is 0.5 s instead of 0.24 s (cycle ≈6.1 s).

Since '''RA2E1260802000''': trying to power on with a flat or too-low pack flashes red '''three times''' immediately (earlier firmware showed nothing, so a flat device looked bricked), and a short press while off with a low pack shows the same three flashes. Continuous red flashing is only used while the system is running. The power-button long press is now 1.5 s.

Fixed in '''RA2E1260805000''': on RA2E1260802000–RA2E1260802001 a short press while the device was off in standby could flash red three times '''even with a full battery''' — the voltage sensor briefly reads 0 mV while waking from standby and this was miscounted as low battery. Red now requires a genuine low-voltage reading.

Since '''RA2E1260808001''': with the system off and the battery below the minimum boot voltage (6600 mV), '''any''' press of the power button answers with the three red flashes right away — about 0.1 s into the press, before the system power rail is touched — and the device then drops back into deep sleep to preserve the last battery reserve for the built-in clock. On RA2E1260802000–RA2E1260808000 the refused-boot flashes only appeared after holding the full 1.5 s long press and releasing; a shorter press showed nothing until release. Also fixed in this version: if the continuous low-battery warning was flashing when the system shut down (including the automatic 6300 mV shutdown), earlier firmware never cancelled it — the red kept flashing indefinitely after the system was off and prevented the controller from sleeping, draining the remaining battery. It now stops at shutdown.

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

==Quick reference==

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

{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v3.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, flashing || Low battery (below 6500 mV — 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-v3.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.5 s off, ≈6.1 s cycle; fades to a dim-orange floor (≈peak/12), never pure red
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same ≈6.1 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-v3.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 || Continuous flashing || 1 s on / 1 s off, begins after 60 s, until the voltage recovers
|-
| Below 6500 mV (valid reading), short press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, '''3 flashes''', first flash immediate (0.5 s debounce)
|-
| Below 6600 mV, any power-button press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || '''3 flashes''', first flash ≈0.1 s into the press (since '''RA2E1260808001'''; earlier firmware flashed only after releasing a full 1.5 s long press). The system power rail is never touched; the device returns to deep sleep afterwards
|-
| 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-v3.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v3.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 || '''System running:''' flashes continuously until the voltage recovers or a charger is connected. '''System off''' (any power-button press): exactly '''3 flashes''', then the device goes back to deep sleep
|-
| While running || Starts only after the voltage has stayed below the threshold for '''60 seconds'''
|-
| Any press while off || With the battery below the boot threshold, any press of the power button flashes red three times, starting about 0.1 s into the press (since '''RA2E1260808001'''); the device then returns to deep sleep. A 0 mV sensor warm-up reading right after standby wake does not count — the firmware takes a fresh voltage sample before deciding (since '''RA2E1260805000''')
|-
| Effect on green || The green heartbeat stops while red is active; the two never show together
|}

'''⚠️ Important'''

* While the system is running, the red warning '''keeps flashing until the voltage recovers or a charger is connected'''; it does not stop on its own. (Firmware before RA2E1260726003 flashed only 3 times and then went quiet.) While the system is off, short press and refused power-up flash exactly 3 times so the MCU can return to standby.
* 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==

* Green breathing peaks at 25 % duty while steady green is 50 %, so breathing green looks dimmer than steady green. Orange breathing peaks at the same R60 %/G24 % mix as steady orange.
* 🔴 Red is only ever used for low battery. While the system is running it keeps flashing until the voltage recovers or a charger is connected; while off it flashes exactly three times.
* The indicator can be disabled entirely through the host protocol, in which case it stays off in all states.
* For how the charge level behind these indications is computed, see [[Photonicat 2 SOC Calculation]].

[[Category:Photonicat 2]]

Photonicat 2 LED 指示灯

2026-08-08T12:34:56Z

C2h2：RA2E1260808001: 低电拒绝开机红闪3次提前到按下~0.1s，不上电源轨，闪完回深睡

'''光影猫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]]

Photonicat 2 LED Indicator

2026-08-08T12:34:55Z

C2h2：RA2E1260808001: flat-pack refusal red x3 now at press time (~0.1s), before RK rail; deep sleep after

'''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.

Since '''RA2E1260731011''' the charging orange is warmer (R60 %/G24 % instead of R55 %/G35 %), the breath fades only to a dim-orange floor (≈1/12 of peak) before the valley off — on earlier firmware the dim ends of each breath cycle could look pure red — and the valley off hold is 0.5 s instead of 0.24 s (cycle ≈6.1 s).

Since '''RA2E1260802000''': trying to power on with a flat or too-low pack flashes red '''three times''' immediately (earlier firmware showed nothing, so a flat device looked bricked), and a short press while off with a low pack shows the same three flashes. Continuous red flashing is only used while the system is running. The power-button long press is now 1.5 s.

Fixed in '''RA2E1260805000''': on RA2E1260802000–RA2E1260802001 a short press while the device was off in standby could flash red three times '''even with a full battery''' — the voltage sensor briefly reads 0 mV while waking from standby and this was miscounted as low battery. Red now requires a genuine low-voltage reading.

Since '''RA2E1260808001''': with the system off and the battery below the minimum boot voltage (6600 mV), '''any''' press of the power button answers with the three red flashes right away — about 0.1 s into the press, before the system power rail is touched — and the device then drops back into deep sleep to preserve the last battery reserve for the built-in clock. On RA2E1260802000–RA2E1260808000 the refused-boot flashes only appeared after holding the full 1.5 s long press and releasing; a shorter press showed nothing until release.

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

==Quick reference==

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

{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v3.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, flashing || Low battery (below 6500 mV — 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-v3.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.5 s off, ≈6.1 s cycle; fades to a dim-orange floor (≈peak/12), never pure red
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same ≈6.1 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-v3.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 || Continuous flashing || 1 s on / 1 s off, begins after 60 s, until the voltage recovers
|-
| Below 6500 mV (valid reading), short press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, '''3 flashes''', first flash immediate (0.5 s debounce)
|-
| Below 6600 mV, any power-button press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || '''3 flashes''', first flash ≈0.1 s into the press (since '''RA2E1260808001'''; earlier firmware flashed only after releasing a full 1.5 s long press). The system power rail is never touched; the device returns to deep sleep afterwards
|-
| 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-v3.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v3.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 || '''System running:''' flashes continuously until the voltage recovers or a charger is connected. '''System off''' (any power-button press): exactly '''3 flashes''', then the device goes back to deep sleep
|-
| While running || Starts only after the voltage has stayed below the threshold for '''60 seconds'''
|-
| Any press while off || With the battery below the boot threshold, any press of the power button flashes red three times, starting about 0.1 s into the press (since '''RA2E1260808001'''); the device then returns to deep sleep. A 0 mV sensor warm-up reading right after standby wake does not count — the firmware takes a fresh voltage sample before deciding (since '''RA2E1260805000''')
|-
| Effect on green || The green heartbeat stops while red is active; the two never show together
|}

'''⚠️ Important'''

* While the system is running, the red warning '''keeps flashing until the voltage recovers or a charger is connected'''; it does not stop on its own. (Firmware before RA2E1260726003 flashed only 3 times and then went quiet.) While the system is off, short press and refused power-up flash exactly 3 times so the MCU can return to standby.
* 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==

* Green breathing peaks at 25 % duty while steady green is 50 %, so breathing green looks dimmer than steady green. Orange breathing peaks at the same R60 %/G24 % mix as steady orange.
* 🔴 Red is only ever used for low battery. While the system is running it keeps flashing until the voltage recovers or a charger is connected; while off it flashes exactly three times.
* The indicator can be disabled entirely through the host protocol, in which case it stays off in all states.
* For how the charge level behind these indications is computed, see [[Photonicat 2 SOC Calculation]].

[[Category:Photonicat 2]]

Photonicat 2 提示音说明

2026-08-05T12:36:57Z

C2h2：RA2E1260805003: 充电电流提示音每次插入只响一声 (issue #8)

'''光影猫2''' 用一颗蜂鸣器提示工作状态。本页列出全部提示音的音高、时长与触发条件，并可直接在线试听。

指示灯说明见 [[Photonicat 2 LED 指示灯]]。English: [[Photonicat 2 Sound Guide]]。

蜂鸣器可通过上位机协议关闭（与指示灯共用一个开关设置，可分别控制声音与灯光）。关闭后所有提示音均不发声。

==速查==

{| class="wikitable"
! 提示音 !! 听感 !! 含义
|-
| 🔔 两声短促上行 || 嘀-嘀 || 开机
|-
| 🔕 三声下行 || 嘀-嘟-哆 || 关机
|-
| 🔌 两声上行 || 嘀-嘀（低起） || 插入充电器
|-
| ⚡ 明亮三连音 || 嘀-嘀-嘀（上行） || 正在给外接设备供电
|-
| 🔊 单声短促 || 嘀 || 充电电流达到标准
|-
| 🚨 四组高低交替 || 嘀-嘟 ×4 || 温度过高，已关闭主机
|-
| 🛠 高低交替两轮 || 嘟-嘀 ×2 || 进入固件烧录模式
|-
| ♻ 八声高低交替 || 长串高低音 || 进入恢复出厂设置模式
|-
| 🎵 上行琶音 3 秒 || 由低到高一串 || 数据擦除成功，即将重启
|-
| 🎵 下行低音 2 秒 || 由高到低，低沉 || 数据擦除失败，即将重启
|-
| 🎵 明亮上行 2 秒 || 短促上行动机 || 固件升级成功，即将重启
|}

==完整提示音表==

频率单位 Hz，时长单位 ms。“静音”表示该步不发声只等待。

{| class="wikitable"
! 提示音 !! 试听 !! 序列（频率 Hz / 时长 ms） !! 总时长 !! 触发条件
|-
| 开机 || [[File:Pcat2-boot.mp3|noicon]] || 1300/75 → 1500/75 || 0.15 s || 长按电源键开机
|-
| 关机 || [[File:Pcat2-shutdown.mp3|noicon]] || 2000/150 → 1500/150 → 1000/150 || 0.45 s || 长按电源键关机，或低电量自动关机
|-
| 插入充电器 || [[File:Pcat2-charger-in.mp3|noicon]] || 432/150 → 528/75 || 0.23 s || 检测到充电器接入
|-
| 对外供电 || [[File:Pcat2-powering-device.mp3|noicon]] || 523/55 → 659/55 → 784/80 || 0.19 s || DC 在位且电池在放电，即正在给外接设备供电（需持续 4 秒才提示）
|-
| 充电电流达标 || [[File:Pcat2-charge-current-ok.mp3|noicon]] || 2500/100 || 0.10 s || 充电电流达到设定标准。'''每次插入充电器只响一声'''（拔掉后重新武装）；'''RA2E1260805003''' 之前的固件在每个充电开始沿都响，弱充电器电流在门限附近徘徊时会反复响
|-
| 温度过高 || [[File:Pcat2-over-temperature.mp3|noicon]] || (2500/100 → 500/100) ×4 || 0.80 s || 温度超过门限，已关闭主机
|-
| 烧录模式 || [[File:Pcat2-download-mode.mp3|noicon]] || (3000/300 → 2000/300) ×2 || 1.20 s || 关机状态下短按 3 下再长按 10 秒以上
|-
| 恢复出厂 || [[File:Pcat2-factory-reset.mp3|noicon]] || 4000/300 → 1000/300 → 2000/300 → 3000/300 → 2000/300 → 4000/300 → 3000/300 → 1000/300 || 2.40 s || 关机状态下短按 1 下再长按 17 秒以上
|-
| MCU 上电（新 bootloader） || [[File:Pcat2-mcu-boot-new.mp3|noicon]] || 4000/30 → 静音 1000 → 4000/200 || 1.23 s || MCU 上电自检
|-
| MCU 上电（旧 bootloader） || [[File:Pcat2-mcu-boot-old.mp3|noicon]] || 4000/200 || 0.20 s || MCU 上电自检
|}

==重启前提示音==

以下三段为'''阻塞播放'''：播完整段才会执行复位，因此时长即为复位前的等待时间。

{| class="wikitable"
! 提示音 !! 试听 !! 序列（频率 Hz / 时长 ms） !! 总时长 !! 触发条件
|-
| 🎵 擦除成功 || [[File:Pcat2-wipe-ok.mp3|noicon]] [[:File:Pcat2-wipe-ok.mid|MIDI]] || 523/160 → 659/160 → 784/160 → 1047/160 → 1319/160 → 1568/160 → 2093/258 → 静音 74 → 1568/135 → 2093/135 → 2637/429 → 静音 92 → 2093/184 → 2637/184 → 3136/552 || 3.00 s || 出厂数据擦除成功，随即重启
|-
| 🎵 擦除失败 || [[File:Pcat2-wipe-fail.mp3|noicon]] [[:File:Pcat2-wipe-fail.mid|MIDI]] || 440/357 → 静音 51 → 415/357 → 静音 51 → 392/357 → 静音 51 → 330/765 || 1.99 s || 出厂数据擦除失败，随即重启
|-
| 🎵 升级成功 || [[File:Pcat2-update-ok.mp3|noicon]] [[:File:Pcat2-update-ok.mid|MIDI]] || 784/170 → 1047/170 → 1319/170 → 1568/382 → 静音 102 → 1319/170 → 1568/170 → 2093/638 || 1.97 s || MCU 固件升级成功，随即重启
|}

'''注：'''自固件 RA2E1260726002 起，这三段整体加快（擦除成功由 4.89 s 压到 3.00 s，另两段各加快约 15 %），音型不变，只是节奏更紧凑，重启等待更短。

==关于试听文件==

试听用的 mp3 由固件里的实际音符表（频率+时长）直接合成，采用方波，与蜂鸣器的听感一致；实际设备上的音色会因蜂鸣器与腔体而略有差别。三段重启前旋律另附 MIDI 文件，方便二次编辑。

==说明==

* 提示音与指示灯可分别开关：声音关闭后指示灯仍正常工作，反之亦然。
* “对外供电”提示需放电条件连续保持 4 秒才触发，避免插拔充电器的瞬态误报。
* 重启前的三段提示音播放期间会正常喂看门狗，不会因为播放时间长而触发意外复位。

[[Category:Photonicat 2]]

Photonicat 2 Sound Guide

2026-08-05T12:36:56Z

C2h2：RA2E1260805003: charge-current beep once per charger insertion (issue #8)

'''Photonicat 2''' uses a single buzzer to signal system events. This page lists every tone, its pitch and duration, and what triggers it, and you can play each one here.

For the indicator LED see [[Photonicat 2 LED Indicator]]. 中文版见 [[Photonicat 2 提示音说明]]。

The buzzer can be disabled through the host protocol. Sound and the indicator LED are controlled separately, so either can be silenced without affecting the other.

==Quick reference==

{| class="wikitable"
! Sound !! What you hear !! Meaning
|-
| 🔔 Two short rising beeps || beep-beep || Power on
|-
| 🔕 Three falling beeps || beep-boop-bop || Power off
|-
| 🔌 Two rising beeps, low start || beep-beep || Charger connected
|-
| ⚡ Bright three-note run || beep-beep-beep rising || Powering an external device
|-
| 🔊 Single short beep || beep || Charge current reached target
|-
| 🚨 Four high/low pairs || beep-boop ×4 || Over temperature, system shut down
|-
| 🛠 Two high/low rounds || boop-beep ×2 || Entering firmware download mode
|-
| ♻ Eight alternating tones || long high/low run || Entering factory reset mode
|-
| 🎵 Rising arpeggio, 3 s || low to high run || Data wipe succeeded, restarting
|-
| 🎵 Falling low tones, 2 s || high to low, sombre || Data wipe failed, restarting
|-
| 🎵 Bright rising motif, 2 s || short rising figure || Firmware update succeeded, restarting
|}

==Full tone table==

Frequencies in Hz, durations in ms. "silent" means the step waits without sounding.

{| class="wikitable"
! Sound !! Listen !! Sequence (Hz / ms) !! Total !! Trigger
|-
| Power on || [[File:Pcat2-boot.mp3|noicon]] || 1300/75 → 1500/75 || 0.15 s || Long press power button to start
|-
| Power off || [[File:Pcat2-shutdown.mp3|noicon]] || 2000/150 → 1500/150 → 1000/150 || 0.45 s || Long press to shut down, or automatic low-battery shutdown
|-
| Charger connected || [[File:Pcat2-charger-in.mp3|noicon]] || 432/150 → 528/75 || 0.23 s || Charger detected
|-
| Powering a device || [[File:Pcat2-powering-device.mp3|noicon]] || 523/55 → 659/55 → 784/80 || 0.19 s || DC present and battery discharging, i.e. supplying an external device (must persist 4 s before it sounds)
|-
| Charge current reached || [[File:Pcat2-charge-current-ok.mp3|noicon]] || 2500/100 || 0.10 s || Charge current met the configured threshold. Sounds '''once per charger insertion''' (re-armed by unplugging); before '''RA2E1260805003''' it fired on every charge-start edge, so a weak charger hovering around the threshold beeped repeatedly
|-
| Over temperature || [[File:Pcat2-over-temperature.mp3|noicon]] || (2500/100 → 500/100) ×4 || 0.80 s || Temperature above limit, system powered down
|-
| Download mode || [[File:Pcat2-download-mode.mp3|noicon]] || (3000/300 → 2000/300) ×2 || 1.20 s || From off: 3 short presses, then hold 10 s or more
|-
| Factory reset || [[File:Pcat2-factory-reset.mp3|noicon]] || 4000/300 → 1000/300 → 2000/300 → 3000/300 → 2000/300 → 4000/300 → 3000/300 → 1000/300 || 2.40 s || From off: 1 short press, then hold 17 s or more
|-
| MCU power-up (new bootloader) || [[File:Pcat2-mcu-boot-new.mp3|noicon]] || 4000/30 → silent 1000 → 4000/200 || 1.23 s || MCU power-on self test
|-
| MCU power-up (old bootloader) || [[File:Pcat2-mcu-boot-old.mp3|noicon]] || 4000/200 || 0.20 s || MCU power-on self test
|}

==Pre-restart tones==

These three play '''synchronously''': the device only resets once the tone has finished, so the duration is exactly how long you wait before the restart.

{| class="wikitable"
! Sound !! Listen !! Sequence (Hz / ms) !! Total !! Trigger
|-
| 🎵 Wipe succeeded || [[File:Pcat2-wipe-ok.mp3|noicon]] [[:File:Pcat2-wipe-ok.mid|MIDI]] || 523/160 → 659/160 → 784/160 → 1047/160 → 1319/160 → 1568/160 → 2093/258 → silent 74 → 1568/135 → 2093/135 → 2637/429 → silent 92 → 2093/184 → 2637/184 → 3136/552 || 3.00 s || Factory data wipe succeeded, restarting
|-
| 🎵 Wipe failed || [[File:Pcat2-wipe-fail.mp3|noicon]] [[:File:Pcat2-wipe-fail.mid|MIDI]] || 440/357 → silent 51 → 415/357 → silent 51 → 392/357 → silent 51 → 330/765 || 1.99 s || Factory data wipe failed, restarting
|-
| 🎵 Update succeeded || [[File:Pcat2-update-ok.mp3|noicon]] [[:File:Pcat2-update-ok.mid|MIDI]] || 784/170 → 1047/170 → 1319/170 → 1568/382 → silent 102 → 1319/170 → 1568/170 → 2093/638 || 1.97 s || MCU firmware update succeeded, restarting
|}

'''Note:''' from firmware RA2E1260726002 these three play faster (wipe-succeeded cut from 4.89 s to 3.00 s, the other two by about 15 %). The note sequences are unchanged — only the tempo — so the wait before restart is shorter.

==About the samples==

The mp3 samples are synthesised directly from the note tables in the firmware (frequency + duration) using square waves, which matches how the piezo buzzer sounds. The timbre on a real device will differ slightly depending on the buzzer and enclosure. The three pre-restart melodies also have MIDI files attached for easier re-editing.

==Notes==

* Sound and the indicator LED have independent enable settings; silencing one leaves the other working.
* The "powering a device" tone requires the discharge condition to hold for 4 continuous seconds, so plugging and unplugging a charger will not trigger it spuriously.
* The watchdog is serviced normally while the pre-restart tones play, so a longer tone cannot cause an unexpected reset.

[[Category:Photonicat 2]]

Photonicat 2 LED 指示灯

2026-08-05T09:40:55Z

C2h2：RA2E1260805000: 修复待机唤醒后满电短按误闪红灯x3 (issue #53)；补充 RA2E1260802000 红灯闪3次说明

'''光影猫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，被误判为低电量。现在只有真实的低电压读数才会触发红灯。

英文版见 [[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 次'''，首次立即亮
|-
| 拔出充电器且关机 || 未插入 || [[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 秒'''后才开始闪
|-
| 短按电源键 || 电压低时短按一下立即红灯闪 3 次（约 0.5 秒防抖）。待机唤醒瞬间传感器的 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]]

Photonicat 2 LED Indicator

2026-08-05T09:40:54Z

C2h2：RA2E1260805000: fix false red x3 on short press at full battery after standby wake (issue #53); document RA2E1260802000 red x3 behaviour

'''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.

Since '''RA2E1260731011''' the charging orange is warmer (R60 %/G24 % instead of R55 %/G35 %), the breath fades only to a dim-orange floor (≈1/12 of peak) before the valley off — on earlier firmware the dim ends of each breath cycle could look pure red — and the valley off hold is 0.5 s instead of 0.24 s (cycle ≈6.1 s).

Since '''RA2E1260802000''': trying to power on with a flat or too-low pack flashes red '''three times''' immediately (earlier firmware showed nothing, so a flat device looked bricked), and a short press while off with a low pack shows the same three flashes. Continuous red flashing is only used while the system is running. The power-button long press is now 1.5 s.

Fixed in '''RA2E1260805000''': on RA2E1260802000–RA2E1260802001 a short press while the device was off in standby could flash red three times '''even with a full battery''' — the voltage sensor briefly reads 0 mV while waking from standby and this was miscounted as low battery. Red now requires a genuine low-voltage reading.

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

==Quick reference==

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

{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v3.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, flashing || Low battery (below 6500 mV — 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-v3.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.5 s off, ≈6.1 s cycle; fades to a dim-orange floor (≈peak/12), never pure red
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same ≈6.1 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-v3.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 || Continuous flashing || 1 s on / 1 s off, begins after 60 s, until the voltage recovers
|-
| Below 6500 mV (valid reading), short press, system off || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, '''3 flashes''', first flash immediate (0.5 s debounce)
|-
| Below 6600 mV, long-press power-up refused || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || '''3 flashes''', first flash immediate
|-
| 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-v3.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v3.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 || '''System running:''' flashes continuously until the voltage recovers or a charger is connected. '''System off''' (short press or refused power-up): exactly '''3 flashes''', then the device goes back to standby
|-
| 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 flashes red three times immediately (after a 0.5 s debounce). A 0 mV sensor warm-up reading right after standby wake does not count (since '''RA2E1260805000''')
|-
| Effect on green || The green heartbeat stops while red is active; the two never show together
|}

'''⚠️ Important'''

* While the system is running, the red warning '''keeps flashing until the voltage recovers or a charger is connected'''; it does not stop on its own. (Firmware before RA2E1260726003 flashed only 3 times and then went quiet.) While the system is off, short press and refused power-up flash exactly 3 times so the MCU can return to standby.
* 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==

* Green breathing peaks at 25 % duty while steady green is 50 %, so breathing green looks dimmer than steady green. Orange breathing peaks at the same R60 %/G24 % mix as steady orange.
* 🔴 Red is only ever used for low battery. While the system is running it keeps flashing until the voltage recovers or a charger is connected; while off it flashes exactly three times.
* The indicator can be disabled entirely through the host protocol, in which case it stays off in all states.
* For how the charge level behind these indications is computed, see [[Photonicat 2 SOC Calculation]].

[[Category:Photonicat 2]]

Photonicat 2 Wifi/WWAN/NVME M2 兼容模块

2026-08-04T07:15:30Z

C2h2：增加电话语音支持列（RM500U/RM500U-CNV/RM500Q 支持，其余不支持）；补充 RM500U-CNV 行

Photonicat 2 的 M.2 插槽使用 '''USB 3.0''' 接口，模块以 USB 设备方式工作。

==WWAN 蜂窝模块 (4G/5G)==
{| class="wikitable"
! 模块 !! 制式 !! 方案 !! GPS/GNSS !! 电话语音 !! 备注
|-
| RM500U-CN-AB || 5G || 紫光展锐 Unisoc || ❌ 不支持 || ✅ 支持 || 实测固件无任何 GNSS AT 指令
|-
| RM500U-CNV || 5G || 紫光展锐 Unisoc || ❌ 不支持 || ✅ 支持（已实测） || 实测固件无任何 GNSS AT 指令
|-
| RM520N-GL-AA || 5G || 高通 Qualcomm || ✅ 支持 || ❌ 不支持 || 与 RM500Q 相同的 AT+QGPS 指令集（GPS 未单独实测）
|-
| RM500Q-GL-AB || 5G || 高通 Qualcomm || ✅ 支持（已实测） || ✅ 支持（USB 声卡方式，已实测） || 测试可用，功能可能不全；标准 AT+QGPS 指令集，NMEA 输出
|-
| FM350-GL || 5G || 联发科 MediaTek || ❌ 不支持 || ❌ 不支持 || USB 版固件不提供 GNSS 接口（已实测）
|-
| EM05-CN-FD || 4G || 高通 Qualcomm || ✅ 支持（已实测） || ❌ 不支持 || 标准 AT+QGPS 指令集，NMEA 输出
|-
| EM05-CE-FC || 4G || 高通 Qualcomm || ✅ 支持 || ❌ 不支持 || EM05 系列同指令集（GPS 未单独实测）
|}
GPS 定位需外接 GNSS 天线。

==Wifi 模块==
{| class="wikitable"
! 型号 !! 类别 !! 备注
|-
| Mediatek MT7921 || Wifi 6 ||
|-
| Mediatek MT7921K || Wifi 6 ||
|-
| Mediatek MT7922 || Wifi 6 ||
|-
| Qualcomm NFA765 || Wifi 6 ||
|-
| MediaTek MT7925B || Wifi 7 || 需 '''2026-06''' 或更新版本固件
|-
| Qualcomm WCN7851 || Wifi 7 || 需 '''2026-06''' 或更新版本固件
|}

==NVME SSD==
2230基本全系支持。

其他可能支持，或不支持，符合标准接口协议的模块。⚠️注意插拔插需要断开USB-PD供电，以及电池供电。

Photonicat 2 Wifi/WWAN/NVME M2 兼容模块

2026-08-04T07:14:38Z

C2h2：表格化模块列表；标注各模块 GPS/GNSS 支持情况（EM05/RM500Q 实测）；注明 M.2 为 USB 3.0 接口

Photonicat 2 的 M.2 插槽使用 '''USB 3.0''' 接口，模块以 USB 设备方式工作。

==WWAN 蜂窝模块 (4G/5G)==
{| class="wikitable"
! 模块 !! 制式 !! 方案 !! GPS/GNSS !! 备注
|-
| RM500U-CN-AB || 5G || 紫光展锐 Unisoc || ❌ 不支持 || 实测固件无任何 GNSS AT 指令；支持语音通话
|-
| RM520N-GL-AA || 5G || 高通 Qualcomm || ✅ 支持 || 与 RM500Q 相同的 AT+QGPS 指令集（GPS 未单独实测）
|-
| RM500Q-GL-AB || 5G || 高通 Qualcomm || ✅ 支持（已实测） || 测试可用，功能可能不全；标准 AT+QGPS 指令集，NMEA 输出
|-
| FM350-GL || 5G || 联发科 MediaTek || ❌ 不支持 || USB 版固件不提供 GNSS 接口（已实测）
|-
| EM05-CN-FD || 4G || 高通 Qualcomm || ✅ 支持（已实测） || 标准 AT+QGPS 指令集，NMEA 输出
|-
| EM05-CE-FC || 4G || 高通 Qualcomm || ✅ 支持 || EM05 系列同指令集（GPS 未单独实测）
|}
GPS 定位需外接 GNSS 天线。

==Wifi 模块==
{| class="wikitable"
! 型号 !! 类别 !! 备注
|-
| Mediatek MT7921 || Wifi 6 ||
|-
| Mediatek MT7921K || Wifi 6 ||
|-
| Mediatek MT7922 || Wifi 6 ||
|-
| Qualcomm NFA765 || Wifi 6 ||
|-
| MediaTek MT7925B || Wifi 7 || 需 '''2026-06''' 或更新版本固件
|-
| Qualcomm WCN7851 || Wifi 7 || 需 '''2026-06''' 或更新版本固件
|}

==NVME SSD==
2230基本全系支持。

其他可能支持，或不支持，符合标准接口协议的模块。⚠️注意插拔插需要断开USB-PD供电，以及电池供电。

Photonicat 2 LED 指示灯

2026-07-31T11:27:40Z

C2h2：RA2E1260731011: 橙色更暖 R60/G24、呼吸谷底暗橙地板(不再出现纯红)、熄灭保持0.5s/周期6.1s；v3 动图

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

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

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

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

英文版见 [[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，持续到松开或电压回升
|-
| 拔出充电器且关机 || 未插入 || [[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 秒
|-
| 闪烁次数 || '''持续闪烁'''，直到电压回升或插上充电器
|-
| 开机状态下 || 电压持续低于门限 '''60 秒'''后才开始闪
|-
| 短按电源键 || 电压低时短按一下可立即触发红闪（约 0.5 秒防抖）
|-
| 绿灯会怎样 || 红灯期间绿色心跳会停止，两者不会同时亮
|}

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

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

==充电上限==

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

==说明==

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

[[Category:Photonicat 2]]

Photonicat 2 LED Indicator

2026-07-31T11:26:36Z

C2h2：RA2E1260731011: warmer orange R60/G24, breath valley floor (no pure-red tails), 0.5s off hold / 6.1s cycle; v3 GIFs

'''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.

Since '''RA2E1260731011''' the charging orange is warmer (R60 %/G24 % instead of R55 %/G35 %), the breath fades only to a dim-orange floor (≈1/12 of peak) before the valley off — on earlier firmware the dim ends of each breath cycle could look pure red — and the valley off hold is 0.5 s instead of 0.24 s (cycle ≈6.1 s).

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

==Quick reference==

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

{| class="wikitable"
! Animation !! Indicator !! Meaning
|-
| [[File:Pcat2-led-orange-breathing-v3.gif|52px|link=]] || 🟠 Yellow, breathing || Charging, system running
|-
| [[File:Pcat2-led-orange-solid-v3.gif|52px|link=]] || 🟠 Yellow, steady || Charging, system off
|-
| [[File:Pcat2-led-green-breathing-v3.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, flashing || Low battery (below 6500 mV — 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-v3.gif|44px|link=]] || 🟠 Yellow || Breathing (system on) || 2.8 s up / 2.8 s down / 0.5 s off, ≈6.1 s cycle; fades to a dim-orange floor (≈peak/12), never pure red
|-
| Charging, any level || Connected || [[File:Pcat2-led-orange-solid-v3.gif|44px|link=]] || 🟠 Yellow || Steady (system off) || Constant
|-
| Full, or at charge limit || Connected || [[File:Pcat2-led-green-breathing-v3.gif|44px|link=]] || 🟢 Green || Breathing (system on) || Same ≈6.1 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-v3.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 || Continuous flashing || 1 s on / 1 s off, begins after 60 s, until the voltage recovers
|-
| Below 6500 mV, short press || None || [[File:Pcat2-led-red-lowbatt-v2.gif|44px|link=]] || 🔴 Red || Flicker || 1 s on / 1 s off, while held or until the voltage recovers
|-
| 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-v3.gif|44px|link=]] || 🟠 Yellow || Fast blink || ≈0.5 s period
|-
| Reset / factory restore mode || [[File:Pcat2-led-orange-blink-slow-v3.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 || '''Flashes continuously''' until the voltage recovers or a charger is connected
|-
| 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 triggers the red flashing immediately (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 '''keeps flashing until the voltage recovers or a charger is connected'''; it does not stop on its own. (Firmware before RA2E1260726003 flashed only 3 times and then went quiet.)
* 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==

* Green breathing peaks at 25 % duty while steady green is 50 %, so breathing green looks dimmer than steady green. Orange breathing peaks at the same R60 %/G24 % mix as steady orange.
* 🔴 Red is only ever used for low battery, and keeps flashing until the voltage recovers or a charger is connected.
* The indicator can be disabled entirely through the host protocol, in which case it stays off in all states.
* For how the charge level behind these indications is computed, see [[Photonicat 2 SOC Calculation]].

[[Category:Photonicat 2]]

文件:Pcat2-led-orange-blink-slow-v3.gif

2026-07-31T11:26:23Z