Logo Home Assistant

INTÉGRATIONS

Home Assistant

Home Assistant trouve le boîtier tout seul sur votre broker MQTT local : mesures, état, alertes, réglages et commandes, sans configuration à écrire.

Découverte automatique

Reliez l’intégration MQTT de Home Assistant (version 2024.11 ou plus récente) au broker du boîtier. Home Assistant trouve le boîtier tout seul et affiche un appareil « Pool Nexus <série> » avec ses mesures, son état, ses alertes, ses réglages et ses commandes. Rien à écrire dans configuration.yaml.

Le boîtier publie sa découverte en messages retenus sur les topics ci-dessous, à chaque connexion et dès que sa configuration change. La disponibilité suit le topic lwt. Les noms des entités suivent la langue du boîtier (français ou anglais) ; une sortie non câblée ou un capteur non posé n’apparaît pas.

text
homeassistant/device/poolnexus_<SERIE>_measures/config
homeassistant/device/poolnexus_<SERIE>_status/config
homeassistant/device/poolnexus_<SERIE>_alerts/config
homeassistant/device/poolnexus_<SERIE>_settings/config
homeassistant/device/poolnexus_<SERIE>_controls/config

Logo MQTTLe mode local

En plus de sa connexion au cloud Nexus, le boîtier peut ouvrir une seconde connexion vers un broker MQTT que vous choisissez. Rien de ce qui suit ne passe par les serveurs Nexus.

  • Le broker (adresse, port, identifiant et mot de passe) se règle dans l’application mobile, dans la configuration locale du boîtier ou pendant la mise en service. Il s’applique tout de suite, sans redémarrer le boîtier.
  • Tous les topics commencent par l’identité du boîtier : PoolNexusV1- suivi de son numéro de série. Le boîtier y publie les mêmes messages qu’au cloud, plus des topics local/… propres au mode local. Messages en JSON, nombres jamais en chaîne.
  • La connexion est chiffrée (TLS) par défaut et demande un identifiant et un mot de passe. Un broker non chiffré doit être autorisé explicitement : n’importe qui sur votre réseau peut alors lire les mesures, et le boîtier n’accepte plus de ce broker que les éclairages.
TopicContenuUsage
PoolNexusV1-<SERIE>/telemetryorp (mV), ph, temperature (°C), pressure1_bar, pressure2_bar, tsMesures, toutes les 30 secondes.
PoolNexusV1-<SERIE>/statepump_state, lights_state, lights_2_state, water_level_ok, ph_product_level, redox_product_level, flow_ok…État complet, retenu, à chaque changement et au moins toutes les 60 secondes.
PoolNexusV1-<SERIE>/lwtonline | offlinePrésence, retenue : « offline » est posé par le broker si le boîtier disparaît.
PoolNexusV1-<SERIE>/local/telemetryph, orp, temperature, pressure1_bar, pressure2_bar, ph_mv, orp_mv…Mesures et valeurs brutes des sondes, toutes les 5 secondes par défaut (réglable de 1 à 300 s).
PoolNexusV1-<SERIE>/local/statusoutputs, alerts, dosing, probes…Sorties, alertes, dosage, sondes et diagnostic. Retenu, au moins toutes les 30 secondes.
PoolNexusV1-<SERIE>/local/set{"outputs": {"lights": true}}, ph_target, pump_mode…Réglages et sorties à changer, acceptés depuis votre broker (réponse sur local/result).

Liste complète des entités, des topics et des clés acceptées : MQTT local et domotique

vérifier la réceptionbash
mosquitto_sub -h <BROKER> -p 8883 --capath /etc/ssl/certs -u <USER> -P <PASSWORD> -t "PoolNexusV1-<SERIE>/#" -v

Sans découverte : capteurs MQTT à la main

Pour une version de Home Assistant antérieure à 2024.11, déclarez vous-même les capteurs à partir des messages du boîtier. Remplacez <SERIE> par le numéro de série.

configuration.yamlyaml
mqtt:
  sensor:
    - name: "Piscine pH"
      unique_id: poolnexus_<SERIE>_ph
      state_topic: "PoolNexusV1-<SERIE>/telemetry"
      value_template: "{{ value_json.ph }}"
      unit_of_measurement: "pH"
      state_class: measurement
    - name: "Piscine redox"
      unique_id: poolnexus_<SERIE>_orp
      state_topic: "PoolNexusV1-<SERIE>/telemetry"
      value_template: "{{ value_json.orp }}"
      unit_of_measurement: "mV"
      state_class: measurement
    - name: "Piscine température"
      unique_id: poolnexus_<SERIE>_temperature
      state_topic: "PoolNexusV1-<SERIE>/telemetry"
      value_template: "{{ value_json.temperature }}"
      unit_of_measurement: "°C"
      device_class: temperature
      state_class: measurement
  binary_sensor:
    - name: "Piscine filtration"
      unique_id: poolnexus_<SERIE>_pump
      state_topic: "PoolNexusV1-<SERIE>/state"
      value_template: "{{ 'ON' if value_json.pump_state else 'OFF' }}"
    - name: "Piscine en ligne"
      unique_id: poolnexus_<SERIE>_online
      state_topic: "PoolNexusV1-<SERIE>/lwt"
      payload_on: "online"
      payload_off: "offline"
      device_class: connectivity

L’intégration Nexus System Local (HACS)

Facultative : la découverte crée déjà toutes les entités. Nexus System Local reconnaît tous vos appareils Nexus System et ajoute la liaison locale de chaque appareil, l’action « Envoyer à un appareil Nexus » (nexus_system_local.send), l’évènement de réponse nexus_system_local_result, une réparation si la découverte MQTT est désactivée et un diagnostic. Elle remplace l’ancienne intégration « PoolNexus », dont les topics poolnexus/<série>/… ne sont plus publiés.

Changer un réglage ou une sortie

Publiez un objet JSON sur local/set, avec une ou plusieurs clés. L’écriture est tout ou rien : une valeur refusée et rien n’est appliqué. Le boîtier répond sur local/result. Exemple : allumer l’éclairage.

bash
mosquitto_pub -h <BROKER> -p 8883 --capath /etc/ssl/certs -u <USER> -P <PASSWORD> \
  -t "PoolNexusV1-<SERIE>/local/set" -q 1 -m "{\"outputs\":{\"lights\":true}}"

Matter

Matter est éteint par défaut. Il s’active sur l’écran du boîtier ou dans sa configuration locale, depuis l’application. Matter n’a pas de type d’appareil « piscine » ni de mesure pH ou redox : il expose la température de l’eau, les capteurs de pression posés, les bidons et le niveau d’eau (capteurs de contact), la filtration et les deux éclairages (marche/arrêt). Les pompes doseuses et la vanne de remplissage ne sont jamais exposées.

Et à distance ?

Sans broker local, une domotique peut interroger l’API publique avec une clé : mêmes appareils, mêmes mesures, depuis n’importe où.

Explorateur d’API