Controladores externos para Deejaysystem(tm) MK2 / VJ2 Ver. 2009.11.11 (c) 1998-2009 Angel García "Edy"   Manual > Controladores externos > MIDI genérico English

MIDI genérico

Deejaysystem puede utilizar cualquier controlador compatible con el estándar MIDI. Sólo es necesario escribir un fichero de configuración en formato XML.

Los controladores MIDI soportados por Deejaysystem están definidos en el fichero Plugins\MidiDevices.xml. Las asignaciones de controles por defecto están en el Plugins\MidiDefaults.xml. No edites estos ficheros porque son actualizados en cada nueva versión de Deejaysystem, y se perderían tus cambios.

Puedes escribir tus propias definiciones de controladores en los ficheros Plugins\UserMidiDevices.xml, con sus asignaciones por defecto en Plugins\UserMidiDefaults.xml. Crea los ficheros si no existen. Deejaysystem los cargará al arrancar.

Contáctanos si quieres que tu controlador MIDI sea soportado oficialmente en Deejaysystem.

Fichero de definición de dispositivos MIDI

Define los controles que ofrece cada dispositivo MIDI y los datos para interactuar con ellos. Deejaysystem lee las definiciones desde los ficheros MidiDevices.xml y UserMidiDevices.xml.

La sección principal MidiDevices contiene una sección Device para cada dispositivo soportado. Cada sección Device contiene las subsecciones Info, Inputs, Outputs y OutputMaps (las dos últimas son opcionales).

<MidiDevices>
    <Device>
         <Info>
            ...
         </Info>
         <Inputs>
              <Input ... />
         </Inputs>
         <Outputs>
              <Output ... />
         </Outputs>
         <OutputMaps>
              <OutputMap ... />
         </OutputMaps>
    </Device>
</MidiDevices>

1. La sección Info

Proporciona los datos para identificar el dispositivo

<MidiDevices>
    <Device>
        <Info>
            <Name>Numark Omni Control</Name>
            <PrefixId>NMC</PrefixId>
            <MidiInName>Numark OMNI CONTROL MIDI</MidiInName>
            <MidiOutName>Numark OMNI CONTROL MIDI</MidiOutName>
        </Info>

Dispositivo que puede presentar varios nombres MIDI:

    <Device>
        <Info>
            <Name>Hercules DJ Console Mk2 / DJ Control MP3</Name>
            <PrefixId>HDC</PrefixId>
            <MidiInNames>
                <MidiName>Hercules DJ Console Mk2 MIDI</MidiName>
                <MidiName>Hercules DJ Control MP3 MIDI</MidiName>
            </MidiInNames>
            <MidiOutName>Hercules DJ Console Mk2 MIDI</MidiOutName>
        </Info>

Identificación del dispositivo mediante códigos de vendedor y producto. Además usa un módulo externo DLL para traducción de mensajes MIDI:

   <Device>
        <Info>
            <Name>Denon DN-HC4500</Name>
            <PrefixId>DNHC</PrefixId>
            <MidiInVendor>0xFFFF</MidiInVendor>
            <MidiInProduct>0xFFFF</MidiInProduct>
            <MidiOutVendor>0xFFFF</MidiOutVendor>
            <MidiOutProduct>0xFFFF</MidiOutProduct>
            <MidiOutDeviceType>1</MidiOutDeviceType>
            <ExternalModule>MidiDevices.dll</ExternalModule>
        </Info> 

* Obligatorios

2. La sección Inputs

Define los controles MIDI disponibles que ofrece el dispositivo y los datos MIDI para interpretarlas. Cada control (INPUT) se define con una subsección Input. Los valores dependen del tipo de control.

<Inputs>
    <Input Name="A_MONITOR"
           Type="BUTTON"
           Command="0x0B" 
           Id="0x15"
           Press="0x7F"
           Release="0"
           />
    <Input Name="A_VOLUME"
           Type="ANALOG"
           Command="0x0B"
           Id="0x32"
           Min="0"
           Max="127"
           Default="127"
           NoCenter="1" 
           />
    <Input Name="A_JOG"
           Type="ENCODER"
           Command="0x0B"
           Id="0x36"
           Mode="1"
           Left="127"
           Right="1"
           Pulses="45"
           />
    <Input Name="A_PITCH"
           Type="ANALOGHR"
           Channel="0"
           Command="0x0E"
           Min="0"
           Max="16383"
           Center="8192"
           Invert="1"
           />
       ... 

Valores comunes a todos los controles:

* Obligatorios

Controles tipo BUTTON

Controles de dos estados (botón, pulsador, conmutador...). Generan valores lógicos 0 (desactivado) y 1 (activado).

Controles tipo ANALOG y ANALOGHR

Emiten un rango limitado de valores (rueda, deslizador, fader...). Generan valores lógicos analógicos desde -1.0 (un extremo del recorrido), 0.0 (centro), y +1.0 (otro extremo del recorrido). Si se indica NOCENTER generan valores entre 0.0 y 1.0.

Los controles ANALOGHR emiten un valor de 14 bits combinando Data1 (7 bits inferiores) y Data2 (7 bits superiores). Varios controles ANALOGHR en el mismo dispositivo se diferencian por CHANNEL en vez de ID.

Controles tipo ENCODER

Ruedas analógicas que indican movimiento en un sentido o en otro (jog-wheel, ruedas sin fin...). Generan valores lógicos entre -1.0 (izquierda) y +1.0 (derecha) según la velocidad y el sentido del movimiento. En reposo generan 0.

Modos de operación (MODE):

• 0 - Valores únicos izquierda-derecha. Data2 contiene sólo LEFT o RIGHT.
• 1 - Base 0. Data2 es un valor con signo de 7 bits indicando las unidades y el sentido del movimiento. 0 representa reposo.
• 2 - Base 64. Data2 es un valor sin signo de 7 bits indicando las unidades y el sentido del movimiento. 64 representa reposo.

3. La sección Outputs

Define las salidas MIDI que ofrece el dispositivo para visualización, luces, etc. y los datos MIDI para accionarlas. Cada salida (OUTPUT) se define con una subsección Output.

<Output Name="A_CUE" Type="BOOL" Channel="0" Command="0x0B" Data1="0x4A" Data1Off="0x4B" Data2="0x26" />
<Output Name="A_TIME" Type="INT" Mode="TRANSLATED" ExternalId="0x01" />
<Output Name="A_DATAREQUEST" Type="CONTROL" Channel="0" Command="0x0B" Data1="0x4A" Data2="0x3C" />

* Obligatorios

Modo de operación MIDI

Se indican todos los datos MIDI necesarios para operar la salida.

<Output Name="A_CUE" Type="BOOL" Channel="0" Command="0x0B" Data1="0x4A" Data1Off="0x4B" Data2="0x26" />
<Output Name="A_PLAY" Type="BOOL" Channel="0" Command="0x0B" Data1="0x4A" Data1Off="0x4B" Data2="0x27" />
<Output Name="A_DATAREQUEST" Type="CONTROL" Channel="0" Command="0x0B" Data1="0x4A" Data2="0x3C" />

Modo de operación TRANSLATED

Se utiliza cuando son necesarios varios mensajes MIDI para actuar sobre el valor de una salida en el dispositivo.

La salida se identifica con un valor EXTERNALID. En cada acción se invocará a la función <PREFIX>_MidiProc en el módulo externo, el cual traducirá la acción en una secuencia de mensajes MIDI. Esta secuencia se enviará al dispositivo. PREFIX está definido en la sección Info.

 <Output Name="A_TIMEMODE" Type="BOOL" Mode="TRANSLATED" ExternalId="0x00" />
 <Output Name="A_TIME" Type="INT" Mode="TRANSLATED" ExternalId="0x01" />
 <Output Name="A_PITCH" Type="INT" Mode="TRANSLATED" ExternalId="0x02" />
 <Output Name="A_TEXT1" Type="TEXT" Mode="TRANSLATED" ExternalId="0x05" Lines="1" Length="12" />      

El módulo externo es el fichero DLL indicado en la sección Info (EXTERNALMODULE). Es necesario sólo cuando el dispositivo tiene alguna salida en modo TRANSLATED. Debe estar localizado en la misma carpeta que MidiDevices.xml. Contiene una o varias funciones exportadas de la siguiente forma:

DWORD __stdcall
HDC_MidiProc(DWORD dwCommand, DWORD dwOutputId, LONG lValue, void* pData, DWORD dwDataSize);

DWORD __stdcall
DNHC_MidiProc(DWORD dwCommand, DWORD dwOutputId, LONG lValue, void* pData, DWORD dwDataSize);

dwCommand: Acción que debe ejecutarse sobre la salida:

dwOutputId: Identificador de la salida que se indicó en EXTERNALID.

lValue: Valor a mandar a la salida en la acción VALUE (dwCommand = 0), o puntero a cadena de texto en acción TEXT (dwCommand = 4).

pData: Puntero a un buffer de estructuras SMidiMessage. La función debe rellenar una por cada mensaje MIDI que sea necesario para aplicar la acción, y devolver en el retorno el número de mensajes MIDI que ha rellenando.

struct SMidiMessage
       {
       union {
             // Mensaje en bruto

             DWORD dwMessage;

             // Mensaje por componentes

             struct {
                    BYTE  nChannel : 4;    // Byte de estado
                    BYTE  nCommand : 4;

                    BYTE  nData1   : 7;
                    BYTE  nSpacer1 : 1;    // Siempre 0

                    BYTE  nData2   : 7;
                    BYTE  nSpacer2 : 1;    // Siempre 0

                    BYTE  nUnused  : 8;
                    };
             };
       };

dwDataSize: Número máximo de mensajes MIDI que se pueden meter en el buffer.

Valor de retorno: El número de mensajes MIDI que se ha metido en el buffer. Serán enviados en orden al dispositivo MIDI.

4. La sección OutputMaps

Asocia los datos y valores de Deejaysystem a las salidas disponibles en el dispositivo (definidas en Outputs). Cada asociación se hace mediante una subsección OutputMap.

<OutputMaps>
    <OutputMap Source="DjsA_PlayLed" Output="A_PLAY" />
    <OutputMap Source="DjsA_CueLed" Output="A_CUE" />
    <OutputMap Source="DjsA_TimeValue" Output="A_TIME"
               Requires="DjsA_IsTrackOpen" Blink="DjsA_IsTimeBlink" />
    <OutputMap Source="DjsA_TrackValue" Output="A_TRACK"
               Requires="DjsA_TrackValue" />

Datos de origen disponibles actualmente (2009.11.11). Los que comienzan por DjsA_ están también disponibles como DjsB_.

Fichero de configuración por defecto de controles MIDI

Define las funciones por defecto que se configuran en los dispositivos MIDI. Estas definiciones se cargan al iniciar el programa por primera vez y en Settings > Control > Por Defecto.

Deejaysystem lee las configuraciones desde los ficheros MidiDefaults.xml y UserMidiDefaults.xml.