SimpleStepGate LV2 Plugin

SimpleStepGate est un plugin audio au format LV2 conçu pour les plateformes MOD (comme MOD Dwarf) et MODEP. Il fonctionne comme un séquenceur à 16 pas (steps) qui active ou désactive le signal audio en sortie (effet de "gate") en fonction de l'état "ON" ou "OFF" de chaque pas.

Fonctionnalités

• Séquenceur 16 Pas : Chaque pas peut être activé (ON) ou désactivé (OFF).
• Gate Audio : Le signal audio en entrée est transmis à la sortie uniquement lorsque le pas de séquence actuel est sur "ON".
• Contrôle du Tempo :
  • Manuel : Définissez le tempo en BPM directement sur le plugin.
  • Synchronisation Hôte : Se synchronise automatiquement au tempo et à l'état de transport (lecture/arrêt) de l'hôte LV2 (MOD). La synchronisation hôte a priorité si le transport de l'hôte est actif.
• Durée des Steps : Paramétrable par l'utilisateur avec les options suivantes :
  • 1 temps
  • 1/2 temps
  • 1/4 temps (défaut)
  • 1/8 temps
  • 1/16 temps
  • 1/32 temps
  • 1/64 temps
• Contrôles Utilisateur :
  • 16 interrupteurs (toggles) pour l'état ON/OFF de chaque pas.
  • 1 potentiomètre pour le tempo manuel (BPM).
  • 1 sélecteur pour la durée des pas.
  • 1 interrupteur (momentané) pour réinitialiser tous les pas à "OFF" et remettre la séquence au premier pas.
  • 1 indicateur numérique/visuel du pas de séquence en cours de lecture (0 à 15).
• Entrées/Sorties :
  • 1 entrée audio mono.
  • 1 sortie audio mono.
  • Port de contrôle Atom pour la synchronisation avec l'horloge de l'hôte.

Compilation

Pour compiler le plugin, vous aurez besoin des outils de développement C standard (gcc/clang, make) et des paquets de développement LV2.

1. Installer les dépendances (exemple pour Debian/Ubuntu) :

   sudo apt-get update
   sudo apt-get install build-essential pkg-config lv2-dev

2. Compiler le plugin : Naviguez dans le répertoire SimpleStepGate.lv2 et exécutez make:

   cd SimpleStepGate.lv2
   make clean # Optionnel, pour nettoyer les anciens artefacts
   make

   Cela devrait produire le fichier binaire SimpleStepGate.so (ou .dylib sur macOS) dans le répertoire SimpleStepGate.lv2.

Déploiement et Test sur MOD Dwarf / MODEP

1. Copier le Bundle LV2 sur l'appareil MOD : Le "bundle" du plugin est le répertoire SimpleStepGate.lv2 (contenant SimpleStepGate.so, manifest.ttl, et SimpleStepGate.ttl). Utilisez SCP (Secure Copy) ou une méthode similaire pour transférer ce répertoire entier vers votre appareil MOD. L'adresse IP de votre MOD peut généralement être trouvée dans les paramètres réseau de l'appareil ou via son interface web.

   Exemple de commande SCP (depuis votre ordinateur, en supposant que SimpleStepGate.lv2 est dans votre répertoire actuel et que l'IP du MOD est 192.168.51.1) :

   scp -r SimpleStepGate.lv2 root@192.168.51.1:/data/lv2/

   Les chemins de destination courants pour les plugins LV2 sur les appareils MOD incluent :

   • /data/lv2/ (courant sur les systèmes MOD plus récents)
   • /usr/local/lib/lv2/
   • /root/.lv2/ (moins courant pour les plugins installés par l'utilisateur) Consultez la documentation de votre version spécifique de MOD/MODEP si besoin.

2. Détection du Plugin par l'Hôte MOD : Après avoir copié le bundle, l'hôte MOD doit le détecter. Cela peut nécessiter :

   • Un redémarrage du moteur audio de l'appareil MOD.
   • Utiliser la fonction "Rescan Plugins" (ou équivalent) dans les paramètres de l'interface web MOD.

3. Tester dans l'Interface MOD :

   • Accédez à l'interface web de votre appareil MOD.
   • Créez un nouveau pedalboard ou modifiez-en un existant.
   • Cherchez "Simple Step Gate" dans la liste des plugins (il pourrait se trouver dans des catégories comme "Utility", "Sequencer", "Experimental", etc.).
   • Ajoutez le plugin au pedalboard.
   • Connectez une source audio (par exemple, une entrée de l'appareil, un générateur de son) à l'entrée "Audio In" du plugin.
   • Connectez la sortie "Audio Out" du plugin à une sortie de l'appareil ou à un autre effet.
   • L'interface utilisateur générée par MOD devrait afficher les 16 interrupteurs pour les pas, les potentiomètres pour le BPM et la durée des pas, le bouton Reset, et l'indicateur du pas actuel.
   • Manipulez ces contrôles :
     • Activez/désactivez des pas.
     • Changez le tempo manuel.
     • Changez la durée des pas.
     • Utilisez le bouton Reset.
   • Vérifiez que le signal audio est correctement "gaté" (coupé et transmis) en fonction de la séquence programmée.
   • Vérifiez que l'indicateur "Current Step" se met à jour comme attendu.
   • Testez la synchronisation avec l'hôte : activez la lecture (transport) sur l'interface MOD et changez le tempo global de MOD. Le plugin devrait suivre.

Dépannage / Itération

• Si le plugin ne compile pas, vérifiez que toutes les dépendances sont installées et que les chemins dans le Makefile (en particulier LV2_CFLAGS) sont corrects pour votre système.
• Si le plugin compile mais ne fonctionne pas comme attendu sur l'appareil MOD, des outils de journalisation LV2 ou des fprintf(stderr, ...) temporaires dans le code (visibles via journalctl -u mod-host -f ou similaire sur l'appareil MOD en SSH) peuvent aider au débogage.
• Après des modifications du code source (.c, .h) ou des fichiers de description (.ttl), recompilez (make) et redéployez le bundle SimpleStepGate.lv2.