> For the complete documentation index, see [llms.txt](https://rhizobiome.gitbook.io/eiwa-shop-supports-et-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rhizobiome.gitbook.io/eiwa-shop-supports-et-documentation/modes-demploi-des-instruments/piezometre.md).

# Piézomètre

#### <mark style="color:blue;">Accès à l'interface web</mark> <a href="#acces-a-linterface-web" id="acces-a-linterface-web"></a>

Matériel requis : Smartphone, tablette ou ordinateur avec WiFi

**1. Réveillez le logger**

→ Appuyer sur le bouton réveil (maintenir 2 à 4 secondes)

→ Attendre environ 15 secondes (boot) \[comptez lentement, vous n’aurez pas le temps d’arriver jusqu’à 20 ! ou alors il y a un problème …]

**2. Connectez-vous au WiFi**

→ Chercher le réseau "PIEZO-AP5" (ou AP1, AP2...)

→ Mot de passe : 12345678

**3. Ouvrez la page web**

→ Navigateur : <http://192.168.4.1>

→ Interface s'affiche automatiquement

**4. Actions disponibles**

→ Voir état actuel (hauteur, batterie, compteurs)

→ ⚠️ Vérifier la cohérence des données (date-heure UTC, nombre de mesures, hauteur d’eau ..)

→ Télécharger données CSV

→ Faire une mesure manuelle (LED clignote 3×)

**5. C'est terminé !**

→ Attendre 5 min → Logger retourne en veille automatiquement

→ Ou cliquer "Démarrer cycle" pour lancer mesures auto si les mesures avaient été arrêtées

#### <mark style="color:blue;">Interface principale</mark> <a href="#interface-principale" id="interface-principale"></a>

<figure><img src="/files/WSJZzNl7uqK7i3xnvluw" alt=""><figcaption><p>interface 5.2</p></figcaption></figure>

<mark style="color:orange;">**1- En-tête :**</mark>

**🌊 Piézomètre PIEZO\_006**

Logger piézométrique ESP32-C6 - ©SCOP SAGNE 2025

<mark style="color:orange;">**2- Barre d'état :**</mark>

🟢 Actif / 🔴 Arrêté

Heure : 2025-11-29 10:30:00 (UTC)

⚠️ <mark style="color:blue;">l’heure est exprimée en heure universelle UTC (heure du soleil) ce qui permet de ne pas avoir à changer entre l’heure d’été et l’heure d’hiver. A ce jour en France nous avons une heure d’avance sur le soleil en hiver et 2 heures en été.</mark>

<mark style="color:orange;">**3- Section "État actuel" (7 item) :**</mark>

**Hauteur d'eau (cm)**

→ Hauteur d'eau mesurée par rapport au capteur

→ Exemple : 122.52 cm

**Batterie (V)**

→ Tension batterie en temps réel avec indicateur coloré selon l’état de la batterie

→ 🟢 >3.8V = Bon 🟡 3.5-3.8V = Moyen 🔴 <3.5V = Critique

**Prochaine mesure**

→ Horodatage prochaine acquisition auto

→ Exemple : 2025-11-29 16:30:00

→ Affiche "---" si logger arrêté

**Debug mode (pour expert)**

**Total mesures**

→ Compteur total depuis démarrage campagne

→ Se réinitialise à 0 si appui sur "Démarrer cycle"

**Période**

→ Intervalle entre mesures

→ Valeur fixée avant flash (10/60/360 min)

**Stockage Flash**

→ Etat de la mémoire de stockage en %

→ Utile pour contrôler s’il reste encore assez de place jusqu’à la prochaine maintenance

⚠️ tant qu’il y a de la place, et à condition d’avoir sauvegardé le fichier csv, nous conseillons de ne pas effacer les données. Car en cas de perte des données sauvegardées, vous pourrez toujours les retrouver dans le logger.

**+ Plage de capteur (version 5.4 et ultérieure)**

<mark style="color:orange;">**4- Section "Contrôle Logger" (3 boutons) :**</mark>

<mark style="color:red;">▶️ Démarrer cycle</mark>

→ Lance campagne mesures automatiques

→ Calcule prochaine mesure selon période

→ Logger entre en deep sleep après timeout AP

<mark style="color:red;">⏹️ Arrêter cycle</mark>

→ Stoppe campagne

→ Flush automatique buffer → CSV

→ Logger reste accessible (pas de deep sleep)

<mark style="color:red;">📏 Mesure manuelle</mark>

→ Force acquisition immédiate

→ LED clignote 3× (contrôle visuel)

→ N'affecte pas le calendrier mesures auto

→ Utile pour tests/vérifications

<mark style="color:orange;">**5- Section "Configuration" (4 champs + bouton) :**</mark>

<mark style="color:red;">Référence Logger</mark>

→ Identifiant unique (ex: PIEZO\_005)

→ Utilisé dans le nom du fichier CSV

→ ⚠️ NE PAS MODIFIER après déploiement (traçabilité)

<mark style="color:red;">Profondeur capteur (cm depuis surface)</mark>

→ Distance entre le capteur ↔ et le niveau sol

→ Permet d’exprimer la position de la nappe

→ Nappe = Profondeur - Hauteur\_eau

<mark style="color:red;">Facteur batterie (diviseur tension)</mark>

→ Coefficient de correction de la lecture de la tension

→ À calibrer précisément (voir §5.3)

→ Valeur typique : 4-6

<mark style="color:red;">Heure de départ (HH:MM UTC) - pour tests</mark>

→ Heure de la première mesure

→ Normalement : 00:00 (minuit UTC)

→ Tests : modifier selon besoin \[pour usage avancé]

<mark style="color:red;">💾 Enregistrer config</mark>

→ Sauvegarde paramètres dans Flash

→ Survit aux redémarrages

<mark style="color:orange;">**6- Section "Calibration" (2 boutons) :**</mark>

<mark style="color:red;">🔧 Calibrer capteur (zéro)</mark>

→ Définit niveau actuel comme hauteur 0 cm

→ ⚠️ À faire capteur hors eau ou niveau connu

→ Stocke valeur mV dans config

🕐 <mark style="color:red;">Sync RTC (UTC)</mark>

→ Synchronise horloge logger avec PC/smartphone

→ ⚠️ IMPORTANT : Vérifier heure système en UTC !

→ À faire après changement pile RTC (ou si une petite dérive est observée )

<mark style="color:orange;">**7- Section "Fichiers" (4 boutons) :**</mark>

<mark style="color:red;">⬇️ Télécharger CSV</mark>

→ Télécharge fichier données complet

→ Nom : PIEZO\_005\_2025-11-29.csv

→ Format : DateTime,Pressure\_mV,Height\_cm,WaterTable\_cm,Battery\_V

→ Ouvrir avec Excel / LibreOffice

<mark style="color:$danger;">🗑️ Supprimer CSV</mark>

→ Efface fichier données local

→ ⚠️ ATTENTION : Irréversible !

→ Télécharger avant si les données doivent être conservées

→ Utile pour libérer espace Flash

⬇️ <mark style="color:red;">Télécharger DEBUG</mark>

<mark style="color:red;">🗑️ Supprimer CSV DEBUG</mark>

→ pour le contrôle technique expert

<figure><img src="/files/fDWsF6BbJHOkGVtg6C40" alt=""><figcaption><p>interface de configuration versions 5.4 et ultérieures</p></figcaption></figure>

<mark style="color:blue;">Nouvelle fenêtre de saisie pour permettre la configuration sur le terrain et non au moment du téléchargement du code</mark>

&#x20; <mark style="color:red;">Type de capteur</mark>

&#x20;   → 0-1 m

&#x20;   → 0-5 m

&#x20;   → 0-10 m

<mark style="color:red;">Période de mesure</mark>

&#x20;   → 15  minutes

&#x20;   → 60 minutes

&#x20;   → 360 minutes

####

#### <mark style="color:blue;">Scénarios d'utilisation</mark>

<mark style="color:green;">**Scénario 1 : Premier déploiement terrain**</mark>

1\.          Réveil logger (bouton 4 sec) attendre jusqu’à 20 secondes

2\.          Sur un smartphone, une tablette, un ordinateur cherchez le SSID (Wifi) du logger

3\.          p ex  PIEZO-AP5

4\.          puis sur le navigateur cherchez la page <http://192.168.4.1>

5\.          Configuration :

&#x20;          a.               - Vérifier référence : PIEZO\_005

&#x20;          b.               - Saisir profondeur capteur : 100.0 cm

&#x20;          c.               - Calibrer batteryFactor (voir §5.3)

6\.            Calibration :

&#x20;          a.               - Capteur hors eau → "Calibrer capteur (zéro)"

&#x20;          b.               - "Sync RTC (UTC)"

7\.            Démarrage :

&#x20;         a.               - "Démarrer cycle"

&#x20;         b.               - Vérifier "Prochaine mesure" affiché

8\.            Attendre timeout 5 min → Deep sleep auto

9\.            ✓ Logger opérationnel

&#x20;<mark style="background-color:orange;">**Exemple de fiche de données pour documenter  l'installation d'un logger:**</mark>

{% file src="/files/ibhCTI0RZMyqQPRFMv4E" %}

<mark style="color:green;">**Scénario 2 : Récupération données**</mark>

&#x20; 1\. Réveil logger (bouton)

&#x20; 2\. WiFi → <http://192.168.4.1>

&#x20; 3\. Vérifier état :

&#x20;    \- Batterie : >3.5V

&#x20;    \- Total mesures : nombre cohérent

&#x20; 4\. "Télécharger CSV"

&#x20; 5\. Sauvegarder fichier PC

&#x20; 6\. Optionnel : "Supprimer CSV" (libère Flash)  <mark style="color:blue;">\[ tant que la mémoire n’est pas saturée il est préférable de garder les données, au moins pendant toute une saison hydrologique]</mark>

&#x20; 7\. Logger continue automatiquement après timeout

&#x20;

<mark style="color:green;">**Scénario 3 : Test/vérification ponctuel**</mark>

&#x20; 1\. Réveil logger

&#x20; 2\. WiFi → Interface

&#x20; 3\. "Mesure manuelle"

&#x20;    → LED clignote 3× (vérifier visuellement)

&#x20;    → Valeurs actualisées immédiatement

&#x20; 4\. Vérifier cohérence :

&#x20;    \- Hauteur eau plausible

&#x20;    \- Batterie >3.5V

&#x20; 5\. Optionnel : "Télécharger CSV" pour historique

&#x20; 6\. Logger continue après timeout

<mark style="color:green;">**Scénario 4 : Changement pile RTC**</mark>

&#x20; 1\. Ouvrir le boîtier

&#x20; 2\. Remplacer la pile CR2032 RTC

&#x20; 3\. Réveil du logger

&#x20; 4\. WiFi → Interface

&#x20; 5\. "Sync RTC (UTC)" → horloge réinitialisée

&#x20; 6\. Vérifier si l’heure affichée est correcte

&#x20; 7\. Logger reprend automatiquement

&#x20;

<mark style="color:green;">**Scénario 5 : Changement de la batterie**</mark>

<mark style="color:$danger;">mode prudent pour ne pas couper l’alimentation et perdre la configuration et les données</mark>

&#x20; 1\. Ouvrir le boîtier

&#x20; 2\. Connecter le port USB C de la carte à une power bank afin de maintenir l’alimentation du logger et ne pas perdre les données. \[Ce peut être aussi un scénario pour recharger la batterie (\~ > 2 heures ?)]

&#x20; 3\. Déconnecter l’ancienne batterie

&#x20; 4\. ⚠️ Vérifier la polarité du connecteur de la nouvelle batterie \[attention à ne surtout pas inverser + et-]

&#x20; 5\. Connecter la nouvelle batterie – calibrer la batterie si nécessaire (cf. § configuration).

#### <mark style="color:blue;">Comprendre les compteurs</mark>

<mark style="color:red;">Total mesures :</mark>

&#x20; • Compteur cumulatif depuis "Démarrer cycle"

&#x20; • Se réinitialise à 0 si nouveau démarrage

&#x20; • Utile pour vérifier nombre acquisitions

&#x20; • Exemple : 120 mesures = 30 jours à 360 min

<mark style="color:red;">Prochaine mesure :</mark>

&#x20; • Calculée selon startTime + multiples période

&#x20; • Production (startTime=00:00, période=360) :

&#x20;   \- Mesures à 00:00, 06:00, 12:00, 18:00 chaque jour

&#x20; • Test (startTime=09:00, période=60) :

&#x20;   \- Mesures à 09:00, 10:00, 11:00, etc.

&#x20; <mark style="color:red;">Stockage Flash :</mark>

&#x20;   • Etat de la mémoire de stockage en %

&#x20;   • Utile pour contrôler s’il reste encore assez de place jusqu’à la prochaine maintenance

#### <mark style="color:blue;">Quand appeler le technicien ?</mark>

🔴 URGENT (intervention <24h) :

&#x20; • Interface web inaccessible (WiFi invisible)

&#x20; • Batterie <3.0V affichée

&#x20; • Heure affichée aberrante (ex: 2000-01-01)

&#x20; • Aucune nouvelle mesure depuis 48h

&#x20;

🟡 À PRÉVOIR (intervention <1 semaine) :

&#x20; • Batterie 3.0-3.5V (décharge anormale)

&#x20; • Valeurs capteur incohérentes

&#x20; • Pas de clignotement LED lors d’une mesure manuelle

&#x20; • Téléchargement CSV échoue

&#x20;

🟢 NORMAL (pas d'intervention) :

&#x20; • LED éteinte pendant mesures auto (économie batterie)

&#x20; • Interface disparaît après 5 min (timeout normal)

&#x20; • Batterie >3.8V (excellent état)

#### <mark style="color:blue;">Planning maintenance préventive</mark>

#### <mark style="color:orange;">Mensuel (les 3 premiers mois) :</mark>

&#x20; ☐ Réveil logger + vérification état

&#x20; ☐ Télécharger CSV (vérifier données cohérentes)

&#x20; ☐ Contrôle batterie (>3.5V minimum)

&#x20; ☐ Test mesure manuelle (LED clignote 3×)

&#x20; ☐ Vérification visuelle boîtier (étanchéité, câbles)

#### <mark style="color:orange;">Semestriel :</mark>

&#x20; ☐ Réveil logger + vérification état

&#x20; ☐ Télécharger CSV (archiver les données)

&#x20; ☐ Contrôle batterie (>3.5V minimum)

&#x20; ☐ Test mesure manuelle (LED clignote 3×)

&#x20; ☐ Nettoyage panneau solaire

&#x20; ☐ Contrôle connexions électriques

&#x20; ☐ Vérification RTC drift (<1 min acceptée)

&#x20; ☐ Vérification visuelle boîtier (étanchéité, câbles)

#### <mark style="color:orange;">Annuel :</mark>

&#x20; ☐ Calibration capteur pression

&#x20; ☐ Calibration batteryFactor

&#x20; ☐ Test charge batterie (déconnexion solaire 24h)

#### <mark style="color:orange;">Tous les 2 ans :</mark>

&#x20; ☐ Remplacement batteries Li-ion

&#x20; ☐ Remplacement pile CR2032 RTC

&#x20; ☐ Mise à jour firmware si disponible

&#x20;

### <mark style="color:blue;">Dépannage courant</mark>

#### <mark style="color:red;">Problème : Interface web inaccessible</mark>

Symptôme : WiFi PIEZO-AP5 invisible

&#x20; Diagnostic :

&#x20;   1\. Vérifier bouton réveil bien enfoncé (maintenir 2 sec)

&#x20;   2\. Attendre 15 secondes (boot complet)

&#x20;   3\. Rechercher WiFi à nouveau

&#x20;   4\. Mesurer tension batterie : doit être >3.3V

&#x20;   5\. Vérifiez votre smartphone ou tablette

&#x20; Solutions :

&#x20;   • Batterie faible : Recharger ou remplacer

&#x20;   • Bouton défectueux : Vérifier câblage pin 6

&#x20;   • Deep sleep bloqué : Reset power (déconnecter batterie)&#x20;

#### <mark style="color:orange;">Problème : Batterie se décharge trop vite</mark>

&#x20; Symptôme : <3.5V après <30 jours

&#x20; Causes possibles :

&#x20;   • Panneau solaire mal orienté

&#x20;   • Câble solaire déconnecté

&#x20;   • Contrôleur TP4056 interne défaillant

&#x20;   • Période mesure trop courte (ex: 10 min au lieu 360)

&#x20; Solutions :

&#x20;   • Vérifier orientation sud panneau

&#x20;   • Tester charge solaire (déconnecter batterie, mesurer Vout)

&#x20;   • Vérifier PERIODE\_MESURE\_MIN dans code (ligne 44)

&#x20;   • Remplacer TP4056 si défaillant

#### <mark style="color:red;">Problème : Données incohérentes</mark>

&#x20; Symptôme : Hauteur eau 0.00 ou >500 cm constant

&#x20; Causes :

&#x20;   • Capteur déconnecté

&#x20;   • Capteur hors plage

&#x20;   • Calibration zéro incorrecte

&#x20; Solutions :

&#x20;   1\. Mesurer tension pin 4 au multimètre (doit varier 0-3.3V)

&#x20;   2\. Vérifier câblage capteur

&#x20;   3\. Refaire calibration zéro

#### <mark style="color:red;">Problème : RTC dérive (heure incorrecte)</mark>

&#x20; Symptôme : Décalage >5 min/mois

&#x20; Causes :

&#x20;   • Pile CR2032 faible

&#x20;   • RTC DS3231 défectueux

&#x20;   • Température extrême

&#x20; Solutions :

&#x20;   1\. Remplacer pile CR2032

&#x20;   2\. "Sync RTC (UTC)" après remplacement

&#x20;   3\. Remplacer module RTC si dérive persiste

### <mark style="color:blue;">Format fichier CSV</mark>

**Fichier données mesures (PIEZO\_005\_data.csv) :**

&#x20; DateTime,Pressure\_mV,Height\_cm,WaterTable\_cm,Battery\_V

&#x20; 2025-11-29T09:05:02,1850.45,89.24,10.76,4.15

&#x20; 2025-11-29T09:15:01,1852.10,89.32,10.68,4.14

&#x20; 2025-11-29T09:25:02,1848.75,89.16,10.84,4.14

**Colonnes détaillées :**

&#x20; DateTime (ISO 8601 UTC)

&#x20;   • Format : YYYY-MM-DDTHH:MM:SS

&#x20;   • Fuseau horaire : UTC (pas heure locale)

&#x20;   • Exemple : 2025-11-29T09:05:02

⚠️ <mark style="color:blue;">L’heure de la mesure a environ 3 secondes d’écart (+ 3s) avec l’heure programmée du départ d’un cycle. Pour une mesure à 00:00 :00 , il serait délicat de programmer un départ à 11:59:57 car on prend le risque d’avoir une confusion dans le changement de date.</mark>

&#x20; **Pressure\_mV (millivolts)**

&#x20;   • Tension brute capteur pression WNL8010-TT

&#x20;   • Plage : 100-3200 mV (0.1-3.2V)

&#x20;   • 100 mV = 0m eau, 3200 mV = 150m eau

&#x20;   • Utile calibration/diagnostic sondes

&#x20;   • NOUVEAU dans PIEZO\_EIWA\_4

&#x20; **Height\_cm (centimètres)**

&#x20;   • Hauteur d'eau calculée depuis capteur

&#x20;   • Formule WNL8010-TT : (Pressure\_mV - zeroLevel) × 150m / 3100mV

&#x20;   • Exemple : 1850 mV → (1850-100) × 150/3100 = 84.7 cm

&#x20;   • Peut être négative (capteur hors eau)

&#x20; **WaterTable\_cm (centimètres)**

&#x20;   • Position nappe phréatique depuis surface

&#x20;   • Formule : sensorDepth - Height\_cm

&#x20;   • Valeur négative = nappe au-dessus surface

&#x20; **Battery\_V (volts)**

&#x20;   • Tension batterie corrigée

&#x20;   • Formule : ADC\_raw / 8191 × 3.3 × batteryFactor

&#x20;   • Surveillance autonomie

&#x20;&#x20;

<mark style="color:violet;">Pour le traitement des données voir notamment</mark> [<mark style="color:violet;">le manuel Gitbook</mark>](https://rhizobiome.gitbook.io/les-tutoriels-du-pecnotlab/protocoles-et-observations/cas-des-sols-hydromorphes/mesure-des-nappes/piezometre-data-logger/traitement-des-donnees) <mark style="color:violet;">du Pecnot’Lab</mark>

#### <mark style="color:blue;">**Le tube piézométrique**</mark>

Réaliser le tube piézométrique selon le modèle ci-dessous. Installer le sur le terrain (tarière de 65 mm). Insérer la sonde et fixer la partie supérieure sur ce tube. Schéma de principe d'un tube piézométrique implanté dans un sol hydromorphe.La sonde peut aussi être placée dans un puits bâti. Le modèle V2 du boitier permet une maintenance plus facile de l'appareil. L'échancrure 35x7 de l'extrémité du tube permet une installation simplifiée de la sonde.&#x20;

<figure><img src="/files/CucNmg6KZgsOVa46s8xF" alt=""><figcaption><p>version V1</p></figcaption></figure>

<div><figure><img src="/files/oiuLa5OVY7wlInCjEpXD" alt="" width="375"><figcaption><p>Version V2</p></figcaption></figure> <figure><img src="/files/2p5u2wAf724p0zMEv0x0" alt=""><figcaption><p>Boitier V2 petit panneau solaire</p></figcaption></figure> <figure><img src="/files/u3OB7CHnwZTGuxo1rYtC" alt=""><figcaption><p>Boitier V2 pour grand panneau</p></figcaption></figure> <figure><img src="/files/Rh4w6BX93hnMlZEpexpY" alt="" width="375"><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://rhizobiome.gitbook.io/eiwa-shop-supports-et-documentation/modes-demploi-des-instruments/piezometre.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.