Domoticz plugin for the Kappelt gBridge
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
adapters
.DS_Store initial version Nov 24, 2018
.gitignore
CHANGELOG.md initial version Nov 24, 2018
README.md Update Readme and mark passwords as passwords Dec 13, 2018
domoticz_client.py When a sync message is received over MQTT, start syncing the devices … Dec 12, 2018
example-hosted.png Fix example of hosted setup Dec 13, 2018
example-local.png Add examples Dec 13, 2018
gbridge_client.py
mqtt.py Publish the state of the device to the set topic to be able to query … Dec 27, 2018
plugin.py Lets try to also get the current temperature in the room Dec 27, 2018

README.md

Kappelt gBridge - Domoticz Python Plugin

Python plugin for Domoticz to add integration with gBridge project

Prerequisites

You have two options:

Installation

  1. Clone repository into your domoticz plugins folder
cd domoticz/plugins
git clone https://github.com/giejay/domoticz-gbridge-plugin.git
  1. Restart domoticz
  2. Make sure you add "127.0.0.1" to your Local Networks under Settings.
  3. Go to "Hardware" page and add new item with type "gBridge"
  4. Set your MQTT server address, gBridge config etc. to plugin settings and click Add

Example of a hosted setup: alt text

Example of a local setup: alt text

Configure devices

For this plugin to know which devices it may add to the gBridge, it checks the description of the device. Description: gBridge is making sure the device is added with its Domoticz name. Description: gBridge:Another friendlyName is creating a device in gBridge with "Another friendlyName".

After you have configured your devices, you have two choices. The first one is going to the Hardware page again, select your gBridge hardware and click "Update".

The second option, if you have gBridge linked to your Google account already, is asking Google: "Sync my devices". This will trigger a MQTT sync message for which the plugin will start a sync cycle. Finally check the logging if the devices are added successfully to gBridge (or visit the device page of gBridge)

Testing

Follow the instructions to connect to Google: https://doc.gbridge.kappelt.net/html/firstSteps/gettingStarted.html#connect-google-assistant After you added gBridge to your Google Home/Assistant, ask Google (again) to "Sync my devices". Then say: Turn on x light and see your light shining. If something went wrong, check for messages in the Domoticz log regarding gBridge. If it doesn't make a lot of sense, create an issue and I will help asap.

Plugin update

  1. Stop domoticz
  2. Go to plugin folder and pull new version
cd domoticz/plugins/gbridge
git pull
  1. Start domoticz

Supported devices

The onoff, brightness, scenes and temperature traits are supported, this means the following Domoticz devices can be controlled:

  • Lights
  • Dimmers
  • Blinds (including Percentage and Percentage Inverted)
  • Scenes
  • (Dummy) switches
  • Temperature setpoint