1. Commandes par bouton

Le comportement des boutons dépend de la configuration de ProffieOS et du nombre de boutons définis pour le sabre. Les commandes ci-dessous supposent la présence d’au moins un bouton d’activation et peuvent inclure un bouton AUX.

2. Commandes du moniteur série

ProffieOS propose des commandes série permettant d’effectuer des tests, des diagnostics, des vérifications de configuration, des tests audio et de naviguer entre les Presets.

3. Installation et configuration des logiciels

Le développement et le téléversement du firmware sur le ProffieBoard nécessitent Arduino IDE, le plugin Arduino pour ProffieBoard ainsi que les pilotes USB appropriés.

3.1 Logiciels requis

3.2 Installation d’Arduino IDE

Installez la dernière version stable d’ Arduino IDE . N’utilisez pas de version bêta.

Sous Windows, l’installation d’Arduino IDE via le Microsoft Store n’est pas recommandée. L’application peut être installée dans un répertoire protégé, ce qui peut empêcher l’installation correcte de plugins ou de logiciels supplémentaires.

3.3 Installer le plugin ProffieBoard et Zadig

Installez le plugin Arduino pour ProffieBoard et Zadig en suivant leurs instructions d’installation respectives.

3.4 Paramètres de la carte dans Arduino IDE

Dans Arduino IDE, sélectionnez :

Tools → Board → Proffieboard V2

Connectez le ProffieBoard à votre ordinateur à l’aide d’un câble USB prenant en charge les données. Le port COM attribué devrait alors apparaître dans le menu Port.

4. Téléversement et mise à jour du firmware

Étape 1 – Télécharger ProffieOS et les fichiers de la carte SD

Téléchargez le package firmware ProffieOS ainsi que les fichiers correspondants pour la carte SD.

Pour les sabres laser SUPERNEOX équipés d’un ProffieBoard V2.2, ce guide utilise ProffieOS 5.9 comme version de référence.

Décompressez :

ProffieOS-v5.9.zip

Extrayez le package dans un répertoire de travail classique, par exemple dans le dossier Documents ou sur le Bureau.

La structure obtenue doit contenir :

ProffieOS-v5.9/

└── ProffieOS/

Ne renommez pas et ne déplacez pas les dossiers ou fichiers situés dans le répertoire ProffieOS.

Étape 2 – Copier le contenu sur la carte SD

Décompressez :

ProffieOS_SD_Card.zip

Copiez tous les fichiers du dossier ProffieOS_SD_Card extrait à la racine de la carte microSD du ProffieBoard.

Afficher les extensions de fichiers sous Windows

Activez l’affichage des extensions de noms de fichiers dans l’Explorateur de fichiers Windows afin de pouvoir voir les extensions telles que .h.

Étape 3 – Créer le fichier de configuration

Ouvrez :

ProffieOS/config/

Créez votre fichier de configuration dans ce répertoire.

La méthode recommandée consiste à copier le fichier de configuration par défaut approprié, à renommer la copie, puis à remplacer son contenu par la configuration générée pour votre sabre.

Pour le ProffieBoard V2.x, utilisez le Configurator officiel ProffieBoard V2.x .

Étape 4 – Sélectionner le fichier de configuration

Ouvrez :

ProffieOS/ProffieOS.ino

Recherchez la définition CONFIG_FILE.

#define CONFIG_FILE "config/my_saber_config.h"

Si plusieurs fichiers de configuration se trouvent dans le répertoire config, seul celui que vous souhaitez compiler doit être actif.

Plusieurs configurations de sabres peuvent être conservées dans le même répertoire config. Pour passer de l’une à l’autre, modifiez la définition CONFIG_FILE active.

Étape 5 – Connecter la carte

Connectez le ProffieBoard à l’ordinateur à l’aide d’un câble Micro-USB avec transfert de données.

Étape 6 – Compiler et téléverser

1. Ouvrez ProffieOS.ino dans Arduino IDE.
2. Vérifiez que le bon ProffieBoard V2 et le bon port COM sont sélectionnés.
3. Vérifiez que le bon CONFIG_FILE est actif.
4. Cliquez sur Upload.
5. Attendez la fin de la compilation et du téléversement.

Une fois le téléversement terminé, l’indicateur de progression doit atteindre 100 %.

Si un haut-parleur est connecté, le ProffieBoard doit émettre le son de démarrage après un téléversement réussi.

Si Serial + Mass Storage est sélectionné et que le ProffieBoard apparaît comme un lecteur amovible, éjectez-le correctement avant de débrancher le câble USB.

Résolution des problèmes de téléversement

Si le téléversement échoue, vérifiez les causes courantes suivantes :

1. Une erreur de syntaxe ou de configuration peut être présente dans votre fichier d’en-tête de configuration.
2. Le nom de CONFIG_FILE peut être incorrect.
3. Le fichier de configuration peut ne pas se trouver dans le répertoire ProffieOS/config/.
4. Le nom d’utilisateur Windows ou le répertoire de travail peut contenir des caractères non latins susceptibles de provoquer des problèmes avec la chaîne d’outils.
5. La carte, le type d’USB, la fréquence du processeur ou le port COM sélectionné peuvent être incorrects.

5. Contenu de la carte SD

ProffieOS utilise la carte microSD du sabre pour stocker les Soundfonts, les fichiers liés à la configuration et les pistes musicales.

Soundfonts

Copiez les dossiers de Soundfonts compatibles à la racine de la carte microSD.

La configuration d’origine prend notamment en charge les structures de Soundfonts suivantes :

Lorsque vous utilisez une structure de Soundfont compatible, il n’est généralement pas nécessaire de modifier les noms des fichiers WAV.

Pistes musicales

Placez les pistes musicales dans :

tracks/

Exemple :

tracks/venus.wav

tracks/mars.wav
tracks/mercury.wav

Noms des fichiers et des dossiers

Pour garantir une compatibilité optimale, utilisez des caractères latins et des noms de fichiers simples pour les dossiers de Soundfonts et les pistes musicales.

Évitez les caractères spéciaux inutiles tels que :

? , . | \ } { [ / -

Chaque dossier de Soundfont doit contenir les fichiers de configuration requis, notamment :

config.ini

smoothsw.ini

6. Configuration et paramètres

La configuration du ProffieBoard est principalement définie dans un fichier d’en-tête de configuration C++ situé dans :

ProffieOS/config/

Cette configuration définit notamment les paramètres de la carte, le nombre de lames, les boutons, les réglages audio, les fonctions de mouvement, la configuration des LED, la sensibilité des Clash, les Presets et les Styles de lame.

Configuration de base du ProffieBoard V2

#ifdef CONFIG_TOP

#include "proffieboard_v2_config.h"

#define NUM_BLADES 1
#define NUM_BUTTONS 2
#define VOLUME 1000

const unsigned int maxLedsPerStrip = 144;

#define CLASH_THRESHOLD_G 1.0

#define ENABLE_AUDIO
#define ENABLE_MOTION
#define ENABLE_WS2811
#define ENABLE_SD
#define SAVE_STATE

#endif

Référence des paramètres

Sensibilité des Clash

Une valeur de départ documentée est :

#define CLASH_THRESHOLD_G 1.0

Des valeurs plus faibles rendent généralement la détection des Clash plus sensible, tandis que des valeurs plus élevées réduisent cette sensibilité.

Modifier la configuration

Utilisez un éditeur de texte brut ou un éditeur de code adapté pour modifier les fichiers de configuration C++.

Après avoir modifié la configuration :

1. Enregistrez le fichier de configuration.
2. Ouvrez ProffieOS.ino.
3. Vérifiez que le bon CONFIG_FILE est actif.
4. Compilez le firmware.
5. Téléversez le firmware sur le ProffieBoard.

7. Configuration des Presets

Les Presets définissent le Soundfont, la bande-son, le Style de lame et le nom lisible utilisés par le sabre.

Structure de base d’un Preset

Un Preset standard est défini dans la section CONFIG_PRESETS :

#ifdef CONFIG_PRESETS

Preset presets[] = {

{
"TeensySF",
"tracks/venus.wav",
StyleNormalPtr(),
"cyan"
}

};

#endif

Éléments d’un Preset

Configuration de la lame

La configuration physique de la lame est déclarée dans un tableau BladeConfig blades[].

Cette configuration associe le matériel physique de la lame et des LED à la configuration des Presets.

BladeConfig blades[] = {

{
0,
WS281XBladePtr<
144,
bladePin,
Color8::GRB,
PowerPINS
>(),
CONFIGARRAY(presets)
},

};

8. Styles de lame

ProffieOS utilise les Blade Styles pour définir le comportement visuel de la lame principale et des autres LED configurées.

Fonctionnalités des Blade Styles

• Couleur de base
• Changements de couleur
• Effets de scintillement
• Flashs de Clash
• Effets Blaster
• Effets Lockup
• Effets Drag
• Effets d’allumage
• Effets d’extinction
• Temporisation
• Comportement des transitions

Blade Style Editor

La documentation développeur d’origine recommande l’utilisation d’un Blade Style Editor pour créer et modifier les Blade Styles.

Ressources de référence utiles :

• ProffieOS Blade Style Editor
• Megtooth Sith Sabers Tutorial
• TRA Blade Style Resources
• Fett263 Blade Style Library

Structure d’un Blade Style

Un Blade Style est généralement contenu dans une expression StylePtr<...>.

Les effets peuvent être imbriqués, chaque niveau modifiant ou transformant le résultat de l’effet sous-jacent.

InOutHelper

InOutHelper<base color, 200, 300, Black>

Définition des couleurs

Des constantes de couleur prédéfinies peuvent être utilisées pour les couleurs de lame courantes :

WHITE

RED
GREEN
BLUE
PURPLE
CYAN
YELLOW
MAGENTA

Les couleurs RGB personnalisées peuvent être définies avec :

Rgb<R, G, B>

Exemple :

Rgb<255, 50, 0>

Chaque canal RGB utilise une valeur comprise entre 0 et 255 :

• 0 = aucune sortie pour ce canal
• 255 = sortie maximale pour ce canal

AudioFlicker

AudioFlicker<"A" color, "B" color>

AudioFlicker crée un effet de scintillement de la lame qui réagit au signal audio ou au son de bourdonnement du sabre.

Plus l’écart entre les deux couleurs est important, plus la variation visuelle est généralement prononcée.

OnSpark

OnSpark<base color, spark color, duration>

OnSpark ajoute un effet d’étincelles pendant l’allumage de la lame. La durée est exprimée en millisecondes.

SimpleClash

SimpleClash<base color, clash color, 40>

Ajoute un flash de Clash. Le dernier paramètre définit la durée de l’effet en millisecondes.

Lockup

Lockup<base color, lockup color>

Ajoute l’effet Lockup et définit le comportement de la couleur pendant l’effet.

Blast

Blast<base color, blast color>

Ajoute l’effet Blaster et définit la couleur utilisée pour cet effet.

Exemple de Blade Style combiné

Un Blade Style avancé peut combiner plusieurs effets dans une seule expression imbriquée.

Un Style combiné peut notamment inclure :

• Couleur de base verte
• AudioFlicker
• Étincelles lors de l’allumage
• Effet Clash
• Effet Blaster
• Effet Lockup
• Effet Drag
• Temporisation de l’allumage
• Temporisation de l’extinction

Le Blade Style final est inséré dans le conteneur StylePtr<...> approprié au sein du Preset.

9. Ressources pour développeurs

Pour obtenir les informations les plus récentes sur le développement ProffieOS, la configuration et les cartes compatibles, utilisez les ressources officielles ci-dessous en complément de ce guide développeur SUPERNEOX.

10. Champ d’application de la documentation

ProffieOS fait l’objet d’un développement continu. La syntaxe de configuration, les fonctionnalités disponibles, le matériel pris en charge et le comportement du système peuvent varier selon les versions.