Get it!

First run

The first time you start BlueHome, it immediately ask you for the IP address of your KNX IP Gateway or knxd server. Note that BlueHome cannot work without an IP Gateway to your KNX system.

After providing the IP address, you will be presented with the main view of the application. For smaller screens this is the Rooms View, while for larger screens this is a three pane view with the Rooms View, the Page View and the Logo.

Initially, BlueHome is configured with two empty Rooms. You can change or remove these according to your home situation (see further below).

Rooms and Pages

Every room in the main Room View contains one or more "pages". A Page is just a container in which you can place a number of Devices (see below on how to create new Devices).

Once you have selected a room, the corresponding pages will be displayed (depending on the screen size, the Page View will replace the Room View or sit beside it). You scroll through the pages by sliding them left or right.

Using the menu, you can add or remove pages.

Pages and Devices

A Page is a container for Devices. With the correct Page in view, use the menu to add devices to the page. Select the devices you wish to add to the page and press Add. The selected devices will be added to the bottom of the page.

Long press a Device in the list to either delete it from the page or move it up/down in the list. Deleting a device from a page will only remove it from the current page.

Adapting the Rooms View to your liking

From the menu, choose Create Room to add a new Room to the collection. Give a Label and select an Icon to quickly locate the new room in the list. The new room will be added to the bottom of the existing list.

Long press a Room in the list to either edit its label or icon, move it up/down in the list or delete it.

Creating and Editing Devices

BlueHome interacts with your KNX system through a set of Devices. Currently, the following devices are supported:

  • Switch: can be configured to "Toggle", or always send "On" or "Off"
  • Relative Dimmer: press and hold to dim up or down, click to toggle on or off
  • Absolute Dimmer: use a slider to set the dim value, click the label to toggle on or off
  • Scene
  • Heating Control: switch between 4 heating modes
  • Thermometer: read the room temperature
  • Blinds: move blinds up, down or stop movement
  • Generic Sensor: choose the relevant datapoint type of your choice to monitor any sensor output
You can email me if you would like to see support for other devices.

On large screens that use the three pane layout, select Configure from the action bar (top right corner) to edit or create devices. On smaller screens, select New Device or Edit Device.

All devices interact with KNX using "Group Addresses". The "Main" address is used to send commands, while the "Status" address is used to receive feedback from the system. For example, a Switch has one main address and one status address. Although it is not necessary to set the status address, BlueHome will not "know" whether a Switch is "on" or "off" without it. The same holds for all other devices. For proper operations, your KNX system should be set up to use status messages and the corresponding addresses should be configured in BlueHome.

In some cases, you can use the Assistant to help you set up the correct group addresses for a device. Simply press the Magic Wand next to the address fields and use your real KNX device to perform the required action. For example, use a button in your home to switch a light. The BlueHome Assistent will capture the main and or status group address used by your KNX device.

Use the "Test Device" to immediately verify whether your addresses have been set up correctly.

Once you have created your device, you can add it to one or more pages.

Device details

A small red triangle on the top left corner of a device indicates that BlueHome has no up to date state information. For example, if you create a Switch without supplying a working status address, BlueHome cannot possibly know the current status of the switch within the KNX system (if you use a button in the wall to toggle that switch, BlueHome will not be notified of this action). This is indicated with the red triangle.

The use of most devices is straightforward, but here is some more information on some features that are less obvious:

Switch (only applicable in Toggle mode)

If you provide a valid status address, the Switch device in BlueHome will know the actual status of the switch in the KNX system and will synchronize with it. This means that BlueHome will show you the current status of the switch and will adapt its "toggle" action to the real status.

In the case that you do not provide a status address, the Switch will just alternate between sending an ON and OFF command to the KNX system. The indication that the Switch is supposedly "on" (blue line) is purely cosmetic and has nothing to do with the actual status of the switch in the KNX network...

Absolute Dimmer

Tap on the label of the dimmer to toggle it on or off!


A Spacer is just a label that you can put between a set of devices on a page. Use the menu to add a new Spacer and long-press it to change its caption.

Bus Monitor

The Bus Monitor shows a history of the last 100 messages that were transmitted on your KNX network (while BlueHome was active).

Touch one of the rows to copy the group address to the clipboard (convinient when configuring new devices).

Long press a row to manually set the KNX datapoint type for that message. This will make the content of the message readable. Note that BlueHome remembers the datapoint type you set. You can always change it at any time.

The Assistent uses the datapoint types and its operation will be more accurate if you manually set the datapoint types!

Share Configuration

Sharing configurations is usefull as backup and to share configurations between different Android devices that you own.

You can share your complete BlueHome configuration using email. You can import these settings on another device by opening the attachment in the mail.

Debug Log

The Debug Log shows a history of the last 100 messages that BlueHome transmitted to the KNX network. This allows users to analyse what is going on in the background in case of strange or inexplicable behavior.

  • REQ means that BlueHome tried to read the data from a particular datapoint
  • WRT means that BlueHome wrote a message to a particular datapoint

Defining Tasks and Tasker integration

Since version 1.4.1, BlueHome supports the creation of Tasks. Each Task can contain one or more devices and an action on the device (like turn on a light, set a dim value, set heating mode, etc.). Once you have created a Task, it is automatically added to the list of devices on your phone or tablet and you can put it on the screen like any other device in the system.

Moreover, you can also execute tasks from another App using an Intent. So you can use a tool like Tasker or Locale to define a trigger and have it execute a BlueHome Task. Examples: shake your phone to set default lights in house, use NFC tags around the house to set certain scenes, use timers to set heating modes, etc.

Defining Tasks and Actions

To create a Task, choose "Tasks" from the menu of the main screen. Tap the Add button to create a new Task and give it a name or long press an existing task to rename it. Once created, tap the new task to start adding Actions (devices) to it.

To add an Action, tap the Add button and choose the device you want to include in this task. This will bring up a dialog in which you can give a name to this action and choose the particular action for this device you wish to execute. For example, a Switch can be set to 'Turn on', 'Turn off', 'Toggle' or 'Trigger'. Tap Save to store the task. You can add multiple Actions to one Task.

The 'Execute all actions' button will do what it says: execute all the Actions you have defined for this task.

Tasker integration

This guide is written for Tasker, but any App that allows you to lets you execute custom Intents can be used in the same way.

Start by reading the manual on the Tasker web site on how to set up a trigger. Once you have your trigger (GPS location, device shaking, timers, etc.), add the following action:

System -> Send Intent

With the following parameters:

Action: biz.seys.bluehome.START_TASK
Extra: biz.seys.bluehome.tasklabel:[name of your task]
Target: Broadcast Receiver

Replace [name of your task] with the name of the task you wish to execute. For example:

will execute the task you defined in BlueHome with the name KitchenTask. Leave the rest to default.

You are done. Tasker will now ask BlueHome to execute the Task you have specified, depending on the trigger you defined in Tasker.