Skip to content

escalate/loxone-ha-bridge-importer

Repository files navigation

Test

Loxone / HA-Bridge Importer

A commandline tool to import Loxone controls into HA-Bridge.

ATTENTION It is recommended to create an backup of the current HA-Bridge configuration before using this tool.

Supported Loxone control types and actions

This is just the list of already implemented control types with there meaningful actions.

Loxone offers many more control types and if you are missing one please create a Pull Request or open an Issue on Github.

Control type On Dim Off
Alarm delayedon - off
CentralAlarm delayedon - off
CentralGate open - close
CentralJalousie fulldown - fullup
Daytimer - - -
Dimmer on - off
Gate open - close
InfoOnlyAnalog - - -
InfoOnlyDigital - - -
IRoomController - - -
IRoomControllerV2 - - -
Jalousie fulldown - fullup
LightController on - off
LightControllerV2 plus - minus
Meter - - -
Presence - - -
Pushbutton on - off
Radio - - -
Switch pulse - pulse
TextState - - -
TimedSwitch pulse - off
Tracker - - -
UpDownDigital pulseup - pulsedown
Webpage - - -
WindowMonitor - - -

Installation

Tested with Python 3.12 on Ubuntu 22.04

If you encounter issues with 3.12.x patch versions of Python, please open a Github issue.

Requirements

Install needed requirements via pip

$ pip install -r requirements.txt

Run

Run tool from commandline

$ ./importer.py

Usage

$ ./importer.py --help

Usage: importer.py [OPTIONS]

    Commandline interface for Loxone / HA-Bridge Importer

Options:
    --loxone-miniserver-host TEXT    Set IP address / hostname of Loxone MiniServer  [required]
    --loxone-miniserver-port INTEGER Set port of Loxone MiniServer (Default: 80) [required]
    --loxone-username TEXT           Set username for Loxone MiniServer login [required]
    --loxone-password TEXT           Set password for Loxone MiniServer login [required]
    --ha-bridge-host TEXT            Set IP address / hostname of HA-Bridge server (Default: localhost) [required]
    --ha-bridge-port INTEGER         Set port of HA-Bridge server (Default: 8080) [required]
    --verbose                        Enable verbose logging output
    --help                           Show this message and exit.

Docker

Build Docker image

$ docker build \
    --tag=importer \
    .

Run Docker container from built image to print help

$ docker run \
    importer

Usage: importer.py [OPTIONS]

    Commandline interface for Loxone / HA-Bridge Importer

Options:
...

Run Docker container from built image with additional arguments

$ docker run \
    importer \
    --loxone-miniserver-host="192.168.1.2" \
    --loxone-username="alexa" \
    --loxone-password="AmAz0n" \
    --verbose

Dependencies

Contribute

Please note the separate contributing guide.

License

MIT