照度センサー
太陽高度または時刻に基づいて屋外の照度を推定する sensor エンティティを作成します。
いずれの場合も、値は別の既存のエンティティから取得した現在の天候条件や雲量に基づいてさらに調整できます。動作モード
3つのモードが利用可能です：通常、放射照度、シンプル。通常/放射照度モード - 太陽高度
これらのモードは、米国海軍天文台[^1] のアルゴリズムを使用して、太陽の高度（別名：仰角）に基づいて太陽の照度または放射照度を推定します。最大照度値は約150,000 lx、最大放射照度値は約1,250 ワット/㎡です。 以下は3日間の照度の例です。
[^1]: Janiczek, P. M., and DeYoung, J. A. _Computer Programs for Sun and Moon Illuminance With Contingent Tables and Diagrams_. Circular No. 171. Washington, D. C.: United States Naval Observatory, 1987 Google Scholar
シンプルモード - 時刻
夜間の値は10 lxです。日の出前後の少しの間に、値は現在の条件に応じて上昇します。日の入り前後も同様ですが、値は減少します。歴史的な理由から、最大値は10,000 lxです。以下は3日間の例です。
対応している天気情報ソース
標準の条件リスト を使用する、または雲量のパーセンテージを提供する任意の天気エンティティは、この統合で動作するはずです。 以下の天気データソースが対応していることが確認されています：統合 | 備考
-|-
AccuWeather | weather
Buienradar | weather
ecobee |
Meteorologisk institutt (Met.no) | weather
OpenWeatherMap | weather; cloud_coverage と condition の sensor
インストール
統合ソフトウェアはまずカスタムコンポーネントとしてインストールする必要があります。 HACSを使用してインストールを管理し、更新通知を受け取ることができます。 または、ソフトウェアを手動でインストールすることも可能です。
HACSを使用する場合
- このリポジトリをカスタムリポジトリとして追加します。
text
https://github.com/pnbruckner/ha-illuminance
`
またはこちらのボタンを使用してください：
- 適切なボタンを使用して統合をダウンロードしてください。
手動インストール
custom_components/illuminance からファイルのコピーを
に配置してください。
ここで はあなたの Home Assistant の設定ディレクトリです。>__注意__: ダウンロード時は、各ファイルのページの
Raw ボタンを必ず使用してください。インストール後
ダウンロード後、Home Assistant を再起動する必要があります。
バージョン
このカスタム統合は HomeAssistant バージョン 2024.8.3 以降をサポートしています。
サービス
illuminance.reloadYAML 設定から Illuminance をリロードします。また、開発者ツール -> YAML ページに
を追加します。設定変数
1つ以上のセンサーの設定オプションのリストです。各センサーは以下のオプションで定義されます。
注意: これは YAML による設定を定義しますが、同じセンサーは UI からも追加可能です。
キー | オプション | 説明
-|-|-
unique_id | いいえ | センサーの一意識別子。これにより、他のオプションを変更しても新しいセンサーのように見えません。（YAMLベースの設定でのみ必要。）
entity_id | はい | 現在の天気条件または雲量のパーセンテージを示す別のエンティティのID
fallback | はい | 天気データが利用できない場合に使用する照度除数。範囲は1（晴れ）から10（暗い）まで。entity_idが使用されている場合のデフォルトは10、そうでない場合は1。
mode | はい | 動作モード。選択肢は、太陽の高度を使うnormal（デフォルト）、時刻を使うsimple、および値がワット毎平方メートルの放射照度で表されるirradiance（normalと同じ）です。
name | はい | センサーの名前。デフォルトはIlluminance。
scan_interval` | はい | 更新間隔。最小は30秒。デフォルトは5分。2.1.0以前のリリース
https://github.com/pnbruckner/homeassistant-config/blob/master/docs/illuminance.md を参照してください。--- Tranlated By Open Ai Tx | Last indexed: 2025-12-28 ---