# Water quality sensors (pH, ORP) + configurable gauges with color-coded thresholds **URL:** \ **Category:** Développement\ **Created:** [May 20, 2026, 2:06pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231 "2026-05-20T14:06:24Z")\ **Posts on this page:** 16\ **Page:** 1
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 20, 2026, 2:06pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/1 "2026-05-20T14:06:24Z")
Hi everyone 👋 I wanted to share 2 PRs that I just opened, related to a concrete case: integrating my **iopool Eco** probe (swimming pool water quality monitoring) into Gladys via MQTT. I’ve sent the probe data to Node-RED, which publishes to the MQTT broker. This allows me to create a virtual MQTT device in Gladys with the following features: temperature, pH, ORP (disinfection capacity), mode, recommended filtration duration, and date of last measurement. The problem: for **pH** and **ORP** , no sensor category matched. I had to use « Unknown » for pH and « Air Quality Index » for ORP (because `airquality-sensor` was the closest match). Not ideal. I therefore made 2 PRs (stack): * * * #### PR 1 — Water Quality Sensor Categories > 🔗 [Add water quality sensor categories (pH, ORP) by Terdious · Pull Request #2530 · GladysAssistant/Gladys · GitHub](https://github.com/GladysAssistant/Gladys/pull/2530) Added 2 generic categories, reusable by any integration (MQTT, Z2M, Matter, custom services): - `ph-sensor` — Water pH, range 0–14, new dimensionless unit `ph` - `orp-sensor` — Oxidation-Reduction Potential (Redox / « Disinfection Capacity »), in `millivolt` (existing unit) Covers swimming pool probes (iopool, Ondilo, BWT), aquariums, rainwater measurement stations, etc. Naming convention: standard scientific terms (no `disinfection-capacity-sensor`). But the FR label keeps « ORP / Disinfection Capacity » to remain accessible to the general public. * * * #### Why No Automatic Coloring on the « Device » Widget? Legitimate question: air quality (CO2, PM2.5, VOC…) displays an automatically colored badge in the Device widget based on the value. Why not do the same for pH and ORP? Because **it only works for measurements with universal thresholds**. CO2 at 1200 ppm is bad everywhere, regardless of context — it’s a global health standard. pH and ORP, on the other hand, are **absolute scales** whose « correct » range depends entirely on the use case: | Use Case | Ideal pH | Ideal ORP | | --- | --- | --- | | Swimming Pool | 7.0 – 7.4 | 650 – 750 mV | | Freshwater Aquarium | 6.5 – 7.5 | 250 – 400 mV | | Reef Aquarium | 8.1 – 8.4 | 350 – 450 mV | | Drinking Water | 6.5 – 8.5 | — | | Hydroponics | 5.5 – 6.5 | — | If we hardcoded swimming pool thresholds in the Device widget, an aquarium user would see their value in red even though their water is perfect. Misleading. There’s also a technical detail: air quality coloring is **monotonic** (« the lower, the better »). pH is a **range** : bad at the low _and_ high ends, good in the middle. The existing logic simply doesn’t apply. That’s why threshold-based coloring is handled by **PR2 (configurable gauge)**: each user defines their own thresholds based on their use case. Neutral, correct for everyone, and reusable far beyond water quality (battery, tank level, etc.). * * * #### PR 2 — Configurable Gauge with Colored Thresholds > 🔗 [Gauge dashboard widget: add configurable color thresholds by Terdious · Pull Request #2531 · GladysAssistant/Gladys · GitHub](https://github.com/GladysAssistant/Gladys/pull/2531) Reuses the threshold + color logic already present in the « Room Temperature » and « Room Humidity » widgets, **but in a generic way** on the Gauge widget: - Checkbox « Configure custom thresholds » in the editor - Double slider to define the 2 thresholds (the slider bounds come from the `min`/`max` of the feature, so consistent with pH 0-12, ORP 500-1100, battery 0-100, etc.) - 3 color selectors (low zone / in range / high zone) with the chart widget palette - Legend under the gauge with the 3 colors and the bounds formatted with the unit - **No custom thresholds → the original ApexCharts gradient is preserved (zero regression)** ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/e/6/e6f40ff966c0e058bc9e19b9e0aaf5309ac0da3d.png) ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/7/7/7734745dd59b6f3931939aadf6cb814ac0649eb3.png) * * * #### Why These Design Choices - **Separate categories** rather than an umbrella category `water-quality-sensor` with multiple types: aligned with the existing pattern (`co2-sensor`, `pm25-sensor`, `voc-sensor`, etc. — 1 category = 1 physical measurement) - **Configurable gauge** rather than a dedicated swimming pool widget: generic = useful for many more use cases (electric vehicle battery, soil humidity, dB, tank level, etc.) - **No hardcoded smart coloring** by category (e.g., « pH between 7.0-7.4 = green »): left to the user’s choice via the editor, to remain neutral on industry conventions (swimming pool ≠ aquarium ≠ spa) * * * Feedback welcome 🙏 — especially on: 1. The naming of the categories (`ph-sensor` / `orp-sensor` vs alternatives?) 2. The FR wording for ORP — is « Disinfection Capacity » clear enough for those who don’t know water chemistry? 3. Are there other use cases (aquarium, rainwater, hydroponics…) that would benefit from these categories or require others (TDS, conductivity, salinity)? 4. The configurable gauge — do you see other widgets that would deserve the same threshold/color treatment? Thanks for reading 🙂 ---
**Author:** ![guim31](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/guim31/32/4840_2.png) [@guim31](https://community.gladysassistant.com/u/guim31)\ **Post date:** [May 20, 2026, 4:00pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/2 "2026-05-20T16:00:01Z")
> [@Terdious](#): > > iopool Eco It’s been a while since I’ve been looking for a probe for my pool. I’ve always been afraid to start because I was afraid the calibration would be totally messed up / change too much over time. Can you tell me how it is on your side? 😉 ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 20, 2026, 5:31pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/3 "2026-05-20T17:31:43Z")
Hi @guim31, Yes of course, I’ve had this probe since 2022, I took one for a colleague in 2023 (Salt), and one for my dad in 2024 (Salt as well). For my part, I use Active Oxygen during the summer, I had an issue with an incorrect value in 2024, I bought the recalibration kit and then it was fine. I completely replaced it when starting up again in 2025 because the battery was dead (rated for 2 years, it lasted 3 summers). Unfortunately, it was the first version and it wasn’t disassemblable to replace just the battery, so I had to buy the new version entirely. The new ones can be opened with screws on the head and therefore you can replace the probe or the battery independently. My colleague has the new version, he hasn’t had any issues yet, maybe when starting up this year for the battery. Regarding the probe, he is a metrologist and his feedback is that it works very well. Drifts are normal in this kind of use with hibernation in the winter, but calibration is fine. Regarding the probe, as a metrologist, he gives a lifespan of 5 to 10 years, which is totally normal. For active oxygen or chlorine use, the probes are cheaper. My dad lives in the south, he doesn’t hibernate it, and no issues so far, not even a recalibration. For monitoring deviations for recalibration, you can do strip tests directly with the application to spot the deviations. I also equipped myself with an electronic pH and ORP sensor to ensure reliability. ---
**Author:** ![mutmut](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/mutmut/32/14064_2.png) [@mutmut](https://community.gladysassistant.com/u/mutmut)\ **Post date:** [May 20, 2026, 5:46pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/4 "2026-05-20T17:46:11Z")
> [@Terdious](#): > > `orp-sensor` — Oxidation-Reduction Potential (Redox / « Disinfection Capacity »), in `millivolt` (existing unit) Personally, I didn’t know ORP, but Redox makes much more sense to me because when I need to check, it’s the Redox I verify (I’m also on salt). By the way, for pools, we talk more about Redox than ORP (or maybe I need to find a bigger pool 😂). I would be more in favor of `redox-sensor` than `orp-sensor`, what do you think? And great job on the development, thanks for all you do 😉 ---
**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\ **Post date:** [May 20, 2026, 5:54pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/5 "2026-05-20T17:54:44Z")
That sounds great! Awesome development 🙂 I’ll let you know as soon as I’ve had a chance to check it out! > [@Terdious](#): > > my **iopool Eco** probe (pool water quality monitoring) to Gladys via MQTT. For your probe, wouldn’t it make sense to have a Matterbridge plugin? Don’t hesitate to test the factory, that’s what it’s for 😉 (even if, for you who already uses Claude Code, it won’t impress you as much!) ---
**Author:** ![guim31](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/guim31/32/4840_2.png) [@guim31](https://community.gladysassistant.com/u/guim31)\ **Post date:** [May 20, 2026, 7:35pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/6 "2026-05-20T19:35:53Z")
Thanks so much for your feedback, I’ll take a closer look thanks to you!!! ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 20, 2026, 8:07pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/7 "2026-05-20T20:07:33Z")
Hi mutmut, You’re right about the pool context in France: Redox is indeed the dominant term (Zodiac, Hayward, CCEI… all label their regulators « Redox »). A small clarification though: « for pools, we talk more about Redox than ORP » → that’s true in France, but internationally (and in English in general), ORP remains the standard according to my brief research. And in other fields that might use this category — aquariums, hydroponics, drinking water treatment — ORP also dominates, especially because almost all probes sold online are labeled « ORP probe ». Technically, both refer to exactly the same thing (oxidation-reduction potential in mV), it’s just a matter of regional/sectoral usage. So I would suggest a compromise: keep `orp-sensor` on the code side (international consistency, more universal for SEO and equipment search), but display « Redox / ORP » on the French UI. It speaks to everyone, French pool professionals as well as aquarists, without excluding anyone. What do you think? ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 20, 2026, 8:18pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/8 "2026-05-20T20:18:24Z")
Thanks Pierre-Gilles 😄 For the Matterbridge plugin, why not indeed! Connecting to the iopool API is quite simple, and there’s already an example integration on the Home Assistant side that we can draw inspiration from. On my end, I can share my Node-RED flow that already does the job, that should give a good basis for development. However, this will be more for the community than for me: I’m really not a fan of Matter at the moment​😅 I’ll test the factory with pleasure, a bit curious to see what it gives anyway. ---
**Author:** ![mutmut](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/mutmut/32/14064_2.png) [@mutmut](https://community.gladysassistant.com/u/mutmut)\ **Post date:** [May 20, 2026, 9:08pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/9 "2026-05-20T21:08:06Z")
> [@Terdious](#): > > I would suggest a compromise: keep `orp-sensor` in the code (international consistency, more universal for SEO and hardware search), but display « Redox / ORP » in the French UI. I think the compromise is very good 👍 ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 21, 2026, 4:31am UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/10 "2026-05-21T04:31:15Z")
> [@mutmut](#): > > I find the compromise very good 👍 It’s done! > [@pierre-gilles](#): > > For your probe, wouldn’t it make sense to have a Matterbridge plugin? > > Don’t hesitate to test the factory, that’s what it’s for 😉 (even if, for you who already use Claude Code, it won’t impress you as much!) Issue created by the AI → for the AI 😅: [[PLUGIN REQUEST] iopool EcO – pool water quality monitor (temperature, pH, ORP) · Issue #15 · GladysAssistant/matterbridge-ai-plugin-factory · GitHub](https://github.com/GladysAssistant/matterbridge-ai-plugin-factory/issues/15) With a point raised by Claude Opus 4.7: «  **One honest reservation to keep in mind: since pH and ORP don’t have a standard Matter cluster, the display in Gladys will probably be perfect for temperature and « best-effort » for pH/ORP — this is exactly the kind of feedback Pierre-Gilles expects from this test.**  » ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 21, 2026, 4:17pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/11 "2026-05-21T16:17:17Z")
> [@Terdious](#): > > Issue created by AI → for AI 😅 : > [[PLUGIN REQUEST] iopool EcO – pool water quality monitor (temperature, pH, ORP) · Issue #15 · GladysAssistant/matterbridge-ai-plugin-factory · GitHub](https://github.com/GladysAssistant/matterbridge-ai-plugin-factory/issues/15) I tested the plugin generated by the factory on my Matterbridge instance (3.7.9). First assessment 👇 ### ✅ What works well - The plugin **installs and runs** (status `Running`), connects to the iopool API, discovers my pool, and names it correctly (« Piscine DUBLEM », the name defined in iopool). - **Water temperature is perfect** : reported in a real Matter `TemperatureMeasurement` cluster → 11.15 °C, natively usable. For this part, the plugin does exactly the job. ### ⚠ The pH / ORP trap — exactly what we anticipated Since Matter has **no pH or ORP clusters** , the AI did its best: it exposes pH and ORP… in `TemperatureMeasurement` clusters as well. Result: - **3 « temperature sensors »** for a single pool (water + pH + ORP). - **pH** : the correct figure (6.69) but displayed in **°C**. - **ORP** : completely **wrong** — displayed `5.73` instead of `573 mV`. The temperature cluster is in hundredths of degrees (÷100 on the controller side), and ORP doesn’t fit in this scale → value divided by 100. ### ❌ Another bug found: the « Online » status The device is marked « Online » permanently (`reachable = true` fixed). This only reflects the success of the cloud API call, **not the actual state of the probe** — my probe is currently out of the water, and the plugin still shows it as « Online » with the last cached values. The iopool API does provide `isValid` + `measuredAt` to handle this correctly. ### 🔍 Conclusion The factory produced a **very good first draft** : connection, discovery, temperature → perfect. But this confirms in black and white the fundamental issue: **Matter cannot structurally support pH and ORP.** The « temperature workaround » is the only possible one today, but it gives false/misleading data in any controller. ### 🙋 Decision to be made — @pierre-gilles I prepared a detailed feedback for issue #15 (checklist + bugs + root cause). Before posting it, your opinion on pH/ORP on the Matterbridge plugin side: 1. **We keep them** in the plugin, clearly documenting the traps (pH = read the value without the unit, ORP = ×100 mentally)? 2. **We remove them** from the Matter plugin and assume « temperature only » as the Matter deliverable, with pH/ORP remaining on the MQTT channel (categories `ph-sensor`/`orp-sensor` from my PR) until Matter has the clusters? The `reachable`/`« Online »` bug and a cosmetic `productUrl` are correctable by a `--fix` from the factory, whatever happens. (In parallel, I created a _feature request_ on `project-chip/connectedhomeip` for real pH/ORP clusters — long-term subject 6-24 months, if taken into account.) ---
**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\ **Post date:** [May 21, 2026, 7:02pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/12 "2026-05-21T19:02:15Z")
> [@Terdious](#): > > 🙋 Decision to be made — @pierre-gilles In this case, the big advantage of Matterbridge plugins is that I’m not needed, do what seems best to you 😉 My goal is not to be the bottleneck on these topics, total freedom 🌬 > [@Terdious](#): > > In parallel, I created a _feature request_ on `project-chip/connectedhomeip` for real pH/ORP clusters Great! ---
**Author:** ![Terdious](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/terdious/32/6316_2.png) [@Terdious](https://community.gladysassistant.com/u/Terdious)\ **Post date:** [May 22, 2026, 6:39am UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/13 "2026-05-22T06:39:54Z")
Perfect, I’ll take the liberty to decide 🙂 So, **I’m going to close the plugin factory request** ([issue #15](https://github.com/GladysAssistant/matterbridge-ai-plugin-factory/issues/15)) — a Matterbridge plugin doesn’t make sense for this type of device: - **Matter has no pH or ORP clusters**. - Consequently, the generated plugin can only properly expose **temperature** — about 10% of the interest of a probe costing around €250, whereas a simple water temperature sensor costs around €20. - pH and ORP, on the other hand, come out unusable. Note: **the factory worked very well** — installation, API connection, pool discovery, and temperature: perfect from the first try. The issue is the **Matter spec**. I left detailed test feedback on the issue before closing it. As a replacement, I’m going to **write a tutorial on the forum** for supporting these probes **via Node-RED**. This method retrieves **100%** of the data (temperature, pH, ORP, mode, filtration advice, treatment advice alert), has been working very well for me for 3 years, and will now rely on the new `ph-sensor` / `orp-sensor` categories from my PR. And for the long term, I’ve opened a _feature request_ on `project-chip/connectedhomeip` for real pH/ORP clusters in Matter — the day that comes to fruition, the Matter route will become relevant again for these sensors. ---
**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\ **Post date:** [May 25, 2026, 3:49pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/14 "2026-05-25T15:49:07Z")
> [@Terdious](#): > > PR 1 — Water quality sensor categories The first PR is merged and available in Gladys Assistant 4.75: [Release v4.75.0 · GladysAssistant/Gladys · GitHub](https://github.com/GladysAssistant/Gladys/releases/tag/v4.75.0) ---
**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\ **Post date:** [June 1, 2026, 1:11pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/15 "2026-06-01T13:11:10Z")
> [@Terdious](#): > > PR 2 — Configurable gauge with colored thresholds I’ve just made progress on this PR, it’s good for me, it’s merged and it will be included in the next version of Gladys 🙂 ---
**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\ **Post date:** [June 1, 2026, 2:59pm UTC](https://community.gladysassistant.com/t/capteurs-de-qualite-de-leau-ph-orp-jauges-configurables-avec-seuils-colores/10231/16 "2026-06-01T14:59:16Z")
Available in Gladys Assistant 4.77: > [@Gladys Assistant 4.77 : Un assistant vocal dans Gladys 🎙️](https://community.gladysassistant.com/t/gladys-assistant-4-77-un-assistant-vocal-dans-gladys/10249): > > Une nouvelle version de Gladys est disponible avec plusieurs améliorations sympa slight_smilestudio_microphone Nouveau widget Assistant Vocal Vous pouvez désormais ajouter un widget Assistant Vocal directement sur votre tableau de bord. [[Je parle à ma maison… et elle me répond exploding_head] ](https://www.youtube.com/watch?v=7LBeCTegKsY) Pratique sur une tablette murale, un smartphone :slight\_smile: Je suis preneur de vos retours, c’est avant tout une première preuve de concept qui pourrait évoluer vers plus de voix dans Gladys si v…