# =============================================================================
# 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 使用该 owner 的 severity。
# OLED 独立轮播主页与全部当前告警页；切页不会关闭、重启或改变 RGB：
#   Warning (1)   = 黄色慢呼吸
#   Critical (2)  = 红色快呼吸
#   Emergency (3) = 纯红快速频闪
# NORMAL_HOME 为 owner 时 RGB OFF。
#
# 该旧版 MCU 由内置灯效产生呼吸。仅在模式变化时按
# speed -> color -> effect 写入，禁止软件 PWM 和循环帧日志。
# 卖家协议：speed 1=慢、2=中、3=快；color 0=红、3=黄。
warning_speed = 1
warning_color = 3
critical_speed = 3
critical_color = 0
write_delay_ms = 10
emergency_flash_ms = 300

# v3.3.0 之前的 brightness、*_breathe_seconds、rgb_update_ms 和 *_r/g/b
# 可以继续留在现有配置中；硬件灯效引擎会安全忽略它们。


[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