Mises à jour

Principe

Les SimServers et dispositifs KerSim fonctionnent en réseau fermé, sans accès internet. Le système de mise à jour est conçu pour que n’importe quel formateur puisse mettre à jour tout son parc en branchant une clé USB.

Le SimServer est le hub de distribution : une fois la mise à jour chargée sur un SimServer, elle se propage automatiquement à tout l’écosystème local.

 kersim.fr       Clé USB           SimServer 1
┌──────────────┐    ┌───────────┐    ┌──────────────────┐
│  Télécharger │───▶│ .ksupdate │───▶│  Détecte, valide, │
│  le package  │    │           │    │  applique         │
└──────────────┘    └───────────┘    └───┬──────┬───┬────┘
                                        │      │   │
                                        ▼      ▼   ▼
                                     PWA    ESP32s  SimServers
                                     SimPilot  (OTA)   pairs

Ce qui est mis à jour

Couche	Contenu	Mécanisme
SimServer	Application SimServer (Docker), configs	Package .ksupdate → SimServer
PWAs	SimPilot, SimCam, SimStudio, SimView, SimPhone	Automatique — servies par SimServer
Firmware ESP32	Binaires par dispositif	OTA WiFi depuis SimServer
Scénarios	Fichiers JSON	Synchronisation ESP-NOW/WiFi
Modèles IA	Fichiers .onnx / .rknn	Copie dans le volume Docker, rechargement du moteur IA
Python	Dépendances serveur	Wheels embarquées dans le .ksupdate

Les 3 canaux de mise à jour

Canal principal — Clé USB

C’est le canal recommandé, le plus simple et le plus fiable.

1. Télécharger le package .ksupdate depuis kersim.fr/updates sur n’importe quel ordinateur connecté à internet

2. Copier le fichier .ksupdate sur une clé USB

3. Brancher la clé USB dans le SimServer (ou la SimBox)

4. Appliquer : SimServer détecte automatiquement la mise à jour et affiche « Mise à jour v2.4.0 disponible — Appliquer ? ». Un clic suffit.

Astuce

C’est le même geste que pour mettre à jour un défibrillateur Zoll ou Philips : télécharger, copier sur clé, brancher. Les formateurs connaissent déjà cette procédure.

Canal secondaire — Tethering 4G

Pour une mise à jour rapide sans clé USB :

• Partager la connexion 4G d’un téléphone vers le SimServer (USB ou WiFi)
• SimServer détecte l’accès internet automatiquement, vérifie kersim.fr/updates
• Téléchargement automatique du .ksupdate
• SimServer repasse en mode fermé automatiquement après la mise à jour

Canal complémentaire — PWA tablette

Quand la tablette du formateur a accès à internet (domicile, bureau) :

• La PWA SimPilot pré-télécharge le package en arrière-plan
• En se reconnectant au SimServer, elle propose « Mise à jour disponible, transférer au SimServer ? »

Note

Ce canal est réservé aux mises à jour légères (< 50 Mo : PWAs, scénarios). Les gros paquets (images Docker, firmware, modèles IA) passent par USB ou tethering.

Cascade automatique

Une fois la mise à jour sur un SimServer, la distribution est automatique :

Cible	Mécanisme	Action du formateur
PWAs	Mise à jour instantanée au prochain chargement (Service Worker)	Aucune
Firmware ESP32	OTA via WiFi au boot des dispositifs (partition A/B)	Aucune
Scénarios	Synchronisés au démarrage de la simulation	Aucune
Autres SimServers	Proposé via Ethernet en mode multi-salles	Un clic par SimServer
Modèles IA	Copiés dans le volume Docker, rechargés par le moteur IA	Aucune (redémarrage service)

Astuce

En mode multi-salles : mettre à jour un seul SimServer suffit. Il propage automatiquement la mise à jour aux autres SimServers du réseau Ethernet via mDNS, qui propagent eux-mêmes à leurs dispositifs ESP32.

Package .ksupdate

Le format .ksupdate est un fichier ZIP standard (Content-Type application/zip) contenant tous les composants. Le format ZIP est utilisé pour passer les proxies et filtres hospitaliers sans problème.

Propriété	Détail
Format	ZIP standard (renommable en .zip si filtre)
Contenu	Docker image (zstd), PWAs, firmware ESP32, scénarios JSON, modèles IA, wheels Python, migrations
Signature	Ed25519 — empêche corruption et injection
Intégrité	Hash SHA-256 par composant dans manifest.json
Manifest	Versions source/cible, plateformes supportées, changelog bilingue

Structure interne

kersim-2.4.0.ksupdate
├── manifest.json              ← Version, checksums, changelog
├── manifest.json.sig          ← Signature Ed25519
├── docker/                    ← Image Docker (docker save | zstd)
├── www/                       ← PWAs buildées (pilot, cam, view, studio, phone)
├── python/wheels/             ← Dépendances Python
├── firmware/                  ← Binaires ESP32 (dinamap.bin, dae.bin, scope.bin)
├── models/                    ← Modèles IA (optionnel)
├── scenarios/                 ← Scénarios JSON (optionnel)
└── migrations/                ← Scripts de migration config

Sécurité et rollback

Le système garantit qu’une mise à jour échouée ne bloque jamais un SimServer ni un dispositif :

• Validation préalable : signature Ed25519, checksums SHA-256, compatibilité plateforme, version minimale, espace disque
• Snapshot : sauvegarde complète (Docker, PWAs, config, version) avant application
• Partition A/B sur ESP32 : si le nouveau firmware ne boot pas en 30 secondes, l’ESP32 revient automatiquement sur l’ancienne version
• Watchdog 5 minutes : si la mise à jour est bloquée, un timer systemd indépendant déclenche le rollback
• Mode maintenance : pendant la mise à jour, SimServer refuse les démarrages de simulation
• Alerte version hétérogène : si un dispositif ESP32 n’a pas pu être mis à jour (éteint, hors portée), le dashboard l’indique avec un bouton « Réessayer »
• Journal de mises à jour : historique horodaté consultable depuis le dashboard

Flux de mise à jour

idle → validating → snapshotting → applying → verifying → completed
                 ↘ validation_failed          ↘ rolled_back

API REST

Le SimServer expose une API pour piloter les mises à jour depuis le dashboard :

Endpoint	Description
GET /api/updates/status	Version courante, état, mise à jour en attente
GET /api/updates/history	Journal des mises à jour appliquées
POST /api/updates/apply	Déclencher l’application d’un .ksupdate détecté
POST /api/updates/rollback	Rollback manuel vers la version précédente
GET /api/updates/firmware	Versions firmware et état OTA par dispositif
POST /api/updates/upload	Transférer un .ksupdate via HTTP (canal PWA)
GET /api/firmware/{type}/version	Version firmware disponible (endpoint OTA ESP32)
GET /api/firmware/{type}/binary	Téléchargement binaire firmware (endpoint OTA ESP32)

Page /updates

Le dashboard SimStudio inclut une page dédiée /updates :

• État de chaque composant : version actuelle, date de dernière mise à jour
• Statut des dispositifs : liste des ESP32 et leur version firmware, avec alerte si hétérogène
• Historique : journal complet des mises à jour appliquées
• Mise à jour manuelle : bouton pour déclencher une vérification / application
• Rollback : bouton pour revenir à la version précédente

Voir aussi

Mode multi-salles

La mise à jour se propage entre SimServers via le réseau multi-salles.

Réseau & HTTPS

Architecture réseau et certificats TLS du SimServer isolé.