Alertes de température avec votre propre firmware

Enfichez l'ESP32-C6-Zero à cheval sur le milieu de la breadboard. L'AM2301 a trois fils :

Ajoutez une résistance de 10 kΩ entre la colonne du fil jaune et 3V3. Elle maintient la ligne de données à l'état haut entre deux lectures.

Comptez les broches avec soin. Du côté du connecteur USB, l'ordre est : 5V, GND, 3V3, GP0. GP0 est la quatrième broche, pas la troisième.

La plupart des cartes Zero sont livrées avec leurs barrettes non soudées. Soudez-les, sinon les broches ne touchent pas la breadboard. La carte s'allume quand même par l'USB, donc rien ne paraît anormal avant la lecture du capteur.

Ouvrez Edges → Firmware custom → Nouveau projet. Nommez-le Climate sensor, choisissez la famille de puce ESP32-C6 et créez-le.

L'éditeur s'ouvre sur un sketch de départ. Tout ce dont PNeX a besoin (Wi-Fi, liaison chiffrée avec le serveur, mises à jour à distance) est dans la bibliothèque PNeX. Votre fichier ne contient que votre logique.

Cliquez sur + Lib et choisissez DHT sensor library. L'AM2301 est de la même famille que le DHT21. La bibliothèque apparaît en pastille à côté de src/main.cpp.

Seules les bibliothèques de cette liste sont utilisables. Leurs versions sont figées, donc le build est identique à chaque fois.

Remplacez tout le contenu de l'éditeur par ce sketch :

// Climate sensor: AM2301 (DHT21) on a Waveshare ESP32-C6-Zero.
// WiFi, device token and encryption key are injected by PneX at build time.
#include <Pnex.h>
#include <DHT.h>

#define DHT_PIN 0        // GP0, yellow wire
#define DHT_TYPE DHT21   // AM2301 = DHT21

PnexDevice pnex;
DHT dht(DHT_PIN, DHT_TYPE);

void setup() {
    Serial.begin(115200);
    dht.begin();

    // Each metric becomes a telemetry series of this device.
    pnex.addMetric("temperature", "°C");
    pnex.addMetric("humidity", "%");

    pnex.begin();  // WiFi + connection to your PneX server
}

unsigned long last_read_ms = 0;

void loop() {
    pnex.loop();  // call it on every iteration, never block with long delays

    // The AM2301 needs at least 2 s between two reads: read every 10 s.
    if (millis() - last_read_ms >= 10000) {
        last_read_ms = millis();
        float t = dht.readTemperature();
        float h = dht.readHumidity();
        if (isnan(t) || isnan(h)) {
            Serial.println("[APP] AM2301 read failed (check wiring)");
            return;
        }
        pnex.publish("temperature", t);
        pnex.publish("humidity", h);
        Serial.printf("[APP] %.1f °C  %.1f %%\n", t, h);
    }
}

Cliquez sur Enregistrer et vérifier. Le serveur compile le code pour l'ESP32-C6 (le premier build prend quelques minutes).

Remarquez ce qui n'est pas dans le code : ni mot de passe Wi-Fi, ni adresse du serveur, ni clé. PNeX les injecte quand il compile le firmware de votre carte.

Ouvrez Edges → Appareils / Agents → Enregistrer. Donnez un nom à la carte, par exemple climate-1. Ce nom identifie le device partout dans PNeX, y compris dans les flows.

Choisissez Generic ESP32-C6 (Waveshare C6-Zero). Sous Firmware, choisissez Climate sensor à la place du firmware PNeX générique.

Choisissez votre réseau Wi-Fi, ou cliquez sur + pour en ajouter un : SSID et mot de passe. Prenez un réseau 2,4 GHz : les cartes ESP ne voient pas les réseaux 5 GHz.

Les réseaux ajoutés sont enregistrés dans Edges → Référentiels et reproposés pour vos prochaines cartes. Le mot de passe ne sert qu'à compiler le firmware.

La carte a besoin de l'adresse de votre serveur PNeX. Si le champ Serveur PNeX est vide, cliquez sur le + à côté : le champ est pré-rempli avec l'adresse que vous utilisez en ce moment. Cliquez sur Ajouter. Détecter les serveurs PNeX sur le LAN trouve le serveur pour vous en cas de doute.

Avec une installation en pnex.local, la carte se connecte à l'adresse IP du Pi (par exemple 192.168.1.20) : les cartes ESP ne savent pas résoudre les noms en .local. Si vous avez installé PNeX avec un vrai nom de domaine, ce champ est imposé et il n'y a rien à choisir.

Vérifiez le récapitulatif et cliquez sur Créer & compiler. PNeX compile un firmware pour cette carte : votre code, plus son Wi-Fi, l'adresse du serveur et ses clés.

Branchez la carte à votre ordinateur avec un câble USB data. Sur la ligne du device, cliquez sur Flasher, puis encore sur Flasher, et choisissez le port de la carte. Il apparaît comme un port série USB ou « USB JTAG/serial debug unit ».

Utilisez Chrome, Edge ou un autre navigateur Chromium : le flash passe par Web Serial. Si aucun port n'apparaît, maintenez le bouton BOOT, appuyez puis relâchez RESET, relâchez BOOT et recommencez.

Le flash par USB ne se fait qu'une fois. Les versions suivantes de votre code s'installent à distance avec Mettre à jour (OTA).

Ouvrez Visualisation → Graphiques rapides. Choisissez la métrique temperature, le capteur climate-1, cliquez sur Ajouter, puis faites de même pour humidity.

Un nouveau point arrive toutes les 10 secondes. Soufflez sur le capteur : l'humidité grimpe en quelques mesures.

Ouvrez Automation → Fonctions → Nouvelle fonction, nommez-la Climate – comfort check, choisissez Starlark et créez-la.

Starlark est un petit langage à la syntaxe Python : def, if, dictionnaires, commentaires #. Il s'exécute dans un bac à sable, il ne peut donc que calculer : ni fichiers, ni réseau. Collez :

# Comfort check for the AM2301: converts the temperature and decides
# when it is too hot. Starlark = Python syntax, sandboxed.
# @input temperature number "Temperature from the sensor, in °C"
# @output too_hot bool "True above the threshold (wire it to the notification trigger)"
# @output celsius string "Temperature in °C, rounded"
# @output fahrenheit string "Temperature in °F, rounded"

THRESHOLD_C = 28.0  # send an alert above this temperature

def one_decimal(x):
    return str(int(x * 10 + 0.5) / 10.0)

def handle(inputs, msg):
    c = inputs["temperature"]
    f = c * 9 / 5 + 32
    return {
        "too_hot": c > THRESHOLD_C,
        "celsius": one_decimal(c),
        "fahrenheit": one_decimal(f),
    }

Les lignes @input et @output ne sont pas de simples commentaires. Chaque @input devient une entrée du nœud fonction dans le flow, et chaque @output une sortie. handle renvoie une valeur par sortie, sous le même nom.

Cliquez sur Enregistrer.

Cliquez sur Tester, saisissez 31.4 pour temperature et cliquez sur Exécuter.

Réglez THRESHOLD_C sur la température qui compte pour vous (une serre, un placard serveur, une chambre de bébé) et enregistrez à nouveau.

Installez l'application ntfy sur votre téléphone et abonnez-vous à un sujet au nom difficile à deviner : pnex-climate- suivi de quelques lettres et chiffres choisis au hasard. Quiconque connaît le nom du sujet peut le lire : ne reprenez jamais celui d'un tutoriel.

Dans PNeX, ouvrez Automation → Notifications → Nouveau canal → ntfy : serveur https://ntfy.sh, le même sujet, puis Créer. Utilisez le bouton Test du canal : un message de test arrive sur votre téléphone.

E-mail, Telegram, Slack ou Discord fonctionnent de la même façon. Voir Recevoir des alertes par e-mail ou sur le téléphone.

Ouvrez l'onglet Modèles, puis Nouveau modèle :

• Nom : Climate – too hot
• Sujet : [climate-1] Too hot
• Corps :

🌡️ It is {{ celsius }} °C ({{ fahrenheit }} °F) in the room, above your alert threshold.

Déclarez les deux variables celsius et fahrenheit (Ajouter une variable), donnez-leur des valeurs d'exemple et cliquez sur Aperçu.

En bas du modèle, Test d'envoi sur un canal rend le modèle avec les valeurs d'exemple et l'envoie aussitôt. Choisissez votre canal ntfy et cliquez sur Test : le message arrive sur votre téléphone. Enregistrez ensuite le modèle.

Ouvrez Automation → Flux → Nouveau flow et nommez-le Climate – too hot alert.

1. Sélectionnez le nœud Inject déjà présent et réglez son intervalle sur 300 secondes : le flow tourne toutes les 5 minutes.
2. Ajoutez un nœud Device (read), choisissez climate-1 et cochez temperature (métrique). Réglez la fenêtre de fraîcheur sur 120 secondes : un capteur débranché ne déclenche jamais d'alerte avec une vieille valeur.

3. Ajoutez un nœud Function et choisissez Climate – comfort check.
4. Ajoutez un nœud Notification, ajoutez votre canal ntfy (et in-app si vous voulez) et choisissez le modèle Climate – too hot.

Tirez les fils :

La notification n'est envoyée que tant que trigger est vrai. Enregistrez, puis cliquez sur Déployer.

Inutile d'attendre la canicule :

• baissez THRESHOLD_C sous la température actuelle dans la fonction, enregistrez, choisissez la nouvelle version dans le nœud Function du flow et déployez à nouveau ;
• ou gardez le capteur dans votre main pendant une minute.

Au prochain passage (5 minutes au plus), votre téléphone vibre.

Chaque message est listé dans Automation → Notifications → Événements (ou Journal sur la ligne du canal) : date, canal, statut (Envoyé, Échec, Bloqué (anti-spam)) et le flow qui l'a envoyé. Cliquez sur une ligne pour voir le détail de l'erreur d'un envoi en échec.

L'application ntfy (ou la page web ntfy de votre sujet) affiche l'alerte avec les valeurs rendues par le modèle.

Tant qu'il fait trop chaud, vous recevez un message toutes les 5 minutes. Changez l'intervalle de l'Inject pour en recevoir moins.