Novation launch control xl инструкция

Программатор Novation Launch Control Xl

Справочное руководство программиста Launch Control XL

информация о продукте

Launch Control XL — это MIDI-контроллер со светодиодной подсветкой, который можно запрограммировать с помощью двух разных протоколов: традиционного MIDI-протокола Launchpad и системного эксклюзивного протокола Launch Control XL. Светодиодные индикаторы могут быть настроены на четыре различных уровня яркости, и ими можно управлять с помощью битов копирования и очистки для двойной буферизации.

Использование продукта

Чтобы настроить светодиодные индикаторы на Launch Control XL, вы можете использовать либо MIDI-протокол Launchpad, либо системный эксклюзивный протокол Launch Control XL.

MIDI-протокол Launchpad

Если вы используете MIDI-протокол Launchpad, вам необходимо выбрать шаблон, содержащий кнопку, нота/CC и MIDI-канал которой соответствуют входящему сообщению. Чтобы настроить светодиоды, отправьте сообщение с однобайтовой структурой, включающей уровень яркости красного и зеленого светодиодов, а также флаги Копировать и Очистить.

Байтовая структура:

• Бит 6: должен быть 0
• Биты 5-4: Уровень яркости зеленого светодиода (0-3)
• Бит 3: Очистить флаг (1 для очистки копии светодиода из другого буфера)
• Бит 2: Флаг копирования (1 для записи данных светодиодов в оба буфера)
• Биты 1-0: Уровень яркости красного светодиода (0-3)

Для каждого светодиода можно установить один из четырех уровней яркости:

• Яркость 0: Выкл.
• Яркость 1: Низкая яркость
• Яркость 2: средняя яркость
• Яркость 3: полная яркость

Рекомендуется оставлять флаги Copy и Clear установленными при включении или выключении светодиодов, если функции двойной буферизации не используются.

Для расчета значений скорости используйте следующую формулу:

• Шестнадцатеричная версия: Скорость = (10 часов x Зеленый) + Красный + Флаги
• Десятичная версия: скорость = (16 x зеленый) + красный + флаги
• Flags = 12 (OCh в шестнадцатеричном формате) для нормального использования; 8, чтобы светодиод мигал, если он настроен; 0 при использовании двойной буферизации.

Эксклюзивный протокол системы Launch Control XL

Если вы используете системный эксклюзивный протокол Launch Control XL, необходимая кнопка будет обновляться независимо от ее значения ноты/CC или MIDI-канала. Чтобы настроить светодиоды, отправьте сообщение с однобайтовой структурой, включающее уровень яркости красного и зеленого светодиодов, а также флаги Копировать и Очистить.

Байтовая структура:

• Бит 6: должен быть 0
• Биты 5-4: Уровень яркости зеленого светодиода (0-3)
• Бит 3: Очистить флаг (1 для очистки копии светодиода из другого буфера)
• Бит 2: Флаг копирования (1 для записи данных светодиодов в оба буфера)
• Биты 1-0: Уровень яркости красного светодиода (0-3)

Для каждого светодиода можно установить один из четырех уровней яркости:

• Яркость 0: Выкл.
• Яркость 1: Низкая яркость
• Яркость 2: средняя яркость
• Яркость 3: полная яркость

Управление двойной буферизацией

Launch Control XL также имеет двойную буферизацию для светодиодного освещения. Чтобы использовать двойную буферизацию, отправьте управляющее сообщение двойной буферизации со значением 0, чтобы включить ее, или 1, чтобы отключить ее. При использовании двойной буферизации флаги Копировать и Очистить можно использовать для управления буфером, в который выполняется запись.

Введение

• В этом руководстве описывается формат MIDI-связи Launch Control XL. Это вся конфиденциальная информация, необходимая вам для написания патчей и приложений, настроенных для Launch Control XL.
• Предполагается, что у вас уже есть базовые знания о MIDI и некоторое соответствующее программное обеспечение для написания интерактивных MIDI-приложений (например,ample, Max for Live, Max/MSP или Pure Data).
• Числа в данном руководстве даны как в шестнадцатеричном, так и в десятичном виде. Во избежание двусмысленности за шестнадцатеричными числами всегда следует буква h в нижнем регистре.

Запустите Control XL MIDI Overview

• Launch Control XL — это совместимое с классом USB-устройство с 24 регуляторами, 8 фейдерами и 24 программируемыми кнопками. Каждая из 16 кнопок «каналов» содержит двухцветный светодиод с красным и зеленым элементами; свет от этих элементов можно смешать, чтобы сформировать янтарь. Каждая из четырех кнопок направления содержит один красный светодиод. Кнопки «Device», «Mute», «Solo» и «Record Arm» содержат по одному желтому светодиоду. Launch Control XL имеет 16 шаблонов: 8 пользовательских шаблонов, которые можно изменять, и 8 заводских шаблонов, которые нельзя изменять. Пользовательские шаблоны занимают слоты 00h07h (0-7), тогда как фабричные шаблоны занимают слоты 08-0Fh (8-15). Используйте редактор Launch Control XL (доступен на веб-сайте Novation). webсайт), чтобы изменить свои 8 пользовательских шаблонов.
• Launch Control XL имеет один MIDI-порт с именем «Launch Control XL n», где n — идентификатор устройства вашего устройства (не показан для устройства с идентификатором 1). Светодиодами кнопок для любого шаблона можно управлять с помощью системных эксклюзивных сообщений. В качестве альтернативы, светодиоды кнопок для текущего выбранного шаблона могут управляться с помощью MIDI-сообщений о включении, выключении ноты и изменении управления (CC) в соответствии с исходным протоколом Launchpad.
• Launch Control XL использует системный эксклюзивный протокол для обновления состояния любой кнопки в любом шаблоне, независимо от выбранного в данный момент шаблона. Чтобы поддерживать совместимость с Launchpad и Launchpad S, Launch Control XL также придерживается традиционного протокола светодиодного освещения Launchpad с помощью сообщений note-on, note-off и CC. Однако такие сообщения будут обработаны только в том случае, если выбранный в данный момент шаблон содержит кнопку/потенциометр, значение ноты/CC и MIDI-канал которого совпадают со значениями входящего сообщения. Поэтому пользователям рекомендуется принять новый протокол System Exclusive.
• Кроме того, Launch Control XL также поддерживает исходные сообщения Launchpad с двойной буферизацией, миганием и установкой/сбросом всех светодиодных сообщений, где MIDI-канал сообщения определяет шаблон, для которого предназначено сообщение. Таким образом, эти сообщения могут быть отправлены в любое время, независимо от того, какой шаблон выбран в данный момент.
• Состояние каждого светодиода сохраняется при изменении шаблона и вызывается при повторном выборе шаблона. Все светодиоды можно обновлять в фоновом режиме через SysEx.

Сообщения от компьютера к устройству

Светодиоды на Launch Control XL можно настроить с помощью двух разных протоколов: (1) традиционный MIDI-протокол Launchpad, который требует, чтобы текущий выбранный шаблон содержал кнопку, нота/CC и MIDI-канал которой соответствуют входящему сообщению; и (2) системный эксклюзивный протокол Launch Control XL, который будет обновлять требуемую кнопку независимо от ее значения ноты/CC или MIDI-канала.
В обоих протоколах для установки интенсивности красного и зеленого светодиодов используется один байт. Этот байт также включает флаги копирования и очистки. Байт структурирован следующим образом (те, кто не знаком с двоичной записью, могут прочитать формулу):

Немного	Имя и фамилия	Смысл
6		Должно быть 0
5 4 ..	Зелёная	Яркость зеленого светодиода
3	Очистить	Если 1: очистить копию этого светодиода из другого буфера.
2	Копировать	Если 1: записать эти данные светодиода в оба буфера.
		Примечание: это поведение переопределяет поведение Clear, когда оба
		биты установлены
1 0 ..	Red	Яркость красного светодиода

Биты Copy и Clear позволяют манипулировать функцией двойной буферизации Launch Control XL. См. сообщение «Управление двойной буферизацией» и Приложение для получения подробной информации о том, как это можно использовать.

Таким образом, для каждого светодиода можно установить одно из четырех значений:

• яркость Смысл
• 0 Off
• 1 Низкая яркость
• 2 Средняя яркость
• 3 Полная яркость

Если функции двойной буферизации не используются, рекомендуется сохранять установленными биты копирования и очистки при включении или выключении светодиодов. Это позволяет использовать одни и те же подпрограммы в режиме прошивки без их повторной обработки. Формула для расчета значений скорости:

Шестнадцатеричная версия	Скорость	=	(10 часов х зеленый)
		+	Red
		+	Флаги
Десятичная версия	Скорость	=	(16 х зеленый)
		+	Red
		+	Флаги
в котором	Флаги	=	12 (ОЧ в шестнадцатеричном формате) для нормального использования;
		8	заставить светодиод мигать, если настроено;
		0	при использовании двойной буферизации.

Также могут быть полезны следующие таблицы предварительно рассчитанных значений скорости для нормального использования:

Hex	Десятичная дробь	Цвет	яркость
0Ch	12	от	от
0Dh	13	Red	Низкий
0Fh	15	Red	В полностью
1Dh	29	Amber	Низкий
3Fh	63	Amber	В полностью
3Eh	62	Жёлтая	В полностью
1Ch	28	Зелёная	Низкий
3Ch	60	Зелёная	В полностью

Значения для мигающих светодиодов

Hex	Десятичная дробь	Цвет	яркость
0Бх	11	Red	В полностью
3Бх	59	Amber	В полностью
3Ah	58	Жёлтая	В полностью
38h	56	Зелёная	В полностью

Протокол панели запуска

Примечание о — Установить светодиоды кнопок

• Шестнадцатеричная версия 9nh, Note, Velocity
• Декабрьская версия 144+n, Note, Velocity

Сообщение о примечании изменяет состояние всех кнопок в выбранном в данный момент шаблоне, чье значение ноты/CC совпадает со значением входящего значения Note и чей MIDI-канал с нулевым индексом соответствует MIDI-каналу n входящего сообщения. Скорость используется для установки цвета светодиода.

Note Off — выключить светодиоды кнопок.

• Шестнадцатеричная версия 8nh, Note, Velocity
• Декабрьская версия 128+n, Note, Velocity

Это сообщение интерпретируется как сообщение о примечании с тем же значением Note, но с скоростью 0.
Байт скорости в этом сообщении игнорируется.

Сбросить управление запуском XL

• Шестнадцатеричная версия Bnh, 00h, 00h
• Декабрьская версия 176+n, 0, 0

Все светодиоды выключаются, а настройки буфера и рабочий цикл сбрасываются до значений по умолчанию. MIDI-канал n определяет шаблон, для которого предназначено это сообщение (00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов).

Управление двойной буферизацией

• Шестнадцатеричная версия Bnh, 00h, 20-3Dh
• Декабрьская версия 176+n, 0, 32-61

Это сообщение используется для управления состоянием двойной буферизации кнопок. MIDI-канал n определяет шаблон, для которого предназначено это сообщение (00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов). Дополнительную информацию о двойной буферизации см. в приложении. Последний байт определяется следующим образом:

Немного	Имя и фамилия	Смысл
6		Должно быть 0.
5		Должно быть 1.
4	Копировать	Если 1: скопировать состояния светодиодов из нового «отображаемого» буфера.	в
что собой представляет		новый «обновляющий» буфер.
3	Flash	Если 1: постоянно переключать «отображаемые» буферы, чтобы сделать их выбранными.
		Светодиоды мигают.
2	Обновление	Установите буфер 0 или буфер 1 в качестве нового «обновляющего» буфера.
1		Должно быть 0.
0	Монитор	Установите буфер 0 или буфер 1 в качестве нового «отображаемого» буфера.

Для тех, кто менее знаком с двоичным кодом, формула для вычисления байта данных выглядит так:

• Бит Имя Значение
• 6 Должно быть 0.
• 5 Должно быть 1.
• 4 Копировать, если 1: скопировать состояния светодиодов из нового «отображаемого» буфера в новый «обновляющий» буфер.
• 3 Мигает, если 1: непрерывно переключайте «отображаемые» буферы, чтобы выбранные светодиоды мигали.
• 2 Обновление Установите буфер 0 или буфер 1 в качестве нового «обновляющего» буфера.
• 1 Должно быть 0.
• 0 Дисплей Установите буфер 0 или буфер 1 в качестве нового «отображаемого» буфера.

Для тех, кто менее знаком с двоичным кодом, формула для вычисления байта данных:

• Данные шестнадцатеричной версии = (4 x обновление)
  • + Дисплей
  • + 20ч
  • + Флаги
• Десятичная версия данных = (4 x обновление)
  • + Дисплей
  • + 32
  • + Флаги
• где флаги = 16 (10h в шестнадцатеричном формате) для копирования;
  • 8 для вспышки;
  • 0 иначе

Состояние по умолчанию равно нулю: не мигает; буфер обновления равен 0; отображаемый буфер также равен 0. В этом режиме любые данные светодиодов, записанные в Launch Control XL, отображаются мгновенно. Отправка этого сообщения также сбрасывает таймер вспышки, поэтому его можно использовать для повторной синхронизации частоты мигания всех Launch Control XL, подключенных к системе.

Включите все светодиоды

• Шестнадцатеричная версия Bnh, 00h, 7D-7Fh
• Декабрьская версия 176+n, 0, 125-127

Последний байт может принимать одно из трех значений

Hex	Десятичная дробь	Смысл
7Dh	125	Тест низкой яркости.
7Eh	126	Тест средней яркости.
7Fh	127	Полная проверка яркости.

Отправка этой команды сбрасывает все остальные данные — см. сообщение Reset Launch Control XL для получения дополнительной информации. MIDI-канал n определяет шаблон, для которого предназначено это сообщение (00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов).

Индикаторы набора эксклюзивных протоколов системы Launch Control XL

Системные эксклюзивные сообщения могут использоваться для установки значений светодиодов для любой кнопки или регулятора в любом шаблоне, независимо от того, какой шаблон выбран в данный момент. Это делается с помощью следующего сообщения

• Шестнадцатеричная версия F0h 00h 20h 29h 02h 11h 78h Значение индекса шаблона F7h
• Декабрьская версия 240 0 32 41 2 17 120 Значение индекса шаблона 247

Где Template — 00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов; Index — это индекс баттона или горшка (см. ниже); и Value — это байт скорости, который определяет значения яркости красного и зеленого светодиодов.
Несколько светодиодов могут быть адресованы в одном сообщении путем включения нескольких пар байтов LED-Value.

Индексы следующие:

• 00-07h (0-7): Верхний ряд ручек, слева направо
• 08-0Fh (8-15): средний ряд ручек, слева направо
• 10-17ч (16-23) : Нижний ряд ручек, слева направо
• 18-1Fh (24-31): Верхний ряд кнопок «канал», слева направо.
• 20-27h (32-39): нижний ряд кнопок «канал», слева направо
• 28-2Bh (40-43): Кнопки Device, Mute, Solo, Record Arm
• 2C-2Fh (44-47): кнопки вверх, вниз, влево, вправо

Переключить состояния кнопки
Состояние кнопок, поведение которых установлено на «Переключение» (а не «Мгновенное»), может быть обновлено системными эксклюзивными сообщениями. Это делается с помощью следующего сообщения:

• Шестнадцатеричная версия F0h 00h 20h 29h 02h 11h 7Bh Значение индекса шаблона F7h
• Декабрьская версия 240 0 32 41 2 17 123 Значение индекса шаблона 247

Где Template — 00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов; Index — это индекс кнопки (см. ниже); и Значение равно 00h (0) для выключения или 7Fh (127) для включения. Сообщения для кнопок, для которых не установлено значение «Переключить», будут игнорироваться.
Несколько кнопок могут быть адресованы в одном сообщении путем включения нескольких пар байтов индекс-значение.

Индексы следующие:

• 00-07h (0-7): верхний ряд кнопок «канал», слева направо
• 08-0Fh (8-15): нижний ряд кнопок «канал», слева направо
• 10-13ч (16-19): Кнопки Устройство, Отключение звука, Соло, Запись
• 14-17ч (20-23): Кнопки Вверх, Вниз, Влево, Вправо

Изменить текущий шаблон

Для изменения текущего шаблона устройства можно использовать следующее сообщение:

• Шестнадцатеричная версия F0h 00h 20h 29h 02h 11h 77h Шаблон F7h
• Декабрьская версия 240 0 32 41 2 17 119 Шаблон 247

Где Template — это 00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов.

Сообщения от устройства к компьютеру

Кнопка нажата

• Шестнадцатеричная версия 9nh, Note, Velocity
• Декабрьская версия 144+n, Note, Velocity ИЛИ
• Шестигранная версия Bnh, CC, Velocity
• Декабрьская версия 176+n, CC, Velocity

Кнопки могут выводить либо нотные сообщения, либо сообщения CC по MIDI-каналу с нулевым индексом n. Сообщение отправляется со скоростью 7Fh при нажатии кнопки; второе сообщение отправляется со скоростью 0, когда оно выпущено. Редактор можно использовать для изменения значения ноты/СС и скорости нажатия каждой кнопки при нажатии/отпускании.

Шаблон изменен
Launch Control XL отправляет следующее сообщение System Exclusive при изменении шаблона:

• Шестнадцатеричная версия F0h 00h 20h 29h 02h 11h 77h Шаблон F7h
• Декабрьская версия 240 0 32 41 2 17 119 Шаблон 247

Где Template — это 00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh (8-15) для 8 заводских шаблонов.

Светодиодное освещение с помощью сообщений Note

Здесь вы можете увидеть заметки, используемые для включения светодиодов под циферблатами Launch Control XL.

Двойная буферизация и мигание светодиодов

Launch Control XL имеет два светодиодных буфера, 0 и 1. Любой из них может отображаться, пока любой из них обновляется поступающими светодиодными инструкциями. На практике это может повысить производительность Launch Control XL одним из двух способов:

• Включив крупномасштабное обновление светодиодов, которое, несмотря на то, что установка может занять 100 миллисекунд, кажется пользователю мгновенным.
• Путем автоматического мигания выбранных светодиодов

Чтобы использовать двойную буферизацию для первой цели, требуется очень небольшая модификация существующих приложений. Его можно ввести следующим образом

1. Отправьте Bnh, 00h, 31h (176+n, 0, 49) при запуске, где n определяет шаблон, для которого предназначено это сообщение (00h-07h (0-7) для 8 пользовательских шаблонов и 08h-0Fh). (8-15) для 8 заводских шаблонов). Это устанавливает буфер 1 в качестве отображаемого буфера и буфер 0 в качестве буфера обновления. Launch Control XL перестанет отображать записанные в него новые светодиодные данные.
2. Запишите светодиоды в Launch Control XL как обычно, убедившись, что биты Copy и Clear не установлены.
3. Когда это обновление будет завершено, отправьте Bnh, 00h, 34h (176+n, 0, 52). Это устанавливает буфер 0 как
   отображаемый буфер и буфер 1 в качестве буфера обновления. Новые светодиодные данные сразу же станут видимыми. Текущее содержимое буфера 0 будет автоматически скопировано в буфер 1.
4. Запишите больше светодиодов в Launch Control XL, установив биты копирования и очистки на ноль.
5. Когда это обновление будет завершено, снова отправьте Bnh, 00h, 31h (176+n, 0, 49). Это переключает обратно в первое состояние. Новые данные светодиода станут видимыми, а содержимое буфера 1 будет скопировано обратно в буфер 0.
6. Продолжайте с шага 2.
7. Наконец, чтобы выключить этот режим, отправьте Bnh, 00h, 30h (176+n, 0, 48).

В качестве альтернативы можно заставить мигать выбранные светодиоды. Чтобы включить автоматическое перепрошивку, позволяющую Launch Control XL использовать собственную скорость перепрошивки, отправьте:

• Шестнадцатеричная версия Bnh, 00h, 28h
• Декабрьская версия 176+n, 0, 40

Если для того, чтобы светодиоды мигали с определенной частотой, требуется внешняя временная шкала, предлагается следующая последовательность:

• Включить мигающие светодиоды Bnh, 00h, 20h (десятичная версия 176+n, 0, 32)
• Выключить мигающие светодиоды Bnh, 00h, 20h (десятичная версия 176+n, 0, 33)

Как упоминалось ранее, рекомендуется оставлять установленными биты очистки и копирования при общей адресации светодиодов, чтобы приложение можно было легко расширить, включив в него мигание. В противном случае при попытке ввести его позже возникнут непреднамеренные эффекты.

Документы / Ресурсы