注釈

こんにちは、SunFounder Raspberry Pi & Arduino & ESP32 Enthusiasts Community on Facebookへようこそ！ Raspberry Pi、Arduino、ESP32について、愛好家仲間とより深く探求しましょう。

参加する理由

専門家によるサポート: コミュニティとチームの助けを借りて、アフターセールスの問題や技術的な課題を解決します。
学びと共有: ヒントやチュートリアルを交換して、スキルを向上させましょう。
先行プレビュー: 新製品の発表や先行情報をいち早く入手できます。
特別割引: 新製品の限定割引をお楽しみいただけます。
お祭りプロモーションとプレゼント: プレゼントキャンペーンやホリデープロモーションに参加しましょう。

👉 私たちと一緒に探求し、創造する準備はできましたか？ [here] をクリックして、今すぐ参加しましょう！

FAQ

Quick Troubleshooting

電源ボタンが動作しない → Power Button Not Working?
OLED 画面が動作しない → OLED Screen Not Working?
RGB LED が点灯しない → RGB LEDs Not Working?
ファンが動作しない → Fan Not Working / Cannot Be Controlled?
ダッシュボードにデータが表示されない → The Dashboard Shows No Data
NVMe SSD が認識されない → NVMe PIP Module Not Working?
NVMe SSD が認識されるがシステムが再起動する → NVMe SSD Detected but Causes System Restart on Read/Write?
PI5 が起動しない → PI5 Fails to Boot (Red LED)?

1. Hardware

Compatible Systems

Raspberry Pi 5でテスト済みの対応システム：

Power Button

電源ボタンは、Raspberry Pi 5の電源ボタンを外部に引き出したもので、同じように動作します。

短く押す: 電源オン / OLED起動 / OLEDページ切り替え。
2秒間長押し: 安全なシャットダウン（1. シャットダウン時のGPIO電源無効化設定が必要です）。
5秒間長押し: 強制シャットダウン。

Power Button Not Working?

まず、電源ボタンの正常な動作を確認してください：
- Raspberry Pi OS Desktop：電源ボタンをすばやく2回押してシャットダウンします。5秒間長押しすると強制シャットダウンします。シャットダウン状態から1回押して電源を入れます。
- Raspberry Pi OS Lite：電源ボタンを1回押してシャットダウンします。5秒間長押しすると強制シャットダウンします。1回押して電源を入れます。
電源コンバーターのピンがRaspberry Pi 5のJ2パッド（RTCバッテリーコネクターと基板エッジの間）に正しく位置合わせされているか確認してください。
電源コンバーターソケット内のピンが電源ボタンコネクターに正しく位置合わせされているか確認してください。必要に応じて、電源ボタンケーブルを再接続してください。
ドライバーを使用して、ボタンが接続されている電源コンバーターソケットの2つのピンを短絡してください。Piの電源が入る場合は、ボタン自体に問題がある可能性があります。入らない場合は、コンバーターボードまたはPi 5の接続に問題がある可能性があります。

Copper Pipe Ends on the Tower Cooler

U字型の銅製ヒートパイプの平らになった端部は、通常の製造工程の一部であり、ヒートパイプがアルミフィンを通過できるようにするためのものです。

Raspberry Pi AI HAT+

Raspberry Pi AI HAT+ は Pironman 5 Pro MAX と互換性がありません。

Raspberry Pi AI Kit は、Raspberry Pi M.2 HAT+ と Hailo AI アクセラレータモジュールを組み合わせたものです。

Raspberry Pi AI Kit から Hailo AI アクセラレータモジュールを取り外し、Pironman 5 Pro MAX の NVMe PIP モジュールに直接挿入できます。

4.3-Inch Screen Is Black / Not Displaying?

4.3インチ DSI スクリーンはプラグアンドプレイで、追加のドライバーインストールは必要ありません。

注釈

HDMI/USB ボードの ON/AUTO ジャンパーは、スピーカーのオーディオ出力のみを制御します。画面表示には 影響しません。

画面が黒いまま、または表示されない場合は、以下を確認してください：

DSI リボンケーブルが Raspberry Pi 5 の正しい DSI ポートに接続されていることを確認します。
リボンケーブルが完全に挿入されているか、クランプがしっかりと押さえられているか、接点が正しい方向を向いているかを確認します。
以下のコマンドを実行して、システムが DSI スクリーンを認識しているか確認します：
```
sudo dmesg | grep -i dsi
```
スクリーンが認識されている場合、DSI display found のような出力が表示されます。出力がない場合は、スクリーンが認識されていません — 物理的な接続を再確認してください。

External HDMI Screen — Taskbar Only Appears on the 4.3-Inch Screen?

Pironman 5 Pro MAX に外部 HDMI モニターを接続すると、デスクトップのタスクバーが外部ディスプレイではなく、内蔵の 4.3インチ DSI スクリーンに表示される場合があります。これは、システムがデフォルトで DSI スクリーンをプライマリディスプレイとして設定しているためです。

起動時に HDMI モニターをプライマリ画面として設定するには：

起動スクリプトを作成します：

sudo nano /usr/local/bin/fix-primary-screen.sh

スクリプトに以下の内容を追加します：

#!/bin/bash
# Check if an external HDMI monitor is connected
if wlr-randr | grep -q "HDMI-A-1"; then
    # Turn off the DSI screen first
    wlr-randr --output DSI-1 --off
    sleep 2
    # Re-enable DSI and place it to the right of HDMI
    wlr-randr --output DSI-1 --on --right-of HDMI-A-1
fi

スクリプトを実行可能にします：

sudo chmod +x /usr/local/bin/fix-primary-screen.sh

スクリプトを自動起動に追加します。labwc の自動起動ファイルを編集します：
```
nano ~/.config/labwc/autostart
```
以下の行を追加します（ & でバックグラウンド実行）：
```
/usr/local/bin/fix-primary-screen.sh &
```

2. Cooling and Fans

Fan Not Working / Cannot Be Controlled?

Pro MAX は公式の Raspberry Pi PWM ファン制御ソリューションを採用しています。3 つの冷却ファンはすべて Raspberry Pi システムによって直接制御されており、pironman5 サービスに依存していません（そのため、コマンドラインツールやダッシュボードにはファン制御オプションは表示されません）。

Pironman 5のCPUファンはRaspberry Piシステムによって制御されています。CPUファンの速度はRaspberry Pi 5のCPU温度に依存します。

デフォルトのCPUファンカーブ：

< 50°C: オフ（0%）
50°C以上: 低速（30%）
60°C以上: 中速（50%）
67.5°C以上: 高速（70%）
75°C以上: 全速（100%）

現在のCPU温度を確認します（出力例： temp=48.7'C）：

vcgencmd measure_temp

以下のコマンドを使用してCPUファンを手動で制御できます：

pinctrl FAN_PWM op dl   # ファンを有効にする（Low Active）
pinctrl FAN_PWM op dh   # ファンを無効にする（High Active）
pinctrl FAN_PWM a0      # 自動モード

以下のファイルを編集して、CPUファンの温度しきい値を調整することもできます：

nano /boot/firmware/config.txt

以下を追加します：

dtparam=cooling_fan=on
dtparam=fan_temp0=40000
dtparam=fan_temp0_hyst=10000
dtparam=fan_temp0_speed=125

この設定により、CPUファンが40°CでPWM速度レベル125で起動します。

ファイルを保存した後、Raspberry Piを再起動して変更を反映させます。

Dashboard Does Not Show Fan Speed?

Pro MAX はカスタムの 5ピン ファンを使用しており、ピン配置は以下の通りです：PWM / 5V / GND / RGB Data In / RGB Data Out

これらのファンには タコメーター（速度フィードバック）ピンがありません ので、システムは実際の RPM を読み取ることができません。ダッシュボードにファン速度が表示されないのは正常であり、仕様です。

ファン速度は Raspberry Pi のネイティブ PWM 温度カーブによって制御されます：

< 50°C: オフ（0%）
50°C 以上: 低速（30%）
60°C 以上: 中速（50%）
67.5°C 以上: 高速（70%）
75°C 以上: 全速（100%）

3. OLED and RGB

OLED Screen Not Working?

OLEDスクリーンが表示されない、または正しく表示されない場合、以下のトラブルシューティング手順を試してください：

OLEDスクリーンのFPCケーブルが確実に接続されていることを確認してください。OLEDを再接続してからデバイスの電源を入れることをお勧めします。
Raspberry Piがサポートされているオペレーティングシステムを実行していることを確認してください。

Compatible Systems を参照してください。
OLEDスクリーンの初回電源投入時は、ピクセルブロックのみが表示される場合があります。Raspberry Pi/Ubuntu/Kali/Homebridge OSでの設定の手順に従って設定を完了すると、正しい情報が表示されるようになります。
以下のコマンドを使用して、OLEDのI2Cアドレス 0x3C が検出されているか確認してください：
```
sudo i2cdetect -y 1
```
- I2Cアドレス 0x3C が検出された場合、Pironman 5サービスを再起動します：
```
sudo systemctl restart pironman5.service
```
- アドレスが検出されない場合、I2Cを有効にします：
```
sudo nano /boot/firmware/config.txt
```
  以下を追加します：
```
dtparam=i2c_arm=on
```
  ファイルを保存し、Raspberry Piを再起動します。
問題が解決しない場合は、以下のログファイルを送信してください：
```
cat /var/log/pironman5/pironman5.log
```

How to Customize the OLED Display?

OLED表示をカスタマイズしたい場合（カスタム2〜4桁の画像表示の追加など）、以下のいずれかの方法でOLEDページファイルを変更できます。

方法1: インストール済みファイルを直接変更する
1. OLEDページファイルを一覧表示します：
```
ls /opt/pironman5/venv/lib/python3.13/site-packages/pm_auto/addons/oled/pages/
```
2. 目的のPythonファイルを変更します。
3. サービスを再起動して変更を反映します：
```
sudo systemctl restart pironman5.service
```

方法2: ``pm_auto`` をクローンして再インストールする

pm_auto リポジトリをクローンします：

git clone -b 1.4.x https://github.com/sunfounder/pm_auto/

変更後、変更したパッケージを再インストールします：

sudo /opt/pironman5/venv/bin/pip3 uninstall pm_auto -y && \
sudo /opt/pironman5/venv/bin/pip3 install ~/pm_auto --no-build-isolation && \
sudo chown -R pironman5:pironman5 /opt/pironman5

サービスを再起動します：

sudo systemctl restart pironman5.service

テストとデバッグ

実行時のログを表示するには：
```
journalctl -xefu pironman5.service
```
サービスを停止して手動で実行し、より迅速にテストすることもできます：
```
sudo systemctl stop pironman5.service
sudo pironman5 start
```

RGB LEDs Not Working?

J9上のIOエクスパンダーにある2つのピンは、RGB LEDをGPIO10に接続するために使用されます。これらのピンにジャンパーキャップが正しく取り付けられていることを確認してください。
Raspberry Piがサポートされているオペレーティングシステムを実行していることを確認してください。

Compatible Systems を参照してください。
以下のコマンドを実行してSPIを有効にします：
```
sudo raspi-config
```
3 Interfacing Options → I3 SPI → YES に移動します。

その後、Raspberry Piを再起動します。
問題が解決しない場合は、以下のログファイルを送信してください：
```
cat /var/log/pironman5/pironman5.log
```

How to Wake Up the OLED Screen

省電力と画面の寿命を延ばすため、OLED 画面は一定時間操作がないと自動的にオフになります。これは通常の設計であり、製品の機能に影響を与えるものではありません。

注釈

OLED 画面の設定（オン/オフ、スリープ時間、回転など）については、ダッシュボードからの表示と制御またはコマンドによる制御を参照してください。

4. Dashboard and Software

The Dashboard Shows No Data

ダッシュボードにデータが表示されない場合、まずダッシュボードのログページを開き、 influxdb に関連するエラーメッセージがないか確認してください。

よくあるエラー：

database not found
failed to connect to influxdb
connection refused
timeout

以下の手順で問題を解決できる場合があります。

ブラウザのキャッシュをクリアするか、 シークレット/プライベート モードでダッシュボードページを再度開いてください。
以下のサービスが正常に実行されているか確認してください：
```
sudo systemctl status pironman5 --no-pager
sudo systemctl status influxdb --no-pager
```
両方のサービスに次のように表示される必要があります：
```
active (running)
```
いずれかのサービスが正常に実行されていない場合、再起動します：
```
sudo systemctl restart influxdb
sudo systemctl restart pironman5
```
その後、約30秒待ってからダッシュボードページを更新してください。
pironman5 データベースが存在するか確認します：
```
influx
```
次に実行します：
```
SHOW DATABASES;
```
次のように表示される必要があります：
```
pironman5
_internal
```
データベースがないか破損している場合、ダッシュボードから履歴データをクリアしてみてください：

Settings → Clear All Data
上記のすべての手順を試しても問題が解決しない場合は、Raspberry Pi OSとPironman 5ソフトウェアの再インストールを推奨します。

How to Disable the Web Dashboard

pironman5 モジュールのインストールが完了すると、ダッシュボードからの表示と制御にアクセスできるようになります。

この機能が不要で、CPUやRAMの使用量を削減したい場合は、インストール時に --disable-dashboard フラグを追加することでダッシュボードを無効にできます。

cd ~/pironman5
sudo python3 install.py --disable-dashboard

すでに pironman5 をインストール済みの場合は、ダッシュボードモジュールと influxdb を削除できます：

/opt/pironman5/venv/bin/pip3 uninstall pm-dashboard influxdb
sudo apt purge influxdb
sudo systemctl restart pironman5

How to Uninstall and Reinstall the Pironman 5 Software

現在の pironman5 ソフトウェアをアンインストールします：
```
cd ~/pironman5
sudo python3 install.py --uninstall
```
指示に従ってRaspberry Piを再起動し、その後 pironman5 ディレクトリを削除します：
```
cd ~/
sudo rm -rf pironman5
```

以下のコマンドを実行して、お使いのPironman 5モデル用のソフトウェアを再インストールします：

curl -sSL "https://raw.githubusercontent.com/sunfounder/sunfounder-installer-scripts/main/pironman5/install.sh" | sudo bash

How to Control Components Using the `pironman5` Command

以下のチュートリアルを参照して、 pironman5 コマンドを使用してPironman 5シリーズのコンポーネントを制御できます。

コマンドによる制御

`pip install piper-tts` Fails with "Could Not Find a Version"?

Pironman 5 Pro MAX に sunfounder-voice-assistant をインストールする際、以下のエラーが発生する場合があります：

ERROR: Could not find a version that satisfies the requirement piper-tts==1.3.0
ERROR: No matching distribution found for piper-tts==1.3.0

このエラーは、piper-tts 1.3.0 が 64ビット**（``aarch64``）のホイールのみを提供しているために発生します。Raspberry Pi が **32ビット のオペレーティングシステムを実行している場合、pip は互換性のあるパッケージを見つけることができません。

解決策： 64ビット版の Raspberry Pi OS をインストールしてください。

現在のシステムアーキテクチャを確認します：
```
uname -m
```
- aarch64 → 64ビット（問題なし）
- armv7l → 32ビット（アップグレードが必要）
Raspberry Pi Imager を使用して、ストレージデバイスに 64ビット の Raspberry Pi OS イメージを書き込みます。
64ビット OS をインストールした後、pironman5 ソフトウェアと sunfounder-voice-assistant を再インストールします。

5. Boot and Storage

PI5 Fails to Boot (Red LED)?

この問題は、システムのアップデート、ブート順序の変更、またはブートローダーの破損が原因で発生する可能性があります。以下の手順を試して問題を解決してください：

USB-HDMIアダプターの接続を確認
- USB-HDMIアダプターがPI5にしっかりと接続されているか慎重に確認してください。
- USB-HDMIアダプターを一度抜き、再度接続してみてください。
- その後、電源を再接続し、PI5が正常に起動するか確認してください。
ケース外でPI5をテスト
- アダプターの再接続で問題が解決しない場合：
- PI5をPironman 5シリーズのケースから取り外してください。
- 電源アダプターでPI5に直接給電してください（ケースなし）。
- 正常に起動できるか確認してください。
ブートローダーを復元
- それでもPI5が起動しない場合、ブートローダーが破損している可能性があります。2. ブートローダーの更新のガイドに従い、SDカードまたはNVMe/USBからの起動を選択してください。
- 準備したSDカードをPI5に挿入し、電源を入れて少なくとも10秒待ちます。リカバリーが完了したら、SDカードを取り外して再フォーマットしてください。
- その後、Raspberry Pi Imagerを使用して最新のRaspberry Pi OSを書き込み、再度起動を試みてください。

NVMe PIP Module Not Working?

NVMe SSDの互換性を確認してください。検証済み、安定、互換性のあるドライブについては、互換性のあるNVMe SSDリストを参照してください。
NVMe PIPモジュールとRaspberry Pi 5を接続しているFPCケーブルがしっかりと取り付けられていることを確認してください。
SSDがNVMe PIPモジュールに正しく固定されていることを確認してください。
NVMe PIPモジュールのLED状態を確認します：

すべての接続が完了したら、Pironman 5 MAXの電源を入れ、NVMe PIPモジュール上の2つのインジケーターを確認します：
- PWR LED: 点灯している必要があります。
- STA LED: 点滅していると正常動作を示します。
- PWR LED が点灯し STA LED が点滅しない場合は、NVMe SSDがRaspberry Piに認識されていないことを意味します。
- PWR LED が消灯している場合、モジュールの Force Enable ピンをショートしてください。 PWR LED が点灯した場合、FPCケーブルの緩みやサポートされていないシステム構成の可能性があります。
NVMe SSDに適切なオペレーティングシステムがインストールされていることを確認してください。3. オペレーティングシステムのインストールを参照してください。

配線が正しく、OS がインストールされているにもかかわらず NVMe SSD が起動しない場合は、Micro SD カードから起動して他のコンポーネントの機能を確認します。確認後、3. SSDからの起動設定に進みます。
上記の手順を実行しても問題が解決しない場合は、service@sunfounder.com までメールをお送りください。できるだけ早く対応いたします。

NVMe SSD Detected but Causes System Restart on Read/Write?

一部のケース（特にWD Blue SN5000）では、NVMe SSDがRaspberry Pi 5に認識されても、読み取り/書き込み操作中にシステムが再起動する場合があります。これはSSDとRaspberry Pi 5の間のPCIe互換性/安定性の問題であり、Pironman 5のハードウェア障害 ではありません。

以下の手順で問題を解決してみてください：

Raspberry Pi 5のブートローダーを最新バージョンに更新します：
```
sudo rpi-eeprom-update -a
sudo reboot
```
以下の行を /boot/firmware/config.txt に追加して、PCIe Gen3速度を強制します：
```
dtparam=pciex1_gen=3
```
pcie_aspm=off をカーネルコマンドラインに追加してASPM（アクティブ状態電力管理）を無効にします。 /boot/firmware/cmdline.txt を編集し、既存の行に追加します（新しい行を作成 しない でください）：
```
pcie_aspm=off
```
注釈

pcie_aspm=off が重要な修正となることがよくあります。PCIe ASPMの問題はRaspberry Pi 5で非常に一般的であり、NVMeドライブがランダムに切断されたり、大量I/O中にシステムが再起動したりする原因となります。
上記の変更を適用した後、Raspberry Piを再起動します：
```
sudo reboot
```
問題が解決しない場合は、NVMe SSDを再パーティションおよび再フォーマットし、オペレーティングシステムを再インストールしてください。

How to Change the Raspberry Pi Boot Order Using Commands

Raspberry Piにログイン済みの場合、コマンドを使用してブート順序を変更できます。

3. SSDからの起動設定

How to Modify the Boot Order with Raspberry Pi Imager

EEPROM設定の BOOT_ORDER を変更する以外にも、 Raspberry Pi Imager を使用してブート順序を変更できます。

2. ブートローダーの更新

How to Copy the System from the SD Card to an NVMe SSD

NVMe-USBアダプターがない場合、まずMicro SDカードにシステムをインストールし、正常に起動した後、システムをNVMe SSDにコピーできます。

Micro SDからNVMe SSDへのOSコピー

6. Advanced Usage

How to Remove the Protective Film

パッケージには2枚のアクリル板が含まれており、両面に黄色または透明の保護フィルムが貼られていて、傷を防ぎます。

保護フィルムは剥がしにくい場合があります。ドライバーを使用して角を持ち上げ、慎重に全体を剥がしてください。

How to Install OpenSSH via Powershell?

ssh <username>@<hostname>.local （または ssh <username>@<IP address>）を使用して Raspberry Pi に接続しようとすると、以下のエラーメッセージが表示される場合があります。

ssh: The term 'ssh' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the
spelling of the name, or if a path was included, verify that the path is correct and try again.

これは、お使いのコンピューターシステムが古く、OpenSSH がプリインストールされていないことを意味します。以下の手順で手動インストールを行ってください。

Windows の検索ボックスに「 powershell 」と入力し、 Windows PowerShell を右クリックして「 Run as administrator 」を選択します。
以下のコマンドで OpenSSH.Client をインストールします。
```
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
```

インストール後、以下のような出力が返ってきます。

Path          :
Online        : True
RestartNeeded : False

以下のコマンドでインストール状況を確認します。

Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'

これで OpenSSH.Client のインストールが正常に完了したことが確認できます。
```
Name  : OpenSSH.Client~~~~0.0.1.0
State : Installed

Name  : OpenSSH.Server~~~~0.0.1.0
State : NotPresent
```
警告

上記の表示がされない場合は、Windows がさらに古いバージョンである可能性があります。PuTTY などのサードパーティ製 SSH ツールの使用をご検討ください。
PowerShell を再起動し、再度管理者権限で起動してください。これで ssh コマンドによる接続が可能になり、設定したパスワードの入力が求められます。

If I Set Up OMV, Can I Still Use the Pironman5's Function?

はい、OpenMediaVault は Raspberry Pi システム上で設定されます。Raspberry Pi/Ubuntu/Kali/Homebridge OSでの設定の手順に従って設定を続行してください。

Raspberry Pi Camera Not Working?

カメラが動作しない場合、90% の原因はリボンケーブルの接続またはカメラハードウェア自体に関連しています。

まず、rpicam-hello --list-cameras を使用してカメラが認識されているか確認します。正常に認識されている場合、以下のようなメッセージが表示されます：

Available cameras
-----------------
0 : ov5647 [2592x1944] (/base/axi/pcie@1000120000/rp1/i2c@88000/ov5647@36)

カメラが認識されない場合は、リボンケーブルが逆になっていないか、完全に挿入されていないかを確認します。問題が解決しない場合は、リボンケーブルまたはカメラモジュールを交換してクロステストを試みてください。

Can I Install Home Assistant OS on the Pironman 5 Pro MAX?

Pironman 5 Pro MAX には専用の Home Assistant アドオンはありません。ただし、Pironman 5 MAX アドオンを代わりに使用できます。SunFounder アドオンリポジトリガイドに従ってください。

以下の制限事項に注意してください：

4.3インチ画面：Home Assistant OS はデスクトップ環境のない Lite システムです。Pro MAX に内蔵された 4.3インチ画面は何も表示しません。
NVMe PIP デュアル SSD：Home Assistant OS は Pro MAX のデュアル NVMe PIP モジュール上の両方の NVMe SSD を読み取ることができません。
OLED 画面と RGB LED：アドオンをインストールした後、これらのコンポーネントは追加設定なしで正常に動作します。
CPU ファン：Home Assistant OS で CPU ファンを動作させるには手動設定が必要です。以下を /boot/firmware/config.txt に追加します：
```
dtparam=cooling_fan=on
dtparam=fan_temp0=40000
dtparam=fan_temp0_hyst=10000
dtparam=fan_temp0_speed=125
```
保存して再起動すると、CPU ファンは CPU 温度に基づいて Raspberry Pi システムによって制御されます。pinctrl コマンドで手動制御することもできます。Fan Not Working / Cannot Be Controlled? を参照してください。