MQTT auto-discovery

Athena toteuttaa laajalti käytetyn MQTT-tunnistuskäytännön, joten mikä tahansa, joka jo puhuu sitä - Tasmota, Shellyn oma MQTT+discovery-laiteohjelmistoasetus, Zigbee2MQTT, ESPHomen oma natiivi MQTT-komponentti - ilmestyy ilman mitään Athena-kohtaista asetusta laitteen puolella.

Mitä tunnistetaan

Anturit, binäärianturit, kytkimet, valot ja painikkeet tunnistetaan kaikki. Kytkimet ja valot saavat live-Päällä/Pois-kytkimen, painikkeet Paina-toiminnon, molemmat julkaistuna suoraan entiteetin omaan komentoaiheeseen; kaikki muu listautuu silti raa'alla tilallaan, vain luku -tilassa. Tila on elävä yksisuuntaisen WebSocketin yli - tilannekuva yhdistettäessä, sitten yksi viesti per tunnistettu, päivitetty tai poistettu entiteetti, joten laite, joka poistaa oman pysyvän tunnistusviestinsä, poistaa sen myös täältä.

Brokerin käyttöönotto

Ei paketoitu kumpaankaan käyttöönottomuotoon - aja docker-compose-mqtt.yml (erillinen Mosquitto-broker, julkaistuna lähiverkossa, jotta oikea laitteisto pääsee siihen suoraan käsiksi) sen Athena-compose-tiedoston rinnalla, jota jo käytät:

# docker-compose-mqtt.yml - Mosquitto, erillinen
services:
  mosquitto:
    container_name: athena-mosquitto
    image: eclipse-mosquitto:2
    volumes:
      - ./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro,z
      - mosquitto-data:/mosquitto/data
    ports:
      - '1883:1883'
    restart: unless-stopped
volumes:
  mosquitto-data:

Juuri tämä tiedosto (sekä sen mosquitto.conf, nimetön pääsy sallittu oletuksena) tulee mukana Athenan omassa repossa - docker compose -f docker-compose-mqtt.yml up -d. Osoita laitteesi siihen ja ne tunnistetaan samalla tavalla kuin mikä tahansa muu. Aseta MQTT_BROKER_URL=tcp://<tuo-isäntä>:1883 Athenan omaan .env-tiedostoon (tyhjä oletuksena, mikä poistaa integraation käytöstä) - tai osoita se omaan jo käynnissä olevaan brokeriisi tämän sijaan.

Sama kohtelu kuin kaikella muulla

MQTT-entiteetit ovat valittavissa Ohjauspaneelin korteissa, kaavioina History-sivulla, ja laukaisimina/ehtoina/toimintoina Automaatioissa - samoin kuin natiivi, Shelly tai mikä tahansa muu yhdistetty lähde.