RaspBee II Installation

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.

Supported platforms

Raspbian
Docker

Connection

Insert the battery of type 337/SR416SW as shown in the battery slot.
The RaspBee II must be placed on the Raspberry Pi header as follows:

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

Raspberry Pi (all models, except Pico)
Raspberry Pi OS

Note

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

RTC-Installation

Install dependencies

 sudo apt update
 sudo apt install i2c-tools build-essential raspberrypi-kernel-headers

Download installation archive

 curl -O -L https://github.com/dresden-elektronik/raspbee2-rtc/archive/master.zip
 unzip master.zip

Change into extracted directory
```
 cd raspbee2-rtc-master
```
Compile RTC kernel module
```
 make
```
Install RTC kernel module
```
 sudo make install
```
Reboot Raspberry Pi
```
 sudo reboot
```
Configure system time to RTC module
```
 sudo hwclock --systohc
```

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

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.

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

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"

Update APT package list
```
 sudo apt update
```
Install deCONZ
```
 sudo apt install deconz
```

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

Menu > Programming > deCONZ

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

Linux x86_64/amd64
Linux armv7 (e.g. Raspberry Pi)
Linux arm64

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.

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.

Create directory for persistent configuration

 mkdir -p ~/.local/share/dresden-elektronik/deCONZ

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.