SailPerf
Notice d'utilisation

Table des matières

1. Présentation de SailPerf
2. Prérequis
3. Installation
4. Configuration réseau à bord
5. Connexion avec Adrena
6. Connexion avec OpenCPN
7. Instruments B&G (Vulcan, Zeus, H5000)
8. Autres logiciels / sources UDP
9. Premier démarrage
10. Guide des onglets
11. Répétiteurs de cockpit
12. Activation de la licence
13. Dépannage

1. Présentation de SailPerf

SailPerf est une application de performance voile développée par MSRacing Performance. Elle reçoit en temps réel les données NMEA de vos instruments (vitesse, vent, cap, GPS…) et les exploite pour vous aider à naviguer plus vite et plus efficacement.

Ce que fait SailPerf

• Tableau de bord live — visualisation de tous vos instruments en temps réel
• Polaire de performance — construction automatique de votre polaire réelle à partir de vos navigations
• Matossage optimal — quelle zone lester selon le vent et l'allure
• Gestion des quarts — planning équipage, repas, météo, journal de bord
• Suivi AIS — cibles AIS autour du bateau avec comparaison de vitesse
• Répétiteurs cockpit — pages dédiées pour tablettes et smartphones du bord

2. Prérequis

Matériel

Logiciel

• Python 3.10 ou supérieur — téléchargeable sur python.org
• Un navigateur web moderne (Chrome, Edge, Safari, Firefox)
• Un logiciel de navigation diffusant du NMEA en UDP (Adrena, OpenCPN, NaviSailor, etc.)

3. Installation

Windows

1. Décompressez l'archive SailPerf Clic droit sur le fichier sailperf.zip → Extraire tout. Choisissez un emplacement simple, par exemple C:\SailPerf.
2. Double-cliquez sur start.bat Une fenêtre noire (terminal) s'ouvre. SailPerf installe automatiquement les dépendances lors du premier lancement (quelques minutes).
3. Ouvrez votre navigateur Allez à l'adresse http://localhost:8000. SailPerf s'affiche. C'est tout.

macOS / Linux

1. Décompressez l'archive Double-cliquez sur sailperf.zip ou dans le terminal : unzip sailperf.zip -d ~/SailPerf
2. Rendez le script exécutable et lancez-le Dans le terminal : cd ~/SailPerf && chmod +x start.sh && ./start.sh
3. Ouvrez votre navigateur Allez à http://localhost:8000.

Arrêter SailPerf

Fermez simplement la fenêtre noire du terminal, ou appuyez sur Ctrl + C dedans.

4. Configuration réseau à bord

SailPerf reçoit les données NMEA via le réseau local du bord (WiFi ou câble Ethernet). Votre PC de navigation (avec Adrena ou OpenCPN) diffuse les données, et SailPerf écoute sur le port 10110 (par défaut).

Trouver l'adresse IP du PC SailPerf

C'est l'adresse que vous devrez saisir dans votre logiciel de navigation.

Sur Windows

1. Appuyez sur Win + R, tapez cmd, Entrée.
2. Tapez ipconfig et Entrée. Notez l'adresse sous "Adresse IPv4", ex : 192.168.1.42.

Sur macOS

Préférences Système → Réseau → WiFi → notez l'adresse IP affichée.

Topologie typique à bord

5. Connexion avec Adrena

Adrena est le logiciel de navigation le plus répandu sur les bateaux de course français. Voici comment configurer la diffusion NMEA vers SailPerf.

Configurer la sortie UDP dans Adrena

1. Ouvrez Adrena et allez dans le menu Configuration → Instruments → NMEA (selon votre version, ce menu peut s'appeler "Sources de données" ou "Capteurs").
2. Cherchez "Sortie UDP" ou "Diffusion réseau". Activez-la en cochant la case correspondante.
3. Saisissez l'adresse IP et le port
   • IP : adresse du PC SailPerf (ex: 192.168.1.42), ou 255.255.255.255 pour diffuser à tout le réseau (broadcast)
   • Port : 10110
4. Sélectionnez les trames NMEA à envoyer. Cochez au minimum les trames listées ci-dessous.
5. Validez et vérifiez que SailPerf affiche des données en temps réel.

Trames NMEA recommandées

6. Connexion avec OpenCPN

1. Ouvrez OpenCPN → menu Options (⚙️) → Connexions.
2. Cliquez sur "Ajouter une connexion".
3. Paramètres de la connexion :
   • Type : Réseau
   • Protocole : UDP
   • Adresse : 0.0.0.0 (écoute tout) ou l'IP du PC SailPerf
   • Port de destination : 10110
   • Mode : Sortie (Output / TX)
   • Filtre NMEA : laisser vide pour tout envoyer
4. Cliquez sur OK puis vérifiez dans SailPerf que les données arrivent.

7. Instruments B&G (Vulcan, Zeus, H5000)

SailPerf est nativement compatible avec tous les instruments B&G. Le parseur NMEA gère automatiquement les identifiants B&G ($II, $WI…) ainsi que toutes les trames standard qu'ils émettent.

Gammes compatibles

Configuration — Zeus / Vulcan (WiFi)

1. Accédez aux réglages réseau
   Sur le chartplotter : Menu → Réglages → Réseau → NMEA 0183
   (selon version du firmware : Settings → Network → NMEA Output)
2. Activez la sortie UDP
   Activez "NMEA over UDP" ou "Partage réseau NMEA".
3. Configurez la destination
   • Adresse IP : celle du PC SailPerf (ex : 192.168.1.42)
   ou 255.255.255.255 pour le broadcast (recommandé)
   • Port : 10110
4. Sélectionnez les données à envoyer
   Activez au minimum : Vent, Vitesse bateau, GPS, Cap. Si disponible, activez aussi : Profondeur, AIS, Gîte/Tangage.

Configuration — H5000

1. Connectez le H5000 au réseau du bord via câble Ethernet (port RJ45 à l'arrière de la centrale) ou via un switch/routeur WiFi.
2. Accédez à l'interface web du H5000
   Depuis un navigateur sur le même réseau : http://[IP du H5000]
   (l'IP est visible dans Menu → Réglages → Réseau sur un afficheur Triton/Zeus).
3. Configurez une sortie NMEA UDP
   Dans l'interface web : Network → NMEA Output → Add UDP
   • Destination : IP du PC SailPerf ou 255.255.255.255
   • Port : 10110

B&G avec NMEA 2000 uniquement

Si votre installation B&G fonctionne exclusivement en NMEA 2000 (N2K) sans sortie NMEA 0183, il faut un convertisseur N2K → NMEA 0183 :

Le convertisseur reçoit le bus N2K et émet les trames NMEA 0183 en UDP sur votre réseau WiFi de bord → SailPerf les reçoit normalement sur le port 10110.

8. Autres logiciels / sources UDP

Changer le port d'écoute dans SailPerf

Si votre équipement diffuse sur un port différent (ex: 4321), allez dans SailPerf → onglet Bateau → Modifier → changez le Port UDP → Sauvegarder.

9. Premier démarrage

1. Lancez SailPerf via start.bat (Windows) ou ./start.sh (Mac/Linux). Attendez le message Uvicorn running on http://0.0.0.0:8000.
2. Ouvrez votre navigateur et allez à http://localhost:8000.
3. Configurez votre bateau
   Onglet ⚙ Bateau → Modifiez le nom, le port UDP. Si vous utilisez le broadcast (255.255.255.255), laissez le champ "Hôte" à 0.0.0.0.
4. Ajoutez vos voiles
   Onglet ⛵ Voiles → Bouton "Nouvelle voile". Saisissez le nom, le type, et les plages de vent (TWA min/max, TWS min/max).
5. Vérifiez la réception des données
   L'onglet 📡 Live doit afficher vos instruments avec le point vert "LIVE" en haut à droite.
6. Créez votre première course
   Onglet 🏁 Courses → "Nouvelle course" → Nommez-la → "Démarrer l'enregistrement". SailPerf commence à enregistrer vos données pour construire la polaire.

10. Guide des onglets

1 Live — Instruments en temps réel

Affiche tous vos instruments dans un tableau de bord configurable. Les valeurs se mettent à jour automatiquement via WebSocket (sans rechargement de page).

• Le point coloré en haut indique l'état de la connexion : 🟢 LIVE, 🟡 retard, 🔴 signal perdu
• Cliquez sur "Configurer l'affichage" pour choisir quels instruments voir et dans quel ordre

2 Polaire

Construit automatiquement votre polaire de performance à partir des données enregistrées. Plus vous naviguez, plus la polaire est précise.

• Filtrer par voile — sélectionnez une voile dans le menu pour voir sa polaire spécifique
• Filtrer par course — comparez différentes régates
• La valeur affichée est le 75e percentile de BSP pour chaque case (vent/angle) — ce que vous faites dans les meilleurs 25% du temps
• Bouton "Exporter Excel" — télécharge la polaire au format standard .xlsx

3 Matossage

Analyse dans quelle zone du bateau le lest était placé lors des meilleures performances, pour chaque combinaison angle/force de vent.

• Définissez vos zones de matossage dans Paramètres → Zones de matossage
• Pendant l'enregistrement, indiquez la zone active avec le bouton "Zone active"
• La matrice affiche la zone optimale pour chaque case de vent

4 Quarts

Gestion complète de l'équipage pour les courses au large.

• Équipage — ajoutez les membres, leur rôle et leur couleur
• Planning quarts — créez un plan de quart avec des créneaux par personne
• Repas — planifiez les repas avec le cuisinier responsable
• Météo — enregistrez vos observations météo toutes les 4h
• Journal de bord — notes, manœuvres, incidents, positions
• Sommeil — suivez le temps de repos de chaque équipier

5 AIS

Affiche les cibles AIS reçues et permet de comparer vos performances avec les bateaux concurrents.

• Ajoutez un concurrent dans "Contacts AIS" en saisissant son numéro MMSI
• SailPerf enregistre en continu la position, vitesse et cap de chaque contact suivi
• Le delta SOG montre la différence de vitesse entre vous et le concurrent en temps réel

6 Courses

Historique de toutes vos navigations enregistrées.

• Créez une course avant chaque départ
• Cliquez sur "Démarrer l'enregistrement" quand vous voulez commencer à collecter des données
• Exportez les données brutes en Excel pour une analyse externe

7 Voiles

Inventaire de votre voilerie avec les plages d'utilisation optimale.

• Définissez pour chaque voile : TWA min/max et TWS min/max
• SailPerf utilise ces plages pour filtrer les données lors du calcul de polaire
• Le compteur d'heures d'utilisation se met à jour automatiquement

11. Répétiteurs de cockpit

SailPerf propose des pages dédiées aux tablettes et smartphones du cockpit, accessibles depuis tout appareil connecté au WiFi du bord.

Comment y accéder

Sur n'importe quel appareil du bord, ouvrez un navigateur et saisissez l'adresse :

12. Activation de la licence

SailPerf est protégé par un système de licence lié à votre ordinateur. Chaque licence est valable sur un seul PC.

Types de licences

Comment activer SailPerf

1. Lancez SailPerf — si votre PC n'est pas encore activé, une page d'activation s'ouvre automatiquement dans votre navigateur. Elle affiche votre Fingerprint, un code unique lié à votre matériel (ex : A3F2-7C1D-9B4E-2A6F).
2. Remplissez le formulaire : votre nom, votre adresse email et le nom du bateau, puis cliquez sur « Télécharger la demande ». Un fichier .json est téléchargé — il contient votre Fingerprint et vos coordonnées.
3. Envoyez ce fichier à MSRacing Performance
   Par email : msracingperformance@gmail.com
4. Recevez votre clé de licence par retour email.
   Licence permanente : XXXXX-XXXXX-XXXXX-XXXXX
   Licence démo : XXXXX-XXXXX-XXXXX-XXXXX-YYYYMMDD
5. Collez la clé dans le champ prévu sur la page d'activation de votre navigateur et cliquez sur « Activer ».
   Un message de confirmation s'affiche. SailPerf est activé.

13. Dépannage

Les instruments affichent des tirets ( — )

• Vérifiez que votre logiciel de navigation envoie bien des données UDP vers le port 10110
• Vérifiez que l'IP de destination dans Adrena/OpenCPN est correcte
• Essayez avec l'adresse broadcast 255.255.255.255
• Vérifiez que le pare-feu Windows n'est pas en train de bloquer SailPerf → Panneau de configuration → Pare-feu Windows → Autoriser une application

SailPerf ne démarre pas (fenêtre noire qui se ferme)

• Vérifiez que Python est bien installé : ouvrez un terminal et tapez python --version
• Vérifiez que Python a bien été ajouté au PATH lors de l'installation
• Essayez de lancer manuellement : ouvrez un terminal dans le dossier SailPerf et tapez python main.py

Erreur "Port already in use"

• SailPerf est déjà en cours d'exécution — fermez l'ancienne instance avant d'en lancer une nouvelle
• Redémarrez le PC si le problème persiste

La polaire est vide

• Vérifiez que vous avez bien enregistré au moins une course (onglet Courses → Démarrer l'enregistrement)
• La polaire nécessite un minimum de données — navigez quelques heures dans des conditions variées

La tablette cockpit ne se connecte pas

• Vérifiez que la tablette et le PC SailPerf sont sur le même réseau WiFi
• Vérifiez l'IP dans l'URL (ex: http://192.168.1.42:8000/static/cockpit.html)
• Essayez de ping le PC SailPerf depuis la tablette

Contact support

Pour toute question ou problème non résolu, contactez MSRacing Performance :
📧 msracingperformance@gmail.com
Indiquez votre version de SailPerf, votre système d'exploitation et la description précise du problème.