novation Launch Control Xl Programmer
Launch Control XL Справочно ръководство за програмисти
Информация за продукта
Launch Control XL е MIDI контролер с LED светлини, който може да се програмира чрез два различни протокола: традиционния MIDI протокол Launchpad и изключителния протокол Launch Control XL System. Светодиодните светлини могат да бъдат настроени на четири различни нива на яркост и могат да бъдат манипулирани с помощта на битовете Copy и Clear за двойно буфериране.
Използване на продукта
За да настроите LED светлините на Launch Control XL, можете да използвате MIDI протокола Launchpad или системния изключителен протокол Launch Control XL.
Launchpad MIDI протокол
Ако използвате MIDI протокола Launchpad, трябва да изберете шаблон, който съдържа бутон, чиято нота/CC и MIDI канал съответстват на входящото съобщение. За да настроите LED светлините, изпратете съобщение с еднобайтова структура, която включва нивото на яркост както на червения, така и на зеления светодиод, както и флаговете Copy и Clear.
Байтова структура:
- Бит 6: Трябва да е 0
- Битове 5-4: Ниво на яркост на зеления светодиод (0-3)
- Бит 3: Изчистване на флаг (1 за изчистване на копие на светодиод на друг буфер)
- Бит 2: флаг за копиране (1 за запис на LED данни в двата буфера)
- Битове 1-0: Ниво на яркост на червения светодиод (0-3)
Всеки светодиод може да бъде настроен на едно от четири нива на яркост:
- Яркост 0: Изкл
- Яркост 1: Ниска яркост
- Яркост 2: Средна яркост
- Яркост 3: Пълна яркост
Добра практика е да запазите флаговете Copy и Clear, когато включвате или изключвате светодиодите, ако функциите за двойно буфериране не се използват.
За да изчислите стойностите на скоростта, използвайте следната формула:
- Шестнадесетична версия: скорост = (10h x зелено) + червено + знамена
- Десетична версия: скорост = (16 x зелено) + червено + флагове
- Флагове = 12 (OCh в шестнадесетичен) за нормална употреба; 8, за да накарате светодиода да мига, ако е конфигуриран; 0, ако използвате двойно буфериране.
Изключителен протокол за системата Launch Control XL
Ако използвате протокола Launch Control XL System Exclusive, необходимият бутон ще бъде актуализиран независимо от стойността на нотата/CC или MIDI канала. За да настроите LED светлините, изпратете съобщение с еднобайтова структура, която включва нивото на яркост както на червения, така и на зеления светодиод, както и на флаговете Copy и Clear.
Байтова структура:
- Бит 6: Трябва да е 0
- Битове 5-4: Ниво на яркост на зеления светодиод (0-3)
- Бит 3: Изчистване на флаг (1 за изчистване на копие на светодиод на друг буфер)
- Бит 2: флаг за копиране (1 за запис на LED данни в двата буфера)
- Битове 1-0: Ниво на яркост на червения светодиод (0-3)
Всеки светодиод може да бъде настроен на едно от четири нива на яркост:
- Яркост 0: Изкл
- Яркост 1: Ниска яркост
- Яркост 2: Средна яркост
- Яркост 3: Пълна яркост
Контролирайте двойното буфериране
Launch Control XL разполага и с двойно буфериране за LED осветление. За да използвате двойно буфериране, изпратете контролно съобщение за двойно буфериране със стойност 0, за да го включите, или 1, за да го изключите. Когато използвате двойно буфериране, флаговете Copy и Clear могат да се използват за манипулиране на буфера, в който се записва.
Въведение
- Това ръководство описва 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 е ID на устройството на вашето устройство (не е показано за ID на устройство 1). Светодиодите на бутоните за всеки шаблон могат да се управляват чрез системни ексклузивни съобщения. Като алтернатива, светодиодите на бутоните за текущо избрания шаблон могат да се контролират чрез MIDI съобщения за включване, изключване на нота и промяна на управлението (CC), съгласно оригиналния протокол на Launchpad.
- Launch Control XL използва System Exclusive протокол за актуализиране на състоянието на всеки бутон във всеки шаблон, независимо от текущо избрания шаблон. За да поддържа съвместимост с Launchpad и Launchpad S, Launch Control XL също се придържа към традиционния протокол за LED осветление на Launchpad чрез note-on, note-off и CC съобщения. По такива съобщения обаче ще се действа само ако текущо избраният шаблон съдържа бутон/пот, чиято нотна/CC стойност и MIDI канал съвпадат с тези на входящото съобщение. Поради това потребителите се съветват да приемат новия протокол System Exclusive.
- В допълнение, Launch Control XL също така поддържа оригиналното Launchpad двойно буфериране, мигащи и задаване/нулиране на всички LED съобщения, където MIDI каналът на съобщението дефинира шаблона, за който е предназначено съобщението. Следователно тези съобщения могат да бъдат изпратени по всяко време, независимо кой шаблон е избран в момента.
- Състоянието на всеки светодиод се съхранява при промяна на шаблона и ще бъде извикано при повторно избиране на шаблона. Всички светодиоди могат да се актуализират във фонов режим чрез SysEx.
Съобщения от компютър към устройство
Светодиодите на Launch Control XL могат да бъдат зададени чрез два различни протокола: (1) традиционния MIDI протокол Launchpad, който изисква текущо избраният шаблон да съдържа бутон, чиято нота/CC и MIDI канал съответстват на входящото съобщение; и (2) протокола Launch Control XL System Exclusive, който ще актуализира необходимия бутон, независимо от неговата нота/CC стойност или MIDI канал.
И в двата протокола един байт се използва за задаване на интензитета на червения и зеления светодиод. Този байт включва също флаговете за копиране и изчистване. Байтът е структуриран по следния начин (тези, които не са запознати с двоичната нотация, могат да прочетат формулата):
| малко | Име | Значение |
| 6 | Трябва да е 0 | |
| 5..4 | Зелено | Яркост на зеления светодиод |
| 3 | ясно | Ако 1: изчистете копието на другия буфер на този светодиод |
| 2 | копие | Ако 1: запишете тези светодиодни данни в двата буфера |
| Забележка: това поведение отменя поведението Clear, когато и двете | ||
| битовете са зададени | ||
| 1..0 | червено | Яркост на червения светодиод |
Битовете Copy и Clear позволяват манипулиране на функцията за двойно буфериране на Launch Control XL. Вижте съобщението „Контрол на двойното буфериране“ и Приложението за подробности как може да се използва това.
Следователно всеки светодиод може да бъде настроен на една от четирите стойности:
- Яркост Значение
- 0 Изкл
- 1 Ниска яркост
- 2 Средна яркост
- 3 Пълна яркост
Ако функциите за двойно буфериране не се използват, добра практика е да запазите зададените битове за копиране и изчистване, когато включвате или изключвате светодиодите. Това прави възможно използването на едни и същи процедури в мигащ режим, без да ги преработвате. Формула за изчисляване на стойностите на скоростта е:
| Шестнадесетична версия | Скорост | = | (10h x зелено) |
| + | червено | ||
| + | Знамена | ||
| Десетична версия | Скорост | = | (16 x зелено) |
| + | червено | ||
| + | Знамена | ||
| където | Знамена | = | 12 (OCh в шестнадесетичен) за нормална употреба; |
| 8 | за да накара светодиода да мига, ако е конфигуриран; | ||
| 0 | ако използвате двойно буфериране. |
Следните таблици с предварително изчислени стойности на скоростта за нормална употреба също могат да бъдат полезни:
| шестнадесетичен | десетична | Цвят | Яркост |
| 0 Летописи | 12 | Изкл | Изкл |
| 0Dh | 13 | червено | ниско |
| 0Fh | 15 | червено | Пълна |
| 1Dh | 29 | Амбър | ниско |
| 3Fh | 63 | Амбър | Пълна |
| 3Eh | 62 | Жълто | Пълна |
| 1 Летописи | 28 | Зелено | ниско |
| 3 Летописи | 60 | Зелено | Пълна |
Стойностите за мигащи светодиоди са
| шестнадесетичен | десетична | Цвят | Яркост |
| 0 г. Bh | 11 | червено | Пълна |
| 3 г. Bh | 59 | Амбър | Пълна |
| 3Ah | 58 | Жълто | Пълна |
| 38ч | 56 | Зелено | Пълна |
Протокол Launchpad
Бележка включена — Задайте светодиоди на бутоните
- Шестнадесетична версия 9nh, Note, Velocity
- Dec версия 144+n, Note, Velocity
Съобщение за нота променя състоянието на всички бутони в текущо избрания шаблон, чиято нота/CC стойност съвпада с тази на входящата стойност на нотата и чийто MIDI канал с нулев индекс съвпада с MIDI канал n на входящото съобщение. Скоростта се използва за задаване на цвета на светодиода.
Бележка Изкл. — Изключете светодиодите на бутоните
- Шестнадесетична версия 8nh, Note, Velocity
- Декември версия 128+n, бележка, скорост
Това съобщение се интерпретира като съобщение за бележка със същата стойност на нотата, но със скорост 0.
Байтът Velocity се игнорира в това съобщение.
Нулиране на Launch Control 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 | Светкавица | Ако 1: непрекъснато обръщайте „показаните“ буфери, за да направите избрани | |
| Светодиодите мигат. | |||
| 2 | Актуализация | Задайте буфер 0 или буфер 1 като нов "актуализиращ" буфер. | |
| 1 | Трябва да е 0. | ||
| 0 | Дисплей | Задайте буфер 0 или буфер 1 като нов "показващ" буфер. |
За тези, които са по-малко запознати с двоичната система, формулата за изчисляване на байта данни е
- Значение на името на бита
- 6 трябва да е 0.
- 5 трябва да е 1.
- 4 Копиране, ако 1: копирайте светодиодните състояния от новия „показан“ буфер в новия „актуализиращ“ буфер.
- 3 Flash If 1: непрекъснато обръщане на 'показаните' буфери, за да накара избраните светодиоди да мигат.
- 2 Актуализация Задайте буфер 0 или буфер 1 като нов буфер за „актуализация“.
- 1 трябва да е 0.
- 0 Дисплей Задайте буфер 0 или буфер 1 като нов "показващ" буфер.
За тези, които са по-малко запознати с двоичните, формулата за изчисляване на байта данни е:
- Данни за шестнадесетична версия = (4 x Актуализация)
- + Дисплей
- + 20ч
- + Знамена
- Десетична версия Данни = (4 x Актуализация)
- + Дисплей
- + 32
- + Знамена
- където флагове = 16 (10h в шестнадесетичен) за копиране;
- 8 за Flash;
- 0 в противен случай
Състоянието по подразбиране е нула: няма мигане; буферът за актуализиране е 0; показаният буфер също е 0. В този режим всички светодиодни данни, записани на Launch Control XL, се показват незабавно. Изпращането на това съобщение също нулира флаш таймера, така че може да се използва за повторно синхронизиране на светкавиците на всички Launch Control XL, свързани към система
Включете всички светодиоди
- Шестнадесетична версия Bnh, 00h, 7D-7Fh
- Дек версия 176+n, 0, 125-127
Последният байт може да приеме една от трите стойности
| шестнадесетичен | десетична | Значение |
| 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-те фабрични шаблона; Индексът е индексът на бутона или пота (вижте по-долу); и Стойността е байтът за скорост, който определя стойностите на яркост както на червения, така и на зеления светодиод.
Множество светодиоди могат да бъдат адресирани в едно съобщение чрез включване на множество двойки байтове LED-стойност.
Индексите са както следва:
- 00-07h (0-7) : Горен ред копчета, отляво надясно
- 08-0Fh (8-15) : Среден ред копчета, отляво надясно
- 10-17h (16-23) : Долен ред копчета, отляво надясно
- 18-1Fh (24-31) : Горен ред от бутони за канали, отляво надясно
- 20-27h (32-39) : Долен ред от бутони за канали, отляво надясно
- 28-2Bh (40-43): Бутони за устройство, заглушаване, соло, рамо за запис
- 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-13h (16-19) : Бутони за устройство, заглушаване, соло, ръка за запис
- 14-17h (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
- Dec версия 144+n, Note, Velocity ИЛИ
- Шестнадесетична версия Bnh, CC, Velocity
- Dec версия 176+n, CC, Velocity
Бутоните могат да извеждат или нотни съобщения, или CC съобщения на MIDI канал с нулев индекс n. Изпраща се съобщение със скорост 7Fh при натискане на бутон; второ съобщение се изпраща със скорост 0, когато се освободи. Редакторът може да се използва за промяна на нотата/CC стойността на всеки бутон и стойността на скоростта при натискане/освобождаване.
Шаблонът е променен
Launch Control XL изпраща следното системно изключително съобщение при промяна на шаблона:
- Шестнадесетична версия 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-те фабрични шаблона.
LED осветление чрез бележки
Тук можете да видите бележките, използвани за осветяване на светодиодите под циферблатите на Launch Control XL.
LED двойно буфериране и мигане
Launch Control XL има два светодиодни буфера, 0 и 1. Всеки от тях може да бъде показан, докато всеки се актуализира от входящите LED инструкции. На практика това може да подобри производителността на Launch Control XL по един от двата начина:
- Чрез активиране на широкомащабна LED актуализация, която, въпреки че може да отнеме 100 милисекунди за настройка, изглежда на потребителя като мигновена.
- Чрез автоматично мигане на избрани светодиоди
Използването на двойното буфериране за първата цел изисква много малко модификации на съществуващите приложения. Може да се въведе по следния начин
- Изпратете Bnh, 00h, 31h (176+n, 0, 49) при стартиране, където n дефинира шаблона, за който е предназначено това съобщение (00h-07h (0-7) за 8 потребителски шаблона и 08h-0Fh (8-15) за 8-те фабрични шаблона). Това задава буфер 1 като показван буфер и буфер 0 като буфер за актуализиране. Launch Control XL ще спре да показва нови LED данни, които са записани в него.
- Запишете светодиодите в Launch Control XL както обикновено, като се уверите, че битовете Copy и Clear не са зададени.
- Когато тази актуализация приключи, изпратете Bnh, 00h, 34h (176+n, 0, 52). Това задава буфер 0 като
показания буфер и буфер 1 като буфер за актуализиране. Новите LED данни незабавно ще станат видими. Текущото съдържание на буфер 0 автоматично ще бъде копирано в буфер 1. - Запишете повече светодиоди в Launch Control XL, като битовете за копиране и изчистване са зададени на нула.
- Когато тази актуализация приключи, изпратете отново Bnh, 00h, 31h (176+n, 0, 49). Това превключва обратно към първото състояние. Новите светодиодни данни ще станат видими и съдържанието на буфер 1 ще бъде копирано обратно в буфер 0.
- Продължете от стъпка 2.
- И накрая, за да изключите този режим, изпратете 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)
Както бе споменато по-рано, добра практика е да запазите битовете Clear и Copy зададени, докато адресирате светодиодите като цяло, така че приложението може лесно да бъде разширено, за да включва мигане. В противен случай ще възникнат нежелани ефекти, когато се опитате да го въведете по-късно.
Документи / Ресурси
 |
novation Launch Control Xl Programmer [pdf] Ръководство за потребителя Програматор Launch Control Xl, Launch Control, Xl Програматор, Програматор |
