From c76eb006e43ab3bbb9398c410b64080ccb26d1f9 Mon Sep 17 00:00:00 2001 From: Kristof Lemmens Date: Sun, 25 Oct 2026 13:02:06 +0000 Subject: [PATCH 1/2] docs: record field confirmations in the errata The LSB-first order of the electric meter kWh total (input 83-84) is confirmed on a Calibra with an EM340 meter, so the row drops "to be verified". Holding 118 reads 20000 until a BMS writes it, and a written value takes effect only when holding 117 selects the BMS. Co-Authored-By: Claude Opus 5.5 --- docs/errata.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/errata.md b/docs/errata.md index 16aa04b..68491cc 100644 --- a/docs/errata.md +++ b/docs/errata.md @@ -20,7 +20,7 @@ field report from another pump. | Input registers 119–120 "Pool supply/return line temperature (EM)" | Listed in chapter 8 only, not in chapter 3 (holding 119–120 are different registers). The reference pump has no pool: both read 20000. | Mapped from chapter 8. | | Holding register 58 "Pool charge set point (EM)" | Unit `°C` in chapter 8, `%` in chapter 3. The reference pump, which has no pool, reads 2600: 26.00, a typical pool temperature. | `°C` (chapter 8, supported by the dump), with `nan=ABSENT_SENSOR` like the other temperatures. To be verified on a pump with a pool. | | Input registers 78–80 "Electric meter L1/L2/L3 power (W)" | The document doesn't say whether the power can be negative. The meter needs the current limiter, which measures the house connection, so a house that exports (for example with solar panels) may report negative power. The reference pump has no meter. | Signed, so export reads as negative watts instead of about 65000 W; a phase of a house connection stays far below 32767 W. To be verified on a pump with a meter and solar panels. | -| Input registers 83–84 "Electric meter kWh total" | LSB listed before MSB, the reverse of every other 32-bit pair. The reference pump has no electric meter (both read 0), so its dump cannot confirm the order. | LSB first, as documented. To be verified on a pump with an electric meter. | +| Input registers 83–84 "Electric meter kWh total" | LSB listed before MSB, the reverse of every other 32-bit pair. The reference pump has no electric meter (both read 0), but LSB first at scale 10 is confirmed on a Calibra with firmware 16.00 and a Carlo Gavazzi EM340 meter (CJNE/thermiagenesis#292, fixed in CJNE/pythermiagenesis#3). | LSB first, as documented. | ## Document-wide @@ -38,5 +38,5 @@ Observed on the reference pump (firmware 17.1.11); the protocol document does no | --------- | --------- | -------- | | Temperature input registers (scale 100) | A sensor the pump doesn't have reads 20000 (200.00 °C), with no sensor alarm. The reference pump reads it on 12, 27, 40 and 41 (system supply, system return, mix valve 1 supply, buffer tank) while 106 (cooling supply, passive cooling enabled) reads 2224. | 20000 decodes as no value (`nan=ABSENT_SENSOR`). | | Input register 121 "Room temperature sensor" (scale 10) | A pump without a room sensor reads 2000 (200.0 °C), the scale-10 form of the 20000 above: reported for a Calibra 7 (CJNE/thermiagenesis#268) and by pg-andersson/pgart_t ("the temperature value will be 200"). The reference pump has a room sensor (input 121 reads 229, 22.9 °C, which confirms scale 10); its undocumented inputs 325–328 and 412 read 2000. | 2000 decodes as no value (`nan=ABSENT_SENSOR_AT_SCALE_10`), as for every °C register at scale 10. | -| Holding register 118 "Outdoor temperature sensor" | Reads 20000 (200.00 °C) when no BMS provides the outdoor temperature (register 117 is 0). | Decodes as no value (`nan=ABSENT_SENSOR`), like an absent sensor. | +| Holding register 118 "Outdoor temperature sensor" | Reads 20000 (200.00 °C) until a BMS writes it (the reference pump reads 117 = 0, 118 = 20000). A written value takes effect only when holding 117 selects the BMS (infradom/thermia-genesis-calibra-modbus-hints#1), and per its description in chapters 3 and 4 the pump falls back to its own sensor when 118 isn't refreshed within 12 hours. | Decodes as no value (`nan=ABSENT_SENSOR`), like an absent sensor. | | Addresses chapter 3 doesn't list | Every address up to at least 5000 answers in all four spaces: undocumented ones read 0 or `False` (input 28, 999 and 5000, holding 999 and 5000, coils and discrete inputs 999 and 5000), except input 14. It reads like the outdoor temperature (input 13): 1150 next to 1170 earlier, 947 next to 947 in three reads on 2026-10-24, and 1425 next to 1425 on 2026-10-25 while the display showed one outdoor temperature, so it is probably the filtered outdoor temperature (holding 118 says the pump filters it). It is not mapped. Only far outside the map (65000) does the pump raise an illegal-address exception. | Not relied on: the library reads only mapped addresses. Missing subsystems are detected from their Enable coils, not from exceptions. | From 4f60d5954b645a422c9196b94b6d7082ed7cdd05 Mon Sep 17 00:00:00 2001 From: Kristof Lemmens Date: Sun, 25 Oct 2026 13:12:29 +0000 Subject: [PATCH 2/2] docs: describe the meter evidence as a field report, still to be verified No correct kWh reading after the switch to LSB first has been reported, so the order stays to be verified on a pump with an electric meter. Co-Authored-By: Claude Opus 5.5 --- docs/errata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/errata.md b/docs/errata.md index 68491cc..bb84d22 100644 --- a/docs/errata.md +++ b/docs/errata.md @@ -20,7 +20,7 @@ field report from another pump. | Input registers 119–120 "Pool supply/return line temperature (EM)" | Listed in chapter 8 only, not in chapter 3 (holding 119–120 are different registers). The reference pump has no pool: both read 20000. | Mapped from chapter 8. | | Holding register 58 "Pool charge set point (EM)" | Unit `°C` in chapter 8, `%` in chapter 3. The reference pump, which has no pool, reads 2600: 26.00, a typical pool temperature. | `°C` (chapter 8, supported by the dump), with `nan=ABSENT_SENSOR` like the other temperatures. To be verified on a pump with a pool. | | Input registers 78–80 "Electric meter L1/L2/L3 power (W)" | The document doesn't say whether the power can be negative. The meter needs the current limiter, which measures the house connection, so a house that exports (for example with solar panels) may report negative power. The reference pump has no meter. | Signed, so export reads as negative watts instead of about 65000 W; a phase of a house connection stays far below 32767 W. To be verified on a pump with a meter and solar panels. | -| Input registers 83–84 "Electric meter kWh total" | LSB listed before MSB, the reverse of every other 32-bit pair. The reference pump has no electric meter (both read 0), but LSB first at scale 10 is confirmed on a Calibra with firmware 16.00 and a Carlo Gavazzi EM340 meter (CJNE/thermiagenesis#292, fixed in CJNE/pythermiagenesis#3). | LSB first, as documented. | +| Input registers 83–84 "Electric meter kWh total" | LSB listed before MSB, the reverse of every other 32-bit pair. The reference pump has no electric meter (both read 0). Field report: users of another integration saw wrong kWh totals while it read MSB first (CJNE/thermiagenesis#292; a Calibra, firmware 16.00 per a later comment), and pythermiagenesis switched to LSB first at scale 10 (CJNE/pythermiagenesis#3), but no correct reading after that switch has been reported. | LSB first, as documented. To be verified on a pump with an electric meter (17.1). | ## Document-wide