Technical support

We are here for you.

If you have technical questions about our products, our support team will be happy to help you.

Help topics

In the frequently asked questions you will quickly find answers and further links to commissioning and trouble shootings, as well as general information.

Phoscon App and deCONZ

Is my system up to date?

The version number of deCONZ has the following format 2.05.xx.

The installation and update process is described on the corresponding product pages, for example the ConBee II installation. If an APT repository installation on Debian based distribution is not an option under Linux, a manual installation of the Debian package is also available.

The latest version can be found in the stable download folder. The Phoscon App offers an update from deCONZ at regular intervals. This is primarily for users who prefer a gui over the command line. Therefore it may happen that the Phoscon App reports The version is up to date although newer versions are available in the stable download folder.

Besides that there is also the beta download folder. Beta versions are made available in shorter intervals, in which new functions can be tested or certain problems can be solved with specific bug fixes.

Why are new Phoscon App features not available?

If the Phoscon App is accessed via http://phoscon.de/app the latest version on the server is used. The Phoscon App version is given by the date behind the deCONZ version number in the Phoscon App settings.

  • Menu
  • Settings
  • Gateway
software version

If accessing the Phoscon App locally in the browser via the IP address of the gateway, the version shipped with deCONZ is used. Each deCONZ release includes the latest Phoscon App version. Under certain circumstances it might be necessary to delete the app data in the browser cache to force an update.

Can I use the Phoscon App with my smartphone?

Currently, the use of the Phoscon App via smartphone is still limited, but is constantly being expanded.

In general, it is possible to control the smart home system via Phoscon App from the smartphone, but not to set up or configure the system.

Short overview of features of the Phoscon App that can be used via smartphone:

  • control lights
  • recall scenes
  • delete devices
  • rename devices

Planned features for smartphone use:

  • switch editor
  • add devices
  • create schedules

ConBee and RaspBee

What is the difference between ConBee and ConBee II?

Both devices offer the same Zigbee functionality. The ConBee II has a smaller housing.

ConBee and ConBee II are actively maintained and supported by deCONZ control software.

How can the firmware of ConBee II or RaspBee II be updated?

The firmware of ConBee II or RaspBee II can be updated via the Phoscon App.

The version number is in the format 26xx0700.

  • Menu
  • Settings
  • Gateway
update firmware

The firmware can also be updated manually on the command line as described in the wiki article Update deCONZ manually.

What is the range of ConBee, ConBee II and RaspBee?

The range in buildings is up to 30 m and in free field of sight up to 200 m. Due the power amplifier it is possible to bridge 2-3 rooms or floors depending on the building conditions.

Devices further away are connected through the Zigbee mesh network. In this network, all permanently powered Zigbee devices, such as lights and sockets, act as repeaters and can relay the signal.

The average range of IKEA, OSRAM and Philips Zigbee devices is approximately 5-7 m. With appropriate distribution, the mesh network can be spread over entire floors or the building.

What is the maximum number of devices that can be connected?

ConBee II and RaspBee II support up to 200 network participants in mixed networks - with lights and other devices.

Why is ZSHARK not mentioned on the ConBee II product page?

Currently, the software is only available for the first generation ConBee. Due to the newly used microcontroller, the ZSHARK software must be adapted, which is currently work in progress.

Devices

How to reset the FLS to factory settings?

The FLS can be reset to factory settings using the following reset sequence:

Resetsequenz FLS

  1. Switch the FLS off and on again 4 times for 5 seconds each.
  2. When the light starts flashing, wait about 10 seconds for it to stop flashing.
  3. Switch the FLS off and on 2x for approx. 5 seconds each.

    The light is reset to factory settings when it flashes briefly.

The following YouTube video shows the reset sequence.

How to reset a Philips Hue light to factory settings?
(Also applies to most lights from other manufacturers)

The simplest method is to reset it using the Philips Hue Dimmer Switch remote control.

  1. Start search for lights in the Phoscon App
  2. Turn the Philips Hue light off/on once
  3. Hold the remote control close to the light and press and hold the I and O buttons for about 10 seconds until the light illuminates.
  4. The light should now be paired within 1 minute by the Phoscon App

Alternative: If the light is still paired to the Philips Hue Bridge, it can also be deleted in the Philips Hue App. Afterwards the light resets to factory settings and can be paired by the Phoscon app.

How does a FLS behave when switched off and on again?

If an RGB/W LED-Stripe is connected, the last set color will be restored. If the brightness was less than 80 %, it will be set to 80 %.

Otherwise the last set value is restored again. The last setting must have existed at least 20 seconds before switching off in order to be recalled.

How can Friends of Hue switches be paired to the network?

Note

A list of all compatible Friends of Hue switches can be found at Compatibility list →

  1. Check the current Zigbee channel of the gateway in the Phoscon App.

    • Menu
    • Settings
    • Gateway
    • Advanced
    Find Zigbee channel in settings
  2. Go to the switch overview page.

    • Menu
    • Devices
    • Switches
    Add new switch
  3. Select than

  4. Press the button matching the Zigbee channel on the switch for 10 seconds.

    • Zigbee channel 15 → button 1
    • Zigbee channel 20 → button 2
    • Zigbee channel 11 → button 3
    • Zigbee channel 25 → button 4
    Friends of Hue key mapping
  5. Important: Complete commissioning by briefly pressing buttons 2 and 3 simultaneously.

    Friends of Hue complete commissioning
  6. Once the switch has been paired to the network, it can be easily configured via the switch editor of the Phoscon App. Phoscon App documentation →

    Friends of Hue switch in switch editor
How to update OSRAM devices?

The following steps describe the OTA update of OSRAM devices. In this example the smart plug is updated.

Note

This guide requires the deCONZ GUI with at least version 2.5.71. The headless deCONZ version is not supported yet.

  1. Select the standard OTAU plugin via the menu bar in deCONZ.

    • Menu
    • Plugins
    • STD OTAU Plugin

    Screenshot: deCONZ Menu Plugins
    Screenshot: deCONZ Menu Plugins

  2. Switch to the STD OTAU Plugin tab.

    Screenshot: deCONZ STD OTAU Plugin tab

  3. Select the device in the list.

    Screenshot: deCONZ STD OTAU Plugin

    1. Check the MAC address of the device that is to be updated.

    2. Select the appropriate device from the list using the MAC address.

  4. Download the OTAU file.

    Screenshot: LEDVANCE download page

    Remember the image type and enter it in the corresponding field on the LEDVANCE page. Download the OTAU file via the button Latest.

  5. Run the OTA update.

    Screenshot: deCONZ OTA update

    1. Select the device entry in the list.
    2. Select the OTAU file.
    3. Start the OTAU via Update button.

      Screenshot: Fortschritt des Downloads

    The process can take up to 5–10 minutes. After completion, the device will restart itself.

    Screenshot: download done

Is my Zigbee device compatible?

The compatibility of devices is divided into several compatibility lists, as a distinction is made between support in the REST API and the Phoscon App.

The Compatibility list on the Phoscon website mainly lists devices that are supported in the Phoscon app. In the future, the scope of support will be specified more precisely, e. g. whether a wizard is available for connecting and which functions are possible to use with the device.

The more comprehensive Compatibility list on GitHub contains the devices that can be used via the REST API and thus via the numerous Home Automation Systems. Both lists are currently still maintained manually and are partly incomplete due to the rapidly growing number of supported Zigbee devices, we are working on automating this process.

If the device you are looking for is not listed, it is worth taking a look at the posts on the current status of the integration in the GitHub Issues.

If it is about a recently released device that is not yet mentioned, the integration can be requested by providing deCONZ screenshots as described in the Wiki on GitHub.

Another recommendation is the Blakadder Compatibility list which is maintained by the community. This provides an extensive overview of the devices supported by the deCONZ REST API.

For home automation systems that do not use deCONZ and therefore do not use the REST API and the Phoscon app, their own compatibility lists apply, such as for Zigbee2MQTT.

Troubleshooting

IKEA TRÅDFRI lights cannot be paired.

To be able to pair an IKEA TRÅDFRI light, it must be set to factory settings. The following steps and the timing of the reset sequence must be strictly followed.

  1. Start search for lights in the Phoscon App
  2. Switch light off/on 6 times quickly (reset sequence)
  3. The light flickers briefly, then switch it off/on once again
  4. The light should now be paired within 1 minute by the Phoscon App

In this Youtube video the execution of the reset sequence is shown.

Troubleshooting for ConBee II with Linux

The following steps guide you to check and fix problems of a deCONZ installation and the ConBee II. We recommend to follow the steps one after the other.

  1. Check USB connection and mitigate USB 3.0 problems.

    Drawing: ConBee II USB extension cable

    The ConBee II should preferably be connected to a USB 2.0 socket with an USB extension cable. Connection problems may occur if the ConBee II is attached directly to the USB port or is located near USB 3.0 devices such as external hard drives or memory sticks.

  2. Check that the communication between ConBee II and deCONZ works.

    Screenshot: Firmware not connected

    If the Phoscon App in the Gateway Settings displays not connected instead of the current firmware version, it’s an indication that the communication between deCONZ and ConBee II could not be established. In this case the next steps should be performed to re-establish the connection.

  3. Check that the current deCONZ version is installed.

    This ensures that already fixed problems of earlier versions do not occur. To install the latest version, all steps must be performed at https://phoscon.de/conbee2/install for the platform used.

  4. Check that a connected ConBee II is registered in the system.

    $ lsusb
    Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
    Bus 001 Device 006: ID 8087:0a2b Intel Corp.
    Bus 001 Device 078: ID 1cf1:0030 Dresden Elektronik

    If the ConBee II has been registered in the system, the manufacturer and product code 1cf1:0030 will be shown for dresden elektronik and the ConBee II.

    If the ConBee II does not appear in the list and deCONZ is running in a virtual machine or a docker container, the USB device needs to be added to the virtual environment.

    In the case of Docker, this happens automatically when the container is started according to the installation instructions: https://phoscon.de/en/conbee2/install#docker

  5. Check that the serial interface is available.

    $ ls -l /dev/ttyACM*
    crw-rw---- 1 root dialout 166, 0 27. Jun 11:39 /dev/ttyACM0
    

    Depending on whether other USB devices are used, the device file of the ConBee II is created with a consecutive number as /dev/ttyACM0 or /dev/ttyACM1.

    Important: In order to have read and write access to the device, the user must be in the dialout group as described in the installation instructions.

  6. Check that the ConBee II firmware is installed and up to date.

    Note: If a previous update has failed, the firmware will be reinstalled.

    • Close deCONZ if it’s running
    • Unplug the ConBee II and wait 10 seconds
    • Connect the ConBee II again and wait 10 seconds
    • Install the latest firmware

      sudo GCFFlasher_internal -d /dev/ttyACM0 -t 60 \
      -f /usr/share/deCONZ/firmware/deCONZ_ConBeeII_0x26490700.bin.GCF

Community

Lots of discussion about deCONZ in connection with other home automation systems as well as suggestions for new ideas also takes place in the community.

Contact

I have one more question… The answer was not yet there?
Our support will be happy to help you.