xaal.knx


Namexaal.knx JSON
Version 0.2 PyPI version JSON
download
home_pageNone
SummaryxAAL devices for KNX bus
upload_time2024-07-16 19:17:54
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseGPL License
keywords xaal knx
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            xaal.knx
===========
This package contains a xAAL gateway for KNX BUS. 


Software 
========
The datapoint mapping (dpts.py) come from the Smarthome.py software : 
https://mknx.github.io/smarthome/plugins/knx.html (GPLv3.0) 


Install
=======
You can use both pip, with pip install xaal.knx or setup.py

You can test the package with :
python setup.py develop (or install) --user

To run the gateway:
- edit your config file (~/.xaal/xaal.knx.ini) 
- launch python -m xaal.knx

run :

If you use an USB (serial) port, you can use knxd to forward commands
between serial & multicast. 

to build knxd : 
git clone https://github.com/knxd/knxd.git
./configure --enable-usb  --prefix=/opt/knxd --disable-systemd

sudo knxd -t 1023 -e 0.0.1 -E 0.0.2:8 -i -R -S -b usb:


This configuration doesn't work out of the box. For an unknow 
reason, knxd doesn't forward knx frame to serial port. Please read
this bug report (fix) 

https://github.com/knxd/knxd/issues/340



Supported datapoints
==================== 
You must use one of this in the configuration file.

+--------+---------+------+----------------------------------+
| DPT    | Data    | Type | Values                           |
+========+=========+======+==================================+
| 1      | 1 bit   | bool | True | False                |
+--------+---------+------+----------------------------------+
| 2      | 2 bit   | list | [0, 0] - [1, 1]                  |
+--------+---------+------+----------------------------------+
| 3      | 4 bit   | list | [0, 0] - [1, 7]                  |
+--------+---------+------+----------------------------------+
| 4.002  | 8 bit   | str  | 1 character (8859_1) e.g. 'c'    |
+--------+---------+------+----------------------------------+
| 5      | 8 bit   | num  | 0 - 255                          |
+--------+---------+------+----------------------------------+
| 5.001  | 8 bit   | num  | 0 - 100                          |
+--------+---------+------+----------------------------------+
| 6      | 8 bit   | num  | -128 - 127                       |
+--------+---------+------+----------------------------------+
| 7      | 2 byte  | num  | 0 - 65535                        |
+--------+---------+------+----------------------------------+
| 8      | 2 byte  | num  | -32768 - 32767                   |
+--------+---------+------+----------------------------------+
| 9      | 2 byte  | num  | -671088,64 - 670760,96           |
+--------+---------+------+----------------------------------+
| 10     | 3 byte  | foo  | datetime.time                    |
+--------+---------+------+----------------------------------+
| 11     | 3 byte  | foo  | datetime.date                    |
+--------+---------+------+----------------------------------+
| 12     | 4 byte  | num  | 0 - 4294967295                   |
+--------+---------+------+----------------------------------+
| 13     | 4 byte  | num  | -2147483648 - 2147483647         |
+--------+---------+------+----------------------------------+
| 14     | 4 byte  | num  | 4-Octet Float Value IEEE 754     |
+--------+---------+------+----------------------------------+
| 16     | 14 byte | str  | 14 characters (ASCII)            |
+--------+---------+------+----------------------------------+
| 16.001 | 14 byte | str  | 14 characters (8859_1)           |
+--------+---------+------+----------------------------------+
| 17     | 8 bit   | num  | Scene: 0 - 63                    |
+--------+---------+------+----------------------------------+
| 20     | 8 bit   | num  | HVAC: 0 - 255                    |
+--------+---------+------+----------------------------------+
| 24     | var     | str  | ulimited string (8859_1)         |
+--------+---------+------+----------------------------------+
| 232    | 3 byte  | list | RGB: [0, 0, 0] - [255, 255, 255] |
+--------+---------+------+----------------------------------+


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "xaal.knx",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "xaal, knx",
    "author": null,
    "author_email": "Jerome Kerdreux <Jerome.Kerdreux@imt-atlantique.fr>",
    "download_url": "https://files.pythonhosted.org/packages/32/4d/2f7a45c29ed2495c3fc4dd3ecefae915621480c4a73d6f315cde3fdfc1b4/xaal_knx-0.2.tar.gz",
    "platform": null,
    "description": "xaal.knx\n===========\nThis package contains a xAAL gateway for KNX BUS. \n\n\nSoftware \n========\nThe datapoint mapping (dpts.py) come from the Smarthome.py software : \nhttps://mknx.github.io/smarthome/plugins/knx.html (GPLv3.0) \n\n\nInstall\n=======\nYou can use both pip, with pip install xaal.knx or setup.py\n\nYou can test the package with :\npython setup.py develop (or install) --user\n\nTo run the gateway:\n- edit your config file (~/.xaal/xaal.knx.ini) \n- launch python -m xaal.knx\n\nrun :\n\nIf you use an USB (serial) port, you can use knxd to forward commands\nbetween serial & multicast. \n\nto build knxd : \ngit clone https://github.com/knxd/knxd.git\n./configure --enable-usb  --prefix=/opt/knxd --disable-systemd\n\nsudo knxd -t 1023 -e 0.0.1 -E 0.0.2:8 -i -R -S -b usb:\n\n\nThis configuration doesn't work out of the box. For an unknow \nreason, knxd doesn't forward knx frame to serial port. Please read\nthis bug report (fix) \n\nhttps://github.com/knxd/knxd/issues/340\n\n\n\nSupported datapoints\n==================== \nYou must use one of this in the configuration file.\n\n+--------+---------+------+----------------------------------+\n| DPT    | Data    | Type | Values                           |\n+========+=========+======+==================================+\n| 1      | 1 bit   | bool | True &#124; False                |\n+--------+---------+------+----------------------------------+\n| 2      | 2 bit   | list | [0, 0] - [1, 1]                  |\n+--------+---------+------+----------------------------------+\n| 3      | 4 bit   | list | [0, 0] - [1, 7]                  |\n+--------+---------+------+----------------------------------+\n| 4.002  | 8 bit   | str  | 1 character (8859_1) e.g. 'c'    |\n+--------+---------+------+----------------------------------+\n| 5      | 8 bit   | num  | 0 - 255                          |\n+--------+---------+------+----------------------------------+\n| 5.001  | 8 bit   | num  | 0 - 100                          |\n+--------+---------+------+----------------------------------+\n| 6      | 8 bit   | num  | -128 - 127                       |\n+--------+---------+------+----------------------------------+\n| 7      | 2 byte  | num  | 0 - 65535                        |\n+--------+---------+------+----------------------------------+\n| 8      | 2 byte  | num  | -32768 - 32767                   |\n+--------+---------+------+----------------------------------+\n| 9      | 2 byte  | num  | -671088,64 - 670760,96           |\n+--------+---------+------+----------------------------------+\n| 10     | 3 byte  | foo  | datetime.time                    |\n+--------+---------+------+----------------------------------+\n| 11     | 3 byte  | foo  | datetime.date                    |\n+--------+---------+------+----------------------------------+\n| 12     | 4 byte  | num  | 0 - 4294967295                   |\n+--------+---------+------+----------------------------------+\n| 13     | 4 byte  | num  | -2147483648 - 2147483647         |\n+--------+---------+------+----------------------------------+\n| 14     | 4 byte  | num  | 4-Octet Float Value IEEE 754     |\n+--------+---------+------+----------------------------------+\n| 16     | 14 byte | str  | 14 characters (ASCII)            |\n+--------+---------+------+----------------------------------+\n| 16.001 | 14 byte | str  | 14 characters (8859_1)           |\n+--------+---------+------+----------------------------------+\n| 17     | 8 bit   | num  | Scene: 0 - 63                    |\n+--------+---------+------+----------------------------------+\n| 20     | 8 bit   | num  | HVAC: 0 - 255                    |\n+--------+---------+------+----------------------------------+\n| 24     | var     | str  | ulimited string (8859_1)         |\n+--------+---------+------+----------------------------------+\n| 232    | 3 byte  | list | RGB: [0, 0, 0] - [255, 255, 255] |\n+--------+---------+------+----------------------------------+\n\n",
    "bugtrack_url": null,
    "license": "GPL License",
    "summary": "xAAL devices for KNX bus",
    "version": "0.2",
    "project_urls": {
        "Documentation": "https://redmine.imt-atlantique.fr/projects/xaal/repository/xaal/entry/code/Python/branches/0.7/devices/protocols/KNX/README.rst",
        "Homepage": "https://recherche.imt-atlantique.fr/xaal/",
        "Source": "https://redmine.imt-atlantique.fr/projects/xaal/repository/xaal/show/code/Python/branches/0.7/devices/protocols/KNX"
    },
    "split_keywords": [
        "xaal",
        " knx"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "37485930f8735de9da4645d343ac84f83a88c9b83afe4745c6a7becb42bd7b86",
                "md5": "3e1fb1a422bfc4c953c061972e831294",
                "sha256": "70a7beb11ee16a44dc6099557f50f23db7a514097b119d71c4429cdc7c970135"
            },
            "downloads": -1,
            "filename": "xaal.knx-0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3e1fb1a422bfc4c953c061972e831294",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 10500,
            "upload_time": "2024-07-16T19:17:52",
            "upload_time_iso_8601": "2024-07-16T19:17:52.396626Z",
            "url": "https://files.pythonhosted.org/packages/37/48/5930f8735de9da4645d343ac84f83a88c9b83afe4745c6a7becb42bd7b86/xaal.knx-0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "324d2f7a45c29ed2495c3fc4dd3ecefae915621480c4a73d6f315cde3fdfc1b4",
                "md5": "c756376484474adc2f82b02f208247cc",
                "sha256": "193c3865ec388b29a0902a7c3a2dded08f38dfc3a637879aa3e6cde12b6613de"
            },
            "downloads": -1,
            "filename": "xaal_knx-0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "c756376484474adc2f82b02f208247cc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 10717,
            "upload_time": "2024-07-16T19:17:54",
            "upload_time_iso_8601": "2024-07-16T19:17:54.006385Z",
            "url": "https://files.pythonhosted.org/packages/32/4d/2f7a45c29ed2495c3fc4dd3ecefae915621480c4a73d6f315cde3fdfc1b4/xaal_knx-0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-16 19:17:54",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "xaal.knx"
}
        
Elapsed time: 2.01145s