Metadata-Version: 2.4
Name: moat-link-knx
Version: 0.20.1
Summary: KNX bus connector for MoaT-Link
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: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Framework :: AsyncIO
Classifier: Framework :: Trio
Classifier: Framework :: AnyIO
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: anyio~=4.2
Requires-Dist: asyncclick~=8.3
Requires-Dist: attrs
Requires-Dist: moat-util~=0.63.0
Requires-Dist: moat-link~=0.8.0
Requires-Dist: moat-lib-config~=0.2.0
Requires-Dist: moat-lib-xknx~=3.15.0
Dynamic: license-file

# KNX bus connector

% start synopsis
Connects MoaT-Link to a KNX bus via XKNX/KNXnet/IP tunneling.
% end synopsis

% start main

This module bridges MoaT-Link values and KNX group addresses, in both
directions, via the XKNX library.  It replaces the legacy
``moat-kv-knx`` package.

## Quick start

1. Configure a KNX gateway:

   ```shell
   moat link knx myhouse add -h 10.0.0.1
   ```

2. Map a group address to a MoaT-Link path:

   ```shell
   moat link knx myhouse at 1/2/3 add -t in -m Bool -s dest .data.lamp.kitchen
   ```

3. Run the connector:

   ```shell
   moat link knx myhouse monitor
   ```

## Deprecation

This package supersedes ``moat-kv-knx``.  The address tree now lives in
MoaT-Link under the ``knx.<NAME>`` prefix; group addresses are stored as
the three integer components of an ``a/b/c`` address.

% end main
