Managing Devices

In this chapter users will learn how to manage devices.

List Devices

From main menu, choose “Devices” -> “Manage Devices”. Device list screen will show up.

Each item is a device currently in network. For Libre Home devices, the icon will correctly reflact the color and layout “for multi-switches”. Also for Liberty IoT Hub device the device IEEE address, Hornet ID and Hub internal device ID will be displayed in the bottom.

List Device

For battery powered devices, such as Libre Remote, the battery voltage is also shown. Usually user shall replace the batter when voltage drops below 2.3V.

Device Status

You may notice that some devices displays with extra icons on the right side.

  • Low Battery - Device battery is low
  • Pending Query - Device data query in progress
  • Pending Remove - Device is being removed
  • Pending Replace - In warranty service is requested, replacement in transit
  • Upgrade Available - Firmware upgrade is available
  • Pending Upgrade - Firmware upgrade is in progress
  • Problem - Can not communicate with device
  • Pending Query - Device is configured in an unusual way (for example, disabled). Note it only serves an notification, which doesn’t necessarily indicate any problem.

Managing Hornet Devices

Clicking a Hornet device will bring up a screen to further configure the device.

Changing Device Name and Icon

When a new device joins the network, the device configure screen will automatically pop up. User shall give device a new and optionally an icon. If users didn’t name the device. The device will have a default name such as “Device40”, where “40” is the unique internal device ID.

Device name and icon can be modified at any time by user.

Note user shall give a meaningful name to every device.

If a device contains multiple loads, each load may have a separate name. For example, a Libre Sprinkler Controller may have a name such as “Front Yard Sprinkler”. The sprinkler may have 8 zones, each zone may be named separately such as “Lawns North East”, or “Rose Garden” etc.

Rename Device

Libre Switch and Dimmer

Below is a device configuration with a multi-button dimmer.

As you can tell this device consists 3 buttons (1 big vertical on top, 2 small verticals on the bottom). This device also contains a load (dimmer).

Multi-Button Switch

Logical Devices

In the multi-button dimmer above, there are 4 “logical devices”, 3 buttons and one load (dimmer). Each logical device can be configured separately.

Logical device is an important concept in Libre Home system, especially for Libre App developers.

Default Linking

In the multi-button dimmer example above, by default, the load (dimmer) is linked to the big button on top. So the user can control the local load (dimmer) through the top button.

The top button can be disabled, so that the load can only be controlled remotely, e.g. through Smartphone App. That feature could be useful in commercial buildings.

Also the load can be disabled. The device then turned into a 3 button remote control device where the 3 buttons can be linked to control other devices.

Configure Buttons

In the multi-button dimmer above, when user press the top big button, a configure screen will pop up.


Configuration process is modifying a collection of attributes.

For example, “On Level” is an attribute with value ranges between 0 and 255. When user press the button to turn on the dimmer, the dimmer level will be set to this level.

So if we change this level to 128, when user turns on the dimmer light, the level is only half of the brightness.

Tips: Many buttons can be linked to the same dimmer load with different “On Level”. Turning on each button will set the dimmer to different pre-defined level. This can be done on many buttons on the same multi-button switch. When the dimmer level changes, only the backlight of the button with the closest “On Level” will be turned to indicate the most approximate level.

Multi-Button Config

Read-only Attributes

Some attributes are read-only that can not be manually changed by user.

Libre Remote

For Libre Remote configuration, please read to “Remote Configuration”.

Libre Thermostat

For Libre Remote configuration, please read to “Thermostat Configuration”.

Attributes List

For detailed attribute list, see Appendix.


User can perform special operations on the device by pressing the buttons on the bottom of screen (Navigation Panel).

  • Upgrade - Upgrade firmware
  • Wiring - Show device wiring, for example, Thermostat wiring diagram
  • Locate - Locate device, for Remote, it will beep with flash screen
  • Custom - Custom setting for device.
    For switch/dimmers, there are 2 types of custom settings,
    • Disable local load (device works as remote buttons) and
    • Decouple local button from local load (load can only be controlled remotely) and one more local buttons can be used to control remote load.
  • Problem - Device lost communication, trying to diagnose the problem
  • Remove - Remove the device from Hub

Third Party Wi-Fi/Ethernet Devices

Liberty IoT Hub can automatically discover other third-party devices running on your local network, using both uPnP and DNS-SD paotocols.

Press the device in the Device List will be able to browse technical details about the device from collected from both uPNP and DNS-SD.

Third party devices can be renamed and removed from this system.

Note user can only remove third party devices that not longer exist; otherwise the device will be rediscovered by Hub. There is no way to hide the device from Hub.

3rd party devices 3rd party devices

Device Drivers

Thanks to our patented Liberty App Engine technology. Anybody can develop application for Liberty-IoT-OS running on Liberty IoT Hub.

One type of Application is device drivers. Shipped with Liberty IoT Hub there is an App called “Denon AVR Driver”. It is a device driver for Denon/Marantz receivers.

That App takes a Denon/Marantz receiver, then create several “Virtual Devices”. User can name and rename those “Virtual Devices”.

It is extremely for users to drive a third party device. Just create a Task based on a driver App. Throw in the device, and optionally give names to exposed virtual devices.

Virtual device are treated in the same way as other devices such as Libre Home devices. For example, a receiver on/off can be controlled from Smartphone App, can be linked to a wall switch or Libre Remote Button. See nest chapter Linked Device Groups.

Similarly, receiver volume can be treated like a light dimmer.

The virtual device is fully stateful. If user manually adjust volume on receiver, the volume level on the Smartphone App will reflect the change immediately.

Task demon Task demon