Skip to content

Add more registers#11

Open
jktjkt wants to merge 3 commits intogertvdijk:developfrom
jktjkt:wip/register-names
Open

Add more registers#11
jktjkt wants to merge 3 commits intogertvdijk:developfrom
jktjkt:wip/register-names

Conversation

@jktjkt
Copy link
Copy Markdown
Contributor

@jktjkt jktjkt commented Apr 22, 2026

The histogram in particular is a nice feature :). Here's how it looks in the vendor's SW (a few minutes after I captured the packet trace, so some values have changed):

image

And here's the pykmp's output:

[...]
 689 → <unknown reg 689>            = 74260 no unit (number)
 690 → <unknown reg 690>            = 0 no unit (number)
 691 → <unknown reg 691>            = 0.900 l/h
 692 → Volume in flow bucket 1      = 0.250 l
 697 → Volume in flow bucket 2      = 0.000 m³
 698 → Volume in flow bucket 3      = 0.000 m³
 699 → Volume in flow bucket 4      = 0.019 m³
 700 → Volume in flow bucket 5      = 0.023 m³
 701 → Volume in flow bucket 6      = 0.488 m³
 702 → Volume in flow bucket 7      = 0.305 m³
 703 → Volume in flow bucket 8      = 0.000 m³
 704 → Volume in flow bucket 9      = 0.000 m³
 705 → Volume in flow bucket 10     = 0.000 m³
 706 → Volume in flow bucket 11     = 0.000 m³
 707 → Volume in flow bucket 12     = 0.000 m³
 708 → Volume in flow bucket 13     = 0.000 m³
 709 → Flow bucket 1                = 0 l/h
 710 → Flow bucket 2                = 1 l/h
 711 → Flow bucket 3                = 6 l/h
 712 → Flow bucket 4                = 32 l/h
 713 → Flow bucket 5                = 48 l/h
 714 → Flow bucket 6                = 480 l/h
 715 → Flow bucket 7                = 640 l/h
 716 → Flow bucket 8                = 800 l/h
 717 → Flow bucket 9                = 960 l/h
 718 → Flow bucket 10               = 1200 l/h
 719 → Flow bucket 11               = 1600 l/h
 720 → Flow bucket 12               = 2000 l/h
 721 → Flow bucket 13               = 15984 l/h
[...]

Comment thread src/pykmp/constants.py
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

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

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)

Comment thread src/pykmp/constants.py
508: "P2 average hour",
# Undocumented, but it "looks good" on a fresh meter from 2026
582: "Maybe battery remaining",
583: "Accoustic noise last day",
Copy link
Copy Markdown
Owner

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",

Comment thread src/pykmp/constants.py
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

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

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.

@gertvdijk
Copy link
Copy Markdown
Owner

This is another huge update, cool, thanks so much!

I've reworked the git commits a bit cleaner in develop...pr-11-reworked-a-bit-wip. PTAL if you are OK with this.

My suggestion would be to use the pr-11-reworked-a-bit-wip branch as a base, amend further edits in there and then force-push it here, so it's reviewed and merged as your PR.

Once the few concerns above are handled I think it looks good for a release with the massive register/unit catalog update and then we can proceed with the functional changes. 😃

@jktjkt
Copy link
Copy Markdown
Contributor Author

jktjkt commented Apr 28, 2026

I've reworked the git commits a bit cleaner in develop...pr-11-reworked-a-bit-wip. PTAL if you are OK with this.

Looks good to me.

Maybe change 640: "Meter type text" to "water meter type" because it's only present on my KWM2231, but not on MC303. On MC303 though, there's something that I call 676: "Heat meter type text" because it returns, well, MC303 on that meter. Not sure if these is worth documenting...

I'll drop you a mail with some of these readouts so that you can decide which ones to pick and which to ignore.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants