Atom-Lite HA Light Home Assistant 連携ガイド

本チュートリアルでは、Atom-Lite と Home Assistant を連携させてライトを制御する方法について説明します。

1. 準備

環境準備

Home Assistant 公式ドキュメントを参照して、Home Assistant をインストールします。
ESPHome 公式ドキュメントを参照して、ESPHome Device Builder アドオンをインストールします。

ESPHome Builder アドオンのインストールが完了したら、管理ページで Show in sidebar を選択し、左側のサイドバーに追加します。

ハードウェア

Atom-Lite
USB Type-C ケーブル

2. オンライン書き込み

下の オンライン書き込み ボタンをクリックし、画面の案内に従ってファームウェアの書き込みと Wi-Fi 設定を完了すると、Atom-Lite と Home Assistant の連携をすぐに試すことができます。

書き込みと設定の詳細な手順については、ESPHome ファームウェアのオンライン書き込みと設定を参照してください。

オンライン書き込みが完了した場合は、「ファームウェアのコンパイルと書き込み」の手順は不要です。4. 使用開始に進んでください。

3. ファームウェアのコンパイルと書き込み

コンパイル時間

HA でのファームウェアコンパイルは多くのリソースを消費します。初回コンパイルではリソースのダウンロードに時間がかかる場合があり、所要時間は HA を実行するデバイスやネットワーク品質によって異なります。

デバイスの追加

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

New device の確認画面が表示されたら、CONTINUE ボタンをクリックします。

デバイスの名前を入力します。名前は任意で設定できます。ここでは Atom-Lite と入力します。

デバイスタイプの選択画面が表示されたら、Use recommended settings のチェックを外してから ESP32 を選択して詳細ページに進みます。

詳細ページで M5Stack-ATOM を見つけ、選択して NEXT ボタンをクリックします。

デバイスの設定完了画面が表示されたら、key をコピーしてから INSTALL をクリックしてインストール手順に進みます。

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

設定の変更

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

以下のコードを yaml ファイルにコピーし、図に示した箇所の ssid と password をご自身の Wi-Fi アカウントとパスワードに変更します。

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

esp32:
  board: m5stack-atom
  flash_size: 4MB
  framework:
    type: esp-idf

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: esp32_rmt_led_strip
    rgb_order: GRB
    pin: GPIO27
    num_leds: 1
    chipset: SK6812
    name: "Atom RGB Light"
    id: atom_light
    restore_mode: RESTORE_DEFAULT_OFF
    effects:
      - random:
          name: "Random"
          transition_length: 1s
          update_interval: 1s

バージョン互換性

ESPHome 2025.10 以降、Arduino は独立したフレームワークではなく ESP-IDF のコンポーネントとして使用されます。従来 Arduino で使用していた NeoPixelBus Light は ESP-IDF フレームワークをサポートしていないため、新しいバージョンの ESPHome では ESP32 RMT LED Strip コンポーネントを使用してください。

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

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

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

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

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

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

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

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

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

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

書き込み完了：

4. 使用開始

ファームウェアの書き込みが完了すると、デバイスの起動時に自動的に Wi-Fi 接続が行われます。Setting をクリックして設定画面に入り、Discovered にあるデバイスを確認し、ADD をクリックしてデバイスを追加します。

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

検索バーに ESP と入力すると ESPHome が見つかります。開いて Atom-Lite を選択します。

Atom-Lite の設定ページでは Atom RGB Light と Atom Button という 2 つの Entity を確認できます。オートメーションはさまざまな Entity を設定することでロジックを実現します。+ ボタンをクリックして Automations を追加し、その後は画面の指示に従って操作してください。