Web3-Pi-UPS-Service/config.toml.example at main · Web3-Pi/Web3-Pi-UPS-Service · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# Web3 Pi UPS Service Configuration (v2)
# Install at /etc/w3p-ups/config.toml.

[serial]
# "auto" detects the Web3_Pi_UPS USB device, or specify a path like "/dev/ttyACM0".
port = "auto"
baud_rate = 115200

[battery]
# Critical SOC (percent) below which shutdown is initiated, when on battery.
# SOC is computed from a hardcoded LUT for the 2S Panasonic CGR18650CH pack
# used in the Web3 Pi UPS — same curve as the OLED on the device.
shutdown_threshold_pct = 10
# Margin above the threshold required to cancel a pending shutdown (anti-flap).
shutdown_cancel_margin_pct = 5
# Input (PD) voltage range that indicates the grid is connected. Outside → on battery.
input_min_valid_mv = 8000
input_max_valid_mv = 26000

[shutdown]
# Path to the script run when shutdown is triggered.
script_path = "/etc/w3p-ups/shutdown.sh"
# Grace period (seconds) between low-battery detection and shutdown.
delay_seconds = 30

[host_metrics]
# Period between host.status emissions to RP2040 (seconds). 0 disables.
# 30 s keeps the LTE uplink inside the ~500 MB/mo data plan.
interval_seconds = 30

[commands]
# Master kill switch for `host.service.restart` REQs.
allow_service_restart = true
# Whitelist of systemd unit names (without `.service`) allowed to be restarted.
service_whitelist = [
    "w3p_geth",
    "w3p_nimbus-beacon",
    "w3p_lighthouse-beacon",
    "nimbus-validator",
]

[ipc]
# Local Unix domain socket for read-only state queries (CLI / future LCD plugin).
socket_path = "/run/w3p-ups/agent.sock"

[logging]
# trace | debug | info | warn | error
level = "info"
# Emit logs through journald in addition to stderr (set true on systemd hosts).
journald = false