POC — Démarrage rapide

Astuce

Cette page vous guide pour valider la partie logicielle de SimServer sur n’importe quelle machine Linux (RPi 4/5, Intel NUC, mini-PC, etc.) avec Docker. Aucun hardware spécifique n’est requis — pas de webcam, pas d’ESP32 — pour un premier test.

Matériel nécessaire

Composant	Spécification
Machine Linux	RPi 4/5, Intel NUC, mini-PC, ou tout PC avec Linux
Docker	Docker Engine + Docker Compose v2
Réseau	Ethernet ou WiFi

Note

Machines recommandées : Radxa ROCK 5 ITX+ (ARM, NPU intégré), Intel NUC (x86), ou Raspberry Pi 4/5 (budget). Voir Profils matériels pour les détails.

Étape 1 — Prérequis

1. Installer Docker sur votre machine Linux :

   curl -fsSL https://get.docker.com | sh
   sudo usermod -aG docker $USER
   # Se déconnecter/reconnecter pour que le groupe prenne effet

2. Vérifier l’installation :

   docker --version
   docker compose version

Étape 2 — Déployer SimServer

Git clone (recommandé)

git clone https://github.com/VOTRE_COMPTE/sim.git ~/sim
cd ~/sim/server
docker compose up -d

Téléchargement direct

mkdir -p ~/simstudio && cd ~/simstudio
# Récupérer le docker-compose.yml et les configs
curl -LO https://github.com/kersim/sim/raw/main/server/docker-compose.yml
curl -LO https://github.com/kersim/sim/raw/main/server/Caddyfile
docker compose up -d

Ce que fait docker compose up

Le stack Docker démarre automatiquement :

1. Caddy — reverse proxy avec TLS automatique (ports 80/443)
2. SimServer API — FastAPI (orchestration, WebSocket, API REST)
3. MQTT — Eclipse Mosquitto (bus d’événements inter-services)
4. Redis — cache et files de tâches
5. go2rtc — relai WebRTC pour le streaming caméra

Note

Le premier démarrage télécharge les images Docker. Compter 2-5 minutes selon la connexion.

Étape 3 — Vérifier que tout tourne

Health check

docker compose ps

Tous les services doivent être en état running.

Vérifications manuelles

# API système
curl -sk https://localhost/api/system | python3 -m json.tool
# → {"profile": "cpu", "espnow_connected": false, ...}

# Caméras de test
curl -sk https://localhost/api/cameras | python3 -m json.tool
# → [{"id": "cam-test-1", "type": "test", "online": true}, ...]

# Logs en temps réel
docker compose logs -f simstudio

Dashboard web

Depuis un navigateur sur le même réseau :

https://<IP-DE-LA-MACHINE>

Le dashboard affiche :

• Les constantes vitales animées (FC, SpO2, PNI, FR, EtCO2) générées par le mock
• Les caméras de test (SMPTE, horloge) marquées “online”
• Les contrôles d’enregistrement (start/stop/marker)

Note

Le certificat TLS est auto-signé par Caddy. Le navigateur affichera un avertissement — accepter le certificat pour continuer.

Étape 4 — WiFi AP (optionnel)

Attention

Prérequis : la machine doit avoir une interface WiFi et un câble Ethernet branché. Le WiFi sera transformé en point d’accès.

# Configurer le point d'accès WiFi
docker compose exec simstudio python -m simstudio.setup_ap

Paramètres par défaut

Paramètre	Valeur	Config
SSID	KerSim-KIT1	config/config.yaml → wifi_ap.ssid
Mot de passe	kersim	config/config.yaml → wifi_ap.password
Canal	6 (2.4 GHz)	config/config.yaml → wifi_ap.channel
IP SimServer	192.168.4.1	config/config.yaml → wifi_ap.ip

Connexion depuis tablette/téléphone

1. Se connecter au WiFi KerSim-KIT1 (mot de passe : kersim)
2. Ouvrir https://192.168.4.1
3. Le dashboard SimStudio s’affiche

Caméra iPhone / mobile (via go2rtc)

Astuce

Un iPhone suffit pour réaliser une séance de simulation complète avec débriefing vidéo. Le flux RTMP arrive en temps réel dans le dashboard, est enregistré avec les constantes vitales en overlay, et peut être rejoué en débriefing. Aucune caméra supplémentaire n’est nécessaire pour démarrer.

go2rtc est installé automatiquement par bootstrap.sh. Il permet d’utiliser un iPhone ou tout smartphone comme caméra WiFi en poussant un flux RTMP vers SimServer.

Prérequis

• WiFi AP configuré (make setup-ap) — le téléphone doit être sur le réseau KerSim-KIT1
• Larix Broadcaster installé sur l’iPhone (gratuit, App Store) ou sur Android (Play Store)

Configuration de Larix Broadcaster

1. Ouvrir Larix Broadcaster sur l’iPhone

2. Aller dans Settings (engrenage) → Connections → New connection

3. Configurer :

   Paramètre	Valeur
   Name	SimServer
   URL	rtmp://192.168.4.1:1935/live/iphone

4. Sauvegarder et revenir à l’écran principal

5. Appuyer sur le bouton rouge pour démarrer le flux

Vérification

# Vérifier que go2rtc reçoit le flux
curl -s http://localhost:1984/api/streams | python3 -m json.tool
# → Le stream "iphone" doit apparaître

# Le flux apparaît dans le dashboard SimStudio
# https://192.168.4.1

Ajouter la caméra au dashboard

Depuis la page Caméras du dashboard SimStudio :

1. Ouvrir https://192.168.4.1/cameras

2. Cliquer sur + Ajouter une caméra → RTMP (Larix / OBS)

3. Nom : iPhone formateur, Stream key : live/iphone

4. Cliquer Ajouter — l’URL RTMP s’affiche, la caméra apparaît dans la liste

Ou via l’API REST :

curl -X POST https://localhost/api/cameras \
  -H "Content-Type: application/json" \
  -d '{"type": "rtmp", "id": "cam-iphone", "name": "iPhone formateur", "stream_key": "live/iphone"}'

Note

Alternatives à Larix Broadcaster : toute application capable de pousser du RTMP fonctionne. Sur Android, Streamlabs ou Larix Broadcaster sont compatibles. Une GoPro avec GoPro Labs peut aussi pousser vers rtmp://192.168.4.1:1935/live/gopro.

Note

Plusieurs smartphones en même temps : chaque téléphone peut pousser un flux RTMP différent (ex: live/iphone, live/android). Il suffit d’ajouter une caméra RTMP par appareil depuis la page /cameras. Tous les flux apparaissent dans la grille du dashboard.

Après un reboot

Docker redémarre automatiquement les services (restart: unless-stopped). Aucune intervention manuelle.

docker compose ps   # Vérifier que tout tourne

Aide-mémoire

Commande	Action
docker compose ps	État des services
docker compose logs -f	Logs temps réel
docker compose up -d	Démarrer les services
docker compose down	Arrêter les services
docker compose restart	Redémarrer les services
docker compose pull && docker compose up -d	Mettre à jour

Prochaines étapes

Caméra iPhone/mobile

Installer Larix Broadcaster, pousser un flux RTMP vers SimServer. Voir la section ci-dessus.

Ajouter une webcam

Brancher une Logitech C930e, puis l’ajouter depuis la page Caméras (/cameras).

ESP32-S3 USB Bridge

Brancher le bridge ESP-NOW pour connecter les dispositifs de simulation.

Profils matériels

Voir les machines de référence et profils d’accélération pour SimServer.