Photonicat 2 sysfs:修订间差异

来自Photonicat Wiki
跳转到导航 跳转到搜索
C2h2留言 | 贡献
无编辑摘要
Monstercat留言 | 贡献
无编辑摘要
 
(未显示1个用户的4个中间版本)
第1行: 第1行:
= 版本说明 =
* '''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) =
= 电源/散热/背光 Sysfs 简明说明(OpenWrt / Debian) =


适用于 OpenWrt 与 Debian。
包含:
包含:
* '''/sys/class/power_supply/battery'''(电池)
* '''/sys/class/power_supply/battery'''(电池)
第10行: 第17行:
* '''/sys/class/backlight/backlight/brightness'''(背光)
* '''/sys/class/backlight/backlight/brightness'''(背光)
* '''/sys/kernel/photonicat-pm/movement_trigger'''(抬腕唤醒)
* '''/sys/kernel/photonicat-pm/movement_trigger'''(抬腕唤醒)
* '''/sys/kernel/photonicat-pm/gs_x''' (加速度传感器X轴, 单位: 1/16384g)
* '''/sys/kernel/photonicat-pm/gs_y''' (加速度传感器Y轴, 单位: 1/16384g)
* '''/sys/kernel/photonicat-pm/gs_z''' (加速度传感器Z轴, 单位: 1/16384g)


== 快速示例 ==
== 快速示例 ==
第38行: 第48行:
# 背光
# 背光
cat /sys/class/backlight/backlight/brightness
cat /sys/class/backlight/backlight/brightness
# 如存在 max_brightness 可换算百分比
</syntaxhighlight>
</syntaxhighlight>


第51行: 第60行:
| /sys/class/thermal/cooling_device0/cur_state || 风扇当前档位 || 0..max_state(写入需 root)
| /sys/class/thermal/cooling_device0/cur_state || 风扇当前档位 || 0..max_state(写入需 root)
|-
|-
| /sys/class/power_supply/battery/* || 电池状态(电量/电压/电流等) || —
| /sys/class/power_supply/battery/* || 电池状态(电量/电压/电流/能量等;二代含库仑计相关) || —
|-
|-
| /sys/class/power_supply/charger/* || 充电器在线/电压/类型 || —
| /sys/class/power_supply/charger/* || 充电器在线/电压/类型 || —
|-
|-
| /sys/class/thermal/thermal_zoneN/{type,temp} || 多热区类型与温度 || m°C
| /sys/class/thermal/thermal_zoneN/{type,temp} || 多热区类型与温度(如 CPU/GPU/NPU/DDR/bigcore 等) || m°C
|-
|-
| /sys/class/backlight/backlight/{brightness,max_brightness} || 背光等级/最大值 || 整数(0..max)
| /sys/class/backlight/backlight/{brightness,max_brightness} || 背光等级/最大值 || 整数(0..max)
第63行: 第72行:


== 备注 ==
== 备注 ==
* 你的设备上:`hwmon2=name: pcat_pm_hwmon_temp_mb`、`hwmon3=name: pcat_pm_hwmon_speed_fan`。 
* 单位:电压 µV、电流 µA、功率 µW、温度 m°C、转速 RPM、能量 µWh。  
  可用 `cat /sys/class/hwmon/hwmon*/name` 确认索引与名称对应关系。 
* 写操作(风扇档位、背光)需 root;接口是否存在取决于驱动与机型。 
* 单位:电压 µV、电流 µA、功率 µW、温度 m°C、转速 RPM。  
* 从一代迁移到二代:优先改为读取上述 sysfs 路径,原 socket 方案仅作为兼容保留。
* 写操作(风扇档位、背光)需 root;接口是否存在取决于驱动。

2025年10月31日 (五) 17:32的最新版本

版本说明

  • 1代(截至 2025-08):通过 pcat-managersocket 方式获取电源/温控数据。
 参考开源项目: 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(抬腕唤醒)
  • /sys/kernel/photonicat-pm/gs_x (加速度传感器X轴, 单位: 1/16384g)
  • /sys/kernel/photonicat-pm/gs_y (加速度传感器Y轴, 单位: 1/16384g)
  • /sys/kernel/photonicat-pm/gs_z (加速度传感器Z轴, 单位: 1/16384g)

快速示例

# 电池 / 充电器
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

关键路径与含义

路径 含义 单位/说明
/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 方案仅作为兼容保留。