エンティティとエンティティレジストリ（Entity Registry）とは何か？私の考えでは、これはHA中のスマートデバイスが分割できる最小の単位であり、制御単位と理解できる。例えば、空気清浄機内の温度センサーの報告は1つのエンティティとみなされる。
各エンティティはUnique IDを有している。このIDはユーザーが変更できない。さもなくば、データの不整合が起こる。もし1つのデバイスが1つのIDしか持たないが、複数のエンティティを提供するならば、{unique_id}-{sensor_type}のように識別できる。
忘れてならないのは、Unique IDは全域で唯一でなくてはならず、変更不可能である。一般的に、MACアドレスが用いられる。
エンティティレジストリ とは、HA内に存在する全てのエンティティを管理するためのデータベースです。エンティティごとに、以下の情報が登録されます。
– エンティティID: エンティティを一意に識別するためのID
– 名前: エンティティの名前
– ドメイン: エンティティの種類 (例: light、switch、sensor)
– 平台: エンティティがどのように統合されているかを示すもの (例: hue、mqtt、zwave)
– 唯一ID: エンティティをグローバルに識別するためのID
– 状態: エンティティの現在の状態
– 属性: エンティティに関する追加情報
唯一ID は、エンティティをグローバルに識別するために使用されます。これは、異なるデバイスや異なるHAインスタンス間でエンティティを一致させるために使用されます。唯一IDは、以下のルールに従って生成されます。
– すべてのエンティティは、唯一ID を持たなければならない。
– 唯一ID は、ユーザーによって変更することはできない。
– 唯一ID は、グローバルに一意でなければならない。
– 唯一ID は、不変でなければならない。
一般的には、MACアドレスが 唯一ID として使用されます。
エンティティID は、HA内でエンティティを参照するために使用されます。エンティティIDは、以下の形式で生成されます。
– `{domain}.{platform}.{unique_id}`
例えば、`light.hue_light_1` というエンティティIDは、以下の意味になります。
– ドメイン: light
– プラットフォーム: hue
– 唯一ID: 1
エンティティ と エンティティレジストリ は、HAを理解するために重要な概念です。これらの概念を理解することで、HAをより有効活用することができます。
