moat-dev-heat 0.1.0__tar.gz

moat_dev_heat-0.1.0/LICENSE.txt

@@ -0,0 +1,14 @@
+The code in this repository, and all MoaT submodules it refers to,
+is part of the MoaT project.
+
+Unless a submodule's LICENSE.txt states otherwise, all included files are
+licensed under the LGPL V3, as published by the FSF at
+https://www.gnu.org/licenses/lgpl-3.0.html .
+
+In addition to the LGPL's terms, the author(s) respectfully ask all users of
+this code to contribute any bug fixes or enhancements. Also, please link back to
+https://M-o-a-T.org.
+
+Thank you.
+
+Copyright © 2021 ff.: the MoaT contributor(s), as per the git changelog(s).

moat_dev_heat-0.1.0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: moat-dev-heat
+Version: 0.1.0
+Summary: REPLACE ME
+Author-email: Matthias Urlichs <matthias@urlichs.de>
+Project-URL: homepage, https://m-o-a-t.org
+Project-URL: repository, https://github.com/M-o-a-T/moat
+Keywords: MoaT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AnyIO
+Classifier: Framework :: Trio
+Classifier: Framework :: AsyncIO
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: anyio~=3.0
+Dynamic: license-file
+
+This is a home heating controller.
+
+Currently it's a personal project that controls a Solvis controller, buffer,
+and heat pump, and a KWB pellet burner, in dual/alternate mode, though the
+result is intended to be somewhat more generic.
+

moat_dev_heat-0.1.0/README.md

@@ -0,0 +1,6 @@
+This is a home heating controller.
+
+Currently it's a personal project that controls a Solvis controller, buffer,
+and heat pump, and a KWB pellet burner, in dual/alternate mode, though the
+result is intended to be somewhat more generic.
+

moat_dev_heat-0.1.0/moat/dev/heat/__init__.py

@@ -0,0 +1,4 @@
+# noqa:D104 pylint: disable=missing-module-docstring
+from __future__ import annotations
+
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

moat_dev_heat-0.1.0/moat/dev/heat/_main.py

@@ -0,0 +1,21 @@
+"""
+Basic heater tool support
+
+"""
+
+from __future__ import annotations
+
+import logging  # pylint: disable=wrong-import-position
+
+import asyncclick as click
+
+from moat.util import load_subgroup
+
+log = logging.getLogger()
+
+
+@load_subgroup(prefix="moat.dev.heat")
+@click.pass_obj
+async def cli(obj):
+    """Device Manager for heaters"""
+    obj  # noqa:B018  pylint: disable=pointless-statement  # TODO

moat_dev_heat-0.1.0/moat/dev/heat/kwb.py

@@ -0,0 +1,108 @@
+"""
+command line interface thing for KWB pellet burner
+"""
+
+from __future__ import annotations
+
+import anyio
+import logging
+
+import asyncclick as click
+
+from moat.util import yload
+from moat.modbus.dev.poll import dev_poll
+
+logger = logging.getLogger()
+
+
+async def lifeticker(dest):
+    "Task to periodically update the lifeticker modbus var"
+    t_out = dest.regs.ksm.modbus.lifetick
+    t_in = dest.regs.ksm.modbus.commit_lifetick
+
+    t_out.value = 0
+    v_old = t_in.value
+    n_old = 0
+
+    while True:
+        for n in range(1, 65535):
+            t_out.value = n
+            await anyio.sleep(45)
+
+            if t_in.value != v_old:
+                v_old = t_in.value
+                n_old = 0
+            elif n_old > 2:
+                raise RuntimeError("No commit_lifetick change")
+            else:
+                n_old += 1
+
+
+@click.command(short_help="Access the KWB modbus.")  # pylint: disable=undefined-variable
+@click.option("-c", "--cfg", type=click.File("r"), help="Moat-Modbus configuration", required=True)
+@click.option("-h", "--host", help="Host to access")
+@click.option("-p", "--port", type=int, help="Port to access")
+@click.option("-u", "--unit", type=int, help="Unit to access")
+@click.pass_context
+async def cli(ctx, cfg, host, port, unit):
+    """
+    This command starts a Modbus client that connects to a KWB EasyFire pellet burner.
+
+    It will send Lifetick updates.
+
+    By default this command talks to all hosts with a `regs.modbus.lifetick` register.
+    (DO NOT set `regs.modbus.lifetick` to mirror from anywhere.)
+
+    """
+
+    cfg = yload(cfg, attr=True)
+
+    obj = ctx.obj
+    if "distkv" in obj.cfg:
+        # pylint: disable=import-outside-toplevel
+        from distkv.client import client_scope
+
+        dkv = await client_scope(**obj.cfg.distkv)
+    else:
+        dkv = None
+
+    n = 0
+
+    def get_one(d, h):
+        if h is None:
+            yield from d.values()
+        elif h in d:
+            yield d[h]
+
+    async with anyio.create_task_group() as tg:
+        cfg = await tg.start(dev_poll, cfg, dkv)
+
+        def proc(dest):
+            try:
+                dest.regs.ksm.modbus.lifetick  # noqa:B018 pylint: disable=pointless-statement
+            except AttributeError:
+                return
+            tg.start_soon(lifeticker, dest)
+
+            nonlocal n
+            n += 1
+
+        for h in get_one(cfg.get("hostports", {}), host):
+            for p in get_one(h, port):
+                for dest in get_one(p, unit):
+                    proc(dest)
+
+        if port is None or port == 502:
+            for h in get_one(cfg.get("hosts", {}), host):
+                for dest in get_one(h, unit):
+                    proc(dest)
+
+        if n:
+            # found a KWB system. Possibly do some work here.
+            pass  # will sleep here, because dev_poll and lifeticker continue to run
+
+        else:
+            # did not find a KWB system. Stop.
+            tg.cancel_scope.cancel()
+
+    raise RuntimeError("No matching servers found")