zwave-js-ui/docs/troubleshooting/app_crash.md

2.2 KiB

Startup crash

This is a list of issues and solutions that may help you to solve startup problems.

Application does not start after updating to version 5.10.x or higher

The error message looks like this:

Failed to initialize the driver: ZWaveError: The driver is not ready or has been destroyed

If this happens on Linux (e.g. Raspberry Pi), it can happen that the USB stick gets a new address on reboot, for example changes from /dev/ttyUSB0 to /dev/ttyUSB1.

This can be avoided by using a fixed address for the USB stick. To do this, execute

ls -l /dev/serial/by-id

on the console and determine which of them corresponds to the Z-Wave stick, recognizable by the referenced path:

...
lrwxrwx 1 root root 13 Oct 25 20:19 usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_8ad925bd7b84e911a7a1d6217343c2-if00-port0 -> ../../ttyUSB0

In this case

/dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_8ad925bd7b84e911a7a7a1d6217343c2-if00-port0

should be entered in the Z-Wave settings instead of /dev/ttyUSB0.

If this does not help, the stick restart can be disabled by disabling Soft Reset option under Z-Wave settings, but this may limit functionality.

This is definitely necessary with the zwave.me UZB1. However, the adapter tries to detect this stick by itself.

Raspberry PI crash with 8.2.0+

If you are getting this error on startup:

#
# Fatal error in , line 0
# unreachable code
#
#
#
#FailureMessage Object: 0x7ed0149c

You have 2 options:

  1. Upgrade to Raspbian Bullseye (Reccomended, check guide here). You can find out your distribution by executing grep "PRETTY_NAME" /etc/os-release)
  2. If you are running Raspbian Buster you need to install libseccomp2, this can be done by executing the following commands:
sudo apt-key adv --keyserver hkps://keyserver.ubuntu.com:443 --recv-keys 04EE7237B7D453EC 648ACFD622F3D138
echo "deb http://httpredir.debian.org/debian buster-backports main contrib non-free" | sudo tee -a "/etc/apt/sources.list.d/debian-backports.list"
sudo apt update
sudo apt install libseccomp2 -t buster-backports