Procédure de test (serveur + ESP32)

1) Lancer le nœud FastAPI (Station K sur PC)

cd backend/obambu_node
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Vérification rapide :

curl http://localhost:8000/health

2) Tester le flux device côté API

curl -X POST http://localhost:8000/api/v1/device/hello \
  -H "Content-Type: application/json" \
  -d '{"device_id":"DEV-001","fw_version":"0.0.1","station_type":"S"}'

curl "http://localhost:8000/api/v1/device/config?device_id=DEV-001"

curl -X POST http://localhost:8000/api/v1/device/content_index

3) Flasher l’ESP32 avec le sketch minimal

Remplir WIFI_SSID, WIFI_PASS et API_BASE puis flasher :

// ESP32 Station S – Sketch minimal de test (Wi-Fi + /health)
// Renseigner WIFI_SSID, WIFI_PASS et API_BASE avant flash.

#include <WiFi.h>
#include <HTTPClient.h>

const char* WIFI_SSID = "YOUR_WIFI_SSID";
const char* WIFI_PASS = "YOUR_WIFI_PASSWORD";
const char* API_BASE  = "http://192.168.1.10:8000"; // IP du nœud FastAPI

const int LED_PIN = 2; // LED intégrée ESP32 DevKit

void setup() {
  Serial.begin(115200);
  pinMode(LED_PIN, OUTPUT);
  digitalWrite(LED_PIN, LOW);

  connectWiFi();
  pingHealth();
}

void loop() {
  delay(5000);
  pingHealth();
}

void connectWiFi() {
  WiFi.mode(WIFI_STA);
  WiFi.begin(WIFI_SSID, WIFI_PASS);
  Serial.print("WiFi...");
  int retries = 0;
  while (WiFi.status() != WL_CONNECTED && retries < 30) {
    delay(500);
    Serial.print(".");
    retries++;
  }
  
if (WiFi.status() == WL_CONNECTED) {
  Serial.println(" OK");
  Serial.print("SSID: "); Serial.println(WiFi.SSID());
  Serial.print("IP: "); Serial.println(WiFi.localIP());
  digitalWrite(LED_PIN, HIGH);
} else {
  Serial.println(" FAIL");
}

}

void pingHealth() {
  if (WiFi.status() != WL_CONNECTED) {
    Serial.println("WiFi non connecté");
    return;
  }
  HTTPClient http;
  String url = String(API_BASE) + "/health";
  http.begin(url);
  int code = http.GET();
  Serial.printf("/health -> %d\n", code);
  if (code > 0) {
    String body = http.getString();
    Serial.println(body);
  }
  http.end();
}

Source complète disponible dans plan-details/details-blockchain-security_code-per-device/esp32_station_s_min.ino/esp32_station_s_min.ino.

THIS IS NOT GOOD : "Heath - 1" commectoin o, mais requête échouée..s

Endpoints device : hello, config, content_index, content

Objectif

• Servir le minimum vital aux stations S/H : handshake, récupération de config, liste des contenus, téléchargement.
• Rester simple (pas de crypto ni quotas) pour valider le flux bout en bout.

Implémentation actuelle

• Routes existantes : /api/v1/device/hello, /api/v1/device/config, /api/v1/device/content_index, /api/v1/device/content.
• Réponses JSON, validation Pydantic, stockage SQLite/JSON.

À surveiller / suites

• Pas encore de throttling ni d’auth sur ces endpoints (sera couvert en Phase 5).
• Prévoir métriques de base (compteurs de hits, temps de réponse) pour la supervision.

Stockage JSON simple (devices.json, dossier docs/)

Objectif

• Avoir un stockage lisible et portable pour les devices et contenus pendant les premiers tests.

Implémentation actuelle

• devices.json pour la liste des devices (hello/config).
• Dossier docs/ pour les fichiers et méta simples.
• Couche SQLite déjà présente si besoin d’état persistant.

À surveiller / suites

• Nettoyage/purge des entrées obsolètes (devices inactifs).
• Migration vers un schéma plus strict quand la crypto et les quotas arriveront.

ESP32 : Wi-Fi dur, hello, config, contenu, LED

Objectif

• Valider le chemin device → nœud → device avec un firmware minimal (scan, téléchargement, feedback LED).

État

• Sketch de base prêt (Wi-Fi, POST hello, GET config, téléchargement contenu, LED).
• Pas encore figé : gestion des erreurs réseau, timeouts, reprise.

À finir

• Stabiliser le sketch (retries, watchdog, logs série).
• Documenter le workflow (ordre des appels, formats attendus).

Implémentation API + sketch ESP32

Travaux à finir

• Aligner les endpoints et payloads entre firmware et API (noms de champs, codes retour).
• Scripts de test automatiques (curl/postman) pour valider le firmware sans le flasher à chaque fois.
• Checklist de build/flashing (librairies Arduino, partitions SPIFFS si utilisées).

Choix à documenter

• Mode connexion Wi-Fi (dur vs opportuniste), timeouts et fréquence de pull.
• Taille max des contenus pour l’ESP32, stratégie de stockage (SPIFFS ou µSD).