identity

Author: kellerza

.DS_Store

@@ -17,10 +17,10 @@ to work in this repository.
 
 ## Current rule files (index)
 
-| Path | Typical scope | Topic |
-| ------ | ---------------- | -------- |
-| `.cursor/rules/sunsynk-addons.mdc` | Home Assistant add-ons, add-on Python (`src/ha_addon_sunsynk_multi/`), `www/docs/reference/multi-options.md` | Edit **`hass-addon-sunsynk-edge/`** for packaging; do not hand-edit **`hass-addon-sunsynk-multi/`** unless the user explicitly asks for stable-multi work; keep Supervisor options, docs, and `options.py` in sync as described in the rule. |
-| `.cursor/rules/sunsynk-definitions.mdc` | `src/sunsynk/definitions/**` | Inverter Modbus definitions: profiles, inheritance, single- vs three-phase; how to extend `ALL_DEFS` and avoid wrong cross-profile register assumptions. |
+| Path                                    | Typical scope                                                                                                | Topic                                                                                                                                                                                                                                        |
+| --------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `.cursor/rules/sunsynk-addons.mdc`      | Home Assistant add-ons, add-on Python (`src/ha_addon_sunsynk_multi/`), `www/docs/reference/multi-options.md` | Edit **`hass-addon-sunsynk-edge/`** for packaging; do not hand-edit **`hass-addon-sunsynk-multi/`** unless the user explicitly asks for stable-multi work; keep Supervisor options, docs, and `options.py` in sync as described in the rule. |
+| `.cursor/rules/sunsynk-definitions.mdc` | `src/sunsynk/definitions/**`                                                                                 | Inverter Modbus definitions: profiles, inheritance, single- vs three-phase; how to extend `ALL_DEFS` and avoid wrong cross-profile register assumptions.                                                                                     |
 
 If this index drifts, **trust the `.mdc` files**; update this table when you add or rename rules.
 

.github/copilot-instructions.md

@@ -1,3 +1,7 @@
+# Graphify output
+graphify-out/cost.json      # local only
+graphify-out/cache          # optional: commit for speed, skip to keep repo small
+
 # private/local config
 hass-addon-sunsynk-edge/sunsynk
 hass-addon-sunsynk-edge/VERSION
@@ -39,6 +43,3 @@ share/python-wheels/
 *.egg-info/
 .installed.cfg
 *.egg
-MANIFEST
-
-.DS_store

.gitignore

@@ -66,16 +66,16 @@ Two libraries means two decode paths until v1 is deleted. The decode is the prod
 
 ## Modelling mismatch
 
-| | sunsynk `Sensor` | `modbus_connection.model` field |
-| --- | --- | --- |
-| Address | tuple of **arbitrary** registers | one start + **consecutive** `count` |
-| Layout | instances in a dict, subset chosen at runtime | class attributes, plan cached on first update |
-| 32-bit | `Sensor16((633, 691), …)` — two far-apart regs, stateful 16/32 heuristic | `uint32(n)` = registers `n` and `n+1`, stateless codec |
-| Combine | `MathSensor((175, 169, 166), factors=(1, 1, -1))` | `@property` over other fields |
-| Packed bits | `bitmask=` + read-modify-write | `bit` / `bits` / `flags` (this part is **better**) |
-| Word order | always little (`<h` / `<2H`) | default **big**; would need `word_order="little"` everywhere |
-| Writes | FC16 even for one register | FC06 unless `force_fc16=True` |
-| Cache | raw regs + decoded values + history + `onchange` | last decoded value on the component |
+|             | sunsynk `Sensor`                                                         | `modbus_connection.model` field                              |
+| ----------- | ------------------------------------------------------------------------ | ------------------------------------------------------------ |
+| Address     | tuple of **arbitrary** registers                                         | one start + **consecutive** `count`                          |
+| Layout      | instances in a dict, subset chosen at runtime                            | class attributes, plan cached on first update                |
+| 32-bit      | `Sensor16((633, 691), …)` — two far-apart regs, stateful 16/32 heuristic | `uint32(n)` = registers `n` and `n+1`, stateless codec       |
+| Combine     | `MathSensor((175, 169, 166), factors=(1, 1, -1))`                        | `@property` over other fields                                |
+| Packed bits | `bitmask=` + read-modify-write                                           | `bit` / `bits` / `flags` (this part is **better**)           |
+| Word order  | always little (`<h` / `<2H`)                                             | default **big**; would need `word_order="little"` everywhere |
+| Writes      | FC16 even for one register                                               | FC06 unless `force_fc16=True`                                |
+| Cache       | raw regs + decoded values + history + `onchange`                         | last decoded value on the component                          |
 
 `Sensor16` and `MathSensor` block a straight rewrite. A `Component` field cannot be “registers 633
 and 691”. You would split them into two integers plus a stateful `@property` — and that state (last
@@ -123,12 +123,12 @@ Two inverters on one adapter: one connection, two units — no swapping `server_
 
 ## What stays in sunsynk
 
-| Keep | Why |
-| --- | --- |
-| `Sensor` / definitions / `mysensors.py` | Public API and the Deye map |
-| `group_sensors` | Same job as Component `max_gap` / `max_span`, but over a dynamic subset |
-| `InverterState` | Raw regs for bitmask writes; history for MQTT; `onchange` for discovery; RW dependencies |
-| Schedules / MQTT | Application layer; Component `_values` is only “last poll” |
+| Keep                                    | Why                                                                                      |
+| --------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `Sensor` / definitions / `mysensors.py` | Public API and the Deye map                                                              |
+| `group_sensors`                         | Same job as Component `max_gap` / `max_span`, but over a dynamic subset                  |
+| `InverterState`                         | Raw regs for bitmask writes; history for MQTT; `onchange` for discovery; RW dependencies |
+| Schedules / MQTT                        | Application layer; Component `_values` is only “last poll”                               |
 
 ## If Components come later
 
@@ -139,6 +139,9 @@ the source of truth and keep `Sensor` as the HA/mysensors view.
 `MathSensor` / `Sensor16` / `FaultSensor` / `SystemTimeRWSensor` stay as properties or custom
 converters. Do not migrate decode and transport at once.
 
+Identity (regs 0–7: device type, protocol, serial) is already a `Component`
+(`sunsynk.identity.Identity`); scheduled polls stay on `Sensor` + `group_sensors`.
+
 ## Sequence
 
 1. `Sunsynk` holds a `HoldingUnit`; I/O delegates; FC16 stays.

MANIFEST.in

@@ -1,31 +1,31 @@
 {
-  "0": "utils/__init__.py",
+  "0": "SensorDefinitions",
   "1": "package.json",
-  "2": "sunsynk.py",
+  "2": ".read_sensors",
   "3": "Adaptors & Wiring",
   "4": "sensors.py",
   "5": "Sunsynk",
   "6": "compilerOptions",
-  "7": "test_a_inverter.py",
-  "8": "BinarySensor",
+  "7": "sensor_options.py",
+  "8": "Sensor",
   "9": "RegType",
   "10": "percentile",
-  "11": "a_inverter.py",
+  "11": "timer_schedule.py",
   "12": "__main__.py",
   "13": "HoldingUnit",
-  "14": "RWSensor",
-  "15": "RegType",
-  "16": "Sensor",
+  "14": "ModbusUnit underlay",
+  "15": "RWSensor",
+  "16": "ToggleLogCallback",
   "17": "SolarmanUnit",
   "18": "ASensor",
-  "19": "test_connection.py",
-  "20": "test_sunsynk.py",
-  "21": "AInverter",
+  "19": "sunsynk.py",
+  "20": "NumberRWSensor",
+  "21": "Architecture: modbus-connection and sunsynk",
   "22": ".get",
   "23": "test_helpers.py",
   "24": "Groups of sensors",
   "25": "InverterState",
-  "26": ".read_sensors",
+  "26": "Identity",
   "27": "definitions.md",
   "28": "ensure_tuple",
   "29": "tests/conftest.py",
@@ -36,7 +36,7 @@
   "34": "Configuration",
   "35": "Single-phase register backfill (proposal)",
   "36": "Unreleased",
-  "37": "NumberRWSensor",
+  "37": "int_round",
   "38": "test_options.py",
   "39": "Inverter Automation",
   "40": "Deye/Sunsynk Inverters",
@@ -49,15 +49,15 @@
   "47": "build_prep.sh",
   "48": "Sunsynk — align with Cursor rules",
   "49": "Issue related to the Python sunsynk library",
-  "50": ".value_to_reg",
+  "50": "AInverter",
   "51": "types.d.ts",
   "52": "Sunsynk User Documentation",
   "53": "Your environment",
   "54": "test_sensor_options.py",
   "55": "test_versions.py",
   "56": "Modbus TCP to Modbus RTU Gateway Add-on",
-  "57": "ToggleLogCallback",
-  "58": "Time",
+  "57": ".publish",
+  "58": "ensure_str",
   "59": "json_view.vue",
   "60": "run.sh",
   "61": "hass-addon-sunsynk-edge/DOCS.md",
@@ -80,9 +80,7 @@
   "78": ".eslintrc.js",
   "79": "copy2local.sh",
   "80": ".create_entity",
-  "81": ".reg_to_value",
-  "82": ".publish",
-  "83": "as_num",
-  "84": "src/ha_addon_sunsynk_multi/__init__.py",
-  "88": "three_phase_common.py"
+  "81": "slug",
+  "83": "hex_str",
+  "84": "src/ha_addon_sunsynk_multi/__init__.py"
 }

docs/modbus-connection.md

@@ -1 +1 @@
-{"0": "5b9e23a8ed845e93", "1": "d7eff289702b5a96", "2": "231a9bc7963820b0", "3": "869f2abe14b8f433", "4": "00eb2a2121871967", "5": "9299608ad508b997", "6": "f732b42942917d95", "7": "a43466836978a0f0", "8": "52a6dcee5bf13c39", "9": "eb95d81a968dd58f", "10": "a1745bd48bc9c400", "11": "bc73166704fe3483", "12": "823ddea8283ed189", "13": "1a67aaa6cb8a773d", "14": "83214d26908bf706", "15": "be821b978c000a33", "16": "c70d3dabbc1212ec", "17": "1a10dcb9a6326da5", "18": "c71bcba8658fe1e0", "19": "3b464bfdb765b6bf", "20": "32020db9747147ff", "21": "52f88a24673d47ed", "22": "3e7ba5a637ec2616", "23": "e3f1e54fee4f7974", "24": "62cb3b589b92b632", "25": "591b8cd772b6658e", "26": "5527b877685edbe0", "27": "889d10a55f518608", "28": "b116de2e8c35d939", "29": "efb3eb460a32a6f2", "30": "4c7b1ac6176ac43f", "31": "40e1b717a00d5720", "32": "9c1f479a3bcd341b", "33": "62b878daf5110c7e", "34": "c7f14ab2ace44244", "35": "92b68165a2cf45e9", "36": "f56eeb0ec6f186b8", "37": "e4ec693244d9be2c", "38": "c1de9d63eeba24c4", "39": "9db7211992a3c63e", "40": "96581cf5de114de1", "41": "0badd1a49fb2a79f", "42": "cb9d34e8318b8eaf", "43": "5b9eff363aa466eb", "44": "09e528f265f0c5ab", "45": "1b6b734b18235303", "46": "880816b24e256dfa", "47": "3eb18500770ce5d5", "48": "594087919fd6a8bf", "49": "6a1b71cfaa02fbe4", "50": "1f3fcd882eef2ae5", "51": "8e91020c75f51e60", "52": "6f85c62bd7407043", "53": "c41d0f8469fb4033", "54": "718fe9b4d9e630e0", "55": "0b0ab091a04e9bbd", "56": "8d0ab5753e1ac6d2", "57": "d40284ea4fdb9344", "58": "7f3a25668f41d6eb", "59": "690532b304f88171", "60": "4d0607b0908e13f3", "61": "3ec2502bc18dc152", "62": "1d486ec4363f3239", "63": "c949b242a690db15", "64": "e8ae0f4946290bf6", "65": "18316c5d24f790ac", "66": "396e4a0815293b67", "67": "4b7e85283b24d2bb", "68": "7fea16a83bf40f41", "69": "3b16499aaf0de712", "70": "8f7839415266b30e", "71": "f59f46a360d37b42", "72": "988bdd5d26ab19f8", "73": "1784db6153045ac1", "74": "8754aeda3c5d62e1", "75": "41e60d101b21e785", "76": "0ea3a21e4cc92283", "77": "b38991a747d1c7fb", "78": "bf4e8f2adf50dbd9", "79": "b2f0b28d1a0427b7", "80": "2cc293e3a09aa9d6", "81": "74ec239edf2a3d98", "82": "c000557f8a3c5b57", "83": "d27c8e33eb3687ae", "84": "0d4a752d9dda280d", "88": "81b00d9c9d22d0a7"}
+{"0": "8b18e54fa772210f", "1": "d7eff289702b5a96", "2": "bea71d73f2763f5e", "3": "869f2abe14b8f433", "4": "c26a5bb33af46529", "5": "04c1585af22b343d", "6": "f732b42942917d95", "7": "1b92b680d32a511f", "8": "619c33e28fe69e1e", "9": "3308159c5944429f", "10": "a1745bd48bc9c400", "11": "047f8218a039dfd3", "12": "cc76b3dee94c460b", "13": "25c515c2acb06404", "14": "31004416107f59f1", "15": "79d51349ccacc62a", "16": "d40284ea4fdb9344", "17": "1a10dcb9a6326da5", "18": "fe3bde5ee3f51074", "19": "3a68886eee63505c", "20": "a30f040b2661dd64", "21": "a9e33aabe228782a", "22": "204bd3688bb79ed6", "23": "153e194ffc8066f7", "24": "62cb3b589b92b632", "25": "ec4bf6df67dc0e57", "26": "83d7bd7cb51237d9", "27": "889d10a55f518608", "28": "a94655012a5293b1", "29": "efb3eb460a32a6f2", "30": "4c7b1ac6176ac43f", "31": "40e1b717a00d5720", "32": "9c1f479a3bcd341b", "33": "62b878daf5110c7e", "34": "c7f14ab2ace44244", "35": "92b68165a2cf45e9", "36": "f56eeb0ec6f186b8", "37": "13c41ba9b905ce5d", "38": "c1de9d63eeba24c4", "39": "9db7211992a3c63e", "40": "96581cf5de114de1", "41": "0badd1a49fb2a79f", "42": "cb9d34e8318b8eaf", "43": "5b9eff363aa466eb", "44": "09e528f265f0c5ab", "45": "1b6b734b18235303", "46": "83736e1d8f464d00", "47": "3eb18500770ce5d5", "48": "594087919fd6a8bf", "49": "6a1b71cfaa02fbe4", "50": "7e9ab709a678603c", "51": "8e91020c75f51e60", "52": "6f85c62bd7407043", "53": "c41d0f8469fb4033", "54": "718fe9b4d9e630e0", "55": "0b0ab091a04e9bbd", "56": "8d0ab5753e1ac6d2", "57": "c000557f8a3c5b57", "58": "ca30820d95603ae5", "59": "690532b304f88171", "60": "4d0607b0908e13f3", "61": "3ec2502bc18dc152", "62": "1d486ec4363f3239", "63": "c949b242a690db15", "64": "e8ae0f4946290bf6", "65": "18316c5d24f790ac", "66": "396e4a0815293b67", "67": "4b7e85283b24d2bb", "68": "7fea16a83bf40f41", "69": "3b16499aaf0de712", "70": "8f7839415266b30e", "71": "f59f46a360d37b42", "72": "988bdd5d26ab19f8", "73": "1784db6153045ac1", "74": "8754aeda3c5d62e1", "75": "41e60d101b21e785", "76": "0ea3a21e4cc92283", "77": "b38991a747d1c7fb", "78": "bf4e8f2adf50dbd9", "79": "b2f0b28d1a0427b7", "80": "2cc293e3a09aa9d6", "81": "5eac985353be60ac", "83": "1b4ca02d1383c760", "84": "0d4a752d9dda280d"}

graphify-out/.graphify_labels.json

@@ -0,0 +1,86 @@
+{
+  "0": "SensorDefinitions",
+  "1": "package.json",
+  "2": ".read_sensors",
+  "3": "Adaptors & Wiring",
+  "4": "sensors.py",
+  "5": "Sunsynk",
+  "6": "compilerOptions",
+  "7": "sensor_options.py",
+  "8": "Sensor",
+  "9": "RegType",
+  "10": "percentile",
+  "11": "timer_schedule.py",
+  "12": "__main__.py",
+  "13": "HoldingUnit",
+  "14": "ModbusUnit underlay",
+  "15": "RWSensor",
+  "16": "ToggleLogCallback",
+  "17": "SolarmanUnit",
+  "18": "ASensor",
+  "19": "sunsynk.py",
+  "20": "NumberRWSensor",
+  "21": "Architecture: modbus-connection and sunsynk",
+  "22": ".get",
+  "23": "test_helpers.py",
+  "24": "Groups of sensors",
+  "25": "InverterState",
+  "26": "Identity",
+  "27": "definitions.md",
+  "28": "ensure_tuple",
+  "29": "tests/conftest.py",
+  "30": "Run standalone using docker compose",
+  "31": "Sensors",
+  "32": ".significant_change",
+  "33": "Available addons",
+  "34": "Configuration",
+  "35": "Single-phase register backfill (proposal)",
+  "36": "Unreleased",
+  "37": "int_round",
+  "38": "test_options.py",
+  "39": "Inverter Automation",
+  "40": "Deye/Sunsynk Inverters",
+  "41": ".reg_value",
+  "42": "multi-options.md",
+  "43": "Schedules",
+  "44": "Issue related to",
+  "45": "Deye/Sunsynk Inverters",
+  "46": "_reset_near_realtime",
+  "47": "build_prep.sh",
+  "48": "Sunsynk — align with Cursor rules",
+  "49": "Issue related to the Python sunsynk library",
+  "50": "AInverter",
+  "51": "types.d.ts",
+  "52": "Sunsynk User Documentation",
+  "53": "Your environment",
+  "54": "test_sensor_options.py",
+  "55": "test_versions.py",
+  "56": "Modbus TCP to Modbus RTU Gateway Add-on",
+  "57": ".publish",
+  "58": "ensure_str",
+  "59": "json_view.vue",
+  "60": "run.sh",
+  "61": "hass-addon-sunsynk-edge/DOCS.md",
+  "62": "hass-addon-sunsynk-edge/README.md",
+  "63": "hass-addon-sunsynk-multi/CHANGELOG.md",
+  "64": "hass-addon-sunsynk-multi/DOCS.md",
+  "65": "hass-addon-sunsynk-multi/README.md",
+  "66": "tests/README.md",
+  "67": "templates.md",
+  "68": "build_sitemap.js",
+  "69": "index.ts",
+  "70": "NearRealtime",
+  "71": "tests/ha_addon_sunsynk_multi/__init__.py",
+  "72": "tests/__init__.py",
+  "73": "tests/sunsynk/definitions/__init__.py",
+  "74": "tests/sunsynk/__init__.py",
+  "75": "test_zuban.py",
+  "76": "docs/index.md",
+  "77": "config.ts",
+  "78": ".eslintrc.js",
+  "79": "copy2local.sh",
+  "80": ".create_entity",
+  "81": "slug",
+  "83": "hex_str",
+  "84": "src/ha_addon_sunsynk_multi/__init__.py"
+}