L’alerte gel qui fonctionne même quand Home Assistant est hors service

Ce que cela apporte à une installation Home Assistant

• Une alerte quand la maison devient silencieuse. Si les relevés s’arrêtent pendant un nombre d’heures défini, ProbeHarbor vous prévient. En hiver, le silence signifie généralement une coupure de courant ou d’internet, et le chauffage peut être coupé lui aussi.
• Des alertes indépendantes de votre réseau. E-mail, notifications push et messageries sur le plan gratuit ; SMS avec Pro. Les membres du foyer les reçoivent sans accès à votre Home Assistant.
• Prévenu avant l’arrivée du froid. Une estimation du temps avant gel sur tous les plans, des alertes de gel basées sur les prévisions avec Member et les alertes du National Weather Service (États-Unis) avec Pro.
• Aucun nouveau matériel. Envoyez n’importe quelle entité de température ou de fuite depuis Home Assistant. Deux appareils sont gratuits.

Deux sens, utilisez l’un, l’autre ou les deux : envoyez des entités de Home Assistant vers ProbeHarbor pour les alertes externes (le YAML est généré avec votre clé dans Dashboard → Devices quand vous choisissez Home Assistant), et récupérez les sondes ProbeHarbor dans Home Assistant sous forme d’entités grâce à l’intégration HACS ci-dessous. Pour aller plus loin : configurer une alerte gel dans Home Assistant et ce qui se passe lors d’une coupure de courant.

Installation via HACS

1. Dans Home Assistant : HACS → Integrations → ⋮ → Custom repositories
2. Ajoutez le dépôt https://github.com/doodersrage/probeharbor-home-assistant (catégorie : Integration)
3. Installez ProbeHarbor et redémarrez Home Assistant
4. Settings → Devices & services → Add integration → ProbeHarbor
5. Créez un lien de partage live dans Dashboard → Share (Free inclut un lien live familial ; Pro ajoute l’historique/les métriques et les liens sans expiration) et collez le jeton issu de /share/YOUR_TOKEN

Guide développeur détaillé : guide Home Assistant ↗ · Les recettes YAML manuelles fonctionnent toujours si vous préférez des capteurs REST à HACS.

Ce qui apparaît dans HA

• Capteurs : température, humidité, CO₂, pression, PM2.5, COV, niveau, énergie et sondes numériques génériques
• Capteurs binaires : porte, inondation/fuite, mouvement et état de l’alimentation
• Interrogation. HACS interroge par défaut toutes les 5 minutes (configurable de 60 à 3600 s). C’est suffisant pour les tableaux de bord ; pour les seuils de gel critiques et les contacts d’humidité, préférez l’ingestion push native (ESP/Arduino → ProbeHarbor) afin que les alertes partent dès le relevé, et non après la prochaine interrogation de HA. Faire tourner les deux en parallèle est normal : push pour les SMS gel et fuite, HACS pour les entités locales.
• Services (webhook entrant optionnel + secret depuis Dashboard → Share) : thermaltrace.snooze, vacation, clear_snooze, clear_vacation, status
• Service push (clé d’ingestion optionnelle) : thermaltrace.push avec un dictionnaire JSON payload

Formats JSON natifs (push et pull)

Au-delà du lien de partage HACS, ProbeHarbor détecte automatiquement le JSON que votre installation HA émet peut-être déjà, sans enveloppe personnalisée.

• Capteur REST Home Assistant. Envoyez (POST) ou faites récupérer { "state": "65.3", "attributes": { "unit_of_measurement": "°F" } } ; associez la clé de sonde state dans Devices
• SenML (RFC 8428). Tableau JSON avec les unités Cel / %RH ; courant sur les passerelles IoT
• thermaltrace.push : sensors[] natifs depuis les automatisations (voir la température intérieure ci-dessous)
• Pont MQTT : déballe les payloads MQTT du réseau local via POST /api/ingest/mqtt

Exemples en direct : HA REST · SenML · Guide des formats d’ingestion

Température intérieure via Home Assistant

Ajoutez le contexte maison vs sonde dans Overview et History. Deux possibilités : Nest OAuth avec Pro (si disponible), ou envoyer n’importe quelle entité climate de HA en plan B, utile quand les inscriptions développeur Ecobee sont fermées ou si vous avez une autre marque de thermostat.

Nest OAuth (Pro, à privilégier si disponible)

Sur probeharbor.dev, les foyers Pro peuvent connecter Nest depuis Dashboard → Temperature pour afficher la température intérieure en direct, la consigne et le mode CVC à côté des sondes du grenier, du vide sanitaire ou de l’atelier : les alertes gel peuvent inclure ce contexte. L’historique enregistre des instantanés du thermostat avec la même tâche planifiée d’environ 15 minutes que les autres collecteurs Pro.

• Comparatif pour les utilisateurs : ProbeHarbor vs Nest
• Opérateurs auto-hébergés qui activent les secrets OAuth : configuration opérateur Nest & Ecobee

Plan B : envoyer la température intérieure depuis Home Assistant

Les inscriptions au programme développeur d’Ecobee sont souvent fermées, si bien qu’Ecobee OAuth peut être indisponible même avec Pro. Tout thermostat déjà présent dans HA (Ecobee, Nest via HA, climate.* générique) peut quand même alimenter ProbeHarbor : envoyez la température intérieure avec thermaltrace.push, puis choisissez cette sonde comme Indoor reference dans Dashboard → Devices.

1. Exposez votre thermostat dans HA (par ex. climate.living_room).
2. Toutes les 15 minutes, appelez thermaltrace.push avec un capteur temperature (clé house_indoor).
3. Dans ProbeHarbor : Devices → Indoor reference : choisissez ce capteur.

automation:
  - alias: Push house temp to ProbeHarbor
    trigger:
      - platform: time_pattern
        minutes: "/15"
    action:
      - service: thermaltrace.push
        data:
          sensors:
            - key: house_indoor
              kind: temperature
              value: "{{ state_attr('climate.living_room', 'current_temperature') }}"
              unit: F

Utile aussi pour Ecobee via HA quand OAuth n’est pas disponible : voir ProbeHarbor vs Ecobee. Notes détaillées sur les payloads (GitHub Pages) : documentation développeur ↗

En parallèle avec MQTT (le cas habituel)

ProbeHarbor n’est pas un broker MQTT. La plupart des homelabbers gardent Mosquitto / ESPHome / HA MQTT sur le réseau local et répliquent certains topics en HTTPS quand ils veulent des alertes gel et fuite dans le cloud et un historique.

• Recette de pont MQTT → HTTPS POST /api/ingest/mqtt avec votre clé d’appareil
• Flow Node-RED pour les abonnés Mosquitto
• ProbeHarbor vs MQTT auto-hébergé : quand des alertes hébergées valent mieux que gérer votre propre infrastructure

Des alertes dans Home Assistant

Les webhooks sortants Pro se déclenchent quand ProbeHarbor envoie une alerte de gel, de fuite ou de règle personnalisée. Pointez l’URL vers votre endpoint webhook HA ou importez le blueprint.

• Télécharger le blueprint webhook (YAML)
• YAML de nommage des entités pour les appareils push
• Guide produit : Ingestion et webhooks
• Configurez les jetons sortants et entrants dans Dashboard → Share

Vérifiez X-Signature lorsque vous définissez un secret de signature de webhook dans ProbeHarbor. HA (ou tout autre récepteur) doit rejeter les POST qui échouent à la vérification HMAC. Le blueprint documente l’en-tête ; détails dans le guide ingestion et webhooks et la FAQ ci-dessous.

Exemple d’automatisation

Mettre en pause les alertes gel et fuite de ProbeHarbor pendant qu’une porte est ouverte pour l’entretien :

automation:
  - alias: Snooze ProbeHarbor while door open
    trigger:
      - platform: state
        entity_id: cover.garage_door
        to: "open"
    action:
      - service: thermaltrace.snooze
        data:
          hours: 4