Skip to main content

Home Assistantの始め方

note

この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues

reTerminalでHome Assistantの始め方

はじめに

このWikiでは、reTerminalを使用して普通の家をスマートホームに変える方法をステップバイステップで説明します! このWikiを読み終える頃には、reTerminalのLCD上で美しいダッシュボードを表示し、家庭の電化製品を制御したり、センサーのデータなどの情報を指先で確認できるようになります。それでは始めましょう!

Home Assistantとは?

Home Assistantは、スマートホームデバイスの中央制御システムとして設計された、ホームオートメーション用の無料かつオープンソースのソフトウェアで、スマートホームハブとも呼ばれます。クラウドを必要としないホームオートメーションを提供しており、これによりホームオートメーションシステムがリモートサーバーやインターネット接続に依存しません。このローカル制御により、クラウド接続デバイスよりもはるかに高いセキュリティを確保できます。また、24時間365日稼働させる際の信頼性も向上します。

Home Assistantは柔軟に使用でき、初心者でも簡単に始められる素晴らしいドキュメントが提供されています。また、Home Assistant Forumには活発なコミュニティがあり、Home Assistantの構築や運用中に問題が発生した場合に助けてくれる多くのメンバーがいます。 Home Assistantをセットアップした後は、AndroidやiOSのコンパニオンアプリを使用したり、Google AssistantやAmazon Alexaなどの対応する仮想アシスタントを通じて音声コマンドで操作したりすることで、ウェブベースのユーザーインターフェースにアクセスできます。 ウェブブラウザでデモをすぐに体験したい場合は、こちらをクリックしてください

インストール方法の種類

Home Assistantは、Raspberry Pi、ODROID、ASUS Tinkerboard、Intel NUC、Windows/Linux/Mac PCなどのさまざまなハードウェアで動作することがサポートされています。そしてこれに伴い、異なるハードウェアに対して異なるインストール方法があります。これらすべてのインストール方法について詳しく知りたい場合は、このページをご覧ください。 以下に示すように、主に4つのインストール方法があり、すべてのHome Assistant機能がすべてのインストール方法でサポートされているわけではありません。

reTerminalのインストール方法

Home Assistantによると、推奨されるHome Assistantインストール方法はOSとコンテナ方式の2つです。しかし、これら2つの方法を使用してreTerminalにインストールすることはありません。なぜでしょうか?

なぜHome Assistant Operating Systemではないのか?

reTerminalにHome Assistant Operating Systemをインストールすると、reTerminalのLCD上でHome AssistantのダッシュボードUIを表示することができません。これは、Home Assistant OSが以下のように接続されたディスプレイにCLIインターフェースのみを出力するためです。

そのため、ダッシュボードUIは別のデバイス上でhomeassistant.local:8123を介してのみアクセス可能です。ただし、この方法でインストールしたい場合や、reTerminalのLCD上でダッシュボードを表示したくない場合は、このガイドに従うことができます。これは、reTerminalがRaspberry Pi Compute Module 4に基づいているため、Raspberry Piと同じインストール方法を採用しています。

なぜHome Assistant Containerではないのか?

reTerminalにHome Assistant Containerをインストールすると、いくつかのHome Assistant機能が欠落することになります。そのため、このインストール方法はスキップします。ただし、このインストール方法を試したい場合は、このガイドに従うことができます。これは、reTerminalがRaspberry Pi Compute Module 4に基づいているため、Raspberry Piと同じインストール方法を採用しています。

なぜHome Assistant Supervisedなのか?

reTerminalにHome Assistant Supervisedをインストールすると、Home Assistantのすべての機能を使用できるだけでなく、reTerminalのLCD上でダッシュボードUIを表示することも可能になります! ただし、このインストールにはOSやコンテナ方式と比較して多くの手順が必要です。しかし、このWikiを注意深く順に従えば、成功することができます!

構築してみましょう

note

いくつかのステップで、Wi-Fi接続を使用している場合、接続が失われる可能性があります。そのため、LAN接続を使用することを推奨します。

それでは、reTerminalにHome Assistant Supervisedをインストールする手順を見ていきましょう。

  • ステップ 1. Raspberry Pi OSがすでにインストールされたreTerminalを準備します。reTerminalにはRPi OS 32ビットがプリインストールされています。ただし、再インストールしたい場合はこのWikiを参照してください。

注意: 32ビット版を使用してください。reTerminal LCD上のHome Assistant Dashboard UIは32ビット版の方がスムーズに動作します。

  • ステップ 2. パッケージマネージャーリストを更新します
sudo apt update
  • ステップ 3. 依存関係をインストールします
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y
  • ステップ 4. 壊れたインストールを修復します
sudo apt --fix-broken install
  • ステップ 5. reTerminalを再起動します
sudo reboot
  • ステップ 6. 公式Dockerスクリプトをダウンロードします
curl -fsSL https://get.docker.com -o get-docker.sh
  • ステップ 7. Dockerスクリプトを実行します
sudo sh get-docker.sh
  • ステップ 8. Dockerユーザーをシステムに追加します
sudo usermod -aG docker pi
  • ステップ 9. Dockerが正常に動作しているか確認します
docker --version

以下のような出力が表示されれば、Dockerが正常にインストールされています。

Docker version 20.10.18, build b40c2f6
note

Home Assistant Supervisorの互換性は特定のDocker CGroup v1に依存しています。この互換性を確保するために、以下の変更を行う必要があります。

  • エディタを使用してこのファイルを開きます
sudo nano /etc/default/grub
  • この行を追加して保存します
systemd.unified_cgroup_hierarchy=false
  • このファイルを開きます
sudo nano /boot/cmdline.txt
  • フレーズの末尾にこの行を追加して保存します
systemd.unified_cgroup_hierarchy=false apparmor=1 security=apparmor
  • ステップ 10. Home Assistant OS Agentページにアクセスし、最新リリースの下で*linux_armv7.debで終わるファイルを右クリックしてリンクをコピーします。
note

reTerminal(CM4)でテスト済みの安定した動作するHome Assistant Agentのリリースは現在V1.3.0です。

  • ステップ 11. 以下の形式でファイルをダウンロードします
wget <copied_link>

例:

wget https://github.com/home-assistant/os-agent/releases/download/1.3.0/os-agent_1.3.0_linux_armv7.deb
  • ステップ 12. Home Assistant OS Agentをインストールします
sudo dpkg -i os-agent_<version_number>_linux_armv7.deb

例:

sudo dpkg -i os-agent_1.3.0_linux_armv7.deb
  • ステップ 13. Home Assistant-Supervisedインストールスクリプトをダウンロードします
note

同様に、reTerminal(CM4)でテスト済みの安定した動作するHome Assistant-Supervisedのリリースは現在V1.3.0です。

wget https://github.com/home-assistant/supervised-installer/releases/download/1.3.0/homeassistant-supervised.deb
  • ステップ 14. Home Assistant-Supervisedをインストールします
sudo dpkg -i homeassistant-supervised.deb
  • ステップ 15. インストール中にエラーが発生した場合、以下のコマンドを実行して壊れたインストールを修復してください
sudo apt --fix-broken install
  • ステップ 16. パッケージ構成ウィンドウで、raspberrypi4を選択し、ENTERを押します

出力は以下のようになります

note

再起動後にWi-Fi接続の問題が発生した場合は、以下の手順を実行してください。

  • 'dhcpcd'を有効にするには、以下のコマンドを実行します:
sudo systemctl enable dhcpcd
  • ネットワークサービスを無効にするには、以下のコマンドを実行します:
sudo systemctl disable networking
  • Raspberry Piを再起動して変更を適用します:
sudo reboot
note

「ネットワークマネージャーの問題」を解決するには、ネットワークマネージャーを起動して有効化する必要があります。以下のコマンドを使用してください:

sudo systemctl enable NetworkManager

WebブラウザでHome Assistant Dashboard UIを表示する

  • ステップ 1. Webブラウザで以下のURLを入力してください
homeassistant.local:8123

初期起動プロセスが完了するまで少し時間がかかります。

  • ステップ 2. 起動が完了したら、アカウントを作成し、初期設定の指示に従ってください。

その後、以下のようなウェルカムダッシュボードが表示されます。

reTerminalでキオスクモードでHome Assistant Dashboard UIを表示する

reTerminalのLCDでHome Assistant Dashboard UIを表示するために、Raspberry Pi OSに既に含まれているChromiumウェブブラウザを使用します。reTerminalが起動した後、Chromiumがフルスクリーンモードで自動的に起動するように設定します。

  • ステップ 1. 以下のディレクトリに移動します。
cd /etc/xdg/lxsession/LXDE-pi/
  • ステップ 2. nanoテキストエディタautostartファイルを開きます。
sudo nano autostart
  • ステップ 3. ファイルの末尾に以下の行を追加します。
@chromium-browser --kiosk --incognito --disable-pinch --overscroll-history-navigation=0 homeassistant.local:8123
  • ステップ 4. reTerminalを再起動します。
sudo reboot 

これで、reTerminalが起動すると、Home AssistantダッシュボードUIがフルスクリーンウィンドウで開きます!

ボーナス

スマートライト、温度・湿度センサー、CCTVなどを統合した後、Home Assistant上の完全なスマートホームダッシュボードは以下のようになります。


技術サポート

弊社製品をお選びいただきありがとうございます!製品をご利用いただく際に、できる限りスムーズな体験を提供するため、さまざまなサポートをご用意しております。お客様の好みやニーズに応じた複数のコミュニケーションチャネルを提供しています。

Loading Comments...