deCONZ

Yhdistää deCONZ/ConBee/RaspBee-yhdyskäytävän omaan paikalliseen REST-rajapintaan, ja reaaliaikaiset päivitykset työnnetään sen omaan WebSocketiin. Eriytetty omaksi integraatiokseen, erillään Zigbeestä - deCONZ-yhdyskäytävä ja paljas EZSP-koordinaattori ovat molemmat käsitteellisesti "Zigbee-koordinaattoreita", mutta puhuvat täysin eri paikallisia protokollia, joten kummallakin on nyt omat yhdyskäytävänsä, laitteensa ja asetuksensa.

deCONZ:n käyttöönotto

Ei paketoitu Athenan omiin compose-tiedostoihin - aja se omana konttinaan sillä koneella, johon ConBee/RaspBee-tikku on fyysisesti kytketty. Athenan omassa repossa on jo valmis docker-compose-deconz.yml (ja siihen kuuluva .env.deconz.example) - kopioi molemmat, täytä .env, ja aja suoraan docker compose -f docker-compose-deconz.yml up -d. Tai tallenna tämä katkelma omaksi docker-compose.yml-tiedostoksi uuteen kansioon:

# docker-compose.yml - deCONZ, erillinen
services:
  deconz:
    container_name: deconz
    image: deconzcommunity/deconz:latest
    restart: unless-stopped
    devices:
      # Käytä /dev/serial/by-id/... -polkua (ks. `ls /dev/serial/by-id/`), älä /dev/ttyACM0/ttyUSB0 -
      # tuo osoite voi vaihtua uudelleenkäynnistysten välillä, jos useampi USB-sarjasovitin on kytkettynä.
      - '/dev/serial/by-id/<oma-tikkusi>:/dev/ttyACM0'
    volumes:
      - deconz-data:/opt/deCONZ
    ports:
      - '8080:8080'  # deCONZ:n oma web-käyttöliittymä (Phoscon) + REST-rajapinta - vastaa Athenan omaa oletusporttia alla
      - '8443:8443'  # WebSocket-rajapinta, jota Athenan oma reaaliaikayhteys käyttää
    environment:
      - DECONZ_DEVICE=/dev/ttyACM0
      - DECONZ_WEB_PORT=8080
      - DECONZ_WS_PORT=8443
      # - DECONZ_BAUDRATE=115200 # ConBee III; käytä 38400 RaspBee II:lle
volumes:
  deconz-data:

Aja docker compose up -d, avaa sitten kerran http://<tuo-isäntä>:8080 ajaaksesi Phosconin oman asetusohjatun toiminnon ja luodaksesi API-avaimen (Settings > Gateway > Advanced > Authenticate app, tai "unlock gateway" -vaihe deCONZ-työpöytäsovelluksessa) - Athenan oma "Lisää yhdyskäytävä" -lomake tarvitsee tämän avaimen sekä tämän koneen osoitteen ja yllä olevan 8080-portin.

Yllä oleva devices:-kartoitus lukitsee yhden tietyn tikun yhteen kiinteään kontin puoleiseen laitesolmuun - Docker ratkaisee sen kerran kontin käynnistyessä, joten tikun irrottaminen (tai vaihtaminen toiseen) ei ole taattu toimimaan ilman docker compose up -d -komennon ajamista uudelleen. Oikeaa kuumavaihtotukea varten liitä sen sijaan koko isäntäkoneen /dev ja myönnä asiaankuuluva laiteluokka - sama kompromissi, joka on dokumentoitu Athenan omassa docker-compose.yml-tiedostossa sen Zigbee EZSP -liitännälle:

devices:
  - /dev:/dev
device_cgroup_rules:
  - 'c 166:* rmw'  # ttyACM* - USB CDC-ACM, esim. ConBee II/III
environment:
  # Osoita tämä suoraan vakaaseen by-id-polkuun /dev/ttyACM0:n sijaan - kun koko isäntäkoneen
  # /dev on näkyvissä yllä, tuo symlinkki (ja mihin todelliseen laitteeseen se osoittaa
  # kytkennän jälkeen) näkyy myös kontin sisällä, joten deCONZ löytää saman tikun vaikka se
  # numeroituisi uudelleen eri ttyACMn:ksi.
  - DECONZ_DEVICE=/dev/serial/by-id/<oma-tikkusi>

Yhdyskäytävän lisääminen

Laitteet ja palvelut > deCONZ > "Lisää yhdyskäytävä" ottaa vastaan tikun osoitteen, portin sekä API-avaimen, joka luodaan deCONZ:n omalla "avaa yhdyskäytävä" -paritusvaiheella (tehdään kerran, deCONZ-sovelluksesta käsin). Päätelaitteet lisätään käsin yhdistetyn yhdyskäytävän alle - IEEE-osoite, päätepiste ja laitetyyppi - eikä niitä tunnisteta automaattisesti.

Mitä on tuettu

• Kytkimet - päällä/pois, ohjattavissa.
• Himmennettävät valot - päällä/pois sekä kirkkaus, pidetään Zigbeen omalla natiivilla 0-254-alueella.
• Värivalot - lisää sävy/kylläisyys-värin ja värilämpötilan himmennyksen päälle.
• Lämpötila- ja läsnäoloanturit - vain luku.

Jokainen laitetyyppi toimii ohjauspaneelikorttien ja automaatioiden kanssa aivan kuin mikä tahansa muu integraatio. deCONZ-entiteettejä ei ole vielä kytketty Historia-sivun monen kohteen kaavionvalitsimeen.