# 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:
* 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.
* 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": null,
"name": "knx-frontend",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11.0",
"maintainer_email": null,
"keywords": "Home Assistant, KNX",
"author": null,
"author_email": "Marvin Wichmann <me@marvin-wichmann.de>, Matthias Alphart <farmio@alphart.net>",
"download_url": "https://files.pythonhosted.org/packages/77/f0/5afab3b31b6e59bffbada000dbdc062645ccf4932568486d694d71bd85ac/knx_frontend-2024.12.26.233449.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 \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 \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",
"summary": "KNX panel for Home Assistant",
"version": "2024.12.26.233449",
"project_urls": {
"Repository": "https://github.com/XKNX/knx-frontend.git"
},
"split_keywords": [
"home assistant",
" knx"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "46689d45ff3aff635a3efee32618161707bf8fa340fa250471b4606b2e65845b",
"md5": "6397d89a3fbe27744f02712ed9dd2a82",
"sha256": "6f106759495073617a6179949c6d6d9c5ffcfc699fef091974c415126b16ee93"
},
"downloads": -1,
"filename": "knx_frontend-2024.12.26.233449-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6397d89a3fbe27744f02712ed9dd2a82",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11.0",
"size": 5921258,
"upload_time": "2024-12-29T07:26:47",
"upload_time_iso_8601": "2024-12-29T07:26:47.310669Z",
"url": "https://files.pythonhosted.org/packages/46/68/9d45ff3aff635a3efee32618161707bf8fa340fa250471b4606b2e65845b/knx_frontend-2024.12.26.233449-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "77f05afab3b31b6e59bffbada000dbdc062645ccf4932568486d694d71bd85ac",
"md5": "20d526516102cac8c2da0c512398c5f4",
"sha256": "3e557508552d29d50c5e79f27a297a73e37b5419ac8e6392b3cb98ce21ab67db"
},
"downloads": -1,
"filename": "knx_frontend-2024.12.26.233449.tar.gz",
"has_sig": false,
"md5_digest": "20d526516102cac8c2da0c512398c5f4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11.0",
"size": 5832191,
"upload_time": "2024-12-29T07:26:50",
"upload_time_iso_8601": "2024-12-29T07:26:50.710643Z",
"url": "https://files.pythonhosted.org/packages/77/f0/5afab3b31b6e59bffbada000dbdc062645ccf4932568486d694d71bd85ac/knx_frontend-2024.12.26.233449.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-29 07:26:50",
"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"
}
JSON
