RaspBee II

Installation

The deCONZ application is a tool to configure, control and monitor Zigbee networks with the RaspBee II.

The following sections describe the installation steps of deCONZ for various platforms.

RaspBee II / deCONZ / Phoscon App

Supported platforms

Connection

  1. Insert the battery of type 337/SR416SW as shown in the battery slot.

    Insert battery
  2. The RaspBee II must be placed on the Raspberry Pi header as follows:

    RaspBee II placed on Raspberry Pi Header

    Important: The RaspBee II must not be placed in an offset position, as this will damage the module!

Note

Connection problems can occur if USB 3.0 devices - such as external hard drives or memory sticks - are located in the immediate surroundings of the Raspberry Pi on which the RaspBee II is plugged.
This can be avoided by using a USB extension cable.

RaspBee II placed on Raspberry Pi Header perspective

Raspbian

Supported Raspberry Pi models and distributions

Note

The following steps describe the manual installation of deCONZ. Alternatively a preinstalled SD-card image can be used.

RTC-Installation

  1. Install dependencies

     sudo apt update
     sudo apt install i2c-tools build-essential raspberrypi-kernel-headers
  2. Download installation archive

     curl -O -L https://github.com/dresden-elektronik/raspbee2-rtc/archive/master.zip
     unzip master.zip
  3. Change into extracted directory

     cd raspbee2-rtc-master
  4. Compile RTC kernel module

     make
  5. Install RTC kernel module

     sudo make install
  6. Reboot Raspberry Pi

     sudo reboot
  7. Configure system time to RTC module

     sudo hwclock --systohc
  8. Test that RTC is working

     sudo hwclock --verbose
    Waiting in loop for time from /dev/rtc0 to change
     ...got clock tick
     Time read from Hardware Clock: 2020/03/06 13:55:21
     Hw clock time : 2020/03/06 13:55:21 = 1583502921 seconds since 1969
     Time since last adjustment is 1583502921 seconds
     Calculated Hardware Clock drift is 0.000000 seconds
     2020-03-06 14:55:20.017097+01:00

deCONZ Installation

  1. Configure user access rights of the serial interface

     sudo raspi-config

    Interface Options → Serial Port

    • Would you like a login shell accessible over serial? → No
    • Would you like the serial port hardware to be enabled? → Yes

    Note: Changes to access rights only become active after a restart.

  2. Import Phoscon public key

    wget -qO- https://phoscon.de/apt/deconz.pub.key | gpg --dearmor | \
              sudo tee /etc/apt/trusted.gpg.d/deconz-keyring.gpg >/dev/null
  3. Configure the APT repository for deCONZ

    Stable

    sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
                generic main' > \
                /etc/apt/sources.list.d/deconz.list"

    Beta (alternative)

    sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
                generic-beta main' > \
                /etc/apt/sources.list.d/deconz.list"
  4. Update APT package list

     sudo apt update
  5. Install deCONZ

     sudo apt install deconz

After the installation deCONZ can be started via the application menu.

Menu > Programming > deCONZ

deCONZ Raspbian Screenshot

Now the first Zigbee devices can be paired via the Phoscon App. Further information can be found in the Phoscon App documentation.

Docker

Supported host systems

To run deCONZ in a Docker container, we recommend the Docker image deconz-community/deconz-docker, which is maintained by the community.

The installation steps are described on https://github.com/deconz-community/deconz-docker.

https://hub.docker.com/r/marthoc/deconz

Installation

The following steps describe how to start the deCONZ container on a Linux host system.

  1. Configure user access rights of the serial interface

     sudo raspi-config

    Interfacing Options → Serial

    • Would you like a login shell accessible over serial? → No
    • Would you like the serial port hardware to be enabled? → Yes

    Note: Changes to access rights only become active after a restart.

  2. Create directory for persistent configuration

     mkdir -p ~/.local/share/dresden-elektronik/deCONZ
  3. Start deCONZ Docker container

     docker run -d \
       --name=deconz \
       --net=host \
       --restart=always \
       -v /etc/localtime:/etc/localtime:ro \
       -v ~/.local/share/dresden-elektronik/deCONZ:/root/.local/share/dresden-elektronik/deCONZ \
       --device=/dev/ttyAMA0 \
       marthoc/deconz

With this configuration deCONZ runs in a Docker container on port 80.

Now the first Zigbee devices can be paired via the Phoscon App. Further information can be found in the Phoscon App documentation.

A description of all available parameters as well as the use of Docker-Compose and VNC to access the deCONZ GUI can be found in the Container Documentation.