この記事を書いた動機

Raspberry Pi 5をPironman 5に入れ、Ubuntu 24.04 LTSでサーバーを構築していました。
組み上げて電源を入れた瞬間、ある事実に気付きます。

CPUは40℃台で涼しいのに、背面のRGBファン2発が常時フル回転で爆音を発し続けている。

sudo pironman5 -gm 3（温度ベース自動制御）を叩いても無反応。
公式ダッシュボードはエラー連発で使い物にならない。
gpiosetコマンドで直接叩いてみると――

sudo gpioset gpiochip4 6=0
# gpioset: error setting the GPIO line values: Device or resource busy

Device or resource busy。
Pironmanのコマンドも、Linux標準のGPIOコマンドも、すべてOSに弾かれていた。

この記事では、「なぜそうなるのか」という根本原因と、Pythonコードを一切書かずにたった1行で完全解決する方法を共有します。

環境

項目	バージョン
ハードウェア	Raspberry Pi 5
ケース	SunFounder Pironman 5
OS	Ubuntu 24.04 LTS
Pironman5ソフト	pironman5 v1.2.7
カーネル	6.8以降

症状の確認

サービスのログを見ると、問題の核心が見えます。

sudo systemctl status pironman5.service

● pironman5.service - pironman5 service
     Active: active (running)
...
[INFO] PWM Fan is supported, sync all other fan with pwm fan
[INFO] FanControl initialized

一見正常に見えますが、journalctlでより詳細なログを確認すると…

sudo journalctl -u pironman5.service -n 50 --no-pager

pm_autoモジュールがGPIO 6番にアクセスしようとしてサイレントにエラーを吐き、制御を放棄していることが確認できます。
設定値は正しく書き込まれているのに、ファンには何も伝わっていない状態です。

sudo pironman5 -c
# "gpio_fan_mode": 3  ← 設定は正しい
# でもファンはフル回転のまま

設定ファイルにgpio_fan_mode: 3が正しく書かれているのにファンが止まらない場合、ソフトウェアの問題ではなくOSレベルのGPIOロックが原因である可能性が非常に高いです。

根本原因：Ubuntuカーネルによる「GPIO 6番の自動予約」

これはPironman5のバグではありません。Ubuntu 24.04（Kernel 6.8以降）とRaspberry Pi 5の仕様変更の衝突が原因です。

ラズパイ5はRP1という新しいチップを搭載しており、Ubuntuのカーネルは起動時にデバイスツリーを読み込んで各ピンの用途を割り当てます。
このとき、特定のGPIOピンを「I2C・SPI・1-Wire通信用として将来使うかもしれないから、カーネルドライバで先に予約（ロック）しておこう」とお節介にも自動的に囲い込んでしまいます。

その結果として

Pironman5（pm_auto）
  └→ GPIO 6番にアクセスしようとする
        └→ Ubuntu カーネル「それは俺の予約済みピンだ。触るな（busy）」
              └→ Pironman5「アクセス失敗…制御不能…フェイルセーフ発動…ファン100%で回し続けます」

という最悪の連鎖が起きています。

「gpiozeroを最新版（2.0.1）にアップデートすれば直る」という情報もありますが、このカーネルレベルのハードウェアロックには無力でした。
venv内のライブラリ更新、GPIOZERO_PIN_FACTORY=lgpioの環境変数設定、/dev/gpiochip4のシンボリックリンク作成、いずれも効果なしでした。

試した解決策と結果まとめ

試した方法	結果
`pironman5 -gm 3`（バランスモード設定）	❌ 効果なし
venv内の`gpiozero`を2.0.1にアップデート	❌ 効果なし
`GPIOZERO_PIN_FACTORY=lgpio`を環境変数に追加	❌ 効果なし
`/dev/gpiochip4`のシンボリックリンク作成	❌ 効果なし
`gpioset`コマンドで直接操作	❌ `Device or resource busy`
`config.txt`にGPIO宣言を追記	✅ 完全解決

解決策：`/boot/firmware/config.txt`への1行追記

なぜこれで直るのか？

config.txtの設定はLinuxカーネルよりも低いレイヤー（ブートローダー＝ファームウェア）が処理します。
つまりUbuntuカーネルがデバイスツリーを読み込んで「GPIO 6番を通信用に予約しよう」と動き出すよりも前の段階で、「このピンはユーザーが出力用に使います」という事実が確定されます。
その結果、カーネルはそのピンに通信用のロックをかけなくなります。

手順

1. config.txtを開く

sudo nano /boot/firmware/config.txt

2. ファイルの末尾に以下を追記する

config.txt

gpio=6=op,dl

パラメータ	意味
`6`	GPIOのピン番号（Pironman5背面ファンの制御ピン）
`op`	Output（出力モードとして宣言）
`dl`	Drive Low（初期電圧を0V＝OFFで固定）

3. 保存して再起動

sudo reboot

動作確認

再起動後、あの煩かった背面ファンが静かになっているはずです。
以下のコマンドで制御が復活していることを確認しましょう。

# テスト①：強制フル回転（これで回ればGPIOアクセス成功）
sudo pironman5 -gm 0
sudo systemctl restart pironman5

# テスト②：温度ベース自動制御（冷えていれば止まる）
sudo pironman5 -gm 3
sudo systemctl restart pironman5

ファンモード（-gm）一覧

モード	名前	起動温度
`0`	Always On	常時回転
`1`	Performance	50℃
`2`	Cool	60℃
`3`	Balanced	67.5℃
`4`	Quiet	70℃

OLED・LED・ファンをダッシュボードなしで管理する

Pironman5のダッシュボードはUbuntu環境で不安定なため、すべてコマンドラインで管理するのがおすすめです。

# 現在の設定を確認
sudo pironman5 -c

# LED制御
sudo pironman5 -re true         # LED ON
sudo pironman5 -rc 0a1aff       # 色（16進）
sudo pironman5 -rb 50           # 明るさ（0-100）
sudo pironman5 -rs breathing    # エフェクト
sudo pironman5 -rp 50           # 速度（0-100）

# OLEDディスプレイ制御
sudo pironman5 -oe true         # ON
sudo pironman5 -or 0            # 回転（0 or 180）

# 設定反映
sudo systemctl restart pironman5

OLEDには「スクリーンセーバー的な自動スリープ」機能がありません。画面焼け（バーンイン）を防ぐには、以下のスクリプトで「見たい時だけ30秒だけ点灯させる」運用がおすすめです。

~/oled_wake.sh

#!/bin/bash
sudo pironman5 -oe true
sudo systemctl restart pironman5
echo "OLEDを点灯しました。30秒後に消灯します…"
sleep 30
sudo pironman5 -oe false
sudo systemctl restart pironman5

まとめ

config.txt

gpio=6=op,dl

この1行が、数時間の苦しみを終わらせてくれました。

同じ問題に苦しんでいる人の参考になれば幸いです。
役に立ったと思ったら LGTM をお願いします 👍