Atom-Lite HA Light

1. 環境セットアップ

Home Assistant公式ドキュメントを参照し、Home Assistant をインストールしてください。
Setting -> Add-ons -> Add-ons STORE から ESPHome Builder アドオンをインストールします。
インストール後、アドオンの管理ページで Show in sidebar を有効にし、左ナビゲーションバーに追加します。
このチュートリアルは HA公式ドキュメントを参考にしています。必要に応じてご確認ください。

2. デバイスの追加

ESPHome アドオンページを開き、右下の NEW DEVICE をクリックして新しいデバイスを作成します。

New device プロンプトが表示されたら、CONTINUE ボタンをクリックします。

デバイス名を入力します（例: Atom-Lite）。

次にデバイスタイプ選択画面が表示されます。まず Use recommended settings のチェックを外し、ESP32 を選択して進みます。

詳細ページで M5Stack-ATOM を探し、選択して NEXT をクリックします。

「デバイスの設定が完了しました」と表示されます。key をコピーし、INSTALL をクリックします。

Manual download を選択し、プログラムのコンパイルとインストールが完了するのを待ちます。

3. コードの記述とコンパイル

上記の手順が完了したら、ESPHome Builder のメイン画面に戻ると、新しい Atom-Lite デバイスが表示されます。EDIT ボタンをクリックして YAML ファイル編集ページに進みます。

以下のコードを YAML ファイルにコピーし、画像で示されている ssid と password をあなたの Wi-Fi の認証情報に変更してください。

yaml 
esphome:
  name: atom-lite
  friendly_name: Atom-Lite

esp32:
  board: m5stack-atom
  framework:
    type: arduino

logger:
api:
  encryption:
    key: "*****************"

ota:
  - platform: esphome
    password: "***************"

wifi:
  ssid: "***********"
  password: "************"
  ap:
    ssid: "Atom-Lite Fallback Hotspot"
    password: "jFsIc2XGuKRe"

captive_portal:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO39
      mode: INPUT
      inverted: true
    name: "Atom Button"
    id: atom_button
    filters:
      - delayed_on: 50ms
      - delayed_off: 50ms
    on_multi_click:
      - timing:
          - ON for at most 0.8s
          - OFF for at most 0.5s
          - ON for at most 0.8s
          - OFF for at least 0.2s
        then:
          - logger.log: "Double Clicked"
          - light.turn_on:
              id: atom_light
              red: 100%
              blue: 50%
              green: 20%
              brightness: 50%
      - timing:
          - ON for at least 0.8s
        then:
          - logger.log: "Single Long Clicked"
          - light.turn_on:
              id: atom_light
              green: 100%
              blue: 50%
              red: 30%
              brightness: 100%

light:
  - platform: neopixelbus
    type: GRB
    pin: GPIO27
    num_leds: 1
    variant: sk6812
    name: "Atom RGB Light"
    id: atom_light
    restore_mode: RESTORE_DEFAULT_OFF
    effects:
      - random:
          name: "Random"
          transition_length: 1s
          update_interval: 1s

まず SAVE ボタンをクリックして YAML ファイルを保存し、次に INSTALL ボタンをクリックしてファームウェアのコンパイルと書き込みを開始します。

再度 Manual download をクリックしてファームウェアのコンパイルを開始し、完了するまで待ちます。

ファームウェアコンパイルに関する注意:

HA を通じたファームウェアのコンパイルはリソースを大量に消費します。初回のコンパイルではリソースのダウンロードに時間がかかる場合があり、HA サーバーのハードウェアとネットワーク品質に依存します。コンパイルに失敗した場合は、下部の web tools 書き込みボタンをクリックして事前にパッケージ化されたファームウェアを書き込むことができます。書き込み後、プロンプトに従って Wi-Fi 接続情報を設定してください（設定に失敗した場合は接続を切断し、ページをリフレッシュして再試行してください）

4. ファームウェアの書き込み

ファームウェアの保存

コンパイルが完了したら、DOWNLOAD ボタンをクリックすると書き込み方法選択画面が表示されます。ここでは Factory format を選択してローカルに保存します。

ローカルへのダウンロードが完了するまで待ちます。

メイン画面に戻り、INSTALL を選択して書き込み方法選択画面に入ります。今回は Plug into this computer を選択し、USB でデバイスを PC に接続して書き込みを行います。

Open ESPHome Web を選択して書き込み画面に入ります。

まず CONNECT ボタンをクリックし、PC に接続されているシリアルポートデバイスを選択して接続します（ここにシリアルポートが表示されない場合は、ハードウェア接続を確認してください）。

INSTALL をクリックしてローカルのファームウェアファイル選択画面に入ります。

先ほどローカルに保存したファームウェアファイルを選択し、INSTALL をクリックして書き込みが完了するまで待ちます。

書き込み完了！

5. デバイス接続設定

ファームウェアの書き込みが完了後、デバイスは起動すると自動的に Wi-Fi 接続を試みます。Settingに移動し、Discoveredセクションで新しいデバイスを確認してください。ADDをクリックしてデバイスを追加します。

6. HA オートメーション設定

Setting をクリックして設定画面に入り、Devices & services を選択します。

検索バーで ESP を検索して ESPHome を見つけ、Atom-Lite を選択します。

Atom-Lite 設定ページでは、Atom RGB Light と Atom Button の 2 つの エンティティ が表示されます。オートメーションはこれらのエンティティを設定することで実現されます。+ボタンをクリックして Automations を追加し、指示に従って設定します。