Files
pigway-device-agent/config/pigway-pi-control.conf
T

243 lines
6.9 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# =============================================================================
# Pigway Pi Control v3.3.0 - 用户配置文件
# =============================================================================
#
# 正式安装后的配置路径:
# /etc/pigway-pi-control.conf
#
# 编辑:
# sudo nano /etc/pigway-pi-control.conf
#
# 保存后让配置生效:
# sudo systemctl restart pigway-pi-control
#
# 查看运行状态:
# systemctl status pigway-pi-control --no-pager -l
#
# 查看实时日志:
# journalctl -u pigway-pi-control -f
#
# 重要:
# 1. 只建议修改本文件,不要直接修改 /usr/local/sbin/pigway-pi-control。
# 2. “#” 开头是注释,不生效。要启用示例项,删除行首的 #。
# 3. 数值单位和建议范围见每项上方注释。
# 4. 配置写错导致服务无法启动时,可查看 journalctl 日志并修正本文件。
# =============================================================================
[timing]
# 传感器采样周期,单位:秒。
# CPU / 内存 / 温度 / 磁盘以及风扇控制按此周期更新。
# 推荐:1。通常不要低于 1。
sensor_interval = 1
# OLED 当前页面刷新周期,单位:秒。
# 这只是刷新当前页面数据,不负责切换页面。
# 推荐:1。
oled_refresh_interval = 1
# 为兼容 v3.2.x/v3.3.0 RC4 旧配置保留。
# RC5 使用单一 Display Owner,不再定时轮播 HOME/告警页,因此该值不参与运行时仲裁。
page_interval = 10
# 网络状态检查周期,单位:秒。
# 推荐:5。太短会产生不必要的网络探测。
network_interval = 5
# systemd 服务和自定义进程检查周期,单位:秒。
# 推荐:5。
service_interval = 5
# 本机健康检查周期,单位:秒。
# 检查 Raspberry Pi 欠压/降频状态、根文件系统只读状态等。
# 推荐:1。当前电源状态必须及时反映到 OLED/RGB;历史状态仅记录一次日志。
health_interval = 1
[fan]
# 风扇温控档位,单位:摄氏度。
#
# 默认曲线:
# < 50°C OFF
# 50~53°C L1
# 53~56°C L2
# 56~59°C L3
# 59~62°C L4
# >= 62°C MAX
#
# 如希望更安静,可适当提高阈值;如更重视散热,可降低。
# 建议保持 start < level2 < level3 < level4 < max。
# 低于此温度,风扇完全停止。
start = 50
# L2 起始温度;start 到 level2 之间为 L1。
level2 = 53
# L3 起始温度。
level3 = 56
# L4 起始温度。
level4 = 59
# MAX 全速起始温度。
max = 62
# 降档回差,单位:°C。
# 防止温度在临界值附近上下波动时风扇频繁升降档。
# 推荐:1.0~2.0。
hysteresis = 1.5
[alerts]
# ---------------- CPU ----------------
# CPU 使用率达到此百分比后开始累计高负载时间。
cpu_high = 90
# CPU 降到此百分比以下,清除高负载累计。
cpu_recover = 75
# CPU 必须持续高负载多少秒才触发告警。
# 避免瞬时峰值造成误报。
cpu_high_seconds = 30
# ---------------- 内存 ----------------
# 内存使用率达到此百分比后开始累计。
memory_high = 90
# 内存降到此百分比以下,清除累计。
memory_recover = 85
# 持续多少秒才触发内存告警。
memory_high_seconds = 30
# ---------------- 温度 ----------------
# 温度普通告警阈值,单位:°C。
temp_high = 68
# 温度严重告警阈值,单位:°C。
temp_critical = 75
# ---------------- 磁盘 ----------------
# 根分区使用率达到此百分比触发普通告警。
disk_high = 90
# 根分区使用率达到此百分比触发严重告警。
disk_critical = 95
# ---------------- Wi-Fi 信号 ----------------
# 仅当 Wi-Fi 是 Linux 当前默认路由/主接口时生效。
# RSSI 单位 dBm,越接近0越强;约 -50很好,-70一般,-80较弱。
# 连续低于 wifi_weak 达到 wifi_weak_seconds 后触发蓝色告警。
wifi_weak = -75
# 已告警后恢复到该值以上才解除,形成滞回避免反复闪烁。
wifi_recover = -68
# 弱信号持续多少秒才正式告警。
wifi_weak_seconds = 30
[led]
# OLED 和 RGB 由同一 Display Owner 同步决定。
# DisplayController 按集中定义的 priority 仲裁 owner,RGB 再使用该 owner 的 severity:
# Warning (1) = 黄色慢呼吸
# Critical (2) = 橙红色快呼吸
# Emergency (3) = 纯红快速频闪
# NORMAL_HOME 为 owner 时 RGB OFF。每次写入明确设置 R/G/B,绝不沿用旧颜色。
#
# brightness 是 RGB 最大输出百分比(0~100)。
# 3颗 RGB 会一起亮,卧室建议 5~15。
brightness = 10
# 旧 warning_on_ms / warning_off_ms / critical_on_ms / critical_off_ms /
# emergency_on_ms / emergency_off_ms 仍可保留,RC3 忽略它们以兼容旧配置。
warning_breathe_seconds = 3.0
critical_breathe_seconds = 1.5
emergency_flash_ms = 300
rgb_update_ms = 80
# RGB 基色(0~255)。安全默认值严格不含蓝色,避免紫色/蓝色残留。
warning_r = 255
warning_g = 255
warning_b = 0
critical_r = 255
critical_g = 72
critical_b = 0
emergency_r = 255
emergency_g = 0
emergency_b = 0
[dark_mode]
# Raspberry Pi 4 板载 PWR / ACT LED。
# 本机硬件只支持开/关,不支持真正的 PWM 调暗。
#
# off = Pigway Pi Control 启动时关闭该灯。
# 若不希望程序干预,可改为 on。
#
# 注意:
# 散热板上的 D1/D8 黄色硬件状态灯以及独立电源模块绿灯
# 不属于已确认的软件控制接口,本程序不会尝试操作。
pi_pwr_led = off
pi_act_led = off
[services]
# =============================================================================
# systemd 服务监控(推荐)
# =============================================================================
#
# 格式:
# OLED显示名称 = systemd真实unit名称
#
# 左侧名称建议尽量短(OLED只有128×32)。
# 右侧必须是真实的 systemd unit。
#
# 如何确认服务名:
# systemctl status ssh.service
# systemctl list-units --type=service
#
# 暂停监控:
# 在该行最前面加 #
#
# 新增监控:
# 直接增加一行,例如:
# TAILSCALE = tailscaled.service
#
# 修改后:
# sudo systemctl restart pigway-pi-control
#
# 默认监控 SSH 和向日葵核心后台服务。
SSH = ssh.service
AWESUN = runawesun.service
# 以下仅为示例,默认不启用:
# TAILSCALE = tailscaled.service
# DOCKER = docker.service
# SAMBA = smbd.service
# NGINX = nginx.service
[processes]
# =============================================================================
# 普通进程监控
# =============================================================================
#
# 仅在程序没有 systemd service 时使用。
# 如果存在 systemd service,优先放到上面的 [services]。
#
# 格式:
# OLED显示名称 = pgrep -f 可以匹配到的进程关键字/命令行
#
# 示例:
# MYAPP = /opt/myapp/server
#
# 可以先在终端测试:
# pgrep -af '/opt/myapp/server'
#
# 有输出说明匹配成功。
#
# 示例默认全部注释,不会监控任何普通进程。
# MYAPP = /opt/myapp/server