Unit Step16 Home Assistant 連携ガイド

このガイドでは、Unit Step16 16 ビットロータリーエンコーダーコントロールユニットを Home Assistant に統合し、ノブによる数値制御や照明制御を実現する方法について説明します。

必要なもの

Home Assistant ホスト。
Atom-Lite。
Home Assistant に ESPHome Builder をインストールして有効化しておくこと。

ご注意

本チュートリアルでは、ファームウェアのコンパイルおよびアップロードに ESPHome 2026.1.2 を使用しています。コンパイル／アップロードに問題が発生した場合は、このバージョンの ESPHome への切り替えをご検討ください。

デバイスの追加

新しいデバイスを作成します。右下の緑色のボタンをクリックしてデバイスを作成します。

デバイス名を作成します。

CONTINUE をクリックします。

New Device Setup をクリックします。

デバイス名を入力し、NEXT をクリックします。

デバイスタイプを選択します。

ESP32 をクリックします。

SKIP をクリックします。

YAML ファイルの編集を開始します。

EDIT をクリックします。YAML ファイルを使用してデバイスの機能をカスタマイズできます。

デバイス設定

以下はコードの主要な部分です。関連する参考情報と説明を以下に示します。

外部コンポーネント設定

External コンポーネントを追加します：

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: unit_step16
    refresh: 0s

unit_step16:
  id: my_step16
  i2c_id: bsp_iic
  address: 0x48 

I2C 設定

i2c:
  - id: bsp_iic
    scl: GPIO32
    sda: GPIO26
    scan: True 

センサー設定

Sensor コンポーネントを追加します：

sensor:
  - platform: unit_step16
    unit_step16_id: my_step16
    name: "Encoder Value"
    update_interval: 100ms
    on_value:
      then:
        - logger.log:
            format: "Encoder value changed to: %.0f"
            args: ["x"] 

出力設定

Output コンポーネントを追加します：

output:
  - platform: unit_step16
    id: led_brightness_output
    unit_step16_id: my_step16
    channel: led_brightness

  - platform: unit_step16
    id: rgb_brightness_output
    unit_step16_id: my_step16
    channel: rgb_brightness

  - platform: unit_step16
    id: rgb_red_output
    unit_step16_id: my_step16
    channel: rgb_red

  - platform: unit_step16
    id: rgb_green_output
    unit_step16_id: my_step16
    channel: rgb_green

  - platform: unit_step16
    id: rgb_blue_output
    unit_step16_id: my_step16
    channel: rgb_blue 

ライト設定

Light コンポーネントを追加します：

light:
  - platform: rgb
    id: step16_rgb_light
    name: "Step16 RGB Light"
    red: rgb_red_output
    green: rgb_green_output
    blue: rgb_blue_output
    restore_mode: ALWAYS_ON
    default_transition_length: 0s

  - platform: monochromatic
    id: step16_led_display
    name: "Step16 LED Display"
    output: led_brightness_output
    restore_mode: ALWAYS_ON
    default_transition_length: 0s 

数値設定

Number コンポーネントを追加します：

number:
  - platform: template
    name: "RGB Brightness"
    min_value: 0
    max_value: 100
    step: 1
    optimistic: true
    initial_value: 50
    on_value:
      then:
        - output.set_level:
            id: rgb_brightness_output
            level: !lambda "return x / 100.0;" 