Skip to content

Add more registers #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jktjkt wants to merge 3 commits into
base: develop
Choose a base branch
from
Open

Add more registers #11

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
205b823
Add more registers from a KWM2231 water meter
jktjkt Apr 22, 2026
4bcc1a4
Add proper names to some previously seen registers
jktjkt Apr 22, 2026
35b0cb2
Add registers from the log readout of a KWM2231
jktjkt Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 77 additions & 5 deletions src/pykmp/constants.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,12 +98,39 @@
234: "l/imp for VA",
235: "l/imp for VB",
239: "Volume V1 hires",
241: "MaxFlow_D",
242: "MinFlow_D",
243: "Reverse flow V1",
254: "Type no",
257: "Pulse value V1",
258: "Pulse value V2",
268: "Q\N{LATIN SUBSCRIPT SMALL LETTER P} averaging time",
# Undocumented (259 and 260), but it matches the info given by Multical 603 in the
# diagnostics display
259: "Nominal Q\N{LATIN SUBSCRIPT SMALL LETTER P} V1",
260: "Nominal Q\N{LATIN SUBSCRIPT SMALL LETTER P} V2",
266: "E1HighRes",
267: "Cooling energy E3 hires",
279: "DIN meter ID",
292: "Water temperature",
# FIXME(jkt): Uncertain order (293-295), check them in May 2026 when a first "valid" log entry is made
293: "Min water temperature monthly",
294: "Max water temperature monthly",
295: "Avg water temperature monthly",
296: "Min water temperature daily",
297: "Max water temperature daily",
298: "Avg water temperature daily",
299: "Meter temperature",
300: "Min meter temperature monthly",
301: "Max meter temperature monthly",
302: "Avg meter temperature monthly",
303: "Min meter temperature daily",
304: "Max meter temperature daily",
305: "Avg meter temperature daily",
# Documentation for 327-330 doesn't match what a KWM2231 water meter is sending
327: "Target date 1",
328: "Target date 2",
338: "Data quality",
346: "Module SW rev",
347: "Customer number",
348: "Date and Time", # TODO: unknown unit 79, 28591984415535
Expand All @@ -122,17 +149,29 @@
381: "T1 time average hour",
382: "T2 time average hour",
383: "Flow V1 max year date",
# 384: something similar as 383?
384: "Flow V1 min year date",
385: "Power max year date",
# 386: something similar as 385?
386: "Power min year date",
387: "Flow V1 max month date",
# 388: something similar as 387?
388: "Flow V1 min month date",
389: "Power max month date",
# 390: something similar as 389?
390: "Power min month time",
Copy link
Copy Markdown
Owner

@gertvdijk gertvdijk Apr 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this actually time and not date? the other ones in the series are all 'date'

Copy link
Copy Markdown
Contributor Author

@jktjkt jktjkt Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sorry, "date" (it's a timestamp with date & time, same as all the other values)

394: "Config XYZ",
398: "T1 actual (one decimal)",
399: "T2 actual (one decimal)",
400: "T1-T2 (one decimal)", # Undocumented, but appears as such on Multical 603
400: "T1-T2 (one decimal)",
404: "Meter Type",
# register 409: a combination of a bitfield and some duration tracking. Example values:
# 17184063489: dry 1-8 hrs, meter temperature too high: 9-24 hrs, no consumption: 9-24 hrs
# 17181966337: dry 1-8 hrs, meter temperature too high: 1-8 hrs, no consumption: 9-24 hrs
# 17179869185: dry 1-8 hrs, no consumption: 9-24 hrs
# 8589934593: dry 1-8 hrs, no consumption: 1-8 hrs
409: "Info hour counter",
440: "MaxFlow_H",
445: "MaxFlowDate_D",
446: "MinFlowDate_D",
# Seen in the logger. E.g. 128 is "meter temperature too high"
458: "Info code",
473: "Energy E10",
474: "Energy E11",
477: "T3 time average day",
Expand All @@ -141,8 +180,41 @@
506: "P2 average day",
507: "P1 average hour",
508: "P2 average hour",
# Undocumented, but it "looks good" on a fresh meter from 2026
582: "Maybe battery remaining",
Copy link
Copy Markdown
Owner

@gertvdijk gertvdijk Apr 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer not to have the "maybe" part of the display name.

Also, depends on the unit here, but if this is a relative number or percentage, perhaps call it "Battery SoC" or "Battery capacity remaining".

Copy link
Copy Markdown
Contributor Author

@jktjkt jktjkt Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On KWM2231, it looks like a number of remaining days of battery life. On a Multical 303, there's no such register :(, and I don't have access to any other battery-operated Kamstrup meters.

583: "Accoustic noise last day",
Copy link
Copy Markdown
Owner

@gertvdijk gertvdijk Apr 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
583: "Accoustic noise last day",
583: "Acoustic noise last day",

622: "V1 extra digit",
# Undocumented, e.g., KWM2231
640: "Meter type text",
# Undocumented, but it matches the actual interval on Multical 303
675: "wM-Bus transmission interval",
# Undocumented (692-721), but it looks like a histogram readout
692: "Volume in flow bucket 1",
697: "Volume in flow bucket 2",
698: "Volume in flow bucket 3",
699: "Volume in flow bucket 4",
700: "Volume in flow bucket 5",
701: "Volume in flow bucket 6",
702: "Volume in flow bucket 7",
703: "Volume in flow bucket 8",
704: "Volume in flow bucket 9",
705: "Volume in flow bucket 10",
706: "Volume in flow bucket 11",
707: "Volume in flow bucket 12",
708: "Volume in flow bucket 13",
709: "Flow bucket 1",
710: "Flow bucket 2",
711: "Flow bucket 3",
712: "Flow bucket 4",
713: "Flow bucket 5",
714: "Flow bucket 6",
715: "Flow bucket 7",
716: "Flow bucket 8",
717: "Flow bucket 9",
718: "Flow bucket 10",
719: "Flow bucket 11",
720: "Flow bucket 12",
721: "Flow bucket 13",
1001: "Fabrication No",
1002: "Time",
1003: "Date",
Expand Down