This manual is made with the hosted gBridge service. If you are running gBridge on your own servers, there might be some small differences. However, they can be easily adapted.
Register a new account¶
That’s not complicated at all: just visit https://gbridge.kappelt.net/register and fill in the required information. After you’ve received the confirmation email, you can instantly log in.
A first device¶
You’ll see your account’s dashboard for the first time after logging in.
Press the top-right button labeled with “+ Device” to create a new one. Choose whatever you like. For this example, I’ve chosen “Light” as the type and both “On and Off” and “Brightness” as supported traits.
Note the MQTT topics that are listed here.
You can edit these MQTT topics for the devices as you like. To do so, press the “Edit” button in the device list.
Please note that you can’t specify your own topics while creating new devices, only while editing them after creation.
Connect Google Assistant¶
Open the Google Home App to connect your Google Home system to gBridge. Add a new device, select the category “Works with Google”. Select Kappelt gBridge.
If you add new devices in your dashboard, they’ll appear in the list automatically.
There is a bug in a current version of the Google Home app that might lead to the message “Couldn’t update the settings. Check your connection”. This problem is solely caused by the Google Home app, thus we are unable to fix it at the moment.
This issue has been analyzed by some Reddit users. It seems to be common among Android devices with Google Chrome as the standard browser, while being logged in to multiple Google Accounts.
For many users, installing Firefox and setting it (temporarily) to the default browser seemed to fixed the problem.
Everything is ready now! Messages will now be available on gBridge’s public MQTT server. You can connect to it:
Shown in your account’s dashboard under “My Account”
Is your account’s password by default, but can be changed independently.
TLS V1.2 is required
About TLS: The Server uses an certificate that is signed by Let’s Encrypt. The Let’s Encrypt CA is trusted by most systems nowadays, you shouldn’t really need to install a certificate. Only download the prepared CA certificates if your system doesn’t support them natively.
Subscribe now to the MQTT topic that belongs to your device, for example with mosquitto_sub:
mosquitto_sub --username your-mqtt-username \ --pw your-mqtt-password \ --capath /etc/ssl/certs/ \ --host mqtt.gbridge.io \ --port 8883 \ --topic gBridge/u2/d4/onoff