Matter

Yhdistää Athenan jo käynnissä olevaan matter-server-instanssiin (matterjs-server, tai sen arkistoitu edeltäjä python-matter-server) lukeakseen ja ohjatakseen laitteita, jotka on jo otettu käyttöön Matter-verkkoosi - sama "silta kumppaniprosessiin" -arkkitehtuuri, jota Athenan oma Z-Wave-integraatio jo käyttää, koska tuotantovalmista natiivia Matter-ohjainta ei ole upotettavaksi suoraan.

matter-serverin käyttöönotto

Ei paketoitu Athenan omiin compose-tiedostoihin - aja se omana konttinaan missä tahansa lähiverkossasi (tarvitsee todellisen verkkonäkyvyyden Matterin oman laitteiden käyttöönotto-/tunnistustoiminnon vuoksi, joten network_mode: host, ei bridge-verkkoa). Tallenna tämä omaksi docker-compose.yml-tiedostoksi uuteen kansioon:

# docker-compose.yml - matterjs-server, erillinen
services:
  matter-server:
    container_name: matter-server
    image: ghcr.io/matter-js/matterjs-server:stable
    restart: unless-stopped
    network_mode: host  # pakollinen - Matterin käyttöönotto/tunnistus tarvitsee todellisen mDNS-näkyvyyden
    volumes:
      - matter-data:/data
volumes:
  matter-data:

Aja docker compose up -d. Sen WebSocket-rajapinta kuuntelee oletuksena porttia 5580 - se on osoite/portti, jonka Athenan oma "Lisää yhdyskäytävä" -lomake tarvitsee.

Yhdyskäytävän lisääminen

Laitteet ja palvelut > Matter > "Add gateway" ottaa matter-server-instanssisi osoitteen ja portin (oletus 5580). Kun yhdistetty, "Add device" näyttää jokaisen solmun, joka on jo otettu käyttöön kyseisen palvelimen verkkoon, valittuna listalta käsin kirjoittamisen sijaan - sama kulku jota Z-Waven oma laitevalitsin jo käyttää.

Mitä tuetaan

• Kytkimet - päällä/pois, OnOff-klusterista.
• Himmentimet - LevelControl-klusterin 0-254-alue, näytettynä ja asetettuna 0-100 %-liukusäätimenä, mukaillen jokaista muuta himmennettävää valoa Athenassa.
• Lämpötila- ja kosteusanturit - TemperatureMeasurement ja RelativeHumidityMeasurement.
• Miehitys- ja totuusarvoanturit - OccupancySensing (liike/läsnäolo) ja BooleanState (kontakti, vesivuoto tai yleinen totuusarvo, laitteesta riippuen).

Jokainen tuettu entiteetti toimii Ohjauspaneelin korttien, Historian ja Automaatioiden kanssa tarkalleen kuten mikä tahansa muu integraatio. Värinhallintaa ja valaistusvoimakkuusantureita ei vielä tueta - valaistusvoimakkuus erityisesti käyttää logaritmisesti koodattua arvoa, jonka Matter-laitteet raportoivat, mikä vaatii oikean laitteiston purun vahvistamiseen.