# KNX UI
This is the KNX panel for the KNX core integration in Home Assistant. It
provides a user interface for interacting with the KNX integration.
## Features
* Info:
![Info](./screenshots/info.png?raw=true)
* Get an overview of your current KNX installation state (shows if connected
to the Bus, which XKNX version is running and the currently assigned
Individual address)
* Upload ETS project file (which is used in the Group Monitor to provide
destination names and DPT interpretation) and delete it again from Home
Assistant.
* Get key information about the parsed ETS project which has been uploaded
* Group Monitor: Use the interactive bus monitor to view all incoming and
outgoing telegrams on the bus.
![Group Monitor](./screenshots/bus_monitor.png?raw=true)
* ETS Project: Displays the Group Addresses provided via ETS Project in a tree view
## Development
If you check this repository out for the first time please run the following command to init the submodules:
```shell
$ make bootstrap
...
```
### Development build (watcher)
```shell
$ make develop
...
```
### Production build
```shell
$ make build
...
```
### Update the home assistant frontend
Replace latest_tag with the current release tag.
```shell
$ cd homeassistant-frontend
$ git fetch
...
$ git checkout latest_tag
...
$ cd ..
$ rm -f yarn.lock
$ node ./script/merge_requirements.js
...
$ script/bootstrap
...
```
### Testing the panel
First of all we recommend to follow the instructions for
[preparing a home assistant development environment][hassos_dev_env].
You can test the panel by symlinking the build result directory `knx_frontend`
into your Home Assistant configuration directory.
Assuming:
* The `knx-frontend` repository is located at `<knx-frontend-dir>` path
* The `home-assistant-core` repository is located at `<hass-dir>` path (Remark: per default the Home Assistant configuration directory will be created within `<hass-dir>/config`)
```shell
$ ln -s <knx-frontend-dir>/knx_frontend <hass-dir>/config/deps/lib/python3.xx/site-packages/
$ hass -c config
...
```
or on a venv-install
```shell
$ cd <hass-dir>
$ script/setup
# Next step might be optional
$ source venv/bin/activate
$ export PYTHONPATH=<knx-frontend-dir>
$ hass
...
```
Now `hass` (Home Assistant Core) should run on your machine and the knx panel is
accessible at http://localhost:8123/knx.
[hassos_dev_env]: https://developers.home-assistant.io/docs/development_environment/
On Home Assistant OS you might use https://github.com/home-assistant/addons-development/tree/master/custom_deps
Raw data
{
"_id": null,
"home_page": "",
"name": "knx-frontend",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9.0",
"maintainer_email": "",
"keywords": "Home Assistant,KNX",
"author": "",
"author_email": "Marvin Wichmann <me@marvin-wichmann.de>, Matthias Alphart <farmio@alphart.net>",
"download_url": "https://files.pythonhosted.org/packages/85/60/d7393166ab0b9080b1e52d3739b468e60e4c3f2cbb6daaaa107f73414467/knx_frontend-2024.1.20.105944.tar.gz",
"platform": null,
"description": "# KNX UI\n\nThis is the KNX panel for the KNX core integration in Home Assistant. It\nprovides a user interface for interacting with the KNX integration.\n\n## Features\n\n* Info:\n ![Info](./screenshots/info.png?raw=true)\n * Get an overview of your current KNX installation state (shows if connected\n to the Bus, which XKNX version is running and the currently assigned\n Individual address)\n * Upload ETS project file (which is used in the Group Monitor to provide\n destination names and DPT interpretation) and delete it again from Home\n Assistant.\n * Get key information about the parsed ETS project which has been uploaded\n* Group Monitor: Use the interactive bus monitor to view all incoming and\n outgoing telegrams on the bus.\n ![Group Monitor](./screenshots/bus_monitor.png?raw=true)\n* ETS Project: Displays the Group Addresses provided via ETS Project in a tree view\n\n## Development\n\nIf you check this repository out for the first time please run the following command to init the submodules:\n\n```shell\n$ make bootstrap\n...\n```\n\n### Development build (watcher)\n\n```shell\n$ make develop\n...\n```\n\n### Production build\n\n```shell\n$ make build\n...\n```\n\n### Update the home assistant frontend\n\nReplace latest_tag with the current release tag.\n\n```shell\n$ cd homeassistant-frontend\n$ git fetch\n...\n$ git checkout latest_tag\n...\n$ cd ..\n$ rm -f yarn.lock\n$ node ./script/merge_requirements.js\n...\n$ script/bootstrap\n...\n```\n\n### Testing the panel\n\nFirst of all we recommend to follow the instructions for\n[preparing a home assistant development environment][hassos_dev_env].\n\nYou can test the panel by symlinking the build result directory `knx_frontend`\ninto your Home Assistant configuration directory.\n\nAssuming:\n\n* The `knx-frontend` repository is located at `<knx-frontend-dir>` path\n* The `home-assistant-core` repository is located at `<hass-dir>` path (Remark: per default the Home Assistant configuration directory will be created within `<hass-dir>/config`)\n\n```shell\n$ ln -s <knx-frontend-dir>/knx_frontend <hass-dir>/config/deps/lib/python3.xx/site-packages/\n$ hass -c config\n...\n```\nor on a venv-install\n```shell\n$ cd <hass-dir>\n$ script/setup\n# Next step might be optional\n$ source venv/bin/activate\n$ export PYTHONPATH=<knx-frontend-dir>\n$ hass\n...\n```\n\nNow `hass` (Home Assistant Core) should run on your machine and the knx panel is\naccessible at http://localhost:8123/knx.\n\n[hassos_dev_env]: https://developers.home-assistant.io/docs/development_environment/\n\nOn Home Assistant OS you might use https://github.com/home-assistant/addons-development/tree/master/custom_deps\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "KNX panel for Home Assistant",
"version": "2024.1.20.105944",
"project_urls": {
"Repository": "https://github.com/XKNX/knx-frontend.git"
},
"split_keywords": [
"home assistant",
"knx"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "48c3398656d80482de4b50bd679ac1b0f4c06c35fa1a150bcb2540e7fdad8a28",
"md5": "0e20bdf7a96f22f7e736ef71fba84211",
"sha256": "8dbc43413fde8ca9acbf90827fd31e77c3d05b9b705969cd7cacd0bdc561b8ae"
},
"downloads": -1,
"filename": "knx_frontend-2024.1.20.105944-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e20bdf7a96f22f7e736ef71fba84211",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.0",
"size": 1091479,
"upload_time": "2024-01-20T16:03:12",
"upload_time_iso_8601": "2024-01-20T16:03:12.279455Z",
"url": "https://files.pythonhosted.org/packages/48/c3/398656d80482de4b50bd679ac1b0f4c06c35fa1a150bcb2540e7fdad8a28/knx_frontend-2024.1.20.105944-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8560d7393166ab0b9080b1e52d3739b468e60e4c3f2cbb6daaaa107f73414467",
"md5": "57cdadf9d54cf909e7430966662011d3",
"sha256": "e6ef816998db1a922941dde4faee4d0b4f7d4d0ba2c0629d13f1282169f2d352"
},
"downloads": -1,
"filename": "knx_frontend-2024.1.20.105944.tar.gz",
"has_sig": false,
"md5_digest": "57cdadf9d54cf909e7430966662011d3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.0",
"size": 1091588,
"upload_time": "2024-01-20T16:03:14",
"upload_time_iso_8601": "2024-01-20T16:03:14.183861Z",
"url": "https://files.pythonhosted.org/packages/85/60/d7393166ab0b9080b1e52d3739b468e60e4c3f2cbb6daaaa107f73414467/knx_frontend-2024.1.20.105944.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-20 16:03:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "XKNX",
"github_project": "knx-frontend",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "knx-frontend"
}