# \[X-Pool\] Documentation et possibilités MQTT

**URL:** <https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088>\
**Category:** Cartes Ethernet IPX800\
**Tags:** x-pool\
**Created:** [Janvier 29, 2024, 1:56 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088 "2024-01-29T13:56:21Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Janvier 29, 2024, 1:56 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/1 "2024-01-29T13:56:21Z")

</div>

Bonjour à tous,

Décidément, je poste beaucoup à propos du [X-Pool](https://gce-electronics.com/1874-.html) au fur et à mesure que la mise en service approche.

J’ai mis en œuvre MQTT (que j’utilise déjà pour d’autre devices) sur le [X-Pool](https://gce-electronics.com/1874-.html) sans trop de problème, néanmoins, je me pose quelques questions auxquelles je n’ai pas trouvé de réponses claires dans la documentation ni dans mes recherches.

Les voici :

- Existe-t-il une documentation avec l’exhaustivité des informations disponibles depuis le [X-Pool](https://gce-electronics.com/1874-.html) via MQTT ? Pour le moment, je récupère de manière ponctuelle les chemins via MQTT Explorer mais c’est laborieux et pour certains, il faut jouer aux devinettes.  
Pour le moment j’ai ceci :

- ana/ph
- ana/redox
- in/filtration
- outState/aux
- outState/filtration
- outState/heater
- outState/light  
Mais j’aimerais pouvoir disposer de l’intégralité de sorte à pouvoir faire le paramétrage nécessaire côté système domotique (jeedom) qui porte le broker.

- Le second point rejoint le premier (et une documentation donnera certainement la réponse) : S’il est possible de lire le statut des différentes E/S du [X-Pool](https://gce-electronics.com/1874-.html), est-il possible d’écrire des commandes de sorte à piloter le [X-Pool](https://gce-electronics.com/1874-.html) en publiant un message MQTT (par exemple arrêter ou démarrer la filtration) ?

En espérant avoir été clair, merci d’avance pour vos réponses.  
Bonne journée.

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Janvier 31, 2024, 8:05 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/2 "2024-01-31T08:05:48Z")

</div>

Bonjour à tous,

Je continue mes recherches, j’ai trouvé la mention suivante page 29 du manuel du [X-Pool](https://gce-electronics.com/1874-.html) :

> Vous pouvez maintenant accéder aux états de votre extension [X-POOL Connect](https://gce-electronics.com/1874-.html) et la piloter. Pour plus information quant à ce qu’il vous est possible de faire en MQTT, veuillez vous référer à la documentation API du [X-POOL Connect](https://gce-electronics.com/1874-.html).

Sauf que j’ai beau chercher, je ne trouve pas cette documentation API, pourriez-vous m’aider svp ?

Bonne journée.

---

<div class="post-metadata">

**Author:** ![fgtoul](https://forum.gce-electronics.com/user_avatar/forum.gce-electronics.com/fgtoul/32/28801_2.png) [@fgtoul](https://forum.gce-electronics.com/u/fgtoul)\
**Post date:** [Janvier 31, 2024, 8:28 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/3 "2024-01-31T08:28:49Z")

</div>

Bonjour,  
la doc API est incluse dans l’archive en téléchargement sur le site officiel.

 ![image](https://forum.gce-electronics.com/uploads/default/original/3X/b/e/beec35cd3b2ce145e91e024ffe46e5b5244ceff2.png)

 ![image](https://forum.gce-electronics.com/uploads/default/original/3X/9/2/92c044c116e020d49a5c3808d1f9e42e251efbb6.png)  
bonne journée

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Janvier 31, 2024, 8:40 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/4 "2024-01-31T20:40:32Z")

</div>

Bonjour,

Un immense Merci ! Ca fonctionne nettement mieux avec la documentation 😅 !

J’ai pourtant mis à jour le [X-Pool](https://gce-electronics.com/1874-.html) mais je suis passé totalement à côté de la doc API MQTT !

Est-ce moi ou cette documentation devrait également être en téléchargement direct dans les ressources disponibles pour le [X-Pool](https://gce-electronics.com/1874-.html) ici : [GCE Download Center (gce-electronics.com)](https://download.gce-electronics.com/) ?

Cordialement,

Olivier

---

<div class="post-metadata">

**Author:** ![Purpleman](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/p/b9bd4f/32.png) [@Purpleman](https://forum.gce-electronics.com/u/Purpleman)\
**Post date:** [Mars 11, 2024, 2:18 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/5 "2024-03-11T14:18:56Z")

</div>

Bonjour Milkshake,  
J’aimerai comme vous contrôler mon [x-pool](https://gce-electronics.com/1874-.html) via mqtt avec home assistant. Mais pour le moment, j’arrive seulement récupérer les donnée de température, PH et redox, mais pas à contrôler la filtration, lumière chauffage, etc.  
A chaque fois que j’essaie de les implémenter dans mon mqtt.yaml, j’ai un message d’erreur.  
Auriez vous la solution de votre coté ?

Merci d’avance.

Bonne journée.

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Mars 11, 2024, 8:20 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/6 "2024-03-11T20:20:25Z")

</div>

Bonjour @Purpleman,

Les tentatives que j’ai pu faire avec le composant MQTT de HA n’ont pas été très concluantes et pour le moment, je n’ai pas basculer depuis Jeedom pour cette raison et d’autres.

Peux-tu nous partager l’extrait de ton mqtt.yaml et le message d’erreur en question ? Est-ce que ça fonctionne avec MQTT Explorer déjà ?

Je vais refaire une tentative pour voir ce que ça donne dès que j’ai un moment.

Bonne soirée.

---

<div class="post-metadata">

**Author:** ![Purpleman](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/p/b9bd4f/32.png) [@Purpleman](https://forum.gce-electronics.com/u/Purpleman)\
**Post date:** [Mars 11, 2024, 10:02 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/7 "2024-03-11T22:02:43Z")

</div>

Bonjour Milkshake,

J’ai réussi via mon fichier mqtt.yaml à faire remonter sans problème tous les sensors. Par contre, à chaque fois que je veux ajouter la filtration et la lumière pour le moment, même en suivant les multiples exemples et tuto, j’ai toujours une erreur de syntaxe, mais je n’arrive pas à voir d’où ça vient alors que c’est le même procédé qu’avec les sensors le retour d’état en plus.  
Je vous tient au courant, si j’arrive à plus de résultats.

Bonne soirée.

---

<div class="post-metadata">

**Author:** ![mcc37](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/c37758/32.png) [@mcc37](https://forum.gce-electronics.com/u/mcc37)\
**Post date:** [Mars 11, 2024, 10:15 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/8 "2024-03-11T22:15:23Z")

</div>

Le mieux serait de nous partager ta config.

J’ai un [X-Pool](https://gce-electronics.com/1874-.html) esclave d’une [v5](https://gce-electronics.com/1799-.html), le MQTT passe très bien. Pas de raison que ça ne fonctionne pas via le [X-Pool](https://gce-electronics.com/1874-.html) en direct.

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Mars 11, 2024, 10:28 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/9 "2024-03-11T22:28:45Z")

</div>

Bonsoir @Purpleman,

Je viens de faire un essai avec la lumière, ça fonctionne correctement.

Voici ce que j’ai dans le configuration.yaml :

```auto
mqtt:
  switch:
  - name: "Piscine Lumière"
    unique_id: "x-pool_00005D_light_yaml"
    command_topic: "x-pool_00005D/outCmd/light"
    state_topic: "x-pool_00005D/outState/light"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "x-pool_00005D"

```

---

<div class="post-metadata">

**Author:** ![mcc37](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/c37758/32.png) [@mcc37](https://forum.gce-electronics.com/u/mcc37)\
**Post date:** [Mars 12, 2024, 7:23 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/10 "2024-03-12T07:23:09Z")

</div>

Tu as au minimum un problème d’indentation dans ton yaml, ton - et toutes les lignes qui suivent doit être décalé de 2 espaces.

Il me semble qu’il ne fat pas de guillemets sur le unique\_id également.

Sinon, ma config pour un des switchs via la [v5](https://gce-electronics.com/1799-.html) :

```auto
    - name: Spots Piscine
      unique_id: switch.spots_piscine
      state_topic: "IPX/XPool/Spots"
      command_topic: "IPX/XPool/Spots"
      payload_on: "1"
      payload_off: "0"
      retain: true

```

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Mars 13, 2024, 8:53 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/11 "2024-03-13T20:53:13Z")

</div>

Bonsoir,

Merci pour la remarque @mcc37, j’ai corrigé l’indentation, je ne comprends pas trop ce qui s’est passé car le Yaml était valide sur HA. Pour ce qui est du unique\_id, je me suis inspiré de la doc officielle HA qui comporte des guillemets donc je suppose que c’est valide.

@Purpleman J’ai poussé un peu ma configuration et j’ai quelque chose de fonctionnel, voici le Yaml :

```auto
sensor:
  #Piscine
  - name: "PH"
    unique_id: "automate.gce.x-pool_00005D.ph"
    device_class: "ph"
    state_class: "measurement"
    state_topic: "x-pool_00005D/ana/ph"
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
      manufacturer: "GCE Electronics"
      model: "X-Pool"
  - name: "Redox"
    unique_id: "automate.gce.x-pool_00005D.redox"
    device_class: "voltage"
    state_class: "measurement"
    state_topic: "x-pool_00005D/ana/redox"
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
  - name: "Température eau"
    unique_id: "automate.gce.x-pool_00005D.water-temp"
    device_class: "temperature"
    state_class: "measurement"
    state_topic: "x-pool_00005D/ana/eau"
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
  - name: "Température air"
    unique_id: "automate.gce.x-pool_00005D.air-temp"
    device_class: "temperature"
    state_class: "measurement"
    state_topic: "x-pool_00005D/ana/air"
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"

switch:
  - name: "Piscine Filtration"
    unique_id: "automate.gce.x-pool_00005D.filtration"
    command_topic: "x-pool_00005D/outCmd/filtration"
    state_topic: "x-pool_00005D/outState/filtration"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
  - name: "Piscine Lumière"
    unique_id: "automate.gce.x-pool_00005D.light"
    command_topic: "x-pool_00005D/outCmd/light"
    state_topic: "x-pool_00005D/outState/light"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
  - name: "Piscine Heater"
    unique_id: "automate.gce.x-pool_00005D.heater"
    command_topic: "x-pool_00005D/outCmd/heater"
    state_topic: "x-pool_00005D/outState/heater"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"
  - name: "Piscine Aux"
    unique_id: "automate.gce.x-pool_00005D.aux"
    command_topic: "x-pool_00005D/outCmd/aux"
    state_topic: "x-pool_00005D/outState/aux"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "automate.gce.x-pool_00005D"
      name: "X-Pool"

```

En espérant que ça aide.

---

<div class="post-metadata">

**Author:** ![Purpleman](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/p/b9bd4f/32.png) [@Purpleman](https://forum.gce-electronics.com/u/Purpleman)\
**Post date:** [Mars 13, 2024, 9:36 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/12 "2024-03-13T21:36:44Z")

</div>

Bonjour,

Je viens d’essayer votre config, mais j’ai toujours le même soucis. Je recois très bien les données des différentes sondes, mais impossible de commander les relais.  
J’ai plus de messages d’erreur de mon fichiers .yaml, j’ai bien les commandes des différents contacteur (filtration, light, aux, heater), mais rien de ne se passe quand j’envoie une commande. Comme si mon [x-pool](https://gce-electronics.com/1874-.html) envoyait bien les données, mais ne les recevait pas.

Si vous avez une idée, je suis preneur.

Bonne journée.

```auto
sensor:
  #Piscine
  - name: "PH"
    unique_id: "x-pool_000052.ph"
    device_class: "ph"
    state_class: "measurement"
    state_topic: "x-pool_000052/ana/ph"
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
      manufacturer: "GCE Electronics"
      model: "X-Pool"
  - name: "Redox"
    unique_id: "x-pool_000052.redox"
    device_class: "voltage"
    state_class: "measurement"
    state_topic: "x-pool_000052/ana/redox"
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
  - name: "Température eau"
    unique_id: "x-pool_000052.water-temp"
    device_class: "temperature"
    state_class: "measurement"
    state_topic: "x-pool_000052/ana/eau"
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
  - name: "Température air"
    unique_id: "x-pool_000052.air-temp"
    device_class: "temperature"
    state_class: "measurement"
    state_topic: "x-pool_000052/ana/air"
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"

switch:
  - name: "Piscine Filtration"
    unique_id: "x-pool_000052.filtration"
    command_topic: "x-pool_000052/outCmd/filtration"
    state_topic: "x-pool_000052/outState/filtration"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
  - name: "Piscine Lumière"
    unique_id: "x-pool_000052.light"
    command_topic: "x-pool_000052/outCmd/light"
    state_topic: "x-pool_000052/outState/light"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
  - name: "Piscine Heater"
    unique_id: "x-pool_000052.heater"
    command_topic: "x-pool_000052/outCmd/heater"
    state_topic: "x-pool_000052/outState/heater"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"
  - name: "Piscine Aux"
    unique_id: "x-pool_000052.aux"
    command_topic: "x-pool_000052/outCmd/aux"
    state_topic: "x-pool_000052/outState/aux"
    payload_on: "1"
    payload_off: "0"
    state_on: "1"
    state_off: "0"
    optimistic: false
    qos: 0
    retain: true
    device:
      identifiers: "x-pool_000052"
      name: "X-Pool"

```

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Mars 25, 2024, 9:07 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/13 "2024-03-25T21:07:26Z")

</div>

Bonjour @Purpleman,

Navré pour la réponse tardive, je n’avais pas vu ta dernière publication.

Je n’ai malheureusement pas de solutions toutes prêtes mais j’ai quelques questions pour essayer de diagnostiquer.

Peux-tu nous indiquer quel est le firmware de ton [X-Pool](https://gce-electronics.com/1874-.html) ? En effet, dans le changelog de la v2.2, il y a cette mention et je me souviens que j’avais rencontré un problème similaire au tiens dans la version précédente :

```auto
*** Version 2.2 (29/08/2023)
## Fixed
* MQTT: Déblocage du pilotage.

```

Autre question, déjà posée, mais je suis du genre tenace 😬 : Parviens-tu à piloter ton [X-Pool](https://gce-electronics.com/1874-.html) via [MQTT Explorer](https://mqtt-explorer.com/) ? Au moins, on met de côté d’éventuels problèmes côté HA de cette façon.

---

<div class="post-metadata">

**Author:** ![Purpleman](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/p/b9bd4f/32.png) [@Purpleman](https://forum.gce-electronics.com/u/Purpleman)\
**Post date:** [Mars 26, 2024, 8:41 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/14 "2024-03-26T08:41:01Z")

</div>

Bonjour @Milkshake,

J’ai bien fait la mise à jour de mon [X-pool](https://gce-electronics.com/1874-.html) en version 2.2 directement à la première utilisation en sortie de boite.  
Quand j’utilise MQTT explorer, les données venant des sondes arrivent bien (je vois bien les mises à jour régulières des données) , par contre, je n’arrive pas non plus à envoyer des infos via MQTT explorer vers le pool. Les données partent mais rien ne se passe. Impossible de commander les contacteurs.  
J’avais aussi une inversion des contacteurs éclairage et chauffage. Je vais essayer de re-appliquer la mise à jour pour voir si ça change…

En tout cas, merci de suivre ce poste.

Bonne journée.

---

<div class="post-metadata">

**Author:** ![Milkshake](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/m/dc4da7/32.png) [@Milkshake](https://forum.gce-electronics.com/u/Milkshake)\
**Post date:** [Mars 28, 2024, 11:00 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/15 "2024-03-28T23:00:26Z")

</div>

Bonjour @Purpleman,

Dernière idée en date (je me suis souvenu que j’avais dû le faire et depuis ça fonctionne) : faire un reset du [X-Pool](https://gce-electronics.com/1874-.html) et reparamétrer le broker MQTT.

Au fait, tu n’as pas indiqué quel broker tu utilises, peux-tu le préciser ?

Bonne nuit

---

<div class="post-metadata">

**Author:** ![harry83](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/h/c4cdca/32.png) [@harry83](https://forum.gce-electronics.com/u/harry83)\
**Post date:** [Août 4, 2026, 9:05 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/16 "2026-08-04T09:05:26Z")

</div>

Bonjour,

il semblerai que la dernière mise a jour cause des soucis

La configuration MQTT n’est pas sauvegardée lors d’une coupure de courant

Les parametres MQTT ( «&nbsp;outCmd&nbsp;» & «&nbsp;in&nbsp;» ) ne se synchronise plus avec «&nbsp;outState&nbsp;» ou j’ai mal compris

Il nous manque via MQTT la version du firmware installé

(pour ne pas repasser en OTA pour simplement valider entre le [x-pool](https://gce-electronics.com/1874-.html) & le download)

Merci

---

<div class="post-metadata">

**Author:** ![fgtoul](https://forum.gce-electronics.com/user_avatar/forum.gce-electronics.com/fgtoul/32/28801_2.png) [@fgtoul](https://forum.gce-electronics.com/u/fgtoul)\
**Post date:** [Août 4, 2026, 9:34 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/17 "2026-08-04T09:34:30Z")

</div>

Bonjour @harry83  
avez-vous ouvert un ticket ?  
Bonne journée

---

<div class="post-metadata">

**Author:** ![harry83](https://forum.gce-electronics.com/letter_avatar_proxy/v4/letter/h/c4cdca/32.png) [@harry83](https://forum.gce-electronics.com/u/harry83)\
**Post date:** [Août 4, 2026, 11:59 UTC](https://forum.gce-electronics.com/t/x-pool-documentation-et-possibilites-mqtt/18088/18 "2026-08-04T11:59:54Z")

</div>

Bonjour François,

Fait, Je ferai un retour des infos du support

Merci.