Control with Commands

除了通过 Dashboard 查看 Pironman 5 Pro MAX 的数据并控制各类设备外，您也可以通过命令行进行控制。

查看基础配置

pironman5 模块提供了一组 Pironman 的基础配置，您可以使用以下命令查看：

sudo pironman5 -c

默认配置如下所示：

{
    "system": {
        "data_interval": 1,
        "enable_history": true,
        "rgb_color": "#ff3dbe",
        "rgb_brightness": 50,
        "rgb_style": "breathing",
        "rgb_speed": 50,
        "rgb_enable": true,
        "rgb_led_count": 18,
        "temperature_unit": "C",
        "oled_enable": true,
        "oled_rotation": 0,
        "oled_sleep_timeout": 10,
        "default_dashboard_page": "small",
        "oled_pages": [
            "mix",
            "performance",
            "ips",
            "disk"
        ],
        "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}]] [-oe [OLED_ENABLE]]
                [-or [{0,180}]] [-op [OLED_PAGES]] [-os [OLED_SLEEP_TIMEOUT]]
                {start,stop,launch-browser} ...

Pironman 5 Pro 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
  -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
```
也可以查看程序生成的日志文件。
```
ls /var/log/pironman5/
```

控制 RGB 灯

该主板配备了 18 个 WS2812B 可编程 RGB 灯：其中 6 个位于主板上，另外 12 个集成在 RGB 风扇中。用户可以控制灯光的开关、颜色、亮度、显示模式、动画速度以及启用的 LED 数量。

备注

修改 pironman5.service 的配置后，必须重启服务才能生效：

sudo systemctl restart pironman5.service

启用/禁用 RGB 灯：使用 true 开启，false 关闭。
```
sudo pironman5 -re true
```
更改颜色：使用十六进制颜色值（不带 #），例如 fe1a1a 表示红色。
```
sudo pironman5 -rc fe1a1a
```
调整亮度：设置范围为 0% 到 100%。
```
sudo pironman5 -rb 75
```
更改显示模式：可选多种动画模式：
- solid：静态颜色
- breathing：呼吸效果（渐亮渐暗）
- flow / flow_reverse：颜色流动效果
- rainbow / rainbow_reverse：彩虹循环效果
- hue_cycle：色相平滑循环
```
sudo pironman5 -rs breathing
```
备注

当使用 rainbow、 rainbow_reverse 或 hue_cycle 模式时，通过 pironman5 -rc 设置的颜色将被自动循环效果覆盖。
调整动画速度：设置效果速度，范围为 0%（最慢）到 100%（最快）。
```
sudo pironman5 -rp 50
```
设置 LED 数量：系统默认控制 18 个 LED。如果您扩展了额外的 WS2812B 灯带，请相应修改总数量。
```
sudo pironman5 -rl 12
```

风扇

风扇通过 Raspberry Pi 5 上的专用 4 针 PWM 风扇接口连接。其默认控制策略为基于 CPU 温度的固件级多档智能调速机制。这意味着，当您使用官方或兼容的 PWM 风扇并正确连接后，系统会根据 CPU 温度变化自动调节风扇转速（约在 50°C 以上开始工作），无需手动干预。

检查 OLED 屏幕

在安装 pironman5 库并重启后，0.96 英寸 OLED 屏幕默认会显示系统信息（CPU、内存、磁盘、温度、IP）。

如果 OLED 屏幕没有显示：

确认 OLED 的 FPC 排线已牢固连接到主板。

检查服务日志是否有报错：

sudo journalctl -u pironman5.service -f

或查看专用日志：

cat /var/log/pironman5/pironman5.log

确认 OLED 已在 I2C 总线上被检测到（地址为 0x3C）：
i2cdetect -y 1

OLED 配置命令

启用/禁用 OLED：打开或关闭 OLED 显示。
```
sudo pironman5 -oe false
```
旋转屏幕：设置显示方向为 0 （默认）或 180 度。
```
sudo pironman5 -or 180
```
配置显示页面：选择循环显示的信息页面。可选页面包括： mix （总览）、 performance （CPU/内存详情）、 ips （网络 IP）、 disk （存储）。多个页面用逗号分隔。
```
sudo pironman5 -op mix,ips,disk
```
设置休眠时间：设置 OLED 在无操作时自动关闭的时间（单位：秒，0 表示不休眠）。
```
sudo pironman5 -os 120
```

检查红外接收器

内置红外接收器支持通过遥控器进行控制。

安装所需软件：

sudo apt-get install lirc -y

测试接收器。运行以下命令，然后用遥控器对准设备并按键，应能看到原始信号输出。

mode2 -d /dev/lirc0

若需要配置特定遥控器按键（例如用于 Kodi 或 Volumio），则需要在 /etc/lirc/lircd.conf 文件中配置对应的遥控器编码。

通用系统命令

显示版本：显示已安装的 pironman5 软件包版本。
```
sudo pironman5 -v
```
显示当前配置：显示所有当前配置设置。
```
sudo pironman5 -c
```
设置温度单位：在摄氏度（C）和华氏度（F）之间切换温度显示单位。
```
sudo pironman5 -u F
```
配置数据记录：
- 设置数据库保留天数：控制历史数据（例如温度记录）保留的天数。
```
sudo pironman5 -drd 30
```
- 启用/禁用历史记录：开启或关闭数据采集。
```
sudo pironman5 -eh false
```
设置日志详细级别：调整系统日志的详细程度。可选项： DEBUG、 INFO、 WARNING、 ERROR、 CRITICAL。
```
sudo pironman5 -dl DEBUG
```
移除 Web 仪表板：卸载可选的基于网页的管理界面。
```
sudo pironman5 -rd
```
指定自定义配置路径：使用位于非默认路径的配置文件。
```
sudo pironman5 -cp /home/pi/my_custom_config.json
```

服务管理子命令

启动 Pironman5 服务：手动启动后台服务，该服务负责管理 LED、风扇、OLED 等设备。
```
sudo pironman5 start
```
停止 Pironman5 服务：安全停止后台服务。
```
sudo pironman5 stop
```
在浏览器中打开 Web 仪表板：如果已安装 Web 仪表板，该命令会在默认浏览器中打开它。
```
sudo pironman5 launch-browser
```