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.
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
Le 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.
| Topic | Contenu | Usage |
|---|---|---|
| PoolNexusV1-<SERIE>/telemetry | orp (mV), ph, temperature (°C), pressure1_bar, pressure2_bar, ts | Mesures, toutes les 30 secondes. |
| PoolNexusV1-<SERIE>/state | pump_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>/lwt | online | offline | Présence, retenue : « offline » est posé par le broker si le boîtier disparaît. |
| PoolNexusV1-<SERIE>/local/telemetry | ph, 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/status | outputs, 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
mosquitto_sub -h <BROKER> -p 8883 --capath /etc/ssl/certs -u <USER> -P <PASSWORD> -t "PoolNexusV1-<SERIE>/#" -vSans 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.
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: connectivityL’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.
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