INTÉGRATIONS
Jeedom
Recevoir les mesures et l’état du boîtier dans Jeedom avec le plugin jMQTT, sur le broker MQTT local.
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>/#" -vAvec jMQTT
- Installez le plugin jMQTT et déclarez votre broker local (le même que celui réglé dans l’application).
- Créez un équipement abonné au topic PoolNexusV1-<SERIE>/#
- Les messages telemetry et state sont en JSON : utilisez la décomposition JSON de jMQTT pour obtenir une commande info par champ (ph, orp, temperature, pump_state…).
- Pour piloter une sortie, créez une commande action qui publie sur …/local/set le message décrit plus bas.
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