TimerCamera シリーズ Home Assistant 連携ガイド

このガイドでは、TimerCamera シリーズデバイスを Home Assistant に連携させる方法について詳しく説明します。対象機種は TimerCamera (U082)、TimerCamera-X (U082-X)、TimerCamera-F (U082-F) です。

必要なもの

Home Assistant ホスト
Home Assistant に ESPHome Builder をインストールして有効化する
OV3660 Datasheet
ESPHome で最新の設定例を確認する：ESP32 Camera

クイックスタート

下のボタンをクリックするだけでファームウェアの書き込みが完了し、画面の指示に従って設定を行うことで、TimerCamera シリーズを Home Assistant にすばやく接続できます。

ご注意

本チュートリアルでは、ESPHome 2025.12.3 でのコンパイルおよびアップロードを前提としています。コンパイル / アップロードに問題が発生した場合は、ESPHome をこのバージョンに切り替えることをご検討ください。ここでは TimerCamera-X を設定例として使用します。一部モデルでカメラ仕様が異なりますが、その他のハードウェア構成は共通です。機種に合わせて名称などの情報を適宜変更してください。

デバイスの追加

ESPHome Builder を開き、右下の NEW DEVICE をクリックして新しいデバイスを作成します。
ポップアップで CONTINUE をクリックします。
New Device Setup を選択し、新しい設定ファイルを作成します。
新しい設定ファイルに名前を付けます。
デバイスタイプを選択します。ここではデフォルト設定のまま ESP32 を選択します。
Encryption Key をコピーして保存しておき、SKIP をクリックしてスキップします。

設定の变更

生成された設定ファイルのカードから EDIT をクリックして編集します。
設定ファイルを開いて編集します。

PSRAM コンポーネントを追加します。

psram:
  mode: quad
  speed: 80MHz 

I2C および ESP32 Camera コンポーネントを追加します。

yaml 
i2c:
  - id: bsp_i2c
    sda: GPIO12
    scl: GPIO14
  - id: cam_i2c
    sda: GPIO25
    scl: GPIO23

esp32_camera:
  name: OV3660 Camera
  external_clock:
    pin: GPIO27
    frequency: 20MHz
  i2c_id: cam_i2c
  data_pins: [GPIO32, GPIO35, GPIO34, GPIO5, GPIO39, GPIO18, GPIO36, GPIO19]
  vsync_pin: GPIO22
  href_pin: GPIO26
  pixel_clock_pin: GPIO21
  reset_pin: GPIO15
  resolution: 640x480
  jpeg_quality: 10

ここではデフォルトの画像設定を使用しています。設定を変更したい場合は、ESPHome が提供する設定例を参照してください。

RTC Time コンポーネントを追加します。

esphome:
  name: timercamera-x
  friendly_name: timercamera-x
  ...
  on_boot:
    then:
      # read the RTC time once when the system boots
      bm8563.read_time:

...
time:
  - platform: bm8563
    i2c_id: bsp_i2c
    # repeated synchronization is not necessary unless the external RTC
    # is much more accurate than the internal clock
    update_interval: never
  - platform: homeassistant
    # instead try to synchronize via network repeatedly ...
    on_time_sync:
      then:
        # ... and update the RTC when the synchronization was successful
        bm8563.write_time: 

システムは起動時に RTC から時刻情報を読み取り、Home Assistant に接続後は自動的に Home Assistant の時刻情報と同期します。

LED を設定します。

yaml 
output:
  - platform: ledc
    id: blue_led
    pin: GPIO2

light:
  - platform: monochromatic
    output: blue_led
    name: "Blue LED"
    restore_mode: RESTORE_DEFAULT_ON

青色 LED はデバイス起動時にデフォルトでオンになります。Home Assistant から LED のオン / オフと輝度を制御できます。

バッテリーを使用する場合。

yaml 
switch:
  - platform: gpio
    id: bat_hold_pin
    name: "Battery Hold Pin"
    pin: GPIO33
    restore_mode: RESTORE_DEFAULT_ON

ここで GPIO33 はバッテリーの使用可否を制御します。有効にしてハイ状態を維持することでバッテリーが動作します。デフォルトでは常にハイ状態を維持します。このスイッチをオフにすると、外部電源がない状態でデバイスがシャットダウンします。

バッテリー残量を監視する。

TimerCamera-X と TimerCamera-F にはバッテリーが内蔵されており、GPIO38 の ADC 読み値を取得することでバッテリー電圧情報を得ることができ、変換後におおよそのバッテリー残量がわかります。

yaml 
sensor:
  - platform: adc
    pin: GPIO38
    attenuation: 12dB
    name: "Battery Voltage"
    id: battery_voltage
    update_interval: 10s
    filters:
      - multiply: 1.51

  - platform: template
    id: battery_percent
    name: "Battery Percentage"
    unit_of_measurement: "%"
    accuracy_decimals: 0
    lambda: |-
      float voltage = id(battery_voltage).state;
      float min_voltage = 3.350f;
      float max_voltage = 4.150f;

      if (voltage <= min_voltage) return 0.0;
      if (voltage >= max_voltage) return 100.0;

      float percent = ((voltage - min_voltage) / (max_voltage - min_voltage)) * 100.0;
      return percent;

注意

バッテリー残量の有効な値を取得するには、外部 USB 電源が接続されていない状態で、かつ BAT_HOLD_Pin（GPIO33）をハイに保つ必要があります。HOLD 状態を維持しない場合はバッテリー駆動にならず、ADC の読み値が非常に低くなります（1V 未満）。外部 USB 電源を接続しつつ HOLD 状態を維持している場合、ここに表示される電圧情報は充電電圧となります。

ファームウェアのダウンロードと書き込み

編集完了後、右上の SAVE と INSTALL をクリックし、表示されるオプションから Manual Download を選択します。

ヒント

TimerCamera-X / TimerCamera-F をクリックして完全な設定ファイルのサンプルを確認できます。初回のコンパイルには時間がかかる場合があります。コンパイル時間は Home Assistant ホストの性能とネットワーク品質によって異なります。

コンパイル完了後、Download ボタンをクリックし、Factory Format を選択してファームウェアをダウンロードします。
USB Type-C ケーブルでデバイスをホストに接続し、ESPHome Web を開いて CONNECT をクリックしてデバイスに接続します。
次に INSTALL をクリックし、先ほどコンパイルしたファームウェアを選択してアップロードします。
再度 INSTALL をクリックして書き込みを開始し、完了するまで待ちます。

使い方

ファームウェアの書き込みが完了すると、デバイス起動時に自動的に Wi-Fi 接続が行われます。Settings -> Device & services に移動してデバイスの状態を確認します。Add をクリックするとデバイスを Home Assistant に追加できます。

ダッシュボードの表示例：

カメラエンティティをクリックすると、リアルタイムプレビュー映像を確認できます。

TimerCamera（TimerCamera-X）は左図のように表示され、TimerCamera-F は魚眼レンズを使用しているため、右図のような映像になります。

Home Assistant OS

Voice Assistant

キット

センサー

スイッチ／リレー

照明

カメラ