Aller au contenu principal

Actions API

FrangiPool expose plusieurs actions ESPHome accessibles depuis Home Assistant. Elles permettent de piloter le device depuis des automatisations, des scripts ou les Developer Tools.

Accès : HA → Developer Tools → Actions → recherchez esphome.frangipool_*


swap_dallas_probes

Échange les assignations des deux sondes Dallas. Persistant après redémarrage.

Quand l'utiliser : si les sondes ont été branchées dans le mauvais ordre physiquement.

action: esphome.frangipool_swap_dallas_probes

Aucun paramètre. Disponible sur tous les presets.


force_filtration

Force la pompe en marche pendant une durée en heures. Prioritaire sur tous les modes sauf l'antigel. Mettre hours: 0 pour annuler le mode forcé.

action: esphome.frangipool_force_filtration
data:
hours: 4 # 0 à 24 heures — 0 annule le mode forcé

Paramètre : hours (entier, 0–24)

Disponible sur tous les presets.


recalc_filtration

Force un recalcul immédiat des horaires de filtration. Utile après avoir modifié plusieurs paramètres en rafale ou pour forcer la prise en compte d'une modification sans attendre le prochain cycle de 30 s.

action: esphome.frangipool_recalc_filtration

Aucun paramètre. Disponible sur tous les presets.


set_redox_manual_offset

Définit un offset de correction manuel sur la mesure Redox. Prend la priorité sur l'offset de calibration tampon (225/475 mV). Mettre offset: 0 pour désactiver et revenir à l'offset de calibration.

action: esphome.frangipool_set_redox_manual_offset
data:
offset: 45 # en mV — négatif pour abaisser, positif pour monter, 0 pour désactiver

Paramètre : offset (float, −300 à +300 mV)

Disponible sur les presets incluant le module Redox : er, erp, ber, berp.


Exemples d'automatisations

Forcer la filtration après ajout de produit

alias: "Filtration 6h après traitement algicide"
trigger:
- platform: template
value_template: "{{ now().hour == 8 and now().weekday() == 5 }}" # Samedi 8h
action:
- action: esphome.frangipool_force_filtration
data:
hours: 6

Notification si Redox trop bas depuis 2h

alias: "Alerte Redox faible"
trigger:
- platform: numeric_state
entity_id: sensor.frangipool_redox
below: 650
for: "02:00:00"
action:
- action: notify.mobile_app_<votre_téléphone>
data:
title: "⚠️ FrangiPool — Redox bas"
message: "Redox à {{ states('sensor.frangipool_redox') }} mV depuis 2h — vérifier l'électrolyseur."