Registering a Bridge

The JowiHue plugin can maintain multiple bridges, so if you are planning to use more then 50 lights and sensors (officially 63) on a Philips Hue bridge, or more then 200 on a RaspBee/ConBee gateway, this plugin can help you out with controlling them. All bridges on a local network can be found with this plugin.

Registration process

The plugin will scan the local network for available bridges. Once it finds one or more bridges, it will report this in the HS3 log and will enable you to register the bridge through the configuration page of the plugin.

On the configuration page (other elements on this page will be explained later) you will see a button with text “register Bridge” to register a bridge.

  • On a Philips Hue bridge press the register button and immediately press the central button on the Philips Hue bridge once.
  • With the RaspBee/Conbee gateways, you'll have to go to Phoscon (normally you will find the botton for Phoscon on the top right of the deCONZ interface), login and proceed to settings\gateway. Press the advanced button and choose “authenticate app”. Press the register button on the JowiHue configuration page and then the authenticate app button.

After registration

After a successful registration, the plugin will immediately read the configuration of the bridge and create devices for lights and groups accordingly.

If you wait to long with the registration buttons on the bridge, the configuration page will return to its previous state until you try again.

After registration of a bridge, the first device that will be created is the bridge device itself.

The bridge device will show the state of the bridge, Available or Unreachable. If an animation is running, the number of running animations is shown on the bridge device and a button is made available to cancel all running animations. If you want to cancel a specific animation, you can use events or scripting. Changing the bridges name can be done through the properties of the device, in the extra plugin tab “JowiHue”.

Once registration is finished, the name of the webpage button will change in “Remove Bridge”.
Use caution! Removing a bridge will orphan all lights an sensordevice in HS3. Unless you are be bringing back the bridge, you need to remove these by hand.
If you remove the bridge device from the device utility page, there is no harm done. After a restart of the plugin the device will be recreated and the bridge will still function normally

An extra button will be shown next to the remove button for Philips Hue Bridges enabling you to include a light that is already registered to another bridge. When using this function you need to be aware that the light will still be known on the ‘old’ bridge. If you move the lights one by one and wait until the plugin recognises the light on the new bridge, the plugin will remove the old light from the old bridge. Warning: do not move more than one light at a time, otherwise the plugin won't keep up anymore.
To correctly find a light, hold the light near the bridge and press the touchlink button. If the light blinks, the light is found, another press is then needed to incorparate the light in the bridge.

If needed, you can remove lights from the bridge by going to the Maintenance page.

Finding additional or new bridges

The plugin will do a regular scan of the network to detect if new bridges are to be found. Normally it should find the new bridge somewhere within 30 minutes after you connect the bridge. If you want to force the scan, you can press the button “start scan” on the configuration page.
If needed, you can force a new scan directly through the configuration page.