Skip to content
Awawa edited this page Dec 29, 2024 · 24 revisions

Start HyperHDR, select the Adalight LED driver but do not save changes and expand the output port list.
You should find your Zigbee coordinator. Note the path, in this example it is /dev/ttyACM0:

Install necessary components:

sudo apt update && sudo apt install -y curl
sudo curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y mosquitto nodejs git make g++ gcc libsystemd-dev

Install Zigbee2MQTT:

sudo mkdir /opt/zigbee2mqtt
sudo chown -R ${USER}: /opt/zigbee2mqtt
git clone --depth 1 https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqtt
cd /opt/zigbee2mqtt && npm ci && npm run build

Mosquitto configuration example (replace user hyperhdr and password with your choice ⚠️):

echo "allow_anonymous false" | sudo tee /etc/mosquitto/conf.d/default.conf
echo "password_file /etc/mosquitto/passwd" | sudo tee -a /etc/mosquitto/conf.d/default.conf
echo "hyperhdr:CHANGE_THIS_PASSWORD" | sudo tee /etc/mosquitto/passwd
sudo mosquitto_passwd -U /etc/mosquitto/passwd
sudo systemctl restart mosquitto

Configure Zigbee2MQTT:

cp /opt/zigbee2mqtt/data/configuration.example.yaml /opt/zigbee2mqtt/data/configuration.yaml
nano /opt/zigbee2mqtt/data/configuration.yaml

Set up the MQTT user and password, and also set the serial port you discovered in the first step of the tutorial.
I also added frontend at the end to have access to the Zigbee2MQTT configuration panel via a web browser

# Home Assistant integration (MQTT discovery)
homeassistant: false

# allow new devices to join
permit_join: true

# MQTT settings
mqtt:
  # MQTT base topic for zigbee2mqtt MQTT messages
  base_topic: zigbee2mqtt
  # MQTT server URL
  server: 'mqtt://localhost'
  # MQTT server authentication, uncomment if required:
  user: hyperhdr
  password: CHANGE_THIS_PASSWORD

# Serial settings
serial:
  # Location of CC2531 USB sniffer
  port: /dev/ttyACM0

# Enable Web frontend
frontend: true