Introduzione al subsistema RawMidi

Introduzione

Il sistema Alsa consente di gestire mediante il suo subsistema RawMidi dati Midi puri, grezzi, privi di temporizzazione e semplicemente strutturati secondo il protocollo Midi, sia in entrata che in uscita da/verso un dispositivo Midi esterno (ad esempio una tastiera).

In particolare l'interfaccia RawMidi permette di accedere al bus Midi della scheda audio.

La Libreria Alsa

Per poter utilizzare le funzioni dell'API di Alsa, è necessario individuare la Libreria contenente tali funzioni.
Attualmente la libreria condivisa .so accessibile di Alsa è libasound.so.2.0.0, che in Gambas richiameremo così:

Library "libasound:2"

e conseguentemente dichiarare attraverso la parola Extern le funzioni di Alsa necessarie.

Aprire una connessione con il subsistema RawMidi

L'operazione essenziale e basilare, che deve essere svolta, è quella di aprire la connessione con l'interfaccia RawMidi di Alsa attraverso un handle, (maniglia), per poter successivamente instaurare ogni altro rapporto.
La funzione esterna adatta per la creazione di questo handle è:

int snd_rawmidi_open (snd_rawmidi_t **in_rmidi, snd_rawmidi_t **out_rmidi, const char *name, int mode)

laddove:

• **in_rmidi: è una variabile di tipo puntatore che rappresenta l'handle del subsistema RawMidi per la lettura dei dati Midi in entrata. Se l'apertura sarà in scrittura, questo parametro andrà posto a Null;
• **out_rmidi: è una variabile di tipo puntatore che rappresenta l'handle del subsistema RawMidi per la scrittura dei dati Midi in uscita. Se l'apertura sarà in lettura, questo parametro andrà posto a Null);
• *name: è una variabile di tipo stringa che rappresenta il nome dell'handle dell'interfaccia RawMidi. Esso è sostanzialmente composto dall'identificativo della scheda audio (Card), del dispositivo Midi (Device) e del sottodispositivo (Subdevice), ad esempio: hw:2,0,0. L'individuazione esatta di questa stringa potrà essere effettuata agevolmente, dopo aver connesso il dispositivo Midi esterno al calcolatore, osservando la denominazione del file-device /dev/snd/midiCnDn, dove Cn è il numero identificativo della Scheda audio e Cn è il numero identificativo del dispositivo virtuale;
• mode: è un flag che rappresenta la modalità di apertura dell'interfaccia RawMidi. |1|

Questa funzione basilare in Gambas potrà essere così dichiarata:

Private Extern snd_rawmidi_open(in_rmidi As Pointer, out_rmidi As Pointer, name As String, mode As Integer) As Integer

Note

[1] Oltre al valore zero, ne sono previsti anche altri più specifici, così spiegati dalla documentazione tratta da internet (Craig Stuart Sapp):
« Using SND_RAWMIDI_NONBLOCK flag for snd_rawmidi_open() or snd_rawmidi_open_lconf() instruct device driver to return the -EBUSY error when device is already occupied with another application. This flag also changes behaviour of snd_rawmidi_write() and snd_rawmidi_read() returning -EAGAIN when no more bytes can be processed.
Using SND_RAWMIDI_APPEND flag (output only) instruct device driver to append contents of written buffer - passed by snd_rawmidi_write() - atomically to output ring buffer in the kernel space. This flag also means that the device is not opened exclusively, so more applications can share given rawmidi device. Note that applications must send the whole MIDI message including the running status, because another writting application might break the MIDI message in the output buffer.
Using SND_RAWMIDI_SYNC flag (output only) assures that the contents of output buffer specified using snd_rawmidi_write() is always drained before the function exits. This behaviour is the same as snd_rawmidi_write() followed immediately by snd_rawmidi_drain(). »