Client Kobo (overlay trmnl-kobo) + README + sonde usage

kobo/README.md

@@ -0,0 +1,54 @@
+# Client Kobo — Monitorink
+
+Affiche le dashboard Monitorink (`/image.png`) sur une **Kobo Libra 2** (FW 4.38.x) déjà
+équipée de **NickelMenu**. Approche : boucle WiFi → fetch image → `fbink` → suspend `rtcwake`.
+
+Ces scripts sont un **overlay** : ils réutilisent les binaires ARM et les helpers WiFi
+pré-compilés/éprouvés du projet [`usetrmnl/trmnl-kobo`](https://github.com/usetrmnl/trmnl-kobo),
+afin de ne pas réinventer (et risquer de casser) la gestion WiFi/suspend spécifique au matériel.
+
+## Contenu de ce dossier
+- `monitorink.sh` — point d'entrée (lancé par NickelMenu).
+- `monitorinkloop.sh` — boucle d'affichage (réutilise `bin/` et `scripts/` de trmnl-kobo).
+- `nm/monitorink` — entrée NickelMenu.
+
+## Installation (Kobo branchée en USB)
+
+1. **Récupérer les binaires + helpers WiFi** depuis trmnl-kobo :
+   ```sh
+   git clone https://github.com/usetrmnl/trmnl-kobo
+   ```
+   On a besoin de `src/TRMNL/bin/` (fbink, fbdepth, busybox_kobo) et `src/TRMNL/scripts/`
+   (enable-wifi.sh, disable-wifi.sh, force-wifi-connection.sh, obtain-ip.sh, release-ip.sh,
+   ledToggle.sh, getrssi.sh).
+
+2. **Construire le dossier Monitorink** sur la Kobo, à
+   `/mnt/onboard/.adds/Monitorink/` :
+   ```
+   Monitorink/
+     monitorink.sh            (ce repo)
+     monitorinkloop.sh        (ce repo)
+     bin/                     (copié depuis trmnl-kobo/src/TRMNL/bin/)
+     scripts/                 (copié depuis trmnl-kobo/src/TRMNL/scripts/)
+   ```
+
+3. **Entrée NickelMenu** : copier `nm/monitorink` dans `/mnt/onboard/.adds/nm/monitorink`.
+
+4. **Configurer l'URL** dans `monitorink.sh` (`MONITORINK_URL`) et l'intervalle
+   (`MONITORINK_REFRESH`, en secondes).
+
+5. **Éjecter proprement** la Kobo → l'entrée « Monitorink » apparaît dans NickelMenu.
+
+## Utilisation
+- Lancer « Monitorink » depuis NickelMenu. La boucle démarre : l'écran se met à jour, puis le
+  device passe en suspend et se réveille à chaque intervalle.
+- Un **swipe** sur l'écran réveille le device et force un rafraîchissement.
+- Pour **arrêter** : maintenir le bouton power (le device se réveille sous Nickel).
+- Logs : `/tmp/monitorink.log` (effacés au reboot).
+
+## À valider sur l'appareil (cf. plan, tâche 8)
+- Orientation framebuffer : si l'image sort tournée, soit pivoter côté serveur, soit ajouter
+  `./bin/fbdepth -r 2` avant l'affichage et `-r -1` après.
+- Stabilité de `rtcwake -m mem` sur FW 4.38.23171 (sinon le fallback `state-extended` prend le
+  relais ; en dernier recours `sleep`).
+- Autonomie réelle sur 24 h.

kobo/monitorink.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+# Monitorink — point d'entrée lancé par NickelMenu.
+# Configure quelques paramètres puis lance la boucle d'affichage.
+
+BASE="/mnt/onboard/.adds/Monitorink"
+cd "$BASE" || exit 1
+
+# --- Configuration (adapter au besoin) ---
+export MONITORINK_URL="http://monitorink.homelab.nestor-server.fr/image.png"
+export MONITORINK_REFRESH=600
+
+# Gouverneur CPU économe pendant les phases actives.
+for gov in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor; do
+    echo ondemand > "$gov" 2>/dev/null
+done
+
+# Lance la boucle (journalisée). exec pour ne pas laisser de process orphelin.
+exec sh "$BASE/monitorinkloop.sh" >> /tmp/monitorink.log 2>&1

kobo/monitorinkloop.sh

@@ -0,0 +1,67 @@
+#!/bin/sh
+# Monitorink — boucle d'affichage e-ink sur Kobo Libra 2.
+#
+# Conçu comme un OVERLAY sur un checkout de https://github.com/usetrmnl/trmnl-kobo :
+# il réutilise ses binaires ARM pré-compilés (bin/fbink, bin/busybox_kobo) et ses
+# helpers WiFi éprouvés (scripts/enable-wifi.sh, etc.). On remplace l'appel API TRMNL
+# par un simple fetch de notre image de dashboard.
+#
+# Lancé par monitorink.sh (lui-même lancé via NickelMenu).
+# ⚠️ La séquence suspend/rtcwake est à valider sur l'appareil (FW 4.38.23171).
+
+BASE="$(dirname "$0")"
+cd "$BASE" || exit 1
+
+IMAGE_URL="${MONITORINK_URL:-http://monitorink.homelab.nestor-server.fr/image.png}"
+REFRESH="${MONITORINK_REFRESH:-600}"     # secondes entre deux rafraîchissements
+TMP="/tmp/monitorink.png"
+
+FBINK="./bin/fbink/fbink"
+BUSYBOX="./bin/busybox_kobo"
+
+# Ferme les FD hérités pour ne pas bloquer l'éjection USB.
+exec 3>&- 2>/dev/null
+
+display() {
+    # Affiche l'image plein écran, full refresh (-f) anti-ghosting, clear (-c) avant.
+    "$FBINK" -g file="$TMP",valign=CENTER,halign=CENTER -c -f
+}
+
+suspend_for() {
+    # Suspend-to-RAM avec réveil RTC. Si rtcwake échoue (retour < 10 s), fallback
+    # séquence Kobo (state-extended) puis sleep en dernier recours.
+    secs="$1"
+    start=$(date +%s)
+    "$BUSYBOX" rtcwake -a -s "$secs" -m mem 2>/dev/null
+    end=$(date +%s)
+    if [ $((end - start)) -lt 10 ]; then
+        echo 1 > /sys/power/state-extended 2>/dev/null
+        sleep 2
+        echo mem > /sys/power/state 2>/dev/null
+        echo 0 > /sys/power/state-extended 2>/dev/null
+        # Si même ça n'a pas tenu, on dort simplement.
+        now=$(date +%s)
+        [ $((now - start)) -lt 10 ] && sleep "$secs"
+    fi
+}
+
+while true; do
+    ./scripts/ledToggle.sh on 2>/dev/null
+
+    # WiFi à la demande (ON -> fetch -> OFF) pour préserver la batterie.
+    ./scripts/enable-wifi.sh
+    ./scripts/force-wifi-connection.sh
+    ./scripts/obtain-ip.sh
+
+    if curl -fsS -m 30 -o "$TMP" "$IMAGE_URL"; then
+        display
+    else
+        "$FBINK" -pmh "Monitorink : image indisponible ($(date '+%H:%M'))"
+    fi
+
+    ./scripts/release-ip.sh
+    ./scripts/disable-wifi.sh
+    ./scripts/ledToggle.sh off 2>/dev/null
+
+    suspend_for "$REFRESH"
+done

kobo/nm/monitorink

@@ -0,0 +1,7 @@
+# Entrée NickelMenu pour Monitorink.
+# À copier dans /mnt/onboard/.adds/nm/monitorink
+# Lance le dashboard en tâche de fond. Pour arrêter : maintenir le bouton power
+# (réveil + reprise Nickel), ou tuer le process via une entrée dédiée si besoin.
+
+menu_item :main :Monitorink :cmd_spawn :exec /mnt/onboard/.adds/Monitorink/monitorink.sh
+  chain_success :dialog :Monitorink démarré