光影猫知识库 - 用户贡献 [zh-cn]

首页

2025-09-25T09:32:14Z

Guangyingmao：

__NOTOC__
[[image:Pcat2-wiki.png||thumb|Photonicat 光影猫 2]]
[[image:4pcat.jpg||thumb|Photonicat 光影猫 1]]
'''Photonicat - 光影猫''' 系列是一个提供电池的便携型路由器。光的速度，猫的灵活，装在一个数据包里。他既是波也是粒子，他是光影猫。

== 产品特性 ==
* 板载 WiFi AC/AX 模块，内置天线，并支持通过 PCI-E 扩展 4G/5G、WiFi 6 等通信能力。
* 丰富的扩展接口，可接入 GPS 及其他无线系统。
* 出厂预装 eMMC/SD OpenWRT 固件，支持快速安装和扩展插件。
* 支持多系统固件，可刷入 Debian、Ubuntu 或 Android。
* 高性能 CPU，支持千兆 NAT 满速转发，长期稳定运行。
* CNC 6 系列铝合金与高分子材料机身，坚固轻巧。
* eMMC 与 SD 双启动方案，提升系统稳定性与抗震性能。
* 内置可充电锂电池，支持 UPS 模式、车载供电及延时关机。
* 完全开源，基于 OpenWRT 平台，支持丰富的开源插件与二次开发。 [[Photonicat 1 Specs]]

== Photonicat 2 ==
2025 年 8 月，我们正式发布了 '''Photonicat 2'''，在原有基础上进行了多方面的增强与升级：

* 🖥️ '''CPU 升级'''：由原来的 4 核升级为 8 核，采用先进的 '''8nm RK3676 SoC'''，计算性能和能效全面提升。
* 🧠 '''内存升级'''：由 DDR4 升级为 '''LPDDR5 内存'''，支持 On-Die ECC，自修复能力更强，数据稳定性更高。
* 📡 '''天线增强'''：内置7根增强型天线，支持4根可扩展外置天线，信号更强。
* 🔋 '''电池升级'''：内置 4 × 18650 大容量电池，续航能力显著提升。
* 🔌 '''电源系统升级'''：支持 '''无电池运行'''（直流供电模式），并新增 '''双向快充 30W''' 功能，既可快速自充，也可作为移动电源反向输出。
* 💾 '''存储扩展'''：除 eMMC/SD 外，新增对 NVMe 固态硬盘的支持，提供高速存储能力。
* 📺 '''新增交互'''：内置屏幕，可实时显示设备状态和网络信息。
* 📊 '''传感器扩展'''：集成库仑计（Columb Meter），支持精确电流/电量测量；G-sensor 提供移动检测与姿态感应。
* 🛠️ '''软件兼容'''：保持 OpenWRT 开源支持，灵活安装丰富插件，同时可刷入 Debian、Ubuntu、Android 固件

{| class="wikitable"
!colspan="5"|Photonicat2光影猫配置表
|-
|align="center" width="150px" | 规格 || align="center" width="200px" | 不安装电池 || align="center" width="200px"| 移动版 Cell|| align="center" width="200px"| 4G版 || align="center" width="200px"| 5G版
|-
| CPU || align="center" colspan="4"|瑞芯微 RK3576（8核 Cortex®-A72 + A53 @ 2.2GHz), ARM Mali G52 MC3, NPU 6Tops
|-
| 内存 || align="center" colspan="4"|标配：4GB LPDDR5, 高配：16GB LPDDR5
|-
| eMMC || align="center" colspan="4"|标配：8GB eMMC, 高配：128GB eMMC
|-
| 网络 || align="center" colspan="4"| 原生 PHY 1000Mbps x 2
|-
| 顶部I/O ||align="center" colspan="4"|USB 3.0, HDMI 4K, 1Gbps RJ45 x 2
|-
| 侧面I/O || align="center" colspan="4"|NanoSIM（家庭版无）全系标配 MicroSD
|-
| 内置WIFI || align="center" colspan="4"| 全系标配 USB WiFi B/G/N/AC (2.4G/5G)
|-
| 内置WiFi天线 || align="center" colspan="4"| 标配： 4/5G x 4，WiFi天线 x3
|-
| 内置M.2 B-key || align="center" colspan="5" | M.2 B-Key（用于扩展其他 WWAN 设备）
|-
| 内置M.2 E-key || align="center" colspan="5" | M.2 E-Key（用于扩展其他 WiFi 模块等设备）
|-
| 内置M.2 M-key || align="center" colspan="5" | M.2 M-Key（用于扩展其他 NVMe 设备）
|-
| 供电/工作功耗 || align="center" colspan="4"|PD 20V @ 2.5A(Max) 双向 30W 电池充放电。
|-
| 电池 ||align="center" | 无 || align="center" colspan="3"| 7000mAh @ 7.4v, 51.8Wh (18650 * 4)
|-
| 4G 模块 ||align="center" | 无 || align="center" | 无 || align="center" | 全网通|| align="center" | 无
|-
| 5G 模块 || align="center" | 无 || align="center" | 无 || align="center" | 无 || align="center" | 全网通/全球通
|-
| 最佳电池续航时间 || align="center" | N/A || align="center" | 24小时 || align="center" | 18小时 || align="center" | 12小时，RM520N-GL 15小时
|-
| 开机充满电时间 || align="center" | N/A || align="center" | 2.0小时 || align="center" | 2.5小时 || align="center" | 2.5小时
|-
| 重量 || align="center" | 260克（无电池）|| align="center" |470克|| align="center" |480克 || align="center" |485克
|-
| 尺寸 || align="center" colspan="4"|154mm x 78mm x 32mm
|}

==Photonicat 2代==
{|width="90%"
|[[Photonicat 2 specs]]||[[Photonicat 2 sysfs]]
|[[Build system image for photonicat2]]
|[[Photonicat 2 Wifi/WWAN/NVME M2 兼容模块]]
|[[Photonicat 2 固件USB线刷更新教程]]
|[[Photonicat 2 固件在线升级更新]]
|-
|}

==Photonicat 1代用户手册 User Manual==
{|width="90%"
|[[Photonicat 快速上手]] || [[Photonicat WEB 管理页面操作手册]] || [[Photonicat 刷机操作手册]] || [[Photonicat SD启动、更新]] || [[Photonicat 6.1.8内核版本回退4.19版本说明]]
|-
||[[Photonicat 安装openWRT插件]] || [[Photonicat OTA更新]] || [[Photonicat FAQs 常见问题]] || [[Photonicat OpenWRT挂载新分区]] || [[Photonicat 板载WIFI 5G频段信道支持列表]]
|-
||[[Photonicat Open Wrt固件更新指南]] || [[Photonicat 使用注意事项]]
|}

==Photonicat 1/2代场景教程 Usage Scenarios==
连接模式：
{|width="90%"
| [[Photonicat 主路由]]|| [[Photonicat 旁路由]] || [[Photonicat 4G/5G 家庭网络备份]]
|-
| [[Photonicat 作为AP]] || [[Photonicat 无线桥接]] || [[Photonicat wifi网卡WAN/LAN同时使用]]
|-
| [[Photonicat 网络加速 Turbo ACC]] || [[Photonicat 端口转发]]
|}
开关机功能：
{|width="90%"
| [[Photonicat 车载/UPS开关机功能]]
|-
|}
其他用途：
{|width="90%"
| [[Photonicat 音乐盒模式]] || [[Photonicat Android]] || [[Photonicat Debain/Ubuntu]] || [[Photonicat Openwrt Docker/istore]] || [[Photonicat 网络共享/samba4]] || [[Photonicat(4G版本)开启GPS功能]]
|-
| [[Photonicat WAN口设置成LAN]]
|-
|}

==Photonicat 进级内容 Advanced Topics==
{|width="90%"
|[[Photonicat 编译 OpenWRT, Debian]] || [[Photonicat 编译 Android]] || [[Photonicat Wifi/WWAN M2 兼容模块]] || [[Photonicat TTL，Watchdog，Recovery说明]] || [[Photonicat 下调CPU频率]]
|-
|| [[Photonicat GPIO扩展说明]] || [[Photonicat Tesla Wifi 推荐设置]] || [[Photonicat Google TV连接]] || [[Photonicat Debian + Virtual Machine]]
|-
||[[Photonicat DIY 注意事项]] || [[Photonicat IPv6 Native, NAT6模式]]||[[Photonicat Tips 使用技巧]] || [[Photonicat Modem 配置USB3.0]]
|-
|[[Photonicat 刷Modem模块固件]] || [[Photonicat 自动关机电压修改]] ||[[Photonicat 功耗测试记录]] || [[Photonicat 改无电池]] || [[Photonicat MCU 通讯协议]]
|-
|}

==固件/Images 相关==
* 正式版固件 : https://dl.photonicat.com/images/
* beta固件 6.x内核 : https://dl.photonicat.com/images/beta/
* [[Photonicat 固件 Changelog]]

==其他链接==
* Photonicat Github: https://github.com/photonicat
* Photonicat Downloads: https://dl.photonicat.com (含所有binary images和自动升级的4G/5G电源管理Web IPKs）
Debian/Ubuntu 默认用户名：photonicat 默认密码：photonicat

[[Photo Gallery 图集]] ｜ [[Photonicat 硬件配置表]]

==官方购买链接==
* 淘宝: [https://shop571644147.taobao.com/ 官方淘宝店铺点击购买访问]
* 京东: [https://item.jd.com/10067989535953.html/ 官方京东店铺点击购买访问]
* 注意识别非官方店铺，谨防上当受骗，非官方店铺、授权渠道购买的商品无法享受质保和技术支持

==其他链接==
* Photonicat B站体验视频: https://www.bilibili.com/video/BV1VR4y197QY
* Photonicat Github: https://github.com/photonicat
* Photonicat Downloads: https://dl.photonicat.com (含所有binary images和自动升级的4G/5G电源管理Web IPKs）

[[Photo Gallery 图集]] ｜ [[Photonicat 硬件配置表]]

==社区、爱好者、帮助等==
如果有什么特殊需求可以通过：
*taobao客服 https://shop571644147.taobao.com/
*email: info@photonicat.cn
*[https://github.com/photonicat github issue]

Photonicat 2 固件USB线刷更新教程

Photonicat Debain/Ubuntu

2025-09-01T16:06:03Z

Guangyingmao：创建页面，内容为“*Debian 10以上版本对于想要开发应用的客户，或通过A-to-A刷机。 images可以在 https://dl.photonicat.com/ 下载可参考Photonicat_刷机操作手册进行刷机。 *Debain 10以上版本可以支持NPU AI加速、QT、或其他应用。 *Debain 12以上版本可以支持WiFi及热点功能，images可以下载：https://dl.photonicat.com/images/rk3568-photonicat-mainline-debian12-full-240822.img.gz ， *Debian登陆用户 : photonicat…”

*Debian 10以上版本对于想要开发应用的客户，或通过A-to-A刷机。 images可以在 https://dl.photonicat.com/ 下载可参考Photonicat_刷机操作手册进行刷机。

*Debain 10以上版本可以支持NPU AI加速、QT、或其他应用。

*Debain 12以上版本可以支持WiFi及热点功能，images可以下载：https://dl.photonicat.com/images/rk3568-photonicat-mainline-debian12-full-240822.img.gz ，

*Debian登陆用户 : photonicat
*Debian登录密码 : photonicat

*Ubuntu 2204以上版本支持多种编程语言和开发工具，可通过A-to-A刷机。images可以在 https://dl.photonicat.com/ 下载可参考Photonicat_刷机操作手册进行刷机。

*Ubuntu登陆用户 : photonicat
*Ubuntu登录密码 : photonicat

*注：WiFi功能仅支持full镜像，【full为预装GNOME桌面环境的镜像，minimal为最小镜像(不包含图形界面)，(需要2GB及以上的系统内存以及16GB以上的eMMC方可使用)】

文件:固件在线更新.png

2025-09-01T16:05:21Z

Guangyingmao：

Photonicat 2 固件在线升级更新

2025-09-01T16:04:14Z

Guangyingmao：创建页面，内容为“===注：Photonicat 2 可进行同类型固件在线更新，用户可选择保留配置。（若需要更新第三方固件，请参考：Photonicat 2 固件USB线刷更新教程)=== *通过浏览器前往：http://172.16.0.1:8080/cgi-bin/luci/admin/system/flash File:固件在线更新.png *点击刷写固件，进入预览导入固件，固件加载完成后点击更新。注意：更新完成后机器会进行重启，首次开机需配置大…”

===注：Photonicat 2 可进行同类型固件在线更新，用户可选择保留配置。（若需要更新第三方固件，请参考：[[Photonicat 2 固件USB线刷更新教程]])===

*通过浏览器前往：http://172.16.0.1:8080/cgi-bin/luci/admin/system/flash

[[File:固件在线更新.png ]]

*点击刷写固件，进入预览导入固件，固件加载完成后点击更新。
注意：更新完成后机器会进行重启，首次开机需配置大量文件，开机需等待屏幕完全亮起，此时网络会断开连接，需要手动再次连接WIFI 。

Photonicat 2 固件USB线刷更新教程

2025-09-01T16:03:43Z

Guangyingmao：创建页面，内容为“==Photonicat 2 固件更新指南== ===注：仅首次更新第三方固件或第三方固件更新为官方固件，同类型固件可进行在线升级，参见：Photonicat 2 固件在线升级更新=== *机器短按三下长按15秒进入烧录模式(第一个LED灯为黄色快闪状态) ::*参见Photonicat 快速上手#Photonicat 按键配置 ::*进入烧录模式视频教程：https://dl.photonicat.com/misc/photonicat_flashing_mode_video.mp4 *用A…”

==Photonicat 2 固件更新指南==
===注：仅首次更新第三方固件或第三方固件更新为官方固件，同类型固件可进行在线升级，参见：[[Photonicat 2 固件在线升级更新]]===
*机器短按三下长按15秒进入烧录模式(第一个LED灯为黄色快闪状态)
::*参见[[Photonicat 快速上手#Photonicat 按键配置]]
::*进入烧录模式视频教程：https://dl.photonicat.com/misc/photonicat_flashing_mode_video.mp4
*用A to A的USB线连接光影猫和电脑，需先进入烧录模式再连接USB线
[[File:burn-usb-port-wiki.png|500px]]
[[File:burn-usb-line-wiki.png|500px]]
*下载最新烧录工具版本最新烧录工具
::*[https://dl.photonicat.com/tools/RKDevTool_Release_v2.86.zip RKDevTool_Release_v2.86]
::*[https://dl.photonicat.com/tools/DriverAssitant_v5.1.1.zip 驱动]
*下载下载[https://dl.photonicat.com/images/MiniLoaderAll.bin MiniLoaderAll.bin]
*下载beta文件夹里以photonicatwrt开头的固件并解压:
::*https://dl.photonicat.com/images/beta/
*打开最新版的烧录工具，点击【下载镜像】在确定maskron设备已经找到的情况在第一行添加【MiniloaderA11.bin】的下载路径，在第二行添加固件下载的路径，添加完成后点击下方【执行】
::*点击红框1位置选择<code>miniLoaderA11.bin</code>文件，点击红框2位置选择固件文件，最后点击<code>执行</code>
[[File:windows-burn-00-wiki.png|500px]]
*等待右边显示【下载完成】，并且机器烧录灯变为常亮即完成更新，等待时间约为1-2分钟
*请手动重启机器
*Debian/Ubuntu更新方式与以上方式一致。
::*系统镜像如:【https://dl.photonicat.com/images/rk3568-photonicat-mainline-debian12-full-230918.img.gz】或者【https://dl.photonicat.com/images/rk3568-photonicat-mainline-ubuntu2204-full-230918.img.gz】
::*Debian为Debian 12系统，ubuntu2204为Ubuntu 22.04系统，minimal为最小镜像(不包含图形界面)，full为预装GNOME桌面环境的镜像(需要2GB及以上的系统内存以及16GB以上的eMMC方可使用)。

===注意事项===
*需先进入烧录模式再插USB线，不然RK烧录工具无法找到maskrom设备
*如按照以上1-6的步骡进行，但机器未发现maskrom设备，可以关机再次进行以上操作。若操作还是操作无效请更换USB数据线
*若电脑下载了火绒杀毒软件需卸载才能识别maskrom
*固件必须解压、否则烧录不成功

Build system image for photonicat2

2025-09-01T16:02:55Z

Guangyingmao：创建页面，内容为“==Create System Image== ===Host System Requirements=== At least Debian 12 (bookworm) or Ubuntu 22.04. with Memory >= 16GB and disk space >= 100GB. ===Build Debian/Ubuntu system image (mainline kernel)=== Check README in https://github.com/photonicat/rockchip_rk3576_linux_mainline for building system image. ===Build OpenWRT=== ====Host System Requirements==== Debian 11 (bullseye) or Ubuntu 20.04, other distributions may work but not tested. ====Compiling Req…”

==Create System Image==

===Host System Requirements===
At least Debian 12 (bookworm) or Ubuntu 22.04. with Memory >= 16GB and disk space >= 100GB.

===Build Debian/Ubuntu system image (mainline kernel)===
Check README in https://github.com/photonicat/rockchip_rk3576_linux_mainline for building system image.

===Build OpenWRT===
====Host System Requirements====
Debian 11 (bullseye) or Ubuntu 20.04, other distributions may work but not tested.

====Compiling Requirements====
Please a NORMAL USER, not root

On Debian/Ubuntu systems, install the packages:
<pre>
sudo apt update
sudo apt upgrade -y
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache cmake cpio curl device-tree-compiler fastjar flex gawk gettext gcc-multilib g++-multilib \
git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libglib2.0-dev libgmp3-dev libltdl-dev \
libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libreadline-dev libssl-dev libtool lrzsz \
mkisofs msmtp nano ninja-build p7zip p7zip-full patch pkgconf python2.7 python3 python3-pyelftools \
libpython3-dev qemu-utils rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip \
vim wget xmlto xxd zlib1g-dev
</pre>

====Get repo files====
Get repo files from Github (non-root user):
<pre>
git clone https://github.com/photonicat/rockchip_rk3568_openwrt.git
cd rockchip_rk3568_openwrt
</pre>

===Config build target===
Run the command below:
<pre>
./scripts/feeds update -a
./scripts/feeds install -a
cp ./configs/photonicat2_base_defconfig .config
</pre>

===Build system image===
Run the command below:
<pre>
make
</pre>
The output path is <code>bin/targets/rockchip/armv8/</code>, system image will be named like <code>photonicatwrt-25.02.0-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat2-squashfs-sysupgrade.img.gz</code>

===Edit your menuconfig (Optional)===
<pre>
make menuconfig
</pre>

save and re-run build process again.

IPKs will be under: <pre>bin/targets/rockchip/armv8/packages/</pre>

===Build your own package, modules on OpenWRT (Optional)===
Use <pre>make menuconfig</pre> to select <pre><M> package_name</pre> for your desired package(s).
If you want to include your own packages to system image, see OpenWRT official documents https://openwrt.org/docs/guide-developer/packages for help.

===Install pcat-manager-web on OpenWRT (Optional)===
If you want to use original Web management tool, you should change the port used by luci to 8080, edit /etc/config/uhttpd on device, change
<pre>
list listen_http '0.0.0.0:80'
list listen_http '[::]:80'
list listen_https '0.0.0.0:443'
list listen_https '[::]:443'
</pre>
to
<pre>
list listen_http '0.0.0.0:8080'
list listen_http '[::]:8080'
list listen_https '0.0.0.0:8443'
list listen_https '[::]:8443'
</pre>

Then install pcat-manager-web on device:
<pre>
cd /tmp
wget https://dl.photonicat.com/repos/photonicatwrt/photonicat2/volatile/pcat-manager-web_2.0.1-27_aarch64_generic.ipk
opkg install pcat-manager-web_2.0.1-27_aarch64_generic.ipk
</pre>

Reboot your device to apply changes.

==Flash system images to the onboard eMMC==
Prepare update tools and files:
<pre>
git clone https://github.com/rockchip-linux/rkdeveloptool.git
cd rkdeveloptool
sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf
aclocal
autoreconf -i
autoheader
automake --add-missing
./configure
make
wget https://dl.photonicat.com/images/photonicat2/RK3576_MiniLoaderAll.bin
</pre>

Refer: [[Photonicat_快速上手#4G/5G版本按键功能定义]] to enter the firmware update mode, use A-to-A cable to connect USB OTG port to PC, and use the command below:
<pre>
gunzip photonicatwrt-25.02.0-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat2-squashfs-sysupgrade.img.gz #Replace file name with the one you get indeed.
sudo ./rkdeveloptool db MiniLoaderAll.bin
sudo ./rkdeveloptool wl 0 photonicatwrt-25.02.0-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat2-squashfs-sysupgrade.img
sudo ./rkdeveloptool rd
</pre>

==How to modify your own version of kernel for OpenWRT==
Compile <code>rockchip_rk3568_openwrt</code> with above steps.

Modify:
*DTB: https://github.com/photonicat/rockchip_rk3568_openwrt/blob/master/target/linux/rockchip/files/arch/arm64/boot/dts/rockchip/rk3576-photonicat2.dts
*kernel patches: (we need to add/ modify your version of kernel patches into this dir and recompile): https://github.com/photonicat/rockchip_rk3568_openwrt/tree/master/target/linux/rockchip/patches-6.12

Recompile and done.

Photonicat 2 sysfs

2025-09-01T16:02:28Z

Guangyingmao：创建页面，内容为“= 版本说明 = * '''1代（截至 2025-08）'''：通过 '''pcat-manager''' 的 '''socket''' 方式获取电源/温控数据。参考开源项目： [https://github.com/photonicat/rockchip_rk3568_pcat_manager/tree/v1 rockchip_rk3568_pcat_manager v1] * '''2代'''：功能集成进内核，统一经 '''sysfs / hwmon / power_supply / thermal''' 导出；并新增 '''电压/电流/电量（库仑计）检查'''。 —— 推荐上层应用直接读取本…”

= 版本说明 =
* '''1代（截至 2025-08）'''：通过 '''pcat-manager''' 的 '''socket''' 方式获取电源/温控数据。
参考开源项目： [https://github.com/photonicat/rockchip_rk3568_pcat_manager/tree/v1 rockchip_rk3568_pcat_manager v1]
* '''2代'''：功能集成进内核，统一经 '''sysfs / hwmon / power_supply / thermal''' 导出；并新增 '''电压/电流/电量（库仑计）检查'''。
—— 推荐上层应用直接读取本文所列 sysfs 路径。

= 电源/散热/背光 Sysfs 简明说明（OpenWrt / Debian） =

适用于 OpenWrt 与 Debian。
包含：
* '''/sys/class/power_supply/battery'''（电池）
* '''/sys/class/power_supply/charger'''（充电器）
* '''/sys/class/thermal/cooling_device0'''（风扇档位）
* '''/sys/class/hwmon/hwmon2/temp1_input'''（主板温度，m°C）
* '''/sys/class/hwmon/hwmon3/fan1_input'''（风扇转速，RPM）
* '''/sys/class/thermal/thermal_zoneN/*'''（多热区）
* '''/sys/class/backlight/backlight/brightness'''（背光）
* '''/sys/kernel/photonicat-pm/movement_trigger'''（抬腕唤醒）

== 快速示例 ==
<syntaxhighlight lang="bash">
# 电池 / 充电器
cat /sys/class/power_supply/battery/capacity
cat /sys/class/power_supply/charger/online

# 风扇档位（0..max_state）
cat /sys/class/thermal/cooling_device0/cur_state
echo 5 > /sys/class/thermal/cooling_device0/cur_state # 需 root

# 主板温度（m°C -> °C） hwmon2: pcat_pm_hwmon_temp_mb
awk '{printf "Mobo: %.1f°C\n",$1/1000}' /sys/class/hwmon/hwmon2/temp1_input

# 风扇转速（RPM） hwmon3: pcat_pm_hwmon_speed_fan
echo -n "Fan1: "; cat /sys/class/hwmon/hwmon3/fan1_input

# CPU 温度（thermal_zone0，m°C -> °C）
awk '{printf "CPU: %.1f°C\n",$1/1000}' /sys/class/thermal/thermal_zone0/temp

# 列出所有热区的类型与温度
for z in /sys/class/thermal/thermal_zone*; do \
printf "%s " "$(cat "$z/type" 2>/dev/null)"; \
awk '{printf "%.1f°C\n",$1/1000}' "$z/temp" 2>/dev/null; \
done

# 背光
cat /sys/class/backlight/backlight/brightness
</syntaxhighlight>

== 关键路径与含义 ==
{| class="wikitable"
! 路径 !! 含义 !! 单位/说明
|-
| /sys/class/hwmon/hwmon2/temp1_input || 主板温度（pcat_pm_hwmon_temp_mb） || m°C（除以1000得°C）
|-
| /sys/class/hwmon/hwmon3/fan1_input || 风扇转速（pcat_pm_hwmon_speed_fan） || RPM
|-
| /sys/class/thermal/cooling_device0/cur_state || 风扇当前档位 || 0..max_state（写入需 root）
|-
| /sys/class/power_supply/battery/* || 电池状态（电量/电压/电流/能量等；二代含库仑计相关） || —
|-
| /sys/class/power_supply/charger/* || 充电器在线/电压/类型 || —
|-
| /sys/class/thermal/thermal_zoneN/{type,temp} || 多热区类型与温度（如 CPU/GPU/NPU/DDR/bigcore 等） || m°C
|-
| /sys/class/backlight/backlight/{brightness,max_brightness} || 背光等级/最大值 || 整数（0..max）
|-
| /sys/kernel/photonicat-pm/movement_trigger || 抬腕唤醒触发标志 || 0/1（写入依驱动）
|}

== 备注 ==
* 单位：电压 µV、电流 µA、功率 µW、温度 m°C、转速 RPM、能量 µWh。
* 写操作（风扇档位、背光）需 root；接口是否存在取决于驱动与机型。
* 从一代迁移到二代：优先改为读取上述 sysfs 路径，原 socket 方案仅作为兼容保留。

Photonicat 2 specs

2025-09-01T16:01:24Z

Guangyingmao：创建页面，内容为“{| class="wikitable" !colspan="5"|Photonicat2光影猫配置表 |- |align="center" width="150px" | 规格 || align="center" width="200px" | 不安装电池 || align="center" width="200px"| 移动版 Cell|| align="center" width="200px"| 4G版 || align="center" width="200px"| 5G版 |- | CPU || align="center" colspan="4"|瑞芯微 RK3568（8核 Cortex®-A72 + A53 @ 2.2GHz), ARM Mali G52 MC3, NPU 6Tops |- | 内存 || align="center" colspan="4"|标配：4GB LPDD…”

{| class="wikitable"
!colspan="5"|Photonicat2光影猫配置表
|-
|align="center" width="150px" | 规格 || align="center" width="200px" | 不安装电池 || align="center" width="200px"| 移动版 Cell|| align="center" width="200px"| 4G版 || align="center" width="200px"| 5G版
|-
| CPU || align="center" colspan="4"|瑞芯微 RK3568（8核 Cortex®-A72 + A53 @ 2.2GHz), ARM Mali G52 MC3, NPU 6Tops
|-
| 内存 || align="center" colspan="4"|标配：4GB LPDDR5, 高配：16GB LPDDR5
|-
| eMMC || align="center" colspan="4"|标配：8GB eMMC, 高配：128GB eMMC
|-
| 网络 || align="center" colspan="4"| 原生 PHY x 2
|-
| 顶部I/O ||align="center" colspan="4"|USB 3.0, HDMI 4K, 1Gbps RJ45 x 2
|-
| 侧面I/O || align="center" colspan="4"|NanoSIM（家庭版无）全系标配 MicroSD
|-
| 内置WIFI || align="center" colspan="4"| 全系标配 USB WiFi B/G/N/AC (2.4G/5G)
|-
| 内置WiFi天线 || align="center" colspan="4"| 标配： 4/5G x 4，WiFi天线 x3
|-
| 内置M.2 B-key || align="center" | 无 || align="center" colspan="4"| M.2 B-Key(用于扩展其他WWAN设备)
|-
| 内置M.2 E-key || align="center" | 无 || align="center" colspan="4"| M.2 E-Key(用于扩展其他Wifi模块等设备)
|-
| 内置M.2 M-key || align="center" | 无 || align="center" colspan="4"| M.2 M-Key(用于扩展其他NVME 设备)
|-
| 供电/工作功耗 || align="center" colspan="4"|DC20V @ 2.5A(Max), 无WWAN, NVME, 1.0~2.0W, 4G 2.5~6W, 5G 2.5~10W
|-
| 电池 ||align="center" | 无 || align="center" colspan="3"| 移动版配 7000mAh @ 7.4v, 50Wh (18650 * 4)
|-
| 4G 模块 ||align="center" | 无 || align="center" | 无 || align="center" | 全网通（占用M.2 B-key接口） || align="center" | 无
|-
| 5G 模块 || align="center" | 无 || align="center" | 无 || align="center" | 无 || align="center" | 全网/球通，（占用M.2 B-key接口）
|-
| 最佳电池续航时间 || align="center" | N/A || align="center" | 6小时 || align="center" | 5小时 || align="center" | 4小时，RM520N-GL 5小时
|-
| 关机充满电时间 || align="center" | N/A || align="center" | 3小时 || align="center" | 3小时 || align="center" | 3小时
|-
| 开机充满电时间 || align="center" | N/A || align="center" | 3-4小时 || align="center" | 4-5小时 || align="center" | 4-6小时
|-
| 重量 || align="center" | 260克（无电池）|| align="center" |470克|| align="center" |480克 || align="center" |485克
|-
| 尺寸 || align="center" colspan="4"|154mm x 78mm x 32mm
|}

首页

2025-09-01T15:29:33Z

Guangyingmao：

__NOTOC__
[[image:Pcat2-wiki.png||thumb|Photonicat 光影猫 2]]
[[image:4pcat.jpg||thumb|Photonicat 光影猫 1]]
'''Photonicat - 光影猫''' 系列是一个提供电池的便携型路由器。光的速度，猫的灵活，装在一个数据包里。他既是波也是粒子，他是光影猫。

== 产品特性 ==
* 板载 WiFi AC/AX 模块，内置天线，并支持通过 PCI-E 扩展 4G/5G、WiFi 6 等通信能力。
* 丰富的扩展接口，可接入 GPS 及其他无线系统。
* 出厂预装 eMMC/SD OpenWRT 固件，支持快速安装和扩展插件。
* 支持多系统固件，可刷入 Debian、Ubuntu 或 Android。
* 高性能 CPU，支持千兆 NAT 满速转发，长期稳定运行。
* CNC 6 系列铝合金与高分子材料机身，坚固轻巧。
* eMMC 与 SD 双启动方案，提升系统稳定性与抗震性能。
* 内置可充电锂电池，支持 UPS 模式、车载供电及延时关机。
* 完全开源，基于 OpenWRT 平台，支持丰富的开源插件与二次开发。 [[Photonicat 1 Specs]]

== Photonicat 2 ==
2025 年 8 月，我们正式发布了 '''Photonicat 2'''，在原有基础上进行了多方面的增强与升级：

* 🖥️ '''CPU 升级'''：由原来的 4 核升级为 8 核，采用先进的 '''8nm RK3678 SoC'''，计算性能和能效全面提升。
* 🧠 '''内存升级'''：由 DDR4 升级为 '''LPDDR5 内存'''，支持 On-Die ECC，自修复能力更强，数据稳定性更高。
* 📡 '''天线增强'''：内置7根增强型天线，支持4根可扩展外置天线，信号更强。
* 🔋 '''电池升级'''：内置 4 × 18650 大容量电池，续航能力显著提升。
* 🔌 '''电源系统升级'''：支持 '''无电池运行'''（直流供电模式），并新增 '''双向快充 30W''' 功能，既可快速自充，也可作为移动电源反向输出。
* 💾 '''存储扩展'''：除 eMMC/SD 外，新增对 NVMe 固态硬盘的支持，提供高速存储能力。
* 📺 '''新增交互'''：内置屏幕，可实时显示设备状态和网络信息。
* 📊 '''传感器扩展'''：集成库仑计（Columb Meter），支持精确电流/电量测量；G-sensor 提供移动检测与姿态感应。
* 🛠️ '''软件兼容'''：保持 OpenWRT 开源支持，灵活安装丰富插件，同时可刷入 Debian、Ubuntu、Android 固件

{| class="wikitable"
!colspan="5"|Photonicat2光影猫配置表
|-
|align="center" width="150px" | 规格 || align="center" width="200px" | 不安装电池 || align="center" width="200px"| 移动版 Cell|| align="center" width="200px"| 4G版 || align="center" width="200px"| 5G版
|-
| CPU || align="center" colspan="4"|瑞芯微 RK3576（8核 Cortex®-A72 + A53 @ 2.2GHz), ARM Mali G52 MC3, NPU 6Tops
|-
| 内存 || align="center" colspan="4"|标配：4GB LPDDR5, 高配：16GB LPDDR5
|-
| eMMC || align="center" colspan="4"|标配：8GB eMMC, 高配：128GB eMMC
|-
| 网络 || align="center" colspan="4"| 原生 PHY 1000Mbps x 2
|-
| 顶部I/O ||align="center" colspan="4"|USB 3.0, HDMI 4K, 1Gbps RJ45 x 2
|-
| 侧面I/O || align="center" colspan="4"|NanoSIM（家庭版无）全系标配 MicroSD
|-
| 内置WIFI || align="center" colspan="4"| 全系标配 USB WiFi B/G/N/AC (2.4G/5G)
|-
| 内置WiFi天线 || align="center" colspan="4"| 标配： 4/5G x 4，WiFi天线 x3
|-
| 内置M.2 B-key || align="center" colspan="5" | M.2 B-Key（用于扩展其他 WWAN 设备）
|-
| 内置M.2 E-key || align="center" colspan="5" | M.2 E-Key（用于扩展其他 WiFi 模块等设备）
|-
| 内置M.2 M-key || align="center" colspan="5" | M.2 M-Key（用于扩展其他 NVMe 设备）
|-
| 供电/工作功耗 || align="center" colspan="4"|PD 20V @ 2.5A(Max) 双向 30W 电池充放电。
|-
| 电池 ||align="center" | 无 || align="center" colspan="3"| 7000mAh @ 7.4v, 51.8Wh (18650 * 4)
|-
| 4G 模块 ||align="center" | 无 || align="center" | 无 || align="center" | 全网通|| align="center" | 无
|-
| 5G 模块 || align="center" | 无 || align="center" | 无 || align="center" | 无 || align="center" | 全网通/全球通
|-
| 最佳电池续航时间 || align="center" | N/A || align="center" | 24小时 || align="center" | 18小时 || align="center" | 12小时，RM520N-GL 15小时
|-
| 开机充满电时间 || align="center" | N/A || align="center" | 2.0小时 || align="center" | 2.5小时 || align="center" | 2.5小时
|-
| 重量 || align="center" | 260克（无电池）|| align="center" |470克|| align="center" |480克 || align="center" |485克
|-
| 尺寸 || align="center" colspan="4"|154mm x 78mm x 32mm
|}

==Photonicat 2代==
{|width="90%"
|[[Photonicat 2 specs]]||[[Photonicat 2 sysfs]]
|[[Build system image for photonicat2]]
|[[Photonicat 2 Wifi/WWAN/NVME M2 兼容模块]]
|[[Photonicat 2 固件USB线刷更新教程]]
|[[Photonicat 2 固件在线升级更新]]
|-
|}

==Photonicat 1代用户手册 User Manual==
{|width="90%"
|[[Photonicat 快速上手]] || [[Photonicat WEB 管理页面操作手册]] || [[Photonicat 刷机操作手册]] || [[Photonicat SD启动、更新]] || [[Photonicat 6.1.8内核版本回退4.19版本说明]]
|-
||[[Photonicat 安装openWRT插件]] || [[Photonicat OTA更新]] || [[Photonicat FAQs 常见问题]] || [[Photonicat OpenWRT挂载新分区]] || [[Photonicat 板载WIFI 5G频段信道支持列表]]
|-
||[[Photonicat Open Wrt固件更新指南]] || [[Photonicat 使用注意事项]]
|}

==Photonicat 1/2代场景教程 Usage Scenarios==
连接模式：
{|width="90%"
| [[Photonicat 主路由]]|| [[Photonicat 旁路由]] || [[Photonicat 4G/5G 家庭网络备份]]
|-
| [[Photonicat 作为AP]] || [[Photonicat 无线桥接]] || [[Photonicat wifi网卡WAN/LAN同时使用]]
|-
| [[Photonicat 网络加速 Turbo ACC]] || [[Photonicat 端口转发]]
|}
开关机功能：
{|width="90%"
| [[Photonicat 车载/UPS开关机功能]]
|-
|}
其他用途：
{|width="90%"
| [[Photonicat 音乐盒模式]] || [[Photonicat Android]] || [[Photonicat Debain/Ubuntu]] || [[Photonicat Openwrt Docker/istore]] || [[Photonicat 网络共享/samba4]] || [[Photonicat(4G版本)开启GPS功能]]
|-
| [[Photonicat WAN口设置成LAN]]
|-
|}

==Photonicat 进级内容 Advanced Topics==
{|width="90%"
|[[Photonicat 编译 OpenWRT, Debian]] || [[Photonicat 编译 Android]] || [[Photonicat Wifi/WWAN M2 兼容模块]] || [[Photonicat TTL，Watchdog，Recovery说明]] || [[Photonicat 下调CPU频率]]
|-
|| [[Photonicat GPIO扩展说明]] || [[Photonicat Tesla Wifi 推荐设置]] || [[Photonicat Google TV连接]] || [[Photonicat Debian + Virtual Machine]]
|-
||[[Photonicat DIY 注意事项]] || [[Photonicat IPv6 Native, NAT6模式]]||[[Photonicat Tips 使用技巧]] || [[Photonicat Modem 配置USB3.0]]
|-
|[[Photonicat 刷Modem模块固件]] || [[Photonicat 自动关机电压修改]] ||[[Photonicat 功耗测试记录]] || [[Photonicat 改无电池]] || [[Photonicat MCU 通讯协议]]
|-
|}

==固件/Images 相关==
* 正式版固件 : https://dl.photonicat.com/images/
* beta固件 6.x内核 : https://dl.photonicat.com/images/beta/
* [[Photonicat 固件 Changelog]]

==其他链接==
* Photonicat Github: https://github.com/photonicat
* Photonicat Downloads: https://dl.photonicat.com (含所有binary images和自动升级的4G/5G电源管理Web IPKs）
Debian/Ubuntu 默认用户名：photonicat 默认密码：photonicat

[[Photo Gallery 图集]] ｜ [[Photonicat 硬件配置表]]

==官方购买链接==
* 淘宝: [https://shop571644147.taobao.com/ 官方淘宝店铺点击购买访问]
* 京东: [https://item.jd.com/10067989535953.html/ 官方京东店铺点击购买访问]
* 注意识别非官方店铺，谨防上当受骗，非官方店铺、授权渠道购买的商品无法享受质保和技术支持

==其他链接==
* Photonicat B站体验视频: https://www.bilibili.com/video/BV1VR4y197QY
* Photonicat Github: https://github.com/photonicat
* Photonicat Downloads: https://dl.photonicat.com (含所有binary images和自动升级的4G/5G电源管理Web IPKs）

[[Photo Gallery 图集]] ｜ [[Photonicat 硬件配置表]]

==社区、爱好者、帮助等==
如果有什么特殊需求可以通过：
*taobao客服 https://shop571644147.taobao.com/
*email: info@photonicat.cn
*[https://github.com/photonicat github issue]

2023-08-21T09:15:13Z

Guangyingmao：

2022年12月17日及以后版本，默认modem 连接采用USB2.0 模式。

如果需要配置成USB3.0 可以通过dd命令把boot 分区修改，重启，已完成修改。

==通过openWRT命令行==
<code>
cd /tmp 
dd if=/dev/mmcblk0p3 of=/root/backup-boot-modem-usb20.img bs=1M #备份p3分区 
wget https://dl.photonicat.com/images/rk3568-photonicat-openwrt-boot-modem-usb30-202301301714.img.gz #日期需要对应image 日期。如20221217 image，需要boot-modem-usb30-20221217 
zcat rk3568-photonicat-openwrt-boot-modem-usb30-202301301714.img.gz | dd of=/dev/mmcblk0p3 bs=1M 
</code>

重启路由器，搞定。

==6.X-3月30日固件切换USB3.0==
<code>
cd /mnt/mmcblk0p5

wget http://dl.photonicat.com/misc/rk3568-photonicat-usb30.dtb

cp rk3568-photonicat.dtb rk3568-photonicat.bak

cp rk3568-photonicat-usb30.dtb rk3568-photonicat.dtb

reboot
</code>

==kernel 6.1.40 2023-07固件开通USB3.0==

<pre>
cd /mnt/mmcblk0p1
wget http://dl.photonicat.com/misc/rk3568-photonicat-usb30.dtb
cp rockchip.dtb rockchip.dtb.bak
cp rk3568-photonicat-usb30.dtb rockchip.dtb
reboot
</pre>

Photonicat 快速上手

2023-08-15T13:50:08Z

Guangyingmao：/* 支持蜂窝网络功能版本的机器如何插入SIM卡 */

==Photonicat 快速上手==
#接入电源USB-C 5V接口，接入sim卡或网线至WAN口。
#手机或电脑连接 WiFi或LAN网口（默认WiFi 密码：photonicat)
#在浏览器中打开172.16.0.1，修改Photonicat配置（例如Wifi密码、Wifi 频率）
#在浏览器中打开172.16.0.1:8080或者在Web管理页面右上角点击OpenWRT，进入OpenWRT配置页面可自主修改
==支持蜂窝网络功能版本的机器如何插入SIM卡==
#光影猫支持标准NANOSIM卡，尺寸为12mm x 9mm，厚度约为0.65mm。请注意，非标准NANOSIM卡可能会卡在机器的卡槽中无法取出，这种情况常见于不合规的超厚物联网卡。如果卡住，建议使用尖嘴镊子夹出SIM卡。
#如果您使用非标准NANOSIM卡，可以自行购买NANOSIM延长线。
#请注意，光影猫不支持开机后插入SIM卡。请在关机状态插入SIM卡，或更换卡后，在172.16.0.1的上方选择重启设备。
#蜂窝网络功能版本的光影猫，可支持移动、联通、电信、广电（广电目前可能使用移动的基站，显示或使用存在问题）的手机卡。
#在使用SIM卡之前，请注意关闭PIN密码（如果开启）。有些物联网卡或副卡可能限制设备使用或禁止共享热点流量功能，因此在光影猫上可能无法正常使用。
#光影猫全球版可以在全球大部分国家和地区使用。请注意开启漫游功能，并确保您的手机卡可用于非手机设备，并支持热点功能。
=== 光影猫SIM卡插入图示 ===
[[File:openwrt-changpw-wiki-sim.png|500px]]

==更改管理员密码==
#进入OpenWRT配置页面
#选择<code>系统</code> -> <code>管理权</code> 页面
#在主机密码位置输入新密码，并点击 <code>保存&应用</code>
[[File:openwrt-changpw-wiki-02.png|500px]]

==出厂默认配置==
#LAN IP : <code>172.16.0.1</code>
#管理界面地址(原厂）: <code>http://172.16.0.1</code>
#OpenWRT原生界面 : <code>http://172.16.0.1:8080</code>
#Wifi默认密码 : <code>photonicat</code>
#登陆用户 : <code>root</code>
#登录密码 : <code>photonicat</code>

==Photonicat 按键配置==
Photonicat采用极简设计理念，外部只保留一个功能按键来实现所有功能，相关按键功能定义请参见以下'''按键功能定义表'''
=== 4G/5G版本按键功能定义 ===
{| class="wikitable sortable"
|-
! 功能 !! 进入方式 !! 状态提示
|-
|开机||长按3秒||电源灯常亮
|-
|开机进入烧录模式||短按3下，再长按10秒以上||电源灯闪烁（0.25秒亮，0.25秒暗）
|-
|开机恢复出厂设置||短按1下，再长按17秒以上||电源灯闪烁（0.5秒亮，0.5秒暗）
|-
|关机||长按3秒||电源灯熄灭
|-
|查看电量||短按1下||3个LED灯全闪2下，根据电量显示，3灯再次全闪2下退出（电量显示定义参见电量定义表）
|-
|}
=== 家庭版（无电池）按键功能定义===
{| class="wikitable sortable"
|-
! 功能点 !! 进入方式 !! 状态提示
|-
|进入烧录模式 || 开机时长按<code>Reset</code> 9秒进入||电源灯闪烁（0.25秒亮，0.25秒暗）
|-
|进入恢复出厂模式 || 开机后长按<code>Reset</code> 16秒进入||电源灯闪烁（0.5秒亮，0.5秒暗）
|-
|开机方式 || 5V供电后直接开机
|-
|关机方式 || 5V掉电后直接关机
|-
|}

=== 电量定义表 ===
{| class="wikitable sortable"
|-
! 电量定义 !! 状态提示
|-
|High || 3灯常亮
|-
|Mid || 网络状态灯、充电灯常亮
|-
|Low || 充电灯常亮
|-
|Critical || 充电灯闪烁
|-
|}

==Photonicat LED灯状态说明==
Photonicat由3颗黄色LED灯来显示相关的工作状态，3颗LED从上至下依次为：开机状态灯、网络状态灯和充电状态灯,相关工作状态参加下表'''LED灯工作状态表'''。
=== LED灯工作状态表 ===
{| class="wikitable sortable"
|-
! LED灯 !! 状态 !! 相关工作状态
|-
|rowspan=2|开机状态灯||常亮||主板上电，开机
|-
|常暗||主板断电，关机
|-
|rowspan=3|网络状态灯||均匀闪烁（亮暗间隔时间相同）||WAN口有线网络工作，并且ping dns通
|-
|不均匀闪烁（亮暗间隔时间不相同）||4G/5G模块工作，并且ping dns通
|-
|常暗||网络异常（ping dns无响应）
|-
|rowspan=4|充电状态灯||呼吸灯||充电中
|-
|常亮||充电完成
|-
|常暗||未插入充电器
|-
|闪烁||低电量警示
|-
|}

ping dns = 为114.114.114.114， 1.1.1.1， 8.8.8.8 任意一个通畅则判断WAN网络有链接。

==Photonicat 工作模式说明==
Photonicat可以通过WEB管理页面配置不同工作模式,分别为普通模式、车载模式和定时模式,相关工作模式的说明请参加下表'''工作模式说明表'''。
=== 工作模式说明表 ===
{| class="wikitable sortable"
|-
! 工作模式 !! 说明
|-
|普通模式||需手动开关机
|-
|车载模式||插入充电器开机，拔出充电器关机，具体细节请参见'''车载模式开关机逻辑表'''
|-
|定时模式||根据WEB管理页面设置的时间定时开关机（车载模式下，定时模式不生效）
|-
|}
=== 车载模式开关机逻辑表 ===
{| class="wikitable sortable"
|-
! 功能 !! 说明
|-
|开机 || 插上充电器
|-
|关机 || 拔出充电器
|-
|无充电器状态下开机 || 长按3秒按键正常开机流程，开机后在充电器保持未插入的状态下不再主动关机，插入再拔出充电器后根据车载模式正常工作
|-
|-
|有充电器状态下关机 || 长按3秒按键正常关机流程，关机后在充电器保持现有状态的情况下不再主动开机，拔出再插入充电器后根据车载模式正常工作
|-
|}