Ne t'approche pas trop, je mesure ton niveau de cringe. 📏

flo@master:~$ ./start_api.py▋

ToF Sensor API
La NASA du pauvre, powered by flo@master

Une API Flask pour mesurer à quel point tu t'approches de la poubelle.
VL53L5CX • 4x4 matrix • 10 Hz

// Live preview (simulation) - survole les cellules !

0.0
71.3
33.5
21.5
92.8
52.0
30.5
23.0
61.8
54.3
37.5
25.0
1974.5
54.5
47.0
31.8

{ Comment ça marche ? }

Spoiler : c'est de la magie. Non, en fait c'est juste de la lumière infrarouge. 🔦

📡

Le capteur VL53L5CX

Un petit capteur Time-of-Flight qui envoie de la lumière et mesure le temps de retour. Résultat : une matrice 4x4 de distances en millimètres.

🚀

API Flask

Un serveur Python qui tourne à 10 Hz et expose une route GET simple. Pas de fioritures, juste du JSON brut et efficace.

// Réponse de l'API

json
{
  "map": [
    [0.0, 71.25, 33.5, 21.5],
    [92.75, 52.0, 30.5, 23.0],
    [61.75, 54.25, 37.5, 25.0],
    [1974.5, 54.5, 47.0, 31.75]
  ]
}
0.0 mm

Soit tu colles le capteur, soit il panique. Dans tous les cas, recule. 😅

1974.5 mm

Attention, probablement un mur, une poubelle... ou ton boss. 👔

GET /map

La route principale. La seule. L'unique. La légende. 🏆

bash
curl http://10.8.252.16:5000/map
4×4

Matrice de distances en mm. 16 zones de détection.

10 Hz

Rafraîchissement. Assez rapide pour tracker ta procrastination.

JSON

Format de réponse. Pas de XML, on est civilisés ici.

💡 Use cases suggérés

  • • Poubelle intelligente — ouvre-toi quand j'arrive !
  • • Robot suiveur — mais pas trop près quand même.
  • • Détecteur de présence — pour savoir si quelqu'un approche de ton bureau.
  • • Art interactif — parce que pourquoi pas.

.env Configuration

Les variables d'environnement, aka "les trucs que tu oublies de configurer". 🙈

VariableDescriptionExemple
API_URLURL où le Pi envoie son IP périodiquementhttps://api.example.com/register
IP_SEND_INTERVALIntervalle d'envoi de l'IP en secondes600

⚠️ Conseil de pro (ou pas)

Si tu mets 1 seconde, ton API va te ghoster.
Si tu mets 86400, ton Pi a le droit de dormir toute la journée.
600 secondes (10 min) c'est le sweet spot. Tu peux me faire confiance. Ou pas.

🔄 Lifecycle du Raspberry

De "Je démarre" à "Je suis prêt à mesurer ta distance de procrastination".

1

Initialisation du capteur VL53L5CX

Le capteur se configure, charge ses paramètres et fait un petit check de santé.

→ Le capteur se réveille et regrette déjà d'être sur ce projet.

2

Démarrage du ranging à 10 Hz

Le capteur commence à envoyer des impulsions laser et mesure le temps de retour.

→ Pew pew pew ! 10 fois par seconde. Comme un Stormtrooper, mais qui vise juste.

3

Envoi de l'IP à l'API distante

Le Pi envoie son adresse IP au serveur distant pour être joignable depuis l'extérieur.

→ « Coucou c'est moi ! » — Le Pi, toutes les 10 minutes.

4

Lancement du serveur Flask

Le serveur Flask démarre sur le port 5000 et attend les requêtes.

→ Flo a oublié de faire un systemd service, donc il relance tout à la main. Classique.

🔧 Matériel

Tout ce qu'il faut pour devenir un professionnel de la mesure de distance. 📏

🥧

Raspberry Pi

Le cerveau de l'opération. Probablement un Pi 4 ou un Pi Zero.

Linux insideGPIO masterConsomme trop de café
📡

VL53L5CX

Le capteur Time-of-Flight qui fait semblant d'être un LIDAR.

Matrice 4x4InfrarougeFait semblant d'être LIDAR

Fun fact : Le VL53L5CX peut mesurer jusqu'à 4 mètres. Mais bon, si tu es à 4 mètres de ton capteur, t'as probablement d'autres problèmes à régler. 🤷

Built with v0