homebridge-echonet-lite-plus 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.7.2
+
+- Clarified how HEMS commonly uses ECHONET Lite and why some HEMS-compatible devices may be discoverable by this plugin.
+- Documented that standard ECHONET Lite air-conditioner temperature control uses 1°C steps, while manufacturer-specific local APIs may support 0.5°C.
+- Rejected fractional numeric writes that an ECHONET property schema cannot represent instead of silently rounding them.
+
 ## 0.7.1
 
 - Added a bilingual `NOTICE-MRA.md` identifying the ECHONET Consortium as the copyright holder and documenting the source of the bundled MRA data.

package/README.md

@@ -8,6 +8,18 @@ ECHONET ConsortiumのMachine Readable Appendix Version 1.4.0を同梱し、EPC
 
 MRAデータの著作権はエコーネットコンソーシアムに帰属します。出典およびライセンス適用範囲の詳細は、同梱の[NOTICE-MRA.md](NOTICE-MRA.md)を参照してください。本プラグインのMITライセンスはMRAデータの著作権、ライセンスその他の条件を変更するものではありません。
 
+## HEMSとECHONET Liteの関係
+
+HEMS（Home Energy Management System）は、家庭内の電力・発電量・ガス・水道などを見える化し、家電や住宅設備を管理・制御するシステムです。
+
+ECHONET Liteは、HEMSを構成するコントローラーと、エアコン、照明、給湯器、分電盤などの機器が通信するために広く利用されている共通規格です。そのため、ECHONET Liteという名称を意識していなくても、ご自宅にある「HEMS対応機器」がECHONET Lite対応機器である場合があります。
+
+本プラグインは、LAN内のECHONET Lite対応機器と直接通信し、対応する機能をHomebridge／Appleホームへ橋渡しします。メーカーがApple HomeやHomeKitへ直接対応していないHEMS対応機器でも、ECHONET Liteで通信できる場合は、本プラグインから検出・操作できる可能性があります。
+
+ECHONET Liteの利用先はHEMSだけに限定されません。家電制御、住宅設備管理、セキュリティ、見守りなどにも利用されています。また、本プラグインはECHONET Liteによる機器通信を扱うものであり、エネルギー最適化、料金計算、需要予測などを行うHEMSそのものではありません。
+
+なお、HEMS対応と表示されているすべての機器を操作できるとは限りません。ネットワークへの接続方法、メーカー独自の制限、機器が公開しているECHONET Liteプロパティ、HomeKitで表現可能な機能などによって対応範囲が異なります。
+
 ## 動作要件とインストール
 
 - Node.js 18以降
@@ -62,6 +74,12 @@ Appleのホームアプリには電力・発電量・EV残量・水道・ガス
 
 ECHONET Liteとして存在していても、HomeKit上で安全かつ自然に表現できない機器クラスは検出一覧にのみ表示し、対応マッピングを実装するまでHomeKitへは公開しません。
 
+### エアコンの設定温度単位
+
+本Standalone版は、家庭用エアコンの標準ECHONET Liteプロパティ「温度設定値」（EPC `B3`）に合わせ、設定温度を1℃単位で扱います。EPC `B3`では0.5℃を表現できないため、Appleホーム上で0.5℃単位を選択できるようにしても、その値を標準ECHONET Lite通信でそのまま実機へ送ることはできません。
+
+Engine Plus構成のメーカー別プラグインでは、メーカーが提供する対応ローカルAPIなど、0.5℃を表現できる別の操作経路が設定されている場合に限り、0.5℃単位へ対応することがあります。標準ECHONET Lite通信へフォールバックする場合は1℃単位です。
+
 ## 構成
 
 HomebridgeをECHONET Lite機器と同じLANで動かし、設定画面で自動探索を有効にします。複数NIC環境では対象ネットワークを指定してください。

package/dist/mra.js

@@ -45,7 +45,13 @@ class MraRepository {
             if (typeof value === 'number' && Number.isFinite(value)) {
                 for (const number of this.schemasOfType(schema, 'number')) {
                     const multiple = number.multiple ?? 1, size = this.sizeOf(number.format), signed = number.format?.startsWith('int') ?? false;
-                    const n = Math.round(value / multiple);
+                    const scaled = value / multiple;
+                    // Do not silently round a value that the ECHONET schema cannot
+                    // represent. For example, the standard air-conditioner B3 property
+                    // is an integer Celsius value, so 25.5°C must not become 26°C.
+                    if (!Number.isInteger(scaled))
+                        continue;
+                    const n = scaled;
                     if ((number.minimum !== undefined && n < number.minimum) || (number.maximum !== undefined && n > number.maximum))
                         continue;
                     const min = signed ? -(2 ** (size * 8 - 1)) : 0, max = signed ? 2 ** (size * 8 - 1) - 1 : 2 ** (size * 8) - 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-echonet-lite-plus",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Standalone Homebridge plugin for ECHONET Lite devices",
   "author": "ECHONET Lite Plus contributors",
   "license": "MIT",