MIDIInterface

Interface MIDI

Une Interface MIDI permet de connecter BlinderKitten à un contrôleur MIDI externe (clavier, surface de contrôle, contrôleur à pads, console MIDI, etc.).

Elle gère :

• l’entrée MIDI (notes, CC, pitch wheel),
• le mapping des messages MIDI vers des actions internes,
• le feedback MIDI vers le contrôleur (LEDs, écrans, motorisation),
• l’envoi optionnel de messages SysEx au démarrage.

Paramètres de l’interface MIDI

Paramètre	Type	Description
Device	Device	Périphérique MIDI utilisé pour l’entrée et la sortie.
Infos	String	Notes libres concernant le contrôleur.
Auto add	Bool	Crée automatiquement un mapping lors de la réception d’un message MIDI non mappé.
Start sysex	Int	Nombre d’octets envoyés au démarrage (message SysEx).

SysEx de démarrage

L’interface MIDI peut envoyer un message SysEx automatiquement à l’ouverture de la sortie MIDI. Les octets sont définis individuellement et encadrés automatiquement par F0 / F7.

MIDI Mapping

Un MIDI Mapping associe un message MIDI entrant à une ou plusieurs actions internes (Go, Stop, fader, bouton, valeur, etc.).

Chaque mapping écoute un type de message précis et transforme la valeur reçue en une valeur normalisée (0 → 1).

Paramètres de MIDI Mapping

Paramètre	Type	Description
Mode	Enum	Mode de fonctionnement : Linear ou Encoder.
Type	Enum	Type de message MIDI surveillé : Note, Control Change ou Pitch Wheel.
Channel	Int	Canal MIDI écouté (0 = tous).
Pitch Or Number	Int	Pitch (Note) ou numéro (CC).
Input Range	Point2D	Plage de valeurs MIDI utilisée (7 bits).
Input Range 14b	Point2D	Plage de valeurs MIDI utilisée (14 bits).
Up range	Point2D	Zone considérée comme incrément positif (mode Encoder).
Down range	Point2D	Zone considérée comme incrément négatif (mode Encoder).
Value range	Point2D	Variation appliquée à chaque incrément (mode Encoder).
Learn	Bool	Active l’apprentissage automatique du message MIDI.
Learn range	Bool	Apprend automatiquement la plage d’entrée.

Mode Linear

En mode Linear, la valeur MIDI est directement remappée vers une valeur normalisée (0 → 1). Ce mode est adapté aux faders, potards ou contrôles absolus.

Mode Encoder

En mode Encoder, le message MIDI est interprété comme un incrément ou décrément. Les zones Up range et Down range définissent le sens du mouvement.

Ce mode est particulièrement adapté aux encodeurs rotatifs sans butée.

Actions associées

Chaque mapping possède une liste d’actions cibles (faders virtuels, boutons, paramètres, etc.).

Lorsqu’un message MIDI valide est reçu :

• la valeur est convertie,
• les actions associées sont déclenchées,
• la valeur peut être relative ou absolue selon le mode.

MIDI Feedback

Le MIDI Feedback permet d’envoyer des informations de BlinderKitten vers le contrôleur MIDI :

• allumer des LEDs,
• afficher du texte,
• positionner des faders motorisés.

Le feedback est déclenché automatiquement lorsque la valeur source change.

Paramètres de MIDI Feedback

Paramètre	Type	Description
Source type	Enum	Élément observé (Virtual fader, button, encoder, Grand Master, Blackout, etc.).
Source ID	Int	Identifiant de la source.
Source Page	Int	Page concernée (0 = page courante).
Only if current page	Bool	N’envoie le feedback que si la page est active.
Midi Type	Enum	Type de message envoyé : Note, Control Change, Pitch Wheel ou Text.
Midi Channel	Int	Canal MIDI utilisé pour l’envoi.
Midi Pitch Or Number	Int	Pitch ou numéro CC utilisé.
Midi Output Range	Point2D	Plage de sortie MIDI (7 bits).
Midi Output Range 14b	Point2D	Plage de sortie MIDI (14 bits).
Different Channels	Bool	Utilise des canaux différents selon l’état.
On Value	Int	Valeur envoyée lorsque la source est active.
Off Value	Int	Valeur envoyée lorsque la source est inactive.
Text mode	Enum	Mode texte pour contrôleurs MCU / X-Touch.
MCU column	Int	Colonne utilisée pour l’affichage texte.

Feedback texte (MCU / X-Touch)

Le feedback texte permet d’afficher des libellés sur les écrans de contrôleurs compatibles (Mackie Control, X-Touch, extensions).

Les textes sont automatiquement découpés et envoyés via SysEx.