通过命令行控制

除了通过 Dashboard 查看 Pironman 5 MAX 的数据并控制各个模块外，你还可以使用命令行方式进行控制。

备注

对于 Home Assistant 系统，只能通过访问 http://<ip>:34001 的网页 Dashboard 进行监控与控制。

查看基本配置

pironman5 模块提供了 Pironman 的基础配置，可通过以下命令查看：

sudo pironman5 -c

标准配置示例如下：

{
    "system": {
        "data_interval": 1,
        "database_retention_days": 30,
        "temperature_unit": "C",
        "enable_history": true,
        "oled_enable": true,
        "oled_rotation": 0,
        "oled_sleep_timeout": 10,
        "oled_pages": [
            "mix",
            "performance",
            "ips",
            "disk"
        ],
        "rgb_enable": true,
        "rgb_color": "#0a1aff",
        "rgb_brightness": 100,
        "rgb_style": "breathing",
        "rgb_speed": 50,
        "rgb_led_count": 4,
        "rgb_led_count_min": 4,
        "gpio_fan_pin": 6,
        "gpio_fan_mode": 0,
        "gpio_fan_led": "on",
        "gpio_fan_led_pin": 5,
        "debug_level": "INFO"
    }
}

你可以根据需要自定义这些配置。

使用 pironman5 或 pironman5 -h 查看指令帮助。

usage: pironman5 [-h] [-v] [-c] [-drd [DATABASE_RETENTION_DAYS]] [-dl [{DEBUG,INFO,WARNING,ERROR,CRITICAL,debug,info,warning,error,critical}]] [-rd] [-cp [CONFIG_PATH]] [-eh [ENABLE_HISTORY]] [-re [RGB_ENABLE]] [-rs [RGB_STYLE]]
                [-rc [RGB_COLOR]] [-rb [RGB_BRIGHTNESS]] [-rp [RGB_SPEED]] [-rl [RGB_LED_COUNT]] [-u [{C,F}]] [-gm [GPIO_FAN_MODE]] [-gp [GPIO_FAN_PIN]] [-fl [GPIO_FAN_LED]] [-fp [GPIO_FAN_LED_PIN]] [-oe [OLED_ENABLE]] [-or [{0,180}]]
                [-op [OLED_PAGES]] [-os [OLED_SLEEP_TIMEOUT]]
                {start,stop,launch-browser} ...

Pironman 5 Max command line interface

options:
  -h, --help            show this help message and exit
  -v, --version         Show version
  -c, --config          Show config
  -drd, --database-retention-days [DATABASE_RETENTION_DAYS]
                        Database retention days
  -dl, --debug-level [{DEBUG,INFO,WARNING,ERROR,CRITICAL,debug,info,warning,error,critical}]
                        Debug level
  -rd, --remove-dashboard
                        Remove dashboard
  -cp, --config-path [CONFIG_PATH]
                        Config path
  -eh, --enable-history [ENABLE_HISTORY]
                        Enable history, True/true/on/On/1 or False/false/off/Off/0
  -re, --rgb-enable [RGB_ENABLE]
                        RGB enable True/False
  -rs, --rgb-style [RGB_STYLE]
                        RGB style: ['solid', 'breathing', 'flow', 'flow_reverse', 'rainbow', 'rainbow_reverse', 'hue_cycle']
  -rc, --rgb-color [RGB_COLOR]
                        RGB color in hex format without # (e.g. 00aabb)
  -rb, --rgb-brightness [RGB_BRIGHTNESS]
                        RGB brightness 0-100
  -rp, --rgb-speed [RGB_SPEED]
                        RGB speed 0-100
  -rl, --rgb-led-count [RGB_LED_COUNT]
                        RGB LED count int
  -u, --temperature-unit [{C,F}]
                        Temperature unit
  -gm, --gpio-fan-mode [GPIO_FAN_MODE]
                        GPIO fan mode, 0: Always On, 1: Performance, 2: Cool, 3: Balanced, 4: Quiet
  -gp, --gpio-fan-pin [GPIO_FAN_PIN]
                        GPIO fan pin
  -fl, --gpio-fan-led [GPIO_FAN_LED]
                        GPIO fan LED state on/off/follow
  -fp, --gpio-fan-led-pin [GPIO_FAN_LED_PIN]
                        GPIO fan LED pin
  -oe, --oled-enable [OLED_ENABLE]
                        OLED enable True/true/on/On/1 or False/false/off/Off/0
  -or, --oled-rotation [{0,180}]
                        Set to rotate OLED display, 0, 180
  -op, --oled-pages [OLED_PAGES]
                        OLED pages, split by ',': mix,performance,ips,disk
  -os, --oled-sleep-timeout [OLED_SLEEP_TIMEOUT]
                        OLED sleep timeout in seconds

Subcommands:
  {start,stop,launch-browser}
    start               Start Pironman5
    stop                Stop Pironman5
    launch-browser      Launch browser

备注

每次更改 pironman5.service 状态后，需使用以下命令使配置生效：

sudo systemctl restart pironman5.service

使用 systemctl 工具查看 pironman5 程序状态：
```
sudo systemctl status pironman5.service
```
或查看程序生成的日志文件：
```
cat /var/log/pironman5/pironman5.log
```

控制 RGB 灯效

板载 4 个 WS2812 RGB LED，可进行开关控制、颜色设置、亮度调整、显示模式切换及变化速度设置。

备注

每次更改 pironman5.service 状态后，需使用以下命令使配置生效：

sudo systemctl restart pironman5.service

设置 RGB 灯开启或关闭， true 表示开启， false 表示关闭：

sudo pironman5 -re true

设置 RGB 灯颜色，输入所需的十六进制颜色值，如 fe1a1a：

sudo pironman5 -rc fe1a1a

设置亮度，范围为 0 ~ 100：

sudo pironman5 -rb 100

设置 RGB 显示模式，支持的模式包括： solid/breathing/flow/flow_reverse/rainbow/rainbow_reverse/hue_cycle：

备注

如果设置为 rainbow、 rainbow_reverse 或 hue_cycle，将无法再设置自定义颜色。

sudo pironman5 -rs breathing

设置变化速度，范围为 0 ~ 100：

sudo pironman5 -rp 80

默认包含 4 个 RGB 灯，如连接更多，可使用以下命令修改数量：

sudo pironman5 -rl 12

控制 GPIO 风扇

IO 扩展板支持最多两个 5V 非 CPU 风扇，风扇统一控制。

备注

每次更改 pironman5.service 状态后，需使用以下命令使配置生效：

sudo systemctl restart pironman5.service

使用命令设置风扇运行模式，不同模式决定启动温度。

例如设置为 1: Performance 模式时，风扇将在 50°C 启动：

sudo pironman5 -gm 3

4: Quiet（静音）：70°C 启动
3: Balanced（均衡）：67.5°C 启动
2: Cool（凉爽）：60°C 启动
1: Performance（性能）：50°C 启动
0: Always On（始终开启）：始终运行
如更换风扇控制引脚，可使用如下命令：

sudo pironman5 -gp 18

关于核心风扇

核心风扇连接到树莓派 5 上专用的 4 针 CPU 风扇接口。其默认的控制策略是一种由固件管理的、基于 CPU 温度的多级智能调速方案。这意味着，当你使用官方或兼容的 CPU 风扇并正确连接后，系统会根据 CPU 温度的变化自动调节风扇转速（在 50°C 以上开始运转），无需你进行任何手动干预。

检查 OLED 屏幕

安装 pironman5 库后，OLED 屏幕将自动显示 CPU、内存、磁盘使用率、CPU 温度及树莓派 IP，每次开机时自动刷新。

若 OLED 无显示，请先检查 FPC 线缆是否连接牢固。

接着可通过以下命令查看日志确认问题：

cat /var/log/pironman5/pironman5.log

或检查 OLED 的 I2C 地址 0x3C 是否被识别：

i2cdetect -y 1

检查红外接收器

安装 lirc 模块：
```
sudo apt-get install lirc -y
```
使用以下命令测试红外接收功能：
```
mode2 -d /dev/lirc0
```
执行命令后，按下遥控器上的任意按键，即可在终端打印对应码值。