ZigBee

The ZigBee integration allows you to connect and control devices that support ZigBee directly through the nomos system Controller.

A ZigBee USB dongle is required for the direct connection of ZigBee devices to the nomos system Controller.

WARNING

Important: Use a USB extension cable that is at least 30 cm long between the dongle and the nomos system Controller.

ZigBee Integration:

1. Status:
   • The banner at the top shows the state of the ZigBee controller, for example Connected, or an error message if the dongle is missing or not ready.
   • Before using ZigBee devices, make sure that the ZigBee USB dongle is plugged in.
2. Buttons and Options:
   • Manage Devices: This button opens a menu where you can manage the connected ZigBee devices. Here, you can add, edit, or remove devices. When pairing devices, follow the manufacturer's instructions and operation manuals for each product. Depending on the manufacturer, some steps may need to be done directly on the device.
   • Settings: Here, you can adjust the network settings and other configuration options for the ZigBee integration.
   • Reset: This option is used to reset the ZigBee integration. Use it carefully: the ZigBee network and the ZigBee settings are deleted; ZigBee then starts with a new network. All ZigBee devices have to be paired again. Everything else on the controller stays as it is.

The page has two tabs: Devices with the device list and the buttons above it, and Network map (see Network map).

Pairing a Device

You pair a new ZigBee device in the Manage Devices window:

1. Click Start Inclusion above the list.
2. As soon as Ready to pair appears, put the device into pairing mode, usually by switching it on or with a long button press. The manufacturer's manual says how.
3. When the device answers, Device found and Including follow while it reports its functions. Keep it switched on and nearby until it is done.
4. After Added the window shows the list again with the new device already selected. Click Next to give it a name and pick its room.

The three steps below the state (Ready – Found – Included) show how far pairing has got. Stop Inclusion cancels it. If no device joins before pairing ends (No device found) or pairing fails (Pairing failed), click Try again.

Removing a Device

In the Manage Devices window, every device has a Delete button. Devices without a recognised description are listed there too, as Unknown device with their address; you cannot add them, but you can delete them. After clicking Delete, choose:

• Block from joining again – The device is put on the block list: if it tries to join the network again, the controller rejects it. You lift the block in the ZigBee Settings under Block list.
• Force remove – The controller only deletes the device from its own database, without signing it off the network.

Without Force remove, the controller asks the device to leave the network. Battery-operated devices must be awake for this; the window points this out: "Battery-operated devices must be woken up once to be deleted."

The device in nomos remains and is then shown as not reachable. If you no longer need it, also delete it with the × on the device card or with Delete Device on the device page.

WARNING

Force remove is meant for devices that no longer respond, for example because they are defective or already removed. The device itself is not informed and still considers itself paired. Reset it according to the manufacturer's instructions before pairing it again.

Network map

The Network map shows through which routers each ZigBee device reaches the coordinator and how good each radio link is. This lets you find weak links, devices without a link and places where another router is missing. Routers are mains-powered devices such as lamps or smart plugs.

1. On the ZigBee page, open the Network map tab and click Scan network. If ZigBee is not running, the button is greyed out.
2. The scan asks every router for its neighbours, one after the other. This takes about a second per router and puts some load on the radio network meanwhile. The bar shows how far it is, for example "3 of 12 routers asked".
3. Afterwards the map shows the network and the bar the time of the scan, for example "Scan from 10:30". The map stays as long as you do not leave the page, also when you switch to the Devices tab. Scan network fetches a new state.

Reading the map:

• The large dot is the Coordinator, the ZigBee dongle on the controller. The medium dots are Routers, the small ones End devices, mostly battery-powered sensors and buttons.
• Each line is a radio link, coloured by its quality (LQI, 0 to 255): green Good, 150 and up, yellow Fair, 75 to 149, red Weak, below 75. If both sides report the same link, the weaker value counts.
• A dashed ring marks a router that did not answer the scan. Its own links are then missing, and end devices connected only through it appear without a line.
• A grey, dashed dot is an Unknown device: a neighbour nomos does not know, such as a removed device that has not left the network yet.
• Zoom with the mouse wheel or the Zoom in, Zoom out and Show the whole map buttons at the top right of the map. Devices can be dragged with the mouse.

Selecting a device: Click a device to highlight its links. Next to the map (below it on a smartphone) you see its type, model, IEEE address, network address and Last seen, and below them its Links (LQI). Click a name there to select that neighbour. Open device leads to the device page.

INFO

Tip: If a device has only red links or none at all, place a router closer to it, for example a smart plug, or move the device. The network rearranges itself within a few minutes; then scan again.

Device Configuration

Every ZigBee device has its own configuration page. You open it with the gear icon Configuration on the device card in the ZigBee device list or below the device name on the device page. The bar at the top shows the device name and contains Cancel and Save.

1. Firmware update:
   • When the page opens, nomos checks for new firmware for the device. The button in the bar then reads Update Device or, greyed out, No Update available.
   • After you click Update Device, nomos asks: Update the firmware? – "The device cannot be reached during the update. Do not cut its power." Confirm with Update.
   • During the update, the button shows the progress in percent. Depending on the device, an update can take a long time. Afterwards nomos reads the version again.
2. Device settings:
   • Which settings appear depends on the device. Labels and descriptions come from the device description and are in English. Depending on the setting, you enter a number (some with a unit and a preset list), a text or a pair of numbers, tick a checkbox or pick a value from a list.
   • For battery-operated devices, unreachableTreshold comes first: the time in minutes (default 120) after which nomos marks the device as not reachable if it has not reported.
   • Philips Hue lamps offer the behaviour after a power failure: hue power on behavior, plus brightness, colour temperature or colour. OSRAM/LEDVANCE lamps offer remember state.
   • Save applies the values and sends them to the device. If the device has no settings, the page shows "No settings available."