Raspbian

Supported Raspberry Pi models and distributions

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

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

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.

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.