Aller au contenu principal

MIDI

Le MIDI est le protocole série de longue date des instruments de musique et des logiciels musicaux — un minuscule flux d'événements composé d'un octet de statut suivi d'un ou deux octets de données, à l'origine à 31 250 bauds sur un connecteur DIN 5 broches, aujourd'hui le plus souvent transporté par USB. NodeBlue propose cinq modules qui transforment des boutons rotatifs, des boutons et des capteurs en événements MIDI, ou qui acheminent un flux d'octets MIDI vers un port série.

Toute la famille se trouve dans la catégorie HID parce que — comme l'USB HID — elle repose sur le fait que le firmware déclare une classe de périphérique USB spécifique. Branchez une carte NodeBlue configurée pour le MIDI sur un ordinateur ou un DAW et elle apparaît comme une entrée/sortie MIDI ordinaire, impossible à distinguer d'un contrôleur commercial.

Le transport — nMidiInterface​

nMidiInterface est le point de terminaison de transport. Il prend en entrée un buffer transportant des événements MIDI et envoie ces événements via l'USB-MIDI ; il lit aussi les événements MIDI arrivant de l'hôte et les émet sur sa sortie. Tous les modules source nMidi* (Control, Note, AfterTouchPoly, RealTime) alimentent en fin de compte l'entrée de ce module.

ParamètreDescription
SyncGénéralement InputSync — les événements sont transmis à chaque tick de la MainLoop.

Le module force le type USB de la carte vers l'une des variantes MIDI. Le panneau Carte de l'IDE refusera de compiler tant qu'un type USB compatible MIDI n'est pas sélectionné :

Type USBEndpoints
midi1 entrée MIDI + 1 sortie MIDI, 1 câble virtuel.
midi4Idem, 4 câbles virtuels.
midi16Idem, 16 câbles virtuels.
serialmidi, serialmidi4, serialmidi16Comme ci-dessus + une interface CDC série USB en parallèle, utile pour des Serial.print de débogage pendant que le MIDI tourne.
serialmidiaudioaudioMIDI + série + un endpoint de classe USB-Audio — pour un appareil qui est à la fois un contrôleur MIDI et une carte son.

Câbles virtuels​

Une seule interface USB-MIDI peut transporter jusqu'à 16 « câbles virtuels » — des flux MIDI indépendants multiplexés sur le même endpoint USB. Le système d'exploitation expose chaque câble comme son propre port MIDI. Un appareil midi4 apparaît comme quatre ports dans le DAW ; le paramètre Cable de chaque module d'événement choisit sur quel port le message arrive.

Pour les configurations à un seul contrôleur, laissez le Cable de chaque module à 0 et sélectionnez midi comme type USB. Pour une console qui pilote des banques de canaux distinctes vers des pistes de DAW distinctes, utilisez midi4 ou midi16 et assignez un câble par banque.

Envoyer des événements — les modules source​

Chacun des quatre modules source ci-dessous prend des entrées conviviales (une valeur de note, une valeur de CC, un déclencheur) et émet un cBuffer contenant le message MIDI approprié. Reliez ce buffer à l'entrée de nMidiInterface. Le type de port du buffer est la variante à petite taille fixe — chaque message MIDI fait un à trois octets, il n'y a donc aucun surcoût d'allocation.

nMidiControl — Continuous Controller (CC)​

Le pain quotidien de tout contrôleur MIDI : un message CC transporte une valeur 0..127 sur un numéro de contrôleur choisi, pour un canal choisi, sur un câble virtuel choisi.

ParamètreDescription
ControlLe numéro de CC (0..127). Par défaut 11 (Expression). Assignations standard : 1 = Modulation, 7 = Volume, 10 = Panoramique, 64 = Pédale de sustain, 74 = Fréquence de coupure du filtre.
ModeMIDI_CONTROL_MODE_CONTINUOUS — la valeur d'entrée Value est la valeur du CC. L'autre mode gère les contrôleurs incrémentaux (encodeurs rotatifs) : utilisez les entrées d'impulsion + / − au lieu de Value, et le module maintient le compteur interne qui est envoyé.
Channel1..16 (ou 0 = « envoyer sur le canal arrivant via l'entrée Chan »).
Cable0..15, index de câble virtuel.

Entrées :

EntréeUtilisation
Value (u8)La valeur du CC en mode continu.
+ / − (impulsions u8)Encodeur haut / bas en mode incrémental — à associer avec nPosToPulses.
Chan (u8)Remplacer le canal configuré depuis un fil.
Cable (u8)Remplacer le câble configuré depuis un fil.

nMidiNote — Note On / Note Off​

Un événement de note musicale. OnOff déclenche un Note On (0 → 1) ou un Note Off (1 → 0) ; l'entrée Velocity fixe la vélocité (le volume) du Note On.

ParamètreDescription
NoteNuméro de note MIDI, 0..127 (do central = 60).
VelocityVélocité par défaut, 0..127 — remplacée par le fil d'entrée Velocity s'il est connecté.
Channel / CableMême sémantique que nMidiControl.

Entrées : OnOff (u8 — front montant = Note On, front descendant = Note Off) et Velocity (u8).

Pilotez OnOff depuis un nButton pour un contrôleur de type pads ; pilotez Velocity depuis un nAnalogInput ou une cellule de charge pour des pads sensibles à la vélocité.

nMidiAfterTouchPoly — aftertouch polyphonique​

Des messages de pression par note — après l'appui de la note, envoie un flux continu indiquant « avec quelle force la touche est-elle encore enfoncée ». Utilisé par les claviers expressifs et les contrôleurs à pads sensibles à l'aftertouch.

ParamètreDescription
NoteNote par défaut.
Channel / CableStandard.

Entrées : Note (u8 — remplace la valeur par défaut) et Pressure (u8, 0..127).

Pour l'aftertouch de canal (la même pression sur toutes les notes maintenues d'un canal), utilisez la voie CC avec un statut de type Control = 0xD0 ; pour la variante polyphonique par note, ce module est la réponse directe.

nMidiRealTime — horloge et transport​

Les messages MIDI temps réel — Start, Stop, Continue, Clock — qui synchronisent les DAW et les boîtes à rythmes.

ParamètreDescription
TypeLe type d'événement temps réel (Clock = 0xF8, Start = 0xFA, Continue = 0xFB, Stop = 0xFC).
CableStandard.

Entrées :

EntréeUtilisation
OnOff (u8)Impulsion pour émettre l'événement une fois (les événements temps réel n'ont pas de paire Note Off).
Type (u8)Remplace le type d'événement configuré — reliez-le via un multiplexeur pour envoyer différents événements depuis différentes sources.

Un schéma courant : un nSoftwareTimer qui se déclenche à BPM × 24 / 60 Hz pilote OnOff avec Type = 0xF8 — une horloge MIDI calée sur un métronome à laquelle le DAW se synchronise.

Un patch canonique​

Un contrôleur à 16 faders / 16 boutons rotatifs / 8 boutons, USB-MIDI :

8 boutons → nButton × 8 → nMidiNote × 8 (chacun avec sa propre Note) → nMidiInterface

16 boutons rotatifs → nAnalogInput × 16 → nRange (ADC 0..65535 → MIDI 0..127) → nMidiControl × 16 (chacun avec son propre numéro de Control) → nMidiInterface

2 encodeurs rotatifs → nRotKnob → nPosToPulses → nMidiControl en mode Increment-Decrement → nMidiInterface

Réglez le type USB de la carte sur midi (ou midi4 si vous voulez que le DAW voie des ports indépendants par groupe), téléversez, branchez sur l'ordinateur — c'est un contrôleur de DAW instantané.

MIDI DIN-5 (MIDI « classique » 5 broches)​

Le standard matériel MIDI d'origine n'est qu'une liaison série asynchrone à 31 250 bauds avec un récepteur opto-isolé. NodeBlue l'expose via les types USB serialmidi* — le côté USB est de classe MIDI mais le firmware ouvre aussi une UART à 31 250 bauds, si bien que relier la ligne TX à un DIN 5 broches à travers l'opto-isolation standard vous donne du MIDI DIN en parallèle du MIDI USB sur la même carte.

Pour les cartes dépourvues de ce type USB mais disposant d'une UART libre, un simple nSerial à 31 250 bauds transportant des octets MIDI bruts fonctionne aussi — vous construisez les messages à la main ou en acheminant la sortie des modules source vers le module série au lieu de nMidiInterface.

Recevoir du MIDI​

La sortie de nMidiInterface est du même type Buffer — elle diffuse chaque événement arrivant de l'hôte (le DAW, un autre contrôleur, un séquenceur). Acheminez-la vers un module Function personnalisé, un afficheur Nextion, un pilote d'anneau de LED, ou renvoyez-la vers un autre port MIDI pour faire une boîte de traduction.

Une utilisation typique : un fader logiciel sur le PC hôte pilote un anneau de LED ou un potentiomètre motorisé sur la carte — le DAW envoie un CC, le firmware le décode (via un module de type Function lisant le buffer ou une chaîne nBufferSplit construite à la main) et l'applique à la sortie.

Exemples​

Suite : comment les patches MIDI se composent avec le protocole NodeBlue inter-cartes pour les contrôleurs multi-cartes, dans Protocole NodeBlue inter-cartes.