Mode d'emploi

Ajouter une passerelle

Une passerelle (le Raspberry Pi de la maison) s'annonce toute seule au site dès qu'elle a du réseau. Vous n'avez rien à saisir côté Pi, à part l'adresse du site lors de son installation.

1. Allumez la passerelle et attendez qu'elle capte la 4G.
2. Lisez le code d'appairage sur son écran local : huit caractères en deux groupes, du type K7QP-2M9X.
3. Sur la page Mes passerelles, saisissez ce code et validez.

La saisie est tolérante : majuscules ou minuscules, tirets ou non. Le code ne contient jamais les caractères ambigus O, 0, I ni 1.

Le code vaut 24 heures, puis expire. Ce n'est pas grave : la passerelle en génère un nouveau à sa prochaine connexion, il suffit de le relire sur son écran. Un code seul ne donne aucun accès — il faut aussi être connecté à un compte.

Le premier compte qui revendique une passerelle en devient propriétaire. Une passerelle déjà liée ne peut pas être reprise par un autre compte : il faut passer par un partage, ou par une réinitialisation.

Comprendre les états affichés

Une passerelle absente n'est pas forcément en panne : elle dort souvent pour économiser la batterie. Les quatre états ne veulent pas dire la même chose.

Chaque valeur affichée porte son âge. Une valeur plus vieille qu'un intervalle de mesure est atténuée et marquée « périmée » : c'est une valeur ancienne, pas une valeur actuelle.

Sur les graphiques, les trous ne sont jamais comblés et les plages de veille apparaissent en fond grisé : ce que vous voyez est ce qui a réellement été mesuré.

Partager l'accès, retirer un accès

Depuis l'onglet Partages d'une passerelle (propriétaire uniquement), ajoutez une adresse électronique et choisissez son rôle :

• Propriétaire — tout, y compris la configuration, les partages et la déliaison.
• Invité — consulter, demander une photo et déclencher des relevés. Rien qui modifie durablement la maison.

Vous pouvez partager avec une adresse qui n'a pas encore de compte : le partage l'attend et devient actif dès l'inscription.

Le dernier propriétaire ne peut pas être retiré — sinon plus personne ne pourrait administrer la passerelle. Nommez un autre propriétaire d'abord.

Inviter par lien ou par code QR

Le partage direct demande de connaître l'adresse du destinataire, et qu'il ait — ou finisse par avoir — un compte. L'invitation produit un lien et un code QR : la personne l'ouvre, crée son compte au passage, et l'accès s'applique aussitôt.

Nominative ou au porteur

• Avec une adresse — le lien ne vaut que pour cette adresse. C'est le choix sûr.
• Sans adresse — le lien vaut pour qui le détient. Pratique pour montrer un QR à quelqu'un en face de soi. Ne le publiez pas et ne le laissez pas traîner dans une conversation de groupe.

Ce qu'il faut savoir

• Une invitation vaut sept jours et ne sert qu'une fois.
• Le lien n'est affiché qu'à sa création. Le site n'en garde qu'une empreinte : il ne pourra pas vous le rappeler. Copiez-le ou faites scanner le code tout de suite.
• Vous pouvez révoquer une invitation tant qu'elle n'a pas servi : le lien cesse alors de fonctionner.
• L'envoi par e-mail suppose qu'un serveur de messagerie soit configuré par l'administrateur. S'il ne l'est pas, le lien existe quand même — transmettez-le vous-même.

Le code QR reste en noir sur blanc même en thème sombre : un code clair sur fond sombre n'est pas lisible par un lecteur.

Réinitialiser une passerelle (cavalier)

À faire quand vous voulez repartir de zéro : passerelle revendue, donnée, ou compte propriétaire perdu. L'opération se fait sur le matériel, elle fonctionne même sans réseau.

1. Éteignez la passerelle.
2. Placez un cavalier entre le GPIO 26 (broche 37) et la masse (broche 39) du Raspberry Pi.
3. Rallumez la passerelle, cavalier en place.
4. Retirez le cavalier une fois qu'elle a démarré.

La passerelle efface alors sa liaison locale — jeton compris — prévient le site si elle a du réseau, puis se ré-enrôle et affiche un nouveau code d'appairage.

Si le site n'a pas pu être prévenu

Si la passerelle était hors-ligne au moment de la réinitialisation, le site ne peut pas faire la différence entre une vraie réinitialisation et quelqu'un qui tenterait de vous prendre la passerelle. Il refuse donc le ré-enrôlement et attend votre confirmation.

Un bandeau apparaît sur la passerelle concernée dans Mes passerelles. Rendez-vous dans son onglet Partages et confirmez.

Ne confirmez que si vous avez vous-même réinitialisé le Pi. Confirmer retire tous les accès et régénère le code d'appairage.

Délier une passerelle depuis le site

La déliaison est l'équivalent logiciel du cavalier, déclenché depuis l'onglet Partages. Elle retire tous les accès, invalide le jeton de la passerelle et régénère son code d'appairage.

La passerelle se ré-enrôlera d'elle-même et affichera son nouveau code, à saisir comme lors d'un premier ajout. C'est irréversible : l'historique reste en base, mais plus personne n'y a accès tant que la passerelle n'a pas été revendiquée à nouveau.

Envoyer une commande

Depuis l'onglet Commandes, ou depuis la page d'un node pour ce qui le concerne. Le cycle de vie est visible à l'écran :

• En attente la passerelle dort — la commande partira à son réveil.
• Transmise la passerelle l'a reçue.
• Transmise à l'ESP elle est partie sur le réseau mesh.
• Échec avec le motif exact.

Limitation actuelle du firmware : le réseau mesh ignore le ciblage d'un node. Une commande destinée à un node est reçue par tous les nodes.

« Transmise à l'ESP » ne veut pas dire « exécutée » : le mesh n'accuse pas réception de bout en bout. La confirmation réelle arrive au prochain rapport du node.

Les commandes coûteuses en énergie — photo, veille, sommeil profond — demandent une confirmation avant d'être envoyées.

Modifier la configuration

L'onglet Configuration pilote les cadences, le seuil de batterie et la plage de veille. Le site est la référence : la passerelle reçoit ces réglages à chaque connexion, et n'a rien à saisir localement.

Après enregistrement, la mention reste « en attente de la passerelle » jusqu'à ce qu'elle réponde. Si elle dort, c'est normal : les réglages seront appliqués à son réveil.

Chaque cadence a un coût en énergie. Une photo par heure reste raisonnable ; une photo toutes les cinq minutes vide la batterie en hiver. Dans le doute, allongez les intervalles.

Le seuil de tension minimale est le filet de sécurité : en dessous, la passerelle s'endort d'elle-même pour ne pas achever la batterie. Pour les horaires, voyez Régler les horaires d'allumage.

Régler les horaires d'allumage

Vous dessinez les moments où la passerelle est allumée. Tout ce que vous ne dessinez pas, elle le passe à dormir — c'est ce qui fait tenir la batterie.

La barre des 24 heures

La barre couvre la journée de minuit à minuit. Les parties pleines sont les heures allumées ; le fond hachuré est le sommeil. Faites glisser une poignée pour déplacer une heure.

• Le glissement s'arrête tous les quarts d'heure. Pour 06:07, tapez l'heure dans le champ sous la barre : les deux restent d'accord en permanence.
• Au clavier : atteignez une poignée par tabulation, puis les flèches pour un quart d'heure, Page haut / Page bas pour une heure.
• Si la barre ne s'affiche pas — JavaScript bloqué, réseau capricieux — les champs d'heure suffisent seuls.

Plusieurs plages

Jusqu'à six, par exemple une le matin et une le soir, avec un creux à midi. Chacune porte un nom libre et une case « Active ».

• Une plage peut traverser minuit : une passerelle allumée de 22:00 à 06:00 se dessine d'un bout à l'autre de la barre.
• Deux plages actives ne peuvent pas se chevaucher. Le chevauchement s'affiche pendant que vous glissez, et l'enregistrement est refusé tant qu'il dure.
• Pour neutraliser une plage sans la perdre, décochez « Active » plutôt que de la retirer : elle disparaît de la barre mais reste dans la liste, prête à être rallumée.
• Il faut au moins une plage active. Une passerelle qui ne se réveille jamais ne peut plus être jointe ni reconfigurée à distance — il faudrait aller sur place.
• Pour qu'elle reste allumée en permanence, mettez la même heure des deux côtés : des bornes confondues valent la journée entière.

Une passerelle dont le logiciel est antérieur aux plages multiples ne respectera que le premier sommeil. Elle dort donc au bon moment, mais pas autant que prévu — mettez son logiciel à jour pour profiter de toutes les plages.

Le site enregistre vos plages d'allumage et envoie à la passerelle les creux correspondants : c'est ainsi qu'elle a toujours fonctionné, rien ne change de son côté.

Régler la prise de vue

L'onglet Réglage photo d'une passerelle rassemble tous les paramètres de prise de vue, un jeu par caméra. Chaque libellé porte entre parenthèses le nom de l'option correspondante — --shutter, --awb — parce que la passerelle exécute réellement l'outil rpicam-still : le nom permet d'en retrouver la documentation.

Ce que le site fait, et ce qu'il ne fait pas

Le site borne les valeurs absurdes, mais il ne sait pas de quel objectif vous disposez. Un réglage accepté ici peut être ignoré par la passerelle : la mise au point sur une focale fixe, le HDR sur un module qui n'en a pas. Ce n'est pas une panne.

Les réglages qui comptent vraiment

Essayer avant de laisser tourner

Deux boutons sous chaque caméra déclenchent une photo tout de suite : l'un avec le profil de jour, l'autre en forçant la pose longue sans attendre la nuit. La photo arrive dans la galerie comme les autres.

Enregistrez d'abord. Un essai utilise les réglages déjà poussés à la passerelle, pas ceux affichés à l'écran — sinon il faudrait que la commande transporte une configuration entière, et l'on ne saurait plus lequel des deux fait foi.

Dire où se trouve la passerelle

Le site a besoin de savoir où est la passerelle pour calculer le lever et le coucher du soleil. Sans cette position, les time-lapse calés sur le soleil refusent de se produire — c'est voulu : deviner un lieu donnerait des heures fausses, donc un film incohérent.

Deux sources, et une seule règle

• Si la passerelle a un GPS, sa position est relevée toute seule et c'est elle qui fait foi. Rien à saisir.
• Sans GPS, saisissez la position dans l'onglet Configuration, en degrés décimaux. Un clic droit sur l'emplacement dans une carte en ligne les donne.

Le GPS l'emporte toujours. Une maison peut se déplacer, et un relevé réel vaut mieux qu'une saisie qu'on a oublié de mettre à jour : si la passerelle se met à rapporter un GPS, la position saisie cesse silencieusement de servir. Elle reste enregistrée, prête à reprendre le relais si le récepteur tombe en panne.

Vider les deux champs efface la position. C'est parfois le bon geste : mieux vaut « inconnue », qui refuse franchement, qu'un lieu faux hérité d'un essai, qui produirait des films décalés sans que rien ne le signale.

Cette position ne quitte pas le site : elle n'est pas envoyée à la passerelle, qui n'en a pas besoin.

Comprendre le bilan d'énergie

Le tableau de bord chiffre, sur les dernières 24 heures :

• Entrée — ce que les panneaux ont fourni, en milliampères-heures (mAh).
• Sortie — ce que la maison a consommé.
• Bilan — la différence. Positif, la batterie s'est rechargée ; négatif, elle s'est vidée.

Un bilan négatif plusieurs jours d'affilée en hiver est normal, mais il annonce une veille prolongée : c'est le moment d'allonger les intervalles de photo et de mesure.

Le calcul intègre les courants relevés : chaque mesure vaut pour l'intervalle qui la sépare de la précédente. Les intervalles trop longs — veille, coupure 4G — sont écartés plutôt qu'extrapolés. Le chiffre est donc prudent : la consommation réelle pendant les trous n'est pas comptée, faute de mesure.

La carte et les positions

Si la passerelle a un récepteur GPS, le tableau de bord affiche sa position. Le marqueur rouge est la position actuelle ; les autres sont les emplacements précédents, reliés par un tracé.

Les positions sont regroupées à une dizaine de mètres près : une maison immobile n'affiche qu'un seul point, même après des milliers de relevés. Voir plusieurs points signifie que la passerelle a réellement bougé — utile pour une cabane de chantier ou un véhicule, et révélateur si elle ne devait pas bouger.

Vie privée

Les fonds de carte ne sont jamais chargés depuis un site tiers : ce serveur va les chercher lui-même et les garde. Aucune adresse IP d'utilisateur ne part chez un fournisseur de cartes, et une zone déjà consultée reste affichable même sans internet.

Si une zone n'a jamais été consultée et que le serveur n'a pas de réseau, les tuiles manquantes apparaissent en gris uni — les marqueurs, eux, restent justes.

Photos

Les photos arrivent périodiquement, sur demande, ou lors d'une alerte. Le bouton Prendre une photo maintenant crée une commande ordinaire : si la passerelle dort, la photo sera prise à son réveil.

Les images ne sont visibles qu'après connexion, et seulement par les comptes ayant accès à la passerelle. Aucune adresse de photo n'est publique ni devinable.

Faire un time-lapse

Le site assemble les photos d'une période en vidéo. Choisissez la période, puis quelles images retenir :

Pourquoi le lever plutôt qu'une heure fixe ? Sur un an, une photo prise tous les jours à 8 h passe du plein jour à la nuit noire au fil des saisons : le film clignote. Calée sur le lever, la lumière reste comparable d'une image à l'autre.

Les modes calés sur le soleil ont besoin de savoir où se trouve la passerelle : sans position GPS, le site refuse plutôt que de deviner. Le midi solaire n'est d'ailleurs pas midi — à Sion, en été, il tombe vers 13 h 33 locales.

L'assemblage se fait en arrière-plan et peut prendre plusieurs minutes. L'état est affiché, et le film reste téléchargeable ensuite. S'il échoue — trop peu de photos, période trop large — le motif exact est indiqué.

Exposition et pose longue

Chaque caméra a ses réglages, dans l'onglet Configuration. Le jour, l'exposition automatique suffit presque toujours. La nuit, elle ne suffit plus : le capteur ne voit rien.

• La pose longue laisse le capteur ouvert plus longtemps — jusqu'à 60 secondes. On voit alors ce que l'œil ne voit plus, mais tout ce qui bouge devient flou et la prise consomme davantage.
• Le gain amplifie le signal. Au-delà de 8, le bruit devient visible : préférez allonger la pose.
• Le bouton Essai pose longue, sur la page Photos, force le réglage tout de suite, sans attendre la nuit. C'est la seule façon de voir ce qu'il donne avant de le laisser tourner — la photo d'essai arrive dans la galerie comme les autres.
• Le site ne sait pas ce que votre objectif sait faire : il écarte les valeurs absurdes, mais c'est la passerelle qui refusera ce dont elle est incapable.

Les films qui se refont tout seuls

Toute passerelle reçoit d'office quatre films permanents : lever du soleil, midi solaire, coucher du soleil, et un film brut de toutes les photos — ce dernier éteint au départ, car il rassemblerait des centaines d'images par jour.

• Ils se refont une fois par jour, sans qu'on demande rien. Plus souvent serait du temps machine gâché : une journée de plus ne change pas un film de trente jours.
• Ils regardent une fenêtre glissante — les trente derniers jours par défaut — et non une période figée. Le film montre donc toujours la période qui vient de s'écouler.
• Suspendre plutôt que retirer : le film cesse de se refaire mais reste dans la liste, prêt à reprendre. Le retirer est définitif — les vidéos déjà produites, elles, restent.
• Le bouton Ajouter un film permanent en crée d'autres : autant que vous voulez, avec leur propre fenêtre et leur propre cadence.

Une passerelle sans position GPS ne peut produire aucun film calé sur le soleil. Le motif s'affiche dans la ligne du film, et le site n'insiste pas : il réessaiera le lendemain, pas toutes les heures.

Réparer la connexion à distance

L'onglet Connectivité pilote le réseau de la passerelle sans être devant elle : WiFi, filaire, 4G, VPN et point d'accès de secours. Il existe parce que la page d'administration locale du Pi n'est joignable que depuis la maison — donc inutilisable quand c'est justement la liaison qu'il faut réparer.

Ce que l'écran affiche

L'état vient de la passerelle, pas de ce que vous lui avez demandé. Une action acceptée n'est pas une action réussie : attendez que l'état se mette à jour. Sa date est affichée, parce qu'un état vieux d'une heure ne se lit pas comme un état actuel.

Les secrets ne sont jamais conservés

Mot de passe WiFi, code PIN de la SIM, clé privée WireGuard : ils traversent le site et sont oubliés. Ils ne sont ni écrits en base, ni journalisés, ni jamais réaffichés.

Conséquence directe : une action portant un secret exige que la passerelle soit connectée. Elle ne peut pas être mise en attente, puisqu'une action en attente devrait bien être écrite quelque part. Les autres actions, elles, patientent et partent à la reconnexion.

Les actions qui peuvent faire disparaître la passerelle

Changer le WiFi, fixer une adresse filaire, couper la 4G, activer le VPN ou monter le point d'accès : chacune peut couper la liaison. Le site prévient avant, et la confirmation peut ne jamais arriver — ce n'est pas forcément un échec.

• Après activation du VPN, la passerelle vérifie qu'elle vous joint toujours et redescend le tunnel sinon. Une configuration en AllowedIPs = 0.0.0.0/0 ou portant une ligne DNS = sera très probablement refusée ainsi.
• Une adresse fixe sans préfixe est refusée : 10.0.0.38 vaut un /24 pour vous mais un /32 pour la machine, et la passerelle ne joindrait plus rien.
• Monter le point d'accès occupe la radio : la passerelle quitte son réseau WiFi, et la recherche de réseaux devient impossible tant qu'il est monté.
• Un point d'accès monté reste actif après un redémarrage jusqu'à un arrêt explicite.

Ce qui exige d'être sur place

Un câble Ethernet débranché, les cavaliers GPIO 26 (réinitialisation) et 19 (portail forcé), et toute panne qui laisse la passerelle sans aucune voie de sortie. Elle ne peut alors plus rien recevoir : aucun bouton de ce site n'y changera quoi que ce soit.

Si quelque chose ne va pas