# =============================================================================
# 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

# OLED 在主页和当前告警页之间轮播的周期，单位：秒。
# 页面切换只影响 OLED；RGB 始终由当前 Display Owner 决定。
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]
# DisplayController 按集中定义的 priority 仲裁 owner。告警页显示时 RGB 同步显示
# 该页对象；主页使用最高优先级 active owner。颜色表示对象，速度表示严重等级：
#   CPU/频率/温度/散热 = 红色
#   供电/欠压          = 橙色闪烁（实机校准，避免内置黄色偏绿）
#   内存           = 紫色
#   磁盘           = 白色
#   网络/Wi-Fi     = 蓝色
#   服务/进程      = 青色
# 颜色通道范围为 0..255。以下是本机实测后的默认值。
cpu_r = 255
cpu_g = 0
cpu_b = 0
power_r = 255
power_g = 40
power_b = 0
memory_r = 255
memory_g = 0
memory_b = 255
storage_r = 255
storage_g = 255
storage_b = 255
network_r = 0
network_g = 0
network_b = 255
service_r = 0
service_g = 255
service_b = 96

# 各严重等级可分别设置亮灯和灭灯时长，单位：毫秒，最小值 50。
# 默认完整周期：Warning 3秒、Critical 1.5秒、Emergency 0.6秒。
warning_flash_on_ms = 1500
warning_flash_off_ms = 1500
critical_flash_on_ms = 750
critical_flash_off_ms = 750
emergency_flash_on_ms = 300
emergency_flash_off_ms = 300
# NORMAL_HOME 为 owner 时 RGB OFF。
#
# 每次点亮使用 v3.2.0 已验证的 selector -> R -> G -> B 完整写入顺序，
# 只在亮/灭边沿访问 MCU，不做高频软件 PWM。
write_delay_ms = 10

# v3.3.0 RC 期间使用过的 brightness、*_breathe_seconds、rgb_update_ms、
# warning_color、critical_color、warning_flash_ms、critical_flash_ms 和
# emergency_flash_ms
# 可以继续留在现有配置中；硬件灯效引擎会安全忽略它们。


[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