Novation Launch Control Xl Programador
Guia de Referência do Programador do Launch Control XL
Informações do produto
O Launch Control XL é um controlador MIDI com luzes LED que pode ser programado através de dois protocolos diferentes: o tradicional protocolo Launchpad MIDI e o protocolo Launch Control XL System Exclusive. As luzes de LED podem ser definidas em quatro níveis de brilho diferentes e podem ser manipuladas usando os bits Copiar e Limpar para buffer duplo.
Uso do produto
Para definir as luzes de LED no Launch Control XL, você pode usar o protocolo Launchpad MIDI ou o protocolo Launch Control XL System Exclusive.
Protocolo MIDI da barra de inicialização
Se você estiver usando o protocolo Launchpad MIDI, precisará selecionar um modelo que contenha um botão cuja nota/CC e canal MIDI correspondam à mensagem recebida. Para definir as luzes LED, envie uma mensagem com uma estrutura de byte único que inclua o nível de brilho dos LEDs vermelho e verde, bem como os sinalizadores Copiar e Limpar.
Estrutura de bytes:
- Bit 6: Deve ser 0
- Bits 5-4: Nível de brilho do LED verde (0-3)
- Bit 3: Clear flag (1 para limpar a cópia do LED de outro buffer)
- Bit 2: sinalizador de cópia (1 para gravar dados de LED em ambos os buffers)
- Bits 1-0: nível de brilho do LED vermelho (0-3)
Cada LED pode ser definido para um dos quatro níveis de brilho:
- Brilho 0: Desligado
- Brilho 1: baixo brilho
- Brilho 2: brilho médio
- Brilho 3: brilho total
É uma boa prática manter os sinalizadores Copiar e Limpar ativados ao ligar ou desligar os LEDs se os recursos de buffer duplo não estiverem em uso.
Para calcular os valores de velocidade, use a seguinte fórmula:
- Versão hexadecimal: Velocidade = (10h x Verde) + Vermelho + Bandeiras
- Versão decimal: Velocidade = (16 x Verde) + Vermelho + Bandeiras
- Flags = 12 (OCh em hex) para uso normal; 8 para fazer o LED piscar, se configurado; 0 se estiver usando buffer duplo.
Protocolo Exclusivo do Sistema Launch Control XL
Se você estiver usando o protocolo Launch Control XL System Exclusive, o botão necessário será atualizado independentemente de seu valor de nota/CC ou canal MIDI. Para definir as luzes de LED, envie uma mensagem com uma estrutura de byte único que inclua o nível de brilho dos LEDs vermelho e verde, bem como os sinalizadores Copiar e Limpar.
Estrutura de bytes:
- Bit 6: Deve ser 0
- Bits 5-4: Nível de brilho do LED verde (0-3)
- Bit 3: Clear flag (1 para limpar a cópia do LED de outro buffer)
- Bit 2: sinalizador de cópia (1 para gravar dados de LED em ambos os buffers)
- Bits 1-0: nível de brilho do LED vermelho (0-3)
Cada LED pode ser definido para um dos quatro níveis de brilho:
- Brilho 0: Desligado
- Brilho 1: baixo brilho
- Brilho 2: brilho médio
- Brilho 3: brilho total
Buffer duplo de controle
O Launch Control XL também possui buffer duplo para iluminação LED. Para usar buffer duplo, envie uma mensagem de buffer duplo de controle com um valor de 0 para ativá-lo ou 1 para desligá-lo. Ao usar buffer duplo, os sinalizadores Copy e Clear podem ser usados para manipular o buffer que está sendo gravado.
Introdução
- Este manual descreve o formato de comunicação MIDI do Launch Control XL. Essas são todas as informações proprietárias de que você precisa para escrever patches e aplicativos personalizados para o Launch Control XL.
- Presume-se que você já tenha um conhecimento básico de MIDI e algum software apropriado para escrever aplicativos MIDI interativos (por exemploample, Max for Live, Max/MSP ou Pure Data).
- Os números neste manual são dados em hexadecimal e decimal. Para evitar qualquer ambiguidade, os números hexadecimais são sempre seguidos por um h minúsculo.
Iniciar controle XL MIDI Overview
- O Launch Control XL é um dispositivo USB compatível com a classe que possui 24 potenciômetros, 8 faders e 24 botões programáveis. Cada um dos 16 botões de 'canal' contém um LED bicolor com um elemento vermelho e um elemento verde; a luz desses elementos pode ser misturada para formar o âmbar. Cada um dos quatro botões direcionais contém um único LED vermelho. Os botões 'Device', 'Mute', 'Solo' e 'Record Arm' contêm um único LED amarelo. O Launch Control XL possui 16 modelos: 8 modelos de usuário, que podem ser modificados, e 8 modelos de fábrica, que não podem. Os modelos de usuário ocupam os slots 00h07h (0-7), enquanto os modelos de fábrica ocupam os slots 08-0Fh (8-15). Use o Launch Control XL Editor (disponível no Novation website) para modificar seus 8 modelos de usuário.
- Launch Control XL tem uma única porta MIDI chamada 'Launch Control XL n', onde n é o ID do dispositivo da sua unidade (não mostrado para o ID do dispositivo 1). Os LEDs de botão para qualquer modelo podem ser controlados por meio de mensagens exclusivas do sistema. Como alternativa, os LEDs de botão para o modelo atualmente selecionado podem ser controlados por meio de mensagens MIDI note-on, note-off e control change (CC), de acordo com o protocolo Launchpad original.
- O Launch Control XL usa um protocolo exclusivo do sistema para atualizar o estado de qualquer botão em qualquer modelo, independentemente do modelo atualmente selecionado. Para manter a compatibilidade com o Launchpad e o Launchpad S, o Launch Control XL também segue o tradicional protocolo de iluminação LED do Launchpad por meio de notas ligadas, desligadas e mensagens CC. No entanto, essas mensagens só terão efeito se o modelo atualmente selecionado contiver um botão/potenciômetro cuja nota/valor CC e canal MIDI correspondam aos da mensagem recebida. Os usuários são, portanto, aconselhados a adotar o novo protocolo System Exclusive.
- Além disso, o Launch Control XL também suporta as mensagens originais de buffer duplo do Launchpad, piscando e set-/reset-all LED, onde o canal MIDI da mensagem define o modelo para o qual a mensagem se destina. Essas mensagens podem, portanto, ser enviadas a qualquer momento, independentemente de qual modelo esteja selecionado no momento.
- O estado de cada LED é armazenado quando o modelo é alterado e será recuperado quando o modelo for selecionado novamente. Todos os LEDs podem ser atualizados em segundo plano via SysEx.
Mensagens de computador para dispositivo
Os LEDs no Launch Control XL podem ser configurados por meio de dois protocolos diferentes: (1) o tradicional protocolo Launchpad MIDI, que requer que o modelo atualmente selecionado contenha um botão cuja nota/CC e canal MIDI correspondam à mensagem recebida; e (2) o protocolo Launch Control XL System Exclusive, que atualizará o botão necessário independentemente de seu valor de nota/CC ou canal MIDI.
Em ambos os protocolos, um único byte é usado para definir as intensidades dos LEDs vermelho e verde. Este byte também inclui os flags Copy e Clear. O byte é estruturado da seguinte forma (aqueles não familiarizados com a notação binária podem ler a fórmula):
| Pedaço | Nome | Significado |
| 6 | Deve ser 0 | |
| 5..4 | Verde | Brilho do LED verde |
| 3 | Claro | Se 1: limpe a cópia do outro buffer deste LED |
| 2 | Cópia | Se 1: gravar esses dados de LED em ambos os buffers |
| Nota: este comportamento substitui o comportamento Limpar quando ambos | ||
| bits são definidos | ||
| 1..0 | Vermelho | Brilho do LED vermelho |
Os bits Copy e Clear permitem a manipulação do recurso de buffer duplo do Launch Control XL. Consulte a mensagem 'Controlar buffer duplo' e o Apêndice para obter detalhes sobre como isso pode ser usado.
Cada LED pode, portanto, ser definido para um dos quatro valores:
- Brilho Significado
- 0 de desconto
- 1 baixo brilho
- 2 Brilho médio
- 3 Brilho total
Se os recursos de buffer duplo não estiverem em uso, é uma boa prática manter os bits Copiar e Limpar definidos ao ligar ou desligar os LEDs. Isso torna possível usar as mesmas rotinas no modo intermitente sem retrabalhá-las. Uma fórmula para calcular os valores de velocidade é:
| Versão hexadecimal | Velocidade | = | (10h x Verde) |
| + | Vermelho | ||
| + | Bandeiras | ||
| versão decimal | Velocidade | = | (16 x Verde) |
| + | Vermelho | ||
| + | Bandeiras | ||
| onde | Bandeiras | = | 12 (OCh em hex) para uso normal; |
| 8 | fazer o LED piscar, se configurado; | ||
| 0 | se estiver usando buffer duplo. |
As seguintes tabelas de valores de velocidade pré-calculados para uso normal também podem ser úteis:
| Hex | Decimal | Cor | Brilho |
| 0Ch | 12 | Desligado | Desligado |
| 0 Dh | 13 | Vermelho | Baixo |
| 0Fh | 15 | Vermelho | Completo |
| 1 Dh | 29 | Âmbar | Baixo |
| 3Fh | 63 | Âmbar | Completo |
| 3Eh | 62 | Amarelo | Completo |
| 1Ch | 28 | Verde | Baixo |
| 3Ch | 60 | Verde | Completo |
Os valores para LEDs intermitentes são
| Hex | Decimal | Cor | Brilho |
| 0Bh | 11 | Vermelho | Completo |
| 3Bh | 59 | Âmbar | Completo |
| 3 Ah | 58 | Amarelo | Completo |
| 38h | 56 | Verde | Completo |
Protocolo Launchpad
Nota sobre — Definir LEDs do botão
- Versão Hex 9nh, Nota, Velocidade
- Versão de dezembro 144+n, Nota, Velocidade
Uma mensagem note-on altera o estado de todos os botões no modelo atualmente selecionado cujo valor de nota/CC corresponda ao valor da nota recebida e cujo canal MIDI com índice zero corresponda ao canal MIDI n da mensagem recebida. A velocidade é usada para definir a cor do LED.
Note Off — Desligue os LEDs dos botões
- Versão Hex 8nh, Nota, Velocidade
- Dec versão 128+n, Note, Velocity
Esta mensagem é interpretada como uma mensagem note-on com o mesmo valor de nota, mas com uma velocidade de 0.
O byte Velocity é ignorado nesta mensagem.
Reiniciar controle de inicialização XL
- Versão hexadecimal Bnh, 00h, 00h
- Versão de dezembro 176+n, 0, 0
Todos os LEDs são desligados e as configurações de buffer e o ciclo de trabalho são redefinidos para seus valores padrão. O canal MIDI n define o modelo ao qual esta mensagem se destina (00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica).
Controle de buffer duplo
- Versão hexadecimal Bnh, 00h, 20-3Dh
- Versão de dezembro 176+n, 0, 32-61
Esta mensagem é usada para controlar o estado de buffer duplo dos botões. O canal MIDI n define o modelo ao qual esta mensagem se destina (00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica). Consulte o Apêndice para obter mais informações sobre buffer duplo. O último byte é determinado da seguinte forma:
| Pedaço | Nome | Significado | |
| 6 | Deve ser 0. | ||
| 5 | Deve ser 1. | ||
| 4 | Cópia | Se 1: copie os estados do LED do novo buffer 'exibido' | para |
| o | novo buffer de 'atualização'. | ||
| 3 | Clarão | Se 1: inverter continuamente os buffers 'exibidos' para fazer o selecionado | |
| LEDs piscam. | |||
| 2 | Atualizar | Defina o buffer 0 ou o buffer 1 como o novo buffer de 'atualização'. | |
| 1 | Deve ser 0. | ||
| 0 | Mostrar | Defina o buffer 0 ou o buffer 1 como o novo buffer de 'exibição'. |
Para aqueles menos familiarizados com binário, a fórmula para calcular o byte de dados é
- Significado do Nome do Bit
- 6 deve ser 0.
- 5 deve ser 1.
- 4 Copiar Se 1: copia os estados do LED do novo buffer 'exibido' para o novo buffer 'atualizado'.
- 3 Piscar Se 1: inverter continuamente os buffers 'exibidos' para fazer os LEDs selecionados piscarem.
- 2 Atualizar Definir buffer 0 ou buffer 1 como o novo buffer de 'atualização'.
- 1 deve ser 0.
- 0 Display Definir buffer 0 ou buffer 1 como o novo buffer de 'exibição'.
Para aqueles menos familiarizados com binário, a fórmula para calcular o byte de dados é:
- Dados da versão hexadecimal = (4 x Atualização)
- + Exibição
- + 20h
- + Bandeiras
- Dados da versão decimal = (4 x Atualização)
- + Exibição
- + 32
- + Bandeiras
- onde Flags = 16 (10h em Hex) para Copy;
- 8 para Flash;
- 0 caso contrário
O estado padrão é zero: sem piscar; o buffer de atualização é 0; o buffer exibido também é 0. Nesse modo, qualquer dado de LED gravado no Launch Control XL é exibido instantaneamente. O envio desta mensagem também redefine o temporizador de flash, para que possa ser usado para ressincronizar as taxas de flash de todos os Launch Control XLs conectados a um sistema
Ligue todos os LEDs
- Versão hexadecimal Bnh, 00h, 7D-7Fh
- Versão de dezembro 176+n, 0, 125-127
O último byte pode assumir um dos três valores
| Hex | Decimal | Significado |
| 7 Dh | 125 | Teste de baixo brilho. |
| 7Eh | 126 | Teste de brilho médio. |
| 7Fh | 127 | Teste de brilho total. |
O envio desse comando redefine todos os outros dados — consulte a mensagem Reset Launch Control XL para obter mais informações. O canal MIDI n define o modelo ao qual esta mensagem se destina (00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica).
LEDs de conjunto de protocolo exclusivo do sistema Launch Control XL
As mensagens exclusivas do sistema podem ser usadas para definir os valores de LED para qualquer botão ou potenciômetro em qualquer modelo, independentemente de qual modelo esteja selecionado no momento. Isso é feito usando a seguinte mensagem
- Versão hexadecimal F0h 00h 20h 29h 02h 11h 78h Valor do índice do modelo F7h
- Versão dez 240 0 32 41 2 17 120 Valor do índice do modelo 247
Onde Template é 00h-07h (0-7) para os 8 templates de usuário, e 08h-0Fh (8-15) para os 8 templates de fábrica; Index é o índice do botão ou pote (veja abaixo); e Value é o byte de velocidade que define os valores de brilho dos LEDs vermelho e verde.
Vários LEDs podem ser endereçados em uma única mensagem, incluindo vários pares de bytes LED-Valor.
Os índices são os seguintes:
- 00-07h (0-7): Fila superior de botões, da esquerda para a direita
- 08-0Fh (8-15): Linha do meio de botões, da esquerda para a direita
- 10-17h (16-23): Linha inferior de botões, da esquerda para a direita
- 18-1Fh (24-31): Linha superior de botões de 'canal', da esquerda para a direita
- 20-27h (32-39): Linha inferior de botões de 'canal', da esquerda para a direita
- 28-2Bh (40-43): Dispositivo de botões, mudo, solo, braço de gravação
- 2C-2Fh (44-47): Botões para cima, para baixo, esquerda, direita
Alternar estados do botão
O estado dos botões cujo comportamento é definido como 'Alternar' (em vez de 'Momentâneo') pode ser atualizado por mensagens exclusivas do sistema. Isso é feito usando a seguinte mensagem:
- Versão hexadecimal F0h 00h 20h 29h 02h 11h 7Bh Valor do índice do modelo F7h
- Versão dez 240 0 32 41 2 17 123 Valor do índice do modelo 247
Onde Template é 00h-07h (0-7) para os 8 templates de usuário, e 08h-0Fh (8-15) para os 8 templates de fábrica; Index é o índice do botão (veja abaixo); e o valor é 00h (0) para desligado ou 7Fh (127) para ligado. Mensagens para botões não definidos como 'Alternar' serão ignoradas.
Vários botões podem ser endereçados em uma única mensagem, incluindo vários pares de bytes Índice-Valor.
Os índices são os seguintes:
- 00-07h (0-7): Linha superior de botões de 'canal', da esquerda para a direita
- 08-0Fh (8-15): Linha inferior de botões de 'canal', da esquerda para a direita
- 10-13h (16-19): Dispositivo de botões, mudo, solo, braço de gravação
- 14-17h (20-23): Botões Cima, Baixo, Esquerda, Direita
Alterar modelo atual
A seguinte mensagem pode ser usada para alterar o modelo atual do dispositivo:
- Versão hexadecimal F0h 00h 20h 29h 02h 11h 77h Modelo F7h
- Versão dez 240 0 32 41 2 17 119 Modelo 247
Onde Template é 00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica.
Mensagens de dispositivo para computador
Botão pressionado
- Versão Hex 9nh, Nota, Velocidade
- Dec versão 144+n, Nota, Velocidade OU
- Versão hexadecimal Bnh, CC, velocidade
- Versão de dezembro 176+n, CC, Velocity
Os botões podem emitir mensagens de nota ou mensagens CC em um canal MIDI indexado zero n. Uma mensagem é enviada com velocidade 7Fh quando um botão é pressionado; uma segunda mensagem é enviada com velocidade 0 quando ela é liberada. O editor pode ser usado para alterar o valor de nota/CC de cada botão e o valor de velocidade ao pressionar/soltar.
Modelo alterado
O Launch Control XL envia a seguinte mensagem exclusiva do sistema ao alterar o modelo:
- Versão hexadecimal F0h 00h 20h 29h 02h 11h 77h Modelo F7h
- Versão dez 240 0 32 41 2 17 119 Modelo 247
Onde Template é 00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica.
Iluminação LED através de mensagens de nota
Aqui você pode ver as mensagens de notas usadas para acender os LEDs sob os mostradores no Launch Control XL.
LED de buffer duplo e piscando
O Launch Control XL tem dois buffers de LED, 0 e 1. Qualquer um pode ser exibido enquanto é atualizado por instruções de LED recebidas. Na prática, isso pode melhorar o desempenho do Launch Control XL de duas maneiras:
- Ao habilitar uma atualização de LED em grande escala que, embora possa levar 100 milissegundos para configurar, parece instantânea para o usuário.
- Ao piscar automaticamente os LEDs selecionados
Para explorar o buffer duplo para o primeiro propósito, é necessário muito pouca modificação nos aplicativos existentes. Pode ser introduzido da seguinte forma
- Envia Bnh, 00h, 31h (176+n, 0, 49) na inicialização, onde n define o modelo para o qual esta mensagem se destina (00h-07h (0-7) para os 8 modelos de usuário e 08h-0Fh (8-15) para os 8 modelos de fábrica). Isso define o buffer 1 como o buffer exibido e o buffer 0 como o buffer de atualização. O Launch Control XL deixará de mostrar novos dados de LED gravados nele.
- Escreva os LEDs no Launch Control XL como de costume, garantindo que os bits Copy e Clear não estejam definidos.
- Quando esta atualização terminar, envie Bnh, 00h, 34h (176+n, 0, 52). Isso define o buffer 0 como
o buffer exibido e o buffer 1 como o buffer de atualização. Os novos dados do LED ficarão instantaneamente visíveis. O conteúdo atual do buffer 0 será automaticamente copiado para o buffer 1. - Grave mais LEDs no Launch Control XL, com os bits Copy e Clear definidos como zero.
- Quando esta atualização terminar, envie Bnh, 00h, 31h (176+n, 0, 49) novamente. Isso muda de volta para o primeiro estado. Os novos dados do LED ficarão visíveis e o conteúdo do buffer 1 será copiado de volta para o buffer 0.
- Continue a partir do passo 2.
- Finalmente, para desligar este modo, envie Bnh, 00h, 30h (176+n, 0, 48).
Alternativamente, os LEDs escolhidos podem ser feitos para piscar. Para ativar o flash automático, que permite que o Launch Control XL use sua própria velocidade de flash, envie:
- Versão hexadecimal Bnh, 00h, 28h
- Versão de dezembro 176+n, 0, 40
Caso seja necessária uma linha de tempo externa para fazer os LEDs piscarem em uma determinada taxa, sugere-se a seguinte sequência:
- Ligue os LEDs intermitentes em Bnh, 00h, 20h (versão decimal 176+n, 0, 32)
- Desligue os LEDs intermitentes Bnh, 00h, 20h (versão decimal 176+n, 0, 33)
Como mencionado anteriormente, é uma boa prática manter os bits Clear e Copy definidos ao endereçar os LEDs em geral, de modo que um aplicativo possa ser facilmente expandido para incluir a intermitência. Caso contrário, ocorrerão efeitos indesejados ao tentar introduzi-lo mais tarde.
Documentos / Recursos
 |
Novation Launch Control Xl Programador [pdf] Guia do Usuário Programador Xl de Controle de Lançamento, Controle de Lançamento, Programador Xl, Programador |
