Logo Domoticz

INTÉGRATIONS

Domoticz

Recevoir les mesures du boîtier dans Domoticz en passant par un relais Node-RED vers l’API MQTT de Domoticz.

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

Logo Node-REDAvec Node-RED

Domoticz ne lit pas un topic JSON quelconque : il attend ses propres messages sur domoticz/in. Un relais Node-RED fait la traduction.

  1. Dans Domoticz, activez le matériel « MQTT Client Gateway » sur votre broker et créez un capteur virtuel par mesure (notez leurs idx).
  2. Dans Node-RED, reliez un nœud mqtt in sur …/telemetry (sortie JSON) à la fonction ci-dessous, puis à un nœud mqtt out sur domoticz/in.
  3. Remplacez les idx de l’exemple par ceux de vos capteurs.
function.jsjavascript
// Node-RED, nœud "function" entre :
//   entrée  : mqtt in  PoolNexusV1-<SERIE>/telemetry (sortie : objet JSON parsé)
//   sortie  : mqtt out domoticz/in
// Remplacez 101, 102, 103 par les idx de vos capteurs virtuels Domoticz.
const t = msg.payload;
const out = [];
if (typeof t.ph === 'number') out.push({ payload: { idx: 101, nvalue: 0, svalue: String(t.ph) } });
if (typeof t.orp === 'number') out.push({ payload: { idx: 102, nvalue: 0, svalue: String(t.orp) } });
if (typeof t.temperature === 'number') out.push({ payload: { idx: 103, nvalue: 0, svalue: String(t.temperature) } });
return [out];

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