6. Adding Z-Wave Devices

Make sure the Z-Wave module is up and running before you continue reading this chapter.

6.1. Pair a device using the CLI

Before you start, make sure the device to pair is factory reset if it has been used before.

  1. Start the CLI by executing:

    homegear -r
  2. Switch to the Z-Wave family:

    families select 17
  3. Enable the pairing mode in Homegear:

    pairing on

or if you want to pair it in secure mode:

secpairing on

The device must support security for the later case.

  1. Enable pairing mode on the device. See the device’s documentation on how to do that. Typically it’s a triple-click (or a single or a double-click) on a button of the device.
  2. After a few seconds ls should show the device.


You can also pair a device by using the command: homegear -e rc '$hg->setInstallMode(17, true, 60);'


By default devices are added in low power mode, this is a security measure, important when you add devices in secure mode. You should have the added device as close as possible to the communication device. If that is not possible, you can enable ‘high power’ mode from CLI.