Logic module for Gira Homeserver to record and compare counter values. The module records values of a specific counter. If the input counter has an overflow, the module outputs a continuous value.

The module provides counter values for up to three intervals. For each interval, the increase of the counter during the current interval and the increase during the passed interval, is given.

All calculations are performed on Counter = (Counter * Gain) - Offset.

• Recalculation during start: no
• Module is retentive: yes
• Internal designation: 11083
• Category: Meter

• V0.11: Improvement: Refactoring
• V0.10
• v0.9
  • Improvement: Debugging messages
  • Fix: Ignoring 0 counter values
• v0.8
  • Refactoring to HSL2

• none

Please use github issue feature to report bugs or rise feature requests. Questions can be addressed as new threads at the knx-user-forum.de also. There might be discussions and solutions already.

Code and releases are available via github. Stable releases will be available at the knx-user-forum.de download section also.

• Python 2.7.18
  • Install python markdown module (for generating the documentation) python -m pip install markdown
• Python editor PyCharm
• Gira Homeserver Interface Information

1. The module shall output the (increasing) consumptions for all current/active time spans.
2. The module shall output the total consumptions of the previous time spans.
3. The module shall use an increasing counter as input for calculating the consumptions.
4. The module should use a pulse signal input for calculating the consumptions.
5. The start / end of a time span shall be indicated by a 1 on a dedicated input.
6. The module shall accept a gain input to be multiplied with the counter input value.
7. The module shall accept an offset input value to be subtracted from the gained counter input value.
8. The module shall accept a "reset" input, setting all outputs and internal values to 0.
9. The module shall output the global counter respecting gain and offset since the last reset.
10. The module shall deal with an overflow of the input counter by continuing increasing the global counter.
11. If running for the 1st time after setting the module on a logic page, the module shall use the 1st input counter signal as init value to calculate future consumptions.

Calculations are based on a global counter. This counter is first initialised by the first in value received. The global counter is increased by the delta of two ic values received. To calculate the consumption during a time span, the value of the global counter at the beginning of the time span is stored. This value equals the value of the global counter at the end of the previous time span. Consumptions are calculated by subtracting the global counter values stored.

• Unit tests are performed for each requirement.

Copyright 2023 T. Paul

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.