Pironman V2.0- SunFounder向けのRaspberry PiミニPCキット¶

SunFounder Pironman V2.0をお選びいただき、ありがとうございます。

注釈

このドキュメントは以下の言語で利用可能です。

Deutsch Online-Kurs

日本語オンライン教材

English Online-tutorials

ご希望の言語でドキュメントにアクセスするために、それぞれのリンクをクリックしてください。

注釈

Pironmanには2つのバージョンがあります。各バージョンのオンラインチュートリアルのスクリプトは互換性がありませんので、注意してください。

適切なセットアップを確保するため、取扱説明書に記載されているショートリンクを使用してバージョンを特定してください：

リンクが"pironman-v2.rtfd.io"の場合、このチュートリアルを続行してください。
リンクが"pironman.rtfd.io"と表示される場合は、Pironman V1.0 のチュートリアルに従ってください。

PironmanはSunFounderのカスタマイズされたRaspberry Pi用ミニPCです。スクリーン、マウス、キーボードを接続するだけで、プロジェクト、エンターテインメント、オフィス用として使用することができます。

サイズは4.43'' x 2.69'' x 4.68''
Raspberry PiミニPC
タワー型クーラーは、室温25°Cで100% CPU負荷のPiを39°Cに冷やすことができます
0.96" OLEDディスプレイには、Raspberry PiのCPU使用率、温度、ディスク使用率、IPアドレス、RAM使用率などが表示されます
オンボードUSBからM.2 SATA SSDへ、TRIM対応
GPIO制御付きのRGBファン
16個のWS2812アドレス指定可能なRGB LED
KodiやVolumioのようなマルチメディアセンター用のIRレシーバ
ピン名ラベル付きの外部GPIOエクステンダ
電源ステータスメモリ、電源ステータスを記憶し、電源が突然切れた場合に自動的に起動します
クリアなアクリルサイドパネル付きのアルミニウム本体

注釈

以下のリンクから、WS2812 RGBストリップおよびM.2 SATA SSDの設定を見ることができます。

注釈

以下にPironmanと互換性のあるシステムを示します。他のシステムをインストールしている場合、Pironmanの一部のコンポーネントが利用できない可能性があります。

何か質問があれば、service@sunfounder.com までメールしてください。できるだけ早く対応させていただきます。

表示言語について

この文書は他の言語でも利用可能です。表示言語を切り替えるには、ページの左下にある Read the Docs アイコンをクリックしてください。

About the display language

This document is available in other languages as well. To switch the display language, kindly click on the Read the Docs icon located in the lower left corner of the page.

1. さらに準備すべきものは？¶

必要なコンポーネント

Raspberry Pi 4 Model B

PirionmanはRaspberry Pi 4 Model Bと完全に互換性があります。
5V/3A 電源アダプター

この5V/3A電源アダプターはPironmanの電源コネクターに接続され、全てのコンポーネントに電力を供給します。他の多くの電力を消費するデバイスも接続している場合、Raspberry Pi 4を別途電源供給することができます。
Micro SDカード

Raspberry PiはPironman内部に完全に収められているため、追加のmicro SDポートを予約しています。使用するmicro SDカードは、最低8GBの容量が必要です。

オプションのコンポーネント

M.2 SATA SSD
注釈
- M.2 SSDインターフェースはSATAプロトコルのみをサポートし、NVME/PCIeはサポートしていません。
- SSDをPironmanに取り付ける方法や関連する設定についての詳細は、:SATA M.2 SSD を参照してください。
Pironmanのマザーボードには、M.2 SSDをインストールするためのコネクタがあります。

M.2 SSDは、内部に取り付けるストレージ拡張カードとして使用される小型の固体ステートドライブ(SSD)です。 M.2 SSDはコンピュータ業界の仕様に準拠しており、高性能なストレージを薄型で、電力制約のあるデバイス、例えばウルトラブックやタブレットPCなどに実装することを目的として設計されています。
スクリーン

Raspberry Piのデスクトップ環境を表示するためには、テレビスクリーンまたはコンピュータモニターを使用する必要があります。スクリーンに内蔵スピーカーがある場合、Piはそれを通じて音を出します。
Micro HDMIケーブル

Raspberry Pi 4 Model Bには2つのMicro HDMI出力ポートがあり、それをスクリーンに接続するための変換ケーブルが必要です。
マウス & キーボード

スクリーンを使用する場合、USBキーボードとUSBマウスも必要です。
サウンドデバイスまたはイヤホン

Raspberry Piには約3.5mmのオーディオポートが備えられており、スクリーンに内蔵スピーカーがない場合やスクリーンを操作していない場合に使用できます。

2. 部品一覧と組み立て手順¶

Pironmanを組み立てる前に、全ての部品とコンポーネントが揃っているか確認してください。何か足りない、または壊れている部品があれば、できるだけ早くservice@sunfounder.comまでSunFounderにご連絡ください。

組み立ての手順は、以下のPDFに従ってください：

[PDF]Pironmanの部品一覧と組み立て手順

組み立てチュートリアル動画

OLEDスクリーンを接続する

GPIOブリッジを接続する

SDカードブリッジを接続する

3. OSのインストール（共通）¶

注釈

Home Assistanceを使用したい場合は、HassOSのインストールを参照してください。

注釈

あなたのRaspberry Piに以下のPironman互換システムがインストールされている場合、この章をスキップしても構いません。

ステップ1

Raspberry Piは、Mac OS、Ubuntu 18.04、Windowsで動作するグラフィカルなSDカード書き込みツールを開発しています。これはイメージをダウンロードしてSDカードに自動でインストールするため、ほとんどのユーザーにとって最も簡単なオプションです。

ダウンロードページ https://www.raspberrypi.org/software/ を訪問して、ご使用のオペレーティングシステムに合った Raspberry Pi Imager のリンクをクリックしてください。ダウンロードが完了したら、インストーラを起動します。

ステップ2

インストーラを起動すると、オペレーティングシステムが実行をブロックしようとする場合があります。例えば、Windowsでは次のようなメッセージが表示される場合があります。

これが表示されたら、 More info をクリックしてから Run anyway をクリックし、Raspberry Pi Imagerのインストール手順に従ってください。

ステップ3

SDカードをコンピュータやラップトップのSDカードスロットに挿入します。

ステップ4

Raspberry Pi Imagerで、インストールしたいOSとインストール先のSDカードを選択します。

注釈

最初の使用時にはインターネットに接続する必要があります。
そのOSは将来のオフライン使用のために保存されます(lastdownload.cache, C:/Users/yourname/AppData/Local/Raspberry Pi/Imager/cache)。次回ソフトウェアを開くと、「リリース日：日付、あなたのコンピュータにキャッシュされている」と表示されます。

ステップ5

使用しているSDカードを選択します。

ステップ6

Ctrl+Shift+X を押すか、 setting アイコンをクリックして、 Advanced options ページを開き、SSHを有効にし、ユーザ名とパスワードを設定します。

注釈

Raspberry Piにはデフォルトのパスワードがないため、自分で設定する必要があります。また、ユーザ名も変更可能です。

リモートアクセスのためには、SSHを手動で有効にする必要があります。

次に、wifiの設定を完了させて SAVE をクリックします。

注釈

wifi country は、Raspberry Piを使用している国の2文字の ISO/IEC alpha2コードに設定する必要があります。

ステップ7

WRITE ボタンをクリックします。

ステップ8

現在のSDカードにファイルがある場合、それらのファイルをバックアップすることをおすすめします。バックアップするファイルがない場合は、 Yes をクリックします。

ステップ9

少し待つと、書き込みが完了したことを示すウィンドウが表示されます。

4. Raspberry Piのセットアップ¶

画面がある場合¶

画面がある場合、Raspberry Piでの操作は簡単です。

必要な部品

Raspberry Pi（任意のモデル）
1 * 電源アダプター
1 * マイクロSDカード
1 * 画面用の電源アダプター
1 * HDMIケーブル
1 * 画面
1 * マウス
1 * キーボード

Raspberry Pi OSがセットアップされたSDカードを、Raspberry Piの下部にあるマイクロSDカードスロットに挿入します。
マウスとキーボードを接続します。
画面をRaspberry PiのHDMIポートに接続し、画面が壁のコンセントに接続され、オンになっていることを確認します。

注釈

Raspberry Pi 4を使用している場合、画面をHDMI0（電源ポートに最も近い）に接続する必要があります。
電源アダプターを使用してRaspberry Piに電源を供給します。数秒後に、Raspberry Pi OSのデスクトップが表示されます。

画面がない場合¶

モニターがない場合でも、Raspberry Piにリモートでログインすることができます。

SSHコマンドを使用して、Raspberry PiのBashシェルを開くことができます。Bashは、Linuxの標準のデフォルトシェルです。シェル自体は、ユーザーがUnix/Linuxを使用する際のコマンド（指示）です。必要な作業のほとんどは、このシェルを通じて行うことができます。

コマンドウィンドウでRaspberry Piにアクセスするだけで満足できない場合、リモートデスクトップの機能を使用して、GUIを使用してRaspberry Pi上のファイルを簡単に管理することもできます。

各システムの詳しいチュートリアルについては、以下を参照してください。

Mac OS Xユーザー¶

Macユーザーにとって、Raspberry PiのデスクトップをVNC経由で直接アクセスする方が、コマンドラインからのアクセスより便利です。Raspberry PiでVNCを有効にした後、Finderを使用して設定済みのアカウントのパスワードを入力することでアクセス可能です。

この方法ではMacとRaspberry Pi間の通信が暗号化されません。通信は家庭やビジネスのネットワーク内で行われるので、保護されていなくても問題にはなりません。しかし、セキュリティを気にする場合は、 VNC® Viewer のようなVNCアプリケーションをインストールすることを検討してください。

また、一時的なモニター（テレビ）、マウス、キーボードを使用して、Raspberry Piのデスクトップを直接開き、VNCを設定するのも便利です。それが不可能な場合でも、SSHコマンドを使ってRaspberry PiのBashシェルを開き、そこからVNCをセットアップすることができます。

一時的なモニター（またはテレビ）をお持ちですか？
一時的なモニタ（またはTV）を持っていない場合

一時的なモニター（またはテレビ）をお持ちですか？¶

Raspberry Piにモニター（またはテレビ）、マウス、キーボードを接続し、電源を入れます。画像に示される数字に従ってメニューを選択してください。
次の画面が表示されます。 Interfaces タブで VNC を Enabled に設定し、 OK をクリックしてください。
画面の右上にVNCのアイコンが表示され、VNCサーバーが起動します。
VNC アイコンをクリックしてVNCサーバーウィンドウを開き、右上の Menu ボタンをクリックし、 Options を選択します。
以下の画面が表示され、ここでオプションを変更することができます。

Encryption を Prefer off 、 Authentication を VNC password に設定してください。
OK をクリックすると、パスワード入力の画面が表示されます。Raspberry piのパスワードと同じ、または異なるパスワードを使用できますので、入力し OK をクリックしてください。

これでMacから接続する準備が整いました。モニターを切断しても問題ありません。

ここからはMac側の操作となります。

Finderのメニューから Connect to Server を選択します。右クリックからも開くことができます。
vnc://<username>@<hostname>.local または vnc://<username>@<IP address> と入力し、 Connect をクリックします。
パスワードの入力を求められるので、正確に入力してください。
Raspberry piのデスクトップが表示され、そのままMacから操作できるようになります。

一時的なモニタ（またはTV）を持っていない場合¶

Raspberry PiのBashシェルを開くには、SSHコマンドを使用できます。
BashはLinuxの標準デフォルトシェルです。
シェル自体は、ユーザーがUnix/Linuxを使用する際のコマンド（指示）です。
必要な操作のほとんどはシェルを通じて行うことができます。
Raspberry Pi側の設定が完了したら、Macの Finder を使用してRaspberry Piのデスクトップにアクセスできます。

ssh <username>@<hostname>.local と入力してRaspberry Piに接続します。
```
ssh pi@raspberrypi.local
```

以下のメッセージは初回ログイン時のみ表示されるので、 yes と入力します。

raspberrypi.local (2400:2410:2101:5800:635b:f0b6:2662:8cba)の真正性は確立できません。
ED25519キーのフィンガープリントはSHA256:oo7x3ZSgAo032wD1tE8eW0fFM/kmewIvRwkBys6XRwgです。
このキーは他の名前で知られていません。
続行して接続してもよろしいですか（yes/no/[フィンガープリント]）？

Raspberry Piのパスワードを入力します。入力したパスワードは表示されませんので、間違いのないように注意してください。

pi@raspberrypi.localのパスワード:
Linux raspberrypi 5.15.61-v8+ #1579 SMP PREEMPT Fri Aug 26 11:16:44 BST 2022 aarch64

Debian GNU/Linuxとともに提供されるプログラムは無料ソフトウェアです。
各プログラムの具体的な配布条件は、/usr/share/doc/*/copyrightにある
個別のファイルで説明されています。

Debian GNU/Linuxは、適用可能な法律の範囲で、絶対に保証されません。
最終ログイン: Thu Sep 22 12:18:22 2022
pi@raspberrypi:~ $

MacからVNCでログインできるようにRaspberry Piを設定します。まず、以下のコマンドを実行して、OSを更新します。
sudo apt update sudo apt upgrade
続行しますか？ [Y/n] と表示されたら、 Y を入力します。

アップデートには時間がかかる場合があります。（その時のアップデート量によります）
VNC Server を有効にするには、以下のコマンドを入力します。
sudo raspi-config
次の画面が表示されます。キーボードの矢印キーで 3 Interface Options を選択し、 Enter キーを押します。
次に、 P3 VNC を選択します。
キーボードの矢印キーを使用して <Yes> -> <OK> -> <Finish> を選択して、設定を完了します。
VNCサーバが起動したので、Macからの接続設定を変更しましょう。
すべてのユーザーアカウントのすべてのプログラムのパラメータを指定するには、 /etc/vnc/config.d/common.custom を作成します。
sudo nano /etc/vnc/config.d/common.custom
Authentication=VncAuthenter を入力した後、 Ctrl+X -> Y -> Enter で保存して終了します。
さらに、MacからVNC経由でログインする際のパスワードを設定します。Raspberry Piのパスワードと同じものや異なるものを使用することができます。
sudo vncpasswd -service
設定が完了したら、変更を適用するためにRaspberry Piを再起動します。
sudo sudo reboot
次に、 Finder のメニューから Connect to Server を選択します。右クリックで開くことができます。
vnc://<username>@<hostname>.local （または vnc://<username>@<IPアドレス> ）と入力します。入力後、 Connect をクリックします。
パスワードが要求されるので、入力してください。
Raspberry piのデスクトップが表示され、そのままMacから操作することができます。

Windowsユーザー¶

Windowsを使用している場合、Windows PowerShellを使用してRaspberry Piにリモートでログインできます。

キーボードで windows + R ショートカットキーを押し、 Run プログラムを開きます。入力ボックスに powershell と入力してください。
Raspberry Piが同じネットワークにあるかどうかを確認するために、 ping <hostname>.local を入力します。
ping raspberrypi.local
- ターミナルが Ping request could not find host <hostname>.local と提示する場合、Raspberry Piがネットワークに接続できなかった可能性があります。ネットワークを確認してください。
- <hostname>.local にピングを送ることができない場合は、 IPアドレスの取得を参照して ping <IPアドレス> を試してください。 (例: ping 192.168.6.116)
- "Reply from <IPアドレス>: bytes=32 time<1ms TTL=64" のようなメッセージが複数回表示される場合、コンピュータはRaspberry Piにアクセスできることを意味します。
ssh <username>@<hostname>.local (または ssh <username>@<IPアドレス>) を入力します。
ssh pi@raspberrypi.local

以下のメッセージが表示される場合があります。

'raspberrypi.local (192.168.6.116)'の真正性を確認できません。
ECDSAキーの指紋はSHA256:7ggckKZ2EEgS76a557cddfxFNDOBBuzcJsgaqA/igz4です。
接続を続行しますか (yes/no/[fingerprint])？

"yes" と入力します。

以前に設定したパスワードを入力します。（私の場合は raspberry です。）

注釈

パスワードを入力すると、文字はウィンドウに表示されません。これは正常です。正しいパスワードを入力するだけです。
Raspberry Piに接続が完了しました。次のステップに進みましょう。

リモートデスクトップ¶

コマンドウィンドウを使用してRaspberry Piにアクセスするのに満足していない場合、リモートデスクトップ機能を使用して、GUIを使用してRaspberry Pi上のファイルを簡単に管理することもできます。

ここでは VNC® Viewer を使用します。

VNCサービスを有効にする

VNCサービスはシステムにインストールされています。デフォルトでは、VNCは無効になっています。それをconfigで有効にする必要があります。

以下のコマンドを入力します：
sudo raspi-config
キーボードの下矢印キーを押して 3 Interfacing Options を選び、 Enter キーを押します。
次に P3 VNC を選択します。
キーボードの矢印キーを使用して、 <Yes> -> <OK> -> <Finish> を選択し、設定を完了します。

VNCにログインする

パーソナルコンピューター上で VNC Viewer をダウンロードしてインストールする必要があります。
インストールが完了したら、それを開きます。次に、ホスト名またはIPアドレスを入力し、Enterを押します。
Raspberry Piの名前とパスワードを入力した後、 OK をクリックします。
Raspberry Piのデスクトップが表示されます。

Linux /Unix ユーザー¶

Applications ->Utilities を開き、 Terminal を探して開いてください。
あなたのRaspberry Piが同じネットワーク上にあるかどうかを確認するには、 ping <hostname>.local を入力します。
ping raspberrypi.local
- ターミナルで ping: cannot resolve <hostname>.local というプロンプトが表示された場合、Raspberry Piがネットワークに接続できていない可能性があります。ネットワークを確認してください。
- もし <hostname>.local にpingができない場合、代わりに IPアドレスの取得を参照して ping <IP address> を試してみてください。（例: ping 192.168.6.116）
- 64 bytes from <IP address>: icmp_seq=0 ttl=64 time=0.464 ms のようなプロンプトが複数表示される場合、あなたのコンピュータはRaspberry Piにアクセスできることを意味します。
ssh <username>@<hostname>.local （または ssh <username>@<IP address> ）を入力します。
ssh pi@raspberrypi.local

以下のメッセージが表示されることがあります。

'raspberrypi.local (192.168.6.116)' の真正性は確立できません。
ECDSAキーのフィンガープリントはSHA256:7ggckKZ2EEgS76a557cddfxFNDOBBuzcJsgaqA/igz4です。
接続を続行しますか？ (yes/no/[fingerprint])?

"yes" と入力してください。

以前設定したパスワードを入力してください。（私の場合は raspberry です。）
Raspberry Piに接続が完了し、次のステップに進む準備ができました。

5. Pironmanの設定¶

注釈

このPironmanはPCと同じ方法で使用され、電源をオン/オフするための電源ボタンが必要です。

互換性のあるシステム¶

Pironmanと互換性のあるシステムは以下のとおりです。

あなたのシステムに git、 python3 、 pip がプリインストールされていない場合、まずそれらをインストールする必要があります。

sudo apt-get update
sudo apt-get install git -y
sudo apt-get install python3 python3-pip python3-setuptools -y

`pironman` モジュールのインストール¶

以下のコマンドを使用して pironman モジュールをダウンロードおよびインストールします。

cd ~
git clone https://github.com/sunfounder/pironman.git -b v2.0
cd ~/pironman
sudo python3 install.py

警告

ディレクティブの中の -b v2.0 は必須です

インストール後、変更を反映するために再起動が必要です。ある時点で再起動のリマインダーが表示され、すぐに再起動するか、後で再起動するかを選択できます。

Pironmanの基本的な設定は以下の通りです。

OLED画面にはRaspberry PiのCPU、RAM、ROMの使用状況、CPU温度、IPアドレスが表示されます。

60秒後、OLEDディスプレイはスリープモードに入り、電源ボタンを短く押すことで起動できます。

ファンは50度セルシウスでオンになります。

WS2812 RGBストリップをオンにして、色#0a1aff（青）で表示し、変更率が50％のブレスモードになります。

この時点で、2秒間押し続けて安全にシャットダウンするか、10秒間押し続けて強制的にシャットダウンすることができます。

設定の変更¶

pironman モジュールには、Pironmanの基本設定がいくつかあり、以下のコマンドでそれらを確認できます。

pironman -c

現在の設定は以下のとおりです。

ファンは50度セルシウスでオンになります。

OLEDディスプレイの持続時間は60秒で、60秒後にスリープを開始します。

WS2812 RGBストリップをオンにして、色#0a1affで表示し、変更率が50％のブレスモードになります。

これらの設定を自分のニーズに合わせて変更することもできます。

pironman 、 pironman -h 、または pironman --help を使用して、次のような指示を表示します。

使用法:
    pironman <オプション> <入力>

オプション:
    start            pironmanサービスを開始

    stop             pironmanサービスを停止

    restart          pironmanサービスを再起動

    -h,--help        ヘルプ、このヘルプを表示

    -c,--check       すべての設定を表示

    -a,--auto        [ on ], ブート時の自動起動を有効にする
                     [ off ], ブート時の自動起動を無効にする

    -u,--unit        [ C/F ], 温度の単位を設定、
                         CまたはF（セルシウス/華氏）

    -f,--fan         [ temp ], ファンがオンになる温度、
                     セルシウス（デフォルト50）、範囲（30〜80）

    -al,--always_on  [on/off], 画面が常にオンかどうか、
                     デフォルトはFalse

    -s,--staty_time  [time], 画面の表示時間（秒）、
                     秒、デフォルト30

    -rw,--rgb_sw     [on/off], rgbストリップスイッチ

    -rs,--rgb_style  rgbストリップの表示スタイル、デフォルト：ブレス、
                     [breath / leap / flow / raise_up / colorful] の中から

    -rc,--rgb_color  [(HEX)color], rgbストリップの色を設定、
                     デフォルト: 0a1aff

    -rb,--rgb_speed  [speed], rgb点滅速度（0〜100, デフォルト50）

    -pwm,--rgb_pwm   [frequency], rgb信号の周波数（400〜1600, デフォルト1000 kHz）

    -rp,--rgb_pin    [pin], rgb信号ピン、次のようにすることができます [10 / spi/ SPI / 12 / pwm/ PWM] または
                     [21 / pcm / PCM], デフォルト10

例えば、ブート時のプログラムの自動実行をオフにする場合。

pironman -a off

または、WS2812 RGBストリップの色をリセットする。

pironman -rc ff8a40

これらの設定は /opt/pironman/config.txt に保存されており、このファイルを直接編集して変更することもできます。

sudo nano /opt/pironman/config.txt

編集を保存して終了するには、 Ctrl+X -> Y -> Enter を押します。

注釈

Pironmanコンポーネントの紹介および設定は、以下のリンクで見ることができます: 6. ハードウェアについて。

6. ハードウェアについて¶

この章では、Pironmanに含まれるすべてのコンポーネントの詳細な説明と、関連するソフトウェアの設定について説明します。

機能¶

機能

Raspberry PiミニPC
25°Cの室温で100%のCPU負荷を持つPiを39°Cまで冷却できるタワークーラー
オンボードのUSBからM.2 SATA SSDへ、TRIM対応
KodiやVolumioのようなマルチメディアセンターのIRレシーバー
GPIO制御を持つRGBファン
16 WS2812アドレス指定可能なRGB LEDで全体のケースをクールな光の効果で照らす
安全なシャットダウン用のインジケータライト付きのレトロな金属製電源ボタン
Raspberry PiのCPU使用率、温度、ディスク使用率、IPアドレス、RAM使用率などを表示する0.96インチのOLEDディスプレイ
ピン名ラベル付きの外部GPIOエクステンダーで簡単にアクセス
電源ステータスメモリ、偶発的な電源遮断時の電源ステータスを記憶
簡単なアクセスのためのmicroSDカードの再配線
クリアアクリルサイドパネルを持つアルミニウム製の本体

仕様

外形寸法: 112.45x68.2x118.92mm
材質
1. 本体: アルミ合金
2. 両側面と前面: アクリル
対応プラットフォーム: Raspberry Pi 4B
電源入力: USB Type C 5V/3A
定格電力: 5V/800mA
インターフェース (d ~ iはオリジナルのRaspberry Piインターフェース)
1. Raspberry Pi標準40-Pin GPIO
2. マイクロSD
3. USB Type C電源入力
4. USB 2.0 x 2
5. USB 3.0
6. ギガビットLANポート
7. USB Type C Raspberry Pi電源供給 (Raspberry Piへの直接電源供給、推奨されません)
8. マイクロHDMI x 2
9. 3.5mmヘッドフォンジャック
電源ボタン
OLEDスクリーン: 0.96インチ 128x64解像度
赤外線受信器: 38KHz
冷却ファン: サイズ 40x40x10mm
WS2812 RGB LED: 16xWS2812B-5050

ピンの機能

シャットダウン信号ピン: 電源ボタンを押すと、Raspberry Piは電源がオフになり、GPIO26が高レベルに設定されます。メインボードがこの高レベルを検出すると、電源が遮断されます。

寸法図

メインボード¶

ポートについて

ピンについて

注釈

ファンピンの2チャンネルが提供されており、Pironmanの前後に同時にファンを組み立てることができます。

メインボードには5つのジャンパーキャップがあり、各ジャンパーキャップは一つの機能に対応しています。機能が不要で、ピンを別の場所で使用したい場合は、ジャンパーキャップを抜くことができます。以下は、5つのジャンパーキャップの機能に関する詳しい説明です。

電源ボタンの有効化: このジャンパーキャップを引き抜くと、電源ボタンは動作しません。また、電源ボタンはスリープモードでのOLEDスクリーンの起動にも使用されます。
シャットダウン信号 (IO26): メインボードは State ピンのレベルに応じて電源をオン/オフします。 State が低いときに電源がオンになり、 State が高いときに電源がオフになります。
- ジャンパーキャップでGNDとstateを接続すると、電源ボタンを10秒間押し続けることでメインボードをオフにすることができます。
- State とIO26をジャンパーキャップで接続すると、設定後、Raspberry PiはIO26を通じて State ピンを制御できます。Raspberry Piがオンのときは State が低レベルに設定され、Raspberry Piがオフのときは State が高レベルに設定されるため、マザーボードとRaspberry Piは同期して電源をオン/オフできます。
WS2812ピン選択: Raspberry PiにはWS2812 RGB LEDストリップを駆動するための3つの高速信号駆動モードがあります。しかし、これらのモードには他の用途があり、WS2812 RGB LEDストリップに使用すると、元々の機能が無効になります。
PCM (IO21) はデジタルオーディオ（HDMIオーディオ）のためのものです。

SPI (IO10) はSPIインターフェースのためのものです。

PWM (IO12) はアナログオーディオ（3.5mmオーディオジャック）のためのものです。
デフォルトではSPI (IO10) 駆動モードが選択されています。組み立て過程で異なるピン（例えばIO21）に切り替える場合は、対応する設定も変更する必要があります。
pironman -rp 21
ファンの有効化: このジャンパーキャップを抜くと、ファンは常に回転します。ファンが不要な場合は、ファンのワイヤを抜くか、ファンを取り外すことができます。
IRレシーバーの有効化: このジャンパーキャップを抜くと、IRレシーバーは動作しません。

電源遮断メモリ

Pironmanが突然電源を失った場合、メインボードのチップはこの状態を記録し、次回は自動的に電源をオンにします。

OLEDスクリーン¶

インストール後、スクリプトは自動的に起動し、OLEDスクリーンにRaspberry PiのCPU、RAM、ROMの使用状況、CPU温度、IPアドレスが表示されます。

OLEDスクリーンの寿命を延ばすために、デフォルトで60秒後にOLEDがオフになり、電源ボタンを短く押すことで再び点灯します。以下のコマンドでこの機能を有効/無効にすることができます。

スリープモードに設定: "al"は"常時点灯"を意味します。スリープモードでは、電源ボタンを短く押して起動します。

pironman  -al off

常時点灯モードに設定:

pironman  -al on

秒単位での期間を設定:

pironman  -s 60

上記はOLEDスクリーンの設定内容です。OLEDスクリーンに他の情報や効果を表示させたい場合、 /opt/pironman/main.py を開いて変更し、実行することができます。
このPythonスクリプトを開いて内容を変更します。
sudo nano /opt/pironman/main.py
Ctrl+X -> Y -> Enter を押して、編集を保存して終了します。

それを実行します。
sudo python3 /opt/pironman/main.py

冷却ファン¶

注釈

冷却ファンはGPIO6（BCM）に接続されています。

冷却ファンの動作状態は、CPUの温度によって決定されます。CPUの温度が設定した閾値に達するとファンが回転し、閾値より2度摂氏以下の場合、ファンは停止します。

温度単位を設定する, C : 摂氏, F : 華氏。

pironman  -u C

ファンが起動する温度を設定します。例えば、40度摂氏（単位はあなたが設定したもの）。

pironman  -f 40

WS2812 RGBストリップ¶

ピン選択

Raspberry Piは、WS2812 RGB LEDストリップの駆動に使用できる3つの高速信号駆動モードを持っています。ただし、これらのモードには他の用途があり、WS2812 RGB LEDストリップに使用すると、元々の機能が無効になります。
- SPI (IO10) はSPIインターフェース用。
- PWM (IO12) はアナログオーディオ（3.5mmオーディオジャック）用。
- PCM (IO21) はデジタルオーディオ（HDMIオーディオ）用。
デフォルトではSPI（IO10）ドライブモードが選択されています。組み立て過程で異なるピン（例: IO21）に切り替える場合は、対応する設定も変更する必要があります。
pironman -rp 21

その他の設定

WS1812 RGBストリップは、Pironmanのステータスを表示するために使用できる8つのRGB LEDを備えたライトストリップです。コマンドを使用してオン/オフを切り替えたり、色（デフォルトは青）、表示モード、変更率を変更することができます。

WS2812 RGBストリップをオンにする。

pironman  -rw on

オフにする。

pironman  -rw off

その色を変更し、16進色値を使用する。

pironman  -rc fe1a1a

表示モードを変更する。選択できる4つのモードがあります： breath、 leap、 flow、 raise_up。

pironman  -rs leap

変更速度を変更する（0〜100%）。

pironman  -rb 80

上記はWS2812 RGBストリップのために事前に設定したエフェクトです。他のエフェクトを表示させたい場合は、 /opt/pironman/ws2812_RGB.py を開いて変更して実行できます。
このpythonスクリプトを開いて内容を変更します。
sudo nano /opt/pironman/ws2812_RGB.py
Ctrl+X -> Y -> Enter を押して、編集を保存して終了します。

実行します。
sudo python3 /opt/pironman/ws2812_RGB.py

電源ボタン¶

注釈

電源ボタンはGPIO26に接続されています。別のピンに変更したい場合は、互換性のあるシステムを参照してください。

電源ボタンは、OLEDスクリーンを起動するためやPironmanをオフにするために使用できます。

電源が入った後、OLEDスクリーンは60秒間表示され、その後スリープモードに入ります。電源ボタンを使用して、後でOLEDスクリーンを再度起動することができます。
Pironmanをシャットダウンする方法は2つあります。
1. 強制シャットダウン
  
  電源ボタンを10秒間押し続けると、Pironmanの電源が切れますが、この方法ではRaspberry Piのファイルが破損する可能性があるか、一部の変更が保存されない場合があります。
2. 安全なシャットダウン
  
  設定後、電源ボタンを2秒間押し続けることで、Pironmanを安全にオフにする方法もあります。

IR受信機¶

注釈

IR受信機はGPIO13に接続されています。別のピンに変更したい場合は、互換性のあるシステムを参照してください。

IR受信機を使用する前に、接続をテストし、関連するモジュールをインストールする必要があります。

下記のコマンドを使用してテストします。表示デバイスがあれば、設定が成功していると言えます。
sudo ls /dev |grep lirc
lirc モジュールをインストールします。
sudo apt-get install lirc -y
以下のコマンドを実行し、リモートコントローラのキーを押すと、対応するキーのコードが表示されます。
mode2 -d /dev/lirc0

注釈

Raspberry PiでKodiを再生したい場合は、 Raspberry PiにOSMCを使用してKodiをインストールを参照してください。

SATA M.2 SSD¶

NVME M.2 SSDとの非互換性の理由¶

注釈

M.2 SSDのハードドライブインターフェースはSATAプロトコルのみをサポートし、NVME/PCIeはサポートしていません。

現在のインターフェースはSATA M.2 SSDに適応する設計となっています。ここで、NVMe M.2 SSDとの互換性を持たせない決定の背景を説明いたします：

NVMe SSDは高性能コンピューティング環境での性能が非常に高い一方、Raspberry Pi 4の処理能力やバス帯域幅は限定されています。したがって、NVMe SSDを接続しても、ハードウェアの制約から、SSDのパフォーマンスを最大限に活用できない場合があり、リソースの最適な利用が難しいと考えられます。

さらに、Raspberry Pi 4のUSB電源供給には制約があります。NVMe SSDを接続すると、特に高負荷時には電源が不足する可能性があります。NVMe SSDは安定した動作のために高い電流を要求することが多いですが、Raspberry Pi 4のUSBポートがこれらの要求を満たせない場合、SSDの動作が不安定になったり、適切に機能しない恐れがあります。

以上の理由から、NVMe SSDを接続することで、大きな性能向上は期待できないと判断しました。このため、NVMe SSDインターフェースのサポートを見送っています。

設計に対するご理解をお願い申し上げます。お客様に最適な製品を提供し、スムーズな体験を実現することが私たちの目標です。

モデルに関して¶

M.2 SSDは、その仕様や性能特性によりさまざまなモデルが存在します。以下は、一般的なM.2 SSDのモデルを示しています：

M.2 SATA SSD: これらは、2.5インチSATA SSDと同様のSATAインターフェイスを使用しますが、より小さなM.2フォームファクターで提供されます。SATA IIIの最大速度約600MB/sによって速度が制限されています。これらのSSDは、BキーとMキーの両方に対応したM.2スロットと互換性があります。
M.2 NVMe SSD: これらのSSDは、PCIeレーンを介してNVMeプロトコルを使用し、M.2 SATA SSDよりも著しく速い速度を提供します。ゲーム、ビデオ編集、データ集約的なタスクなど、高速な読み書き速度が求められるアプリケーションに適しています。これらのSSDは、通常Mキーのスロットを要求します。これらのドライブはPCIe（Peripheral Component Interconnect Express）インターフェイスを利用しており、3.0、4.0、5.0などの異なるバージョンがあります。PCIeの新しいバージョンは、前任者のデータ転送速度を実質的に倍増させます。

M.2 SSDはBキー、Mキー、B+Mキーの3つの主要なタイプがあります。しかし、B+Mキーが後に導入され、BキーとMキーの機能を統合。結果として独立したBキーは廃止されました。下の画像を参照してください。

一般的に、M.2 SATA SSDはB+Mキーであり、PCIe 3.0 x4レーンのM.2 NVMe SSDはMキーです。

長さについて¶

M.2モジュールはさまざまなサイズがあり、Wi-Fi、WWAN、Bluetooth、GPS、NFCなどにも使用されます。

Pironmanは、その名称から以下の4つのM.2 SATA SSDサイズをサポートしています：2230、2242、2260、および2280。「22」はミリメートル単位の幅を示し、次の2つの数字は長さを示します。ドライブの長さが長いほど、多くのNANDフラッシュチップを取り付けることができ、それにより容量が増えます。

SSDの組み立て方法¶

Pironmanのベースプレートを取り外します。
M.2 SATA SSDのためのネジを外します。
お持ちのM.2 SATA SSDを挿入します。
適切な位置にネジを固定します。
ベースプレートを元に戻します。
SSDブリッジと5V/3Vの電源供給を接続します。

SSDからの起動¶

Raspberry PiにSSDをインストールしたので、Raspberry Pi OSをその上にインストールし、SSDからRaspberry Piを起動する方法を学びましょう。

1. Raspberry Pi OSをSSDにインストール

SSDにRaspberry Pi OSをインストールする方法は2つあります：

最初の方法は、 Raspberry Pi Imager を使用して直接インストールする方法です。これはMicro SDカードにOSをインストールするのと似ています。ストレージデバイスを選ぶよう求められたら、SSDを選択してください。この手順に不慣れな場合は、チュートリアル 3. OSのインストール（共通）を参照してください。
代替の方法は、既存のSDカードからコピーする方法です。SDカード上のファイルやシステムを保持したい場合は、この方法が適しています。

Micro SDの内容をSSDにコピーする方法を以下に説明します：

Pironmanにmicro SDカードを挿入し、USB Bridgeを使ってSSDをRaspberry Piに接続し、Pironmanの電源を入れます。
Raspberry Piのデスクトップにアクセスします。これは、モニターを直接接続するか、リモートデスクトップを使用して行うことができます。詳細はチュートリアル画面がない場合を参照してください。
start メニューの Accessoriesー セクションから SD Card Copier を起動します。
コピー元デバイス（Micro SDカード）とコピー先デバイス（SSD、/dev/sda/）を選択します。正しいドライブを選択したことを確認し、 "Start" をクリックしてコピープロセスを開始します。これには数分かかることがあります。
"Copy Complete" と表示されたら、Raspberry Piをシャットダウンし、micro SDカードを取り外します。

注釈

Micro SDカードが Raspberry Pi Lite の場合、コピーを完了するためにコマンドを使用する必要があります。詳しい手順については、 Micro SDからSSDにRaspberry Pi OS Liteをコピーする方法は？を参照してください。

2. ブートローダーのインストール

Raspberry Pi OSがSSDにインストールされたので、次はPiのブートローダーをリセットしてUSBからの起動を優先する必要があります。

Raspberry Piのウェブサイトから Raspberry Pi Imager をダウンロードしてインストールします。
余分なmicro SDカードをコンピュータに挿入します。このカードの内容は削除されるため、重要なデータのバックアップを忘れずに。
Raspberry Pi Imager を起動し、 “Operating System” の下にスクロールして “Misc Utility Images” をクリックします。
Bootloader を選択します。
次に、 USB Boot を選択します。これでメインメニューに戻ります。
"Storage" の下で、micro SDカードを選択します。進む前に、正しいドライブを選択したことを再確認してください。
“WRITE” をクリックして、設定イメージをダウンロードし、それをmicro SDカードに書き込みます。
書き込みが成功したことを確認してから、micro SDカードをコンピュータから取り外します。
Pironmanにmicro SDカードを挿入し、電源を入れます。
アップデートが完了すると、緑色のアクティビティLEDが定期的に点滅します。HDMIモニターが接続されている場合、完了時に画面が緑色になります。アップデートには10秒以上かかることがあるため、このプロセス中にmicro SDカードを取り外さないようにしてください。
Raspberry Piの電源を切り、micro SDカードを取り外します。

3. SSDからの起動

この時点で、micro SDカードが取り外されていることを確認してください。USB Bridgeを使用してSSDをRaspberry Piに接続します。次に、Pironmanの電源を入れます。

7. 付録¶

Raspberry PiにOSMCを使用してKodiをインストール¶

Kodi は、Raspberry Piでメディアを再生するためのもっとも人気のある方法の一つです。多くの異なるメディアフォーマットをサポートしており、このメディアセンターソフトウェアを使用して音楽、動画、画像を再生できます。

Kodiを使用すると、すべてのメディアファイルをスキャンしてソートできます。ファイルの情報をダウンロードし、魅力的な方法で表示します。

Raspberry PiのシステムにKodiを直接インストールすることも、 OSMC や LibreELEC のようなKodiがプリインストールされているディストリビューションを使用することもできます。

このチュートリアルでは、OSMCメディアセンターのインストールとセットアップ方法を紹介します。

OSMCは、Kodiメディアセンターソフトウェアを使用するオペレーティングシステムのディストリビューションです。

OSMCの利点の一つは、完全なオペレーティングシステムの上に構築されており、組み込みのKodi機能を超えて簡単に拡張できることです。例えば、バックエンドに簡単にアクセスできるので、Netflixを簡単にセットアップすることができます。

Kodiを最高の状態で使用するためには、Raspberry Pi 4以降のモデルの使用をおすすめします。高性能なプロセッサと増加したRAMが、Kodiの最適な動作をサポートします。

部品リスト¶

必須

Pironman
Micro SDカード（8GB以上）
イーサネットケーブルまたはWi-Fi
HDMIケーブル
モニター
キーボードとマウス

オプション

M.2 SATA SSD

OSMCイメージのインストール¶

このセクションでは、Micro SDカードにOSMCイメージをインストールする方法を学びます。従来はEtcherやWin32ディスクイメージャーなどの書き込みツールが使用されていましたが、Raspberry PiはRaspberry Pi Imagerを開発し、イメージとツールが一体となったもので、イメージのインストールが簡単になりました。

Raspberry Pi Imager がない場合はダウンロードしてください。
Raspberry Pi Imagerを開き、 CHOOSE OS をクリックします。
Media player OS ボタンをクリックします。このボタンをクリックすると、Kodi用の2つのイメージが表示されます。
ここでは OSMC を選択します。
Raspberry Pi 0/1、2/3、4/400のバージョンが提供されていますので、適切なバージョンを選択してください。
適切なドライブを選択した後、書き込みをクリックします。
インストール完了のメッセージが表示されたら、Micro SDカードを取り出してください。

Raspberry PiでのOSMCの初期セットアップ¶

OSMCをSDカードにインストールしたので、初期セットアップの手順を説明します。

Micro SDカードを取り出し、Pironのカードスロットに挿入します。
HDMIケーブルでディスプレイをPironmanに接続し、電源スイッチで電源を入れます。
OSMCを初めて起動すると、次の画面が表示されます。OSMCのセットアップガイドを続ける前に、セットアッププロセスが完了するのを待ってください。
インストールが完了したら、Pironmanを再起動する必要があります。電源スイッチを長押しするか、電源ケーブルを再接続して再起動できます。
再起動すると、言語を選択するように求められる設定ページが表示されます。OSMCの言語を選択した後、 Yes を選択してセットアップを続けてください。
次に、タイムゾーンを選択するように求められます。正しい時間を確保するために、住んでいる場所の関連するタイムゾーンを選択してください。
ここで、デバイスの名前を変更するかどうかを尋ねられます。デフォルトのデバイス名は osmc ですが、別の名前に変更することをおすすめします。
このセクションでは、SSHサービスを無効または有効にすることができます。OSMCのセットアップツールはデフォルトでSSHを有効にします。インストールを続けるには、 Accept をクリックしてください。
このステップでは、OSMCおよびKodiの利用規約に同意するように求められます。ライセンスを読んで同意した後、 Continue オプションを選択してください。
好みのテーマを選択します。このガイドでは、デフォルトの OSMC テーマを使用します。
ここで、OSMCのニュースレターにサインアップするかどうかを尋ねられます。このガイドでは、 No thanks オプションを使用して続けます。
この時点で、Raspberry Pi上のOSMCの初期設定プロセスを完了しました。 Exit オプションを選択することで、Kodiのメイン画面に移動できます。

OSMCでのネットワーク設定¶

このセクションでは、OSMCインターフェースを使用してデバイスのネットワークを設定する方法を示します。

Settings オプションに移動します。
次に、 My OSMC メニューに進みます。
Network を選択します。このメニューには、Raspberry PiのOSMCを設定するのに役立つ他のオプションも含まれています。
このオプションでWIFIを設定することができます。また、ネットワークケーブルを接続するだけで、接続に関する情報が表示され、後でOSMCにリモートでアクセスするためにこのIPアドレスを覚えておく必要があります。

ファイル転送¶

OSMCデバイスとコンピューターの間でファイルを編集、追加、または変更するためにファイルを転送する必要があることがあります。経験に応じて、ファイルを転送する方法は多岐にわたります。これらの方法の中には、SSHが有効になっている場合にすぐに動作するものもあります。Samba (SMB) サーバーやFTPサーバーなどの追加のOSMC機能が必要な方法もあります。

SFTP

簡単さを重視して、FileZillaを使用したSFTPのみに焦点を当てます。これは、OSMCに追加の変更を加えずに（SSHが有効になっている必要があります）すべての三つのプラットフォーム（Windows、macOS、Linux）ですぐに動作します。

FileZillaを初めて開くと、ホスト、ユーザー名、パスワードを提供する必要があります。

ホスト: sftp://あなたのosmcのipアドレス
ユーザー名: osmc
パスワード: osmc (または指定されたパスワード)
ポート: デフォルトのSSHポート22を使用する場合は空白のままにできます。

これらを入力したら、接続を確立するためにクイック接続ボタンをクリックします。

Sambaサーバー

SMBサーバーを使用してもファイルを転送することができます。これはより直感的で役立つ方法ですが、以下のようにしてOSMCにこのサーバーを最初にインストールする必要があります。

My OSMC メニューページに移動し、 App Store アイコンを選択します。
Samba (SMB) Server を選択します。
Install を選択します。
SMBサーバーのインストールを開始するために Apply を選択します。
右上隅にポップアップが表示され、インストールを促します。インストールが完了すると、自分のコンピューターからRaspberry Piのファイルにアクセスできるようになります。
Windowsで Win+R を使用してRun Boxを開きます。
入力ボックスに \\ipアドレス を入力します。
すると、 osmc という名前の共有ドライブが表示されます。
クリックすると、さまざまなフォルダが表示され、音楽、ビデオ、映画などをこれらのフォルダに転送することができます。

OSMCのビデオをScrapeに追加する¶

このセクションでは、OSMCがスクレイプするためのビデオフォルダを追加する方法を説明します。

ビデオのスクレイピングはかなり簡単なプロセスであり、Kodiの主要な機能の一つです。

まず、 Video メニューに移動します。
次に、 Files サブメニューを選択します。このサブメニューでは、インポート済みのフォルダを閲覧するか、追加のフォルダを追加することができます。
次に、 Add video.. オプションを選択します。このオプションでは、OSMCのKodiがライブラリにスキャンするためのフォルダを追加します。
このメニューでは、 Browse または Add オプションを選択する必要があります。
- Browse オプションは、OSMCのファイルブラウザを使用してフォルダを検索することができます。
- Add オプションを使用すると、ディレクトリへのパスを手動で入力できます。
- どちらの方法を選択しても、テレビ番組や映画が格納されているフォルダを選択して、 OK をクリックします。
- 映画とテレビ番組は別々のフォルダに分けて保存してください。
- 同じフォルダに含まれている場合、Kodiのスクレイパはそれらを区別することができません。
OSMCはビデオを3つのカテゴリー、 Movies 、 Music Videos 、 TV Shows に分けます。あなたのビデオに最も関連するオプションを選択します。選択するオプションによって、OSMCがビデオから情報を取得する方法が変わります。
メディアの種類を選択した後、 OK を選択できます。OSMCはライブラリをスクレイプするために使用される信頼できる 情報提供者 を自動的に選択します。

OSMCはあなたのビデオをスキャンし、インターネット上のデータベースでその名前を検索します。このスキャンにより、ポスターや俳優、メッセージ、ビデオに関するその他の興味深い情報を取得することができます。

OKを選択した後、スクレイピングプロセスが自動的に開始されるはずです。OSMCのインターフェースに映画やテレビ番組が追加されたことが確認できるでしょう。

リモートを設定する¶

Pironmanには38KHzのIRレシーバが組み込まれており、GPIO13ピンに接続されているため、リモートコントロールを使用してKodiを制御できます。

1. IRレシーバを設定する

Settings -> My OSMC メニューに移動し、 Raspberry Pi アイコンを選択します。
Hardware Support を選択し、 gpio_pin に13と入力します。

設定が完了すると、この設定を有効にするために再起動するように求められます。

2. リモートコントロールを選択する

Kodiは多種多様なリモートをサポートしているため、それらを設定するための指示に従うことができます。 My OSMC メニューに戻り、 Remotes アイコンを選択して設定ページに進みます。
リストから使用しているリモートのブランドを選択します。

Kodiはあなたのリモートで制御することができます。

詳細については、次のURLを参照してください：https://osmc.tv/wiki/。

3. リモートを手動で追加する

リモートを手動で設定することは、あなたのリモートに適した.confファイルを取得し、 リモート リストに追加し、現在使用するものとして選択する方法です。

i. SSH経由でのログイン

PCからOSMCシステムにリモートでログインします。デフォルトの名前とパスワードは osmc です。

Windowsユーザーは、ここでPuTTYというSSHクライアントをダウンロードできます。

代わりに、一部のWindows 10のインストールでは、Windowsのスタートメニューから“PowerShell”を使用してコマンドラインのSSHクライアントにアクセスできます。Windows 10システムがこれをサポートしている場合、Linuxの手順を使用できます。

LinuxおよびOS Xのユーザーは既にSSHクライアントを持っているはずです。

デバイスのIPアドレスは、 Settings -> Systems -> Network で見ることができます。

Windows

PuTTYを実行し、デバイスのIPアドレスを入力して、 OK をクリックします。求められた場合、ユーザー名とパスワードの両方として osmc を入力します。

Linux / OS X

ターミナルインターフェースを開き、以下のコマンドを実行します：

ssh osmc@<あなたのデバイスのIPアドレス>

このデバイスに初めて接続する場合、SSHキーを受け入れるように求められます。 yes と入力します。

ii. LIRC設定ファイルの作成

gpio_pin がOSMCの Settings -> My OSMC -> Raspberry Pi -> Hardware Support で13に設定されていることを確認してください。
ターミナルで、Raspberry PiがIRレシーバを検出しているかどうかを次のコマンドで確認します。
ls /dev/lirc*
/dev/lirc0 のようなポートメッセージが表示されるはずです。
次に、リモートからデータを受信できるかどうかを確認します。
sudo mode2 --driver default --device /dev/lirc0

リモートのボタンを押し、パルスデータの文字列が表示されるかどうかを確認します。

osmc@osmc:/etc/lirc$ sudo mode2 --driver default --device /dev/lirc0
Using driver default on device /dev/lirc0
Trying device: /dev/lirc0
Using device: /dev/lirc0
Running as regular user osmc
space 16777215
pulse 9083
space 4442
pulse 628
space 509
pulse 626
space 508
pulse 596
space 543
pulse 593
space 538

lircdを停止します。
sudo killall lircd
すべての利用可能な KEY_codes を後でマッチングするために取得します。
irrecord --list-namespace
これで、リモートに適した .conf 設定ファイルを作成します。
irrecord -d /dev/lirc0
- 上記のコマンドを実行するだけです。
- Enterキーを2回押します。
- リモートコントロールに名前を付けます。
- Please enter the name .. が表示されるまで、キーを押し続けてサンプルを取ります。
- すべてのキーを定義するために前のコマンドを参照してください。
- リモートのすべてのキーを設定した後、Enterを押して終了します。 ls コマンドを使用して、設定した .conf ファイルが存在しているかどうかを確認できます。
これで、OSMCに戻って、 Settings -> My OSMC -> Remotes をクリックします。
Browseを使用してHomeフォルダの下にある.confファイルを選択します。
一度選択すると、OKを押して選択し、変更を確認します。

この時点で、リモートを使用してOSMCを制御できるようになります。

IPアドレスの取得¶

IPアドレスを知る方法は多数ありますが、以下にそのうちの2つを紹介します。

ルーターを通じての確認

ルーターにログインする権限がある場合（家庭用ネットワークなど）、ルーターの管理画面からRaspberry Piに割り当てられたアドレスを確認できます。

Raspberry Pi OSのデフォルトのホスト名はraspberrypiですので、それを探してください。（ArchLinuxARMシステムを使用している場合は、alarmpiを探してください。）

ネットワークセグメントのスキャン

ネットワークのスキャニングも使用して、Raspberry PiのIPアドレスを検索することができます。Advanced IP scanner などのソフトウェアを利用できます。

IP範囲をスキャンすると、接続されているすべてのデバイスの名前が表示されます。同様に、Raspberry Pi OSのデフォルトのホスト名はraspberrypiですので、変更していなければそれを探してください。

Home Assistant¶

このセクションでは、Raspberry PiにHome Assistantオペレーティングシステムをインストールする手順を案内します。このプロセスを実行すると、Raspberry Piシステム上の既存のコンテンツがすべて失われることに注意してください。進める前に、データのバックアップを取ることが重要です。

HassOSのインストール¶

ステップ1

Raspberry Piは、Mac OS、Ubuntu 18.04、Windowsで動作するグラフィカルなSDカード書き込みツールを開発しました。これは、多くのユーザーにとって最も簡単なオプションです。なぜなら、自動的にイメージをダウンロードし、SDカードにインストールしてくれるからです。

ダウンロードページ https://www.raspberrypi.org/software/ にアクセスしてください。あなたのオペレーティングシステムに対応する Raspberry Pi Imager のリンクをクリックして、ダウンロードが完了したら、インストーラを起動します。

ステップ2

インストーラを起動すると、オペレーティングシステムがそれを実行するのをブロックしようとするかもしれません。例えば、Windowsでは以下のようなメッセージが表示されます。

このようなポップアップが表示された場合は、 More info をクリックし、次に Run anyway をクリックして、Raspberry Pi Imagerをインストールする手順に従ってください。

ステップ3

SDカードをコンピュータまたはラップトップのSDカードスロットに挿入します。

ステップ4

Raspberry Pi Imagerで、インストールしたいOSと、それをインストールしたいSDカードを選択します。

ステップ5

使用しているSDカードを選択します。

ステップ6

WRITE ボタンをクリックします。

ステップ7

SDカードに現在ファイルがある場合は、それらのファイルをバックアップしてから続行することをおすすめします。バックアップするファイルがない場合は、 Yes をクリックします。

ステップ8

しばらく待つと、書き込みが完了したことを示すウィンドウが表示されます。

Home Assistantのセットアップ¶

ステップ1

この手順は、Pironman OLEDを起動するためのI2Cインターフェースを有効にするものです。

ファイルエクスプローラを開き、 Hassio-boot という名前のSDカードにアクセスします。

ルートパーティションに CONFIG という新しいフォルダを作成します。

CONFIG フォルダの中に modules というフォルダを作成します。

ファイル拡張子の表示を有効にします。

modules フォルダ内にテキストファイルを作成し、それを rpi-i2c.conf にリネームします。拡張子の変更を確認するプロンプトが表示されるので、「はい」を選択します。

Notepadで rpi-i2c.conf を開き、以下の内容を追加します：

i2c-dev

ファイルを保存して閉じます。

ステップ2

このステップでは、RGB LEDの設定を行います。

Hassio-boot ディレクトリの config.txt というファイルを開きます。

下部に以下の内容を追加します：

dtparam=i2c_vc=on
dtparam=i2c_arm=on
dtoverlay=gpio-poweroff,gpio_pin=26,active_low=0
dtoverlay=gpio-ir,gpio_pin=13

WS2812 LEDストリップを駆動するために使用するピンを特定することが重要です。
- デフォルトのSPIピン（GPIO10）を使用している場合、SPIを有効にし、周波数を500bpsに設定するために、以下のコマンドを config.txt ファイルに追加する必要があります。
  dtparam=spi=on core_freq=500 core_freq_min=500 # 必要に応じてオーディオを有効にします。 dtparam=audio=on
- オーディオ出力にも使用されるPWM（GPIO12）を使用している場合、オーディオを無効にする必要があります。 config.txt ファイルに以下のコマンドを挿入します：
  dtparam=audio=off
- PCM（GPIO21）を使用している人は、追加のセットアップは不要です。ただし、 hifiberry-dac や i2s-mmap のようなI2Sデバイスと競合する可能性があります。これらを無効にし、必要に応じてオーディオをオンにします。
  # 必要に応じてオーディオを有効にします。 dtparam=audio=on # i2sデバイスのコメントアウトをします。 # dtoverlay=hifiberry-dac # dtoverlay=i2s-mmap
最後に、このファイルを保存して閉じます。

ステップ3

次に、PironmanのWiFi設定を行います。

注釈

ネットワークアクセスに有線接続を使用する予定の場合、この手順はスキップできます。

CONFIG フォルダ内に network というフォルダを作成します。

network フォルダ内に、拡張子なしの新しいテキストファイル my-network を作成します。

my-network ファイルに、以下のテキストを書き込み、 MY_SSID および MY_WLAN_SECRET_KEY を自分のネットワークのSSIDとパスワードに置き換えます：

[connection]
id=my-network
uuid=72111c67-4a5d-4d5c-925e-f8ee26efb3c3
type=802-11-wireless

[802-11-wireless]
mode=infrastructure
ssid=MY_SSID
# SSIDがブロードキャストされていない場合は、以下のコメントを解除します
#hidden=true

[802-11-wireless-security]
auth-alg=open
key-mgmt=wpa-psk
psk=MY_WLAN_SECRET_KEY

[ipv4]
method=auto

[ipv6]
addr-gen-mode=stable-privacy
method=auto

ファイルを保存して終了します。

ステップ4

コンピュータからmicroSDカードを取り出し、Raspberry Piに挿入してください。その後、電源（必要であればイーサネットケーブルも）を接続します。

PCに戻り、 homeassistant.local:8123 にアクセスします。それが機能しない場合は、ルーターでIPアドレスを確認してください。

Home Assistantを初めて使用する際、初期設定が行われるため、しばらく待つ必要があります。

ステップ5

次に、最初のアカウントを作成するように求められます。

システムは、検出されたデバイスのインストールを促しますが、今は「FINISH」をクリックしてスキップできます。

ステップ6

次に、Home Assistant用のPironmanアドオンをインストールします。

下のボタンをクリックしてすぐに追加してください。その後、 ステップ7 に進んでください。

または、手動でインストールするには以下の手順に従ってください：

Home Assistantで「Settings」->「Addons」に移動します。
右下の「Addon Store」ボタンをクリックします。
右上のメニューボタンをクリックし、「Repositories」を選択します。
リポジトリのURLを入力: https://github.com/sunfounder/home-assistant-addon , 「Add」をクリックします。SunFounderのリポジトリを追加したら、ポップアップウィンドウを閉じます。
メニューボタンを再びクリックし、「Check for updates」をクリックします。
数秒後、Pironmanアドオンがアドオンストアの最後に表示されます。表示されない場合は、ページをリフレッシュしてみてください。

ステップ7

Pironmanアドオンに入り、「インストール」をクリックします。このプロセスには数分かかる場合があります。

現在、アドオンがハードウェア情報にアクセスできるように保護モードを無効にする必要があります。「Protection Mode」を見つけてオフにします。その後、アドオンを起動（または再起動）します。

この時点で、Pironmanの照明効果とOLEDディスプレイが点灯するはずです。これは、設定が完了したことを示しています。

トラブルシューティング¶

OLEDやRGBストリップが正常に起動しない場合は、「Log」ページに移動してください。

[DEBUG] oled init failed:
[Errno 2] No such file or directory
Cannot open /dev/spidev0.0. spi_bcm2835 module not loaded?

[DEBUG] rgb_strip init failed:
ws2811_init failed with code -13 (Unable to initialize SPI)

上記のログが表示される場合、設定が成功していないことを意味します。以下の手順に従ってください：

まず、Home Assistantをシャットダウンします。

警告

強制的に電源を切ると、HassOSにダメージを与える可能性があります。以下のシャットダウン手順に従ってください：

その後、電源プラグを抜く前に1分間待ってください。
このセクションの ステップ1 と ステップ2 を繰り返します (Home Assistantのセットアップ) 。
SDカードをPironmanに再度挿入し、電源を接続し、1～2分待ちます。その後、ブラウザで http://homeassistant.local:8123/ に移動します。Pironmanアドオンで「START」をクリックします。
しばらく待つと、Pironman (RGBストリップ & OLED) が点灯するはずです。

アドオン設定¶

Pironmanの効果を「Settings」ページでカスタマイズできます。

ここでは、以下を変更できます：

OLEDに表示される温度の単位。
OLED画面の明るさの持続時間。
ファンが動作を開始する温度。
RGBストリップの色と点滅モード。

変更を行った後、「SAVE」をクリックして設定を適用します。

FAQ¶

PironmanのLEDは点灯しているが、電源ボタンを押してもRaspberry Piが起動しないのは？¶

以下の条件を確認してください。

Raspberry Pi用の別の電源はありますか？

以下の理由でこれを行わないでください。

Raspberry Pi自体にはオン/オフ制御がないため、Raspberry Piの電源を入れることでのみ起動します。したがって、Pironmanは電源オフ後にRaspberry Piの電源を切り、Raspberry Piの電源を入れてRaspberry Piを起動します。 Raspberry PiとPironmanの両方の電源を入れると、シャットダウン後、Raspberry Piは外部からプラグを挿入されて常に電源が供給されているため、PironmanはRaspberry Piの電源を入れてRaspberry Piを起動する方法がありません。
Micro SDカードは既にPironmanのスロットに挿入されていますか？
Micro SDカードにシステムはインストールされていますか？
GPIOブリッジのFFCケーブルが正しく接続されているか、特に注意が必要ですか？

Micro SDからSSDにRaspberry Pi OS Liteをコピーする方法は？¶

ブートローダを更新する
sudo apt update sudo apt full-upgrade sudo rpi-update sudo rpi-eeprom-update -d -a
設定後、効果を適用するために再起動します。
以下のコマンドを使用して、ストレージデバイスの名前を表示します。
sudo fdisk -l
Raspberry Piに接続されているすべてのドライブのリストが表示されます。ほとんどの場合、 /dev/mmcxxx はMicro SDカードを指し、 /dev/sda/ はSSDを指します。
次に、以下のコマンドを使用して、Micro SDカードからSATA M.2 SSDにシステムをクローンします。
注釈

Micro SDカードの名前を /dev/mmcblk0 に置き換え、SSDの名前が異なる場合は /dev/sda も変更してください。
sudo dd if=/dev/mmcblk0 of=/dev/sda bs=4M
Micro SDカードを取り外し、M.2 SATA SSDを接続して、Pironmanの電源を入れます。

Pironman V2.0- SunFounder向けのRaspberry PiミニPCキット¶

1. さらに準備すべきものは？¶

2. 部品一覧と組み立て手順¶

3. OSのインストール（共通）¶

4. Raspberry Piのセットアップ¶

画面がある場合¶

画面がない場合¶

Mac OS Xユーザー¶

一時的なモニター（またはテレビ）をお持ちですか？¶

一時的なモニタ（またはTV）を持っていない場合¶

Windowsユーザー¶

リモートデスクトップ¶

Linux /Unix ユーザー¶

5. Pironmanの設定¶

互換性のあるシステム¶

pironman モジュールのインストール¶

設定の変更¶

6. ハードウェアについて¶

機能¶

メインボード¶

OLEDスクリーン¶

冷却ファン¶

WS2812 RGBストリップ¶

電源ボタン¶

IR受信機¶

SATA M.2 SSD¶

NVME M.2 SSDとの非互換性の理由¶

モデルに関して¶

長さについて¶

SSDの組み立て方法¶

SSDからの起動¶

7. 付録¶

Raspberry PiにOSMCを使用してKodiをインストール¶

部品リスト¶

OSMCイメージのインストール¶

Raspberry PiでのOSMCの初期セットアップ¶

OSMCでのネットワーク設定¶

ファイル転送¶

OSMCのビデオをScrapeに追加する¶

リモートを設定する¶

IPアドレスの取得¶

Home Assistant¶

HassOSのインストール¶

Home Assistantのセットアップ¶

トラブルシューティング¶

アドオン設定¶

FAQ¶

PironmanのLEDは点灯しているが、電源ボタンを押してもRaspberry Piが起動しないのは？¶

Micro SDからSSDにRaspberry Pi OS Liteをコピーする方法は？¶

`pironman` モジュールのインストール¶