查看“Photonicat 2 sysfs”的源代码

= 版本说明 =
* '''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 方案仅作为兼容保留。