Novation Launch Control Xl Programmeur
Start de Control XL Programmer's Reference Guide
Productinformatie
De Launch Control XL is een MIDI-controller met LED-verlichting die via twee verschillende protocollen kan worden geprogrammeerd: het traditionele Launchpad MIDI-protocol en het Launch Control XL System Exclusive-protocol. De LED-lampjes kunnen op vier verschillende helderheidsniveaus worden ingesteld en kunnen worden gemanipuleerd met behulp van de Copy- en Clear-bits voor dubbele buffering.
Productgebruik
Om de LED-lampjes op de Launch Control XL in te stellen, kunt u het Launchpad MIDI-protocol of het Launch Control XL System Exclusive-protocol gebruiken.
Launchpad MIDI-protocol
Als u het Launchpad MIDI-protocol gebruikt, moet u een sjabloon selecteren die een knop bevat waarvan de noot/CC en het MIDI-kanaal overeenkomen met het binnenkomende bericht. Om de LED-lampjes in te stellen, verzendt u een bericht met een structuur van één byte die het helderheidsniveau van zowel de rode als de groene LED's bevat, evenals de vlaggen Kopiëren en Wissen.
Bytestructuur:
- Bit 6: Moet 0 zijn
- Bits 5-4: Helderheidsniveau groene LED (0-3)
- Bit 3: Vlag wissen (1 om de kopie van de LED van een andere buffer te wissen)
- Bit 2: Kopieervlag (1 om LED-gegevens naar beide buffers te schrijven)
- Bits 1-0: helderheidsniveau rode LED (0-3)
Elke LED kan worden ingesteld op een van de vier helderheidsniveaus:
- Helderheid 0: Uit
- Helderheid 1: Lage helderheid
- Helderheid 2: gemiddelde helderheid
- Helderheid 3: Volledige helderheid
Het is een goede gewoonte om de vlaggen Kopiëren en Wissen ingeschakeld te laten bij het in- of uitschakelen van LED's als de dubbele bufferfuncties niet in gebruik zijn.
Gebruik de volgende formule om snelheidswaarden te berekenen:
- Hex-versie: snelheid = (10 uur x groen) + rood + vlaggen
- Decimale versie: snelheid = (16 x groen) + rood + vlaggen
- Vlaggen = 12 (OCh in hex) voor normaal gebruik; 8 om de LED te laten knipperen, indien geconfigureerd; 0 bij gebruik van dubbele buffering.
Launch Control XL Systeem exclusief protocol
Als u het Launch Control XL System Exclusive-protocol gebruikt, wordt de vereiste knop bijgewerkt, ongeacht de noot/CC-waarde of het MIDI-kanaal. Om de LED-lampjes in te stellen, verzendt u een bericht met een structuur van één byte die het helderheidsniveau van zowel de rode als de groene LED's bevat, evenals de vlaggen Kopiëren en Wissen.
Bytestructuur:
- Bit 6: Moet 0 zijn
- Bits 5-4: Helderheidsniveau groene LED (0-3)
- Bit 3: Vlag wissen (1 om de kopie van de LED van een andere buffer te wissen)
- Bit 2: Kopieervlag (1 om LED-gegevens naar beide buffers te schrijven)
- Bits 1-0: helderheidsniveau rode LED (0-3)
Elke LED kan worden ingesteld op een van de vier helderheidsniveaus:
- Helderheid 0: Uit
- Helderheid 1: Lage helderheid
- Helderheid 2: gemiddelde helderheid
- Helderheid 3: Volledige helderheid
Controle dubbele buffering
De Launch Control XL beschikt ook over dubbele buffering voor LED-verlichting. Om dubbele buffering te gebruiken, verzendt u een Control double-buffering-bericht met de waarde 0 om deze in te schakelen of 1 om deze uit te schakelen. Bij gebruik van dubbele buffering kunnen de vlaggen Copy en Clear worden gebruikt om de buffer waarnaar wordt geschreven te manipuleren.
Invoering
- Deze handleiding beschrijft het MIDI-communicatieformaat van Launch Control XL. Dit is alle bedrijfseigen informatie die u nodig hebt om patches en applicaties te kunnen schrijven die zijn aangepast voor Launch Control XL.
- Er wordt aangenomen dat je al een basiskennis van MIDI hebt, en enige geschikte software voor het schrijven van interactieve MIDI-applicaties (bijvample, Max voor Live, Max/MSP of Pure Data).
- Getallen in deze handleiding worden zowel in hexadecimaal als in decimaal weergegeven. Om elke dubbelzinnigheid te voorkomen, worden hexadecimale getallen altijd gevolgd door een kleine letter h.
Start Control XL MIDI Overview
- Launch Control XL is een klasse-compatibel USB-apparaat met 24 potten, 8 faders en 24 programmeerbare knoppen. De 16 'kanaal'-knoppen bevatten elk een tweekleurige LED met een rood element en een groen element; het licht van deze elementen kan worden gemengd om amber te vormen. De vier richtingsknoppen bevatten elk een enkele rode LED. De knoppen 'Device', 'Mute', 'Solo' en 'Record Arm' bevatten elk een enkele gele LED. Launch Control XL heeft 16 sjablonen: 8 gebruikerssjablonen, die kunnen worden gewijzigd, en 8 fabriekssjablonen, die niet kunnen worden gewijzigd. Gebruikerssjablonen bezetten slots 00h07h (0-7), terwijl fabriekssjablonen slots 08-0Fh (8-15) bezetten. Gebruik de Launch Control XL Editor (beschikbaar op de Novation website) om uw 8 gebruikerssjablonen te wijzigen.
- Launch Control XL heeft een enkele MIDI-poort genaamd 'Launch Control XL n', waarbij n de apparaat-ID van uw apparaat is (niet weergegeven voor apparaat-ID 1). De knop-LED's voor elk sjabloon kunnen worden bestuurd via System Exclusive-berichten. Als alternatief kunnen knop-LED's voor het momenteel geselecteerde sjabloon worden bestuurd via MIDI note-on, note-off en control change (CC) berichten, volgens het originele Launchpad-protocol.
- Launch Control XL gebruikt een System Exclusive-protocol om de status van elke knop op elk sjabloon bij te werken, ongeacht het momenteel geselecteerde sjabloon. Om de compatibiliteit met Launchpad en Launchpad S te behouden, houdt Launch Control XL zich ook aan het traditionele Launchpad LED-verlichtingsprotocol via note-on, note-off en CC-berichten. Er wordt echter alleen op dergelijke berichten gereageerd als het momenteel geselecteerde sjabloon een knop/pot bevat waarvan de noot/CC-waarde en het MIDI-kanaal overeenkomen met die van het binnenkomende bericht. Gebruikers wordt daarom geadviseerd om het nieuwe System Exclusive-protocol te gebruiken.
- Daarnaast ondersteunt Launch Control XL ook de originele Launchpad dubbelbufferende, knipperende en set-/reset-all LED-berichten, waarbij het MIDI-kanaal van het bericht de sjabloon definieert waarvoor het bericht bedoeld is. Deze berichten kunnen dus op elk moment worden verzonden, ongeacht welk sjabloon momenteel is geselecteerd.
- De status van elke LED wordt opgeslagen wanneer het sjabloon wordt gewijzigd en wordt opgeroepen wanneer het sjabloon opnieuw wordt geselecteerd. Via SysEx kunnen alle LED's op de achtergrond worden bijgewerkt.
Computer-naar-apparaat-berichten
LED's op de Launch Control XL kunnen via twee verschillende protocollen worden ingesteld: (1) het traditionele Launchpad MIDI-protocol, waarbij het momenteel geselecteerde sjabloon een knop moet bevatten waarvan de noot/CC en het MIDI-kanaal overeenkomen met het binnenkomende bericht; en (2) het Launch Control XL System Exclusive-protocol, dat de vereiste knop zal bijwerken, ongeacht de noot/CC-waarde of het MIDI-kanaal.
In beide protocollen wordt één byte gebruikt om de intensiteiten van zowel de rode als de groene LED's in te stellen. Deze byte bevat ook de vlaggen Kopiëren en Wissen. De byte is als volgt gestructureerd (degenen die niet bekend zijn met de binaire notatie kunnen verder lezen voor de formule):
| Beetje | Naam | Betekenis |
| 6 | Moet 0 zijn | |
| 5..4 | Groente | Groene LED-helderheid |
| 3 | Duidelijk | Indien 1: wis de kopie van deze LED in de andere buffer |
| 2 | Kopiëren | Indien 1: schrijf deze LED-gegevens naar beide buffers |
| Opmerking: dit gedrag overschrijft het gedrag Wissen als beide | ||
| bits zijn ingesteld | ||
| 1..0 | Rood | Rode LED-helderheid |
De Copy- en Clear-bits maken manipulatie van de dubbele bufferfunctie van Launch Control XL mogelijk. Zie het bericht 'Controle dubbele buffering' en de bijlage voor details over hoe dit kan worden gebruikt.
Elke LED kan daarom op een van de vier waarden worden ingesteld:
- Helderheid Betekenis
- 0 Korting
- 1 Lage helderheid
- 2 Gemiddelde helderheid
- 3 Volledige helderheid
Als de dubbele bufferfuncties niet in gebruik zijn, is het een goede gewoonte om de Copy- en Clear-bits ingesteld te houden bij het in- of uitschakelen van LED's. Dit maakt het mogelijk om dezelfde routines in de knipperende modus te gebruiken zonder ze opnieuw te bewerken. Een formule voor het berekenen van snelheidswaarden is:
| Hex-versie | Snelheid | = | (10u x Groen) |
| + | Rood | ||
| + | Vlaggen | ||
| Decimale versie | Snelheid | = | (16 x groen) |
| + | Rood | ||
| + | Vlaggen | ||
| waar | Vlaggen | = | 12 (OCh in hex) voor normaal gebruik; |
| 8 | om de LED te laten knipperen, indien geconfigureerd; | ||
| 0 | bij gebruik van dubbele buffering. |
De volgende tabellen met vooraf berekende snelheidswaarden voor normaal gebruik kunnen ook nuttig zijn:
| Zeshoek | Decimale | Kleur | Helderheid |
| 0Ch | 12 | Uit | Uit |
| 0Dh | 13 | Rood | Laag |
| 0Fh | 15 | Rood | Vol |
| 1Dh | 29 | Amber | Laag |
| 3Fh | 63 | Amber | Vol |
| 3 Eh | 62 | Geel | Vol |
| 1Ch | 28 | Groente | Laag |
| 3Ch | 60 | Groente | Vol |
Waarden voor knipperende LED's zijn
| Zeshoek | Decimale | Kleur | Helderheid |
| 0Bh | 11 | Rood | Vol |
| 3Bh | 59 | Amber | Vol |
| 3Ah | 58 | Geel | Vol |
| 38 uur | 56 | Groente | Vol |
Launchpad-protocol
Opmerking over — Knop-LED's instellen
- Hex-versie 9nh, Opmerking, Snelheid
- Dec-versie 144+n, Opmerking, Velocity
Een noot-aan-bericht verandert de status van alle knoppen in het momenteel geselecteerde sjabloon waarvan de noot/CC-waarde overeenkomt met die van de binnenkomende nootwaarde en waarvan het op nul geïndexeerde MIDI-kanaal overeenkomt met het MIDI-kanaal n van het binnenkomende bericht. Velocity wordt gebruikt om de LED-kleur in te stellen.
Opmerking Uit — Schakel de LED's van de knoppen uit
- Hex-versie 8nh, Opmerking, Snelheid
- Dec versie 128+n, Opmerking, Velocity
Dit bericht wordt geïnterpreteerd als een noot-aan-bericht met dezelfde nootwaarde maar met een snelheid van 0.
De Velocity-byte wordt in dit bericht genegeerd.
Launch Control XL opnieuw instellen
- Hex-versie Bnh, 00h, 00h
- Dec-versie 176+n, 0, 0
Alle LED's worden uitgeschakeld en de bufferinstellingen en de werkcyclus worden teruggezet naar hun standaardwaarden. Het MIDI-kanaal n definieert de sjabloon waarvoor dit bericht is bedoeld (00h-07h (0-7) voor de 8 gebruikerssjablonen en 08h-0Fh (8-15) voor de 8 fabriekssjablonen).
Controle dubbele buffering
- Hex-versie Bnh, 00h, 20-3Dh
- Dec-versie 176+n, 0, 32-61
Dit bericht wordt gebruikt om de dubbele bufferstatus van de knoppen te regelen. Het MIDI-kanaal n definieert de sjabloon waarvoor dit bericht is bedoeld (00h-07h (0-7) voor de 8 gebruikerssjablonen en 08h-0Fh (8-15) voor de 8 fabriekssjablonen). Zie de bijlage voor meer informatie over dubbele buffering. De laatste byte wordt als volgt bepaald:
| Beetje | Naam | Betekenis | |
| 6 | Moet 0 zijn. | ||
| 5 | Moet 1 zijn. | ||
| 4 | Kopiëren | Indien 1: kopieer de LED-statussen uit de nieuwe 'weergegeven' buffer | naar |
| de | nieuwe 'update'-buffer. | ||
| 3 | Flash | Indien 1: draai de 'weergegeven' buffers voortdurend om om ze geselecteerd te maken | |
| LED's knipperen. | |||
| 2 | Update | Stel buffer 0 of buffer 1 in als de nieuwe 'bijwerkbuffer'. | |
| 1 | Moet 0 zijn. | ||
| 0 | Weergave | Stel buffer 0 of buffer 1 in als de nieuwe 'weergegeven' buffer. |
Voor degenen die minder bekend zijn met binair: de formule voor het berekenen van de databyte is:
- Bitnaam Betekenis
- 6 Moet 0 zijn.
- 5 Moet 1 zijn.
- 4 Kopiëren Indien 1: kopieer de LED-statussen van de nieuwe 'weergegeven' buffer naar de nieuwe 'update'-buffer.
- 3 Knipperen Indien 1: draai voortdurend de 'weergegeven' buffers om, zodat de geselecteerde LED's knipperen.
- 2 Update Stel buffer 0 of buffer 1 in als de nieuwe 'update'-buffer.
- 1 Moet 0 zijn.
- 0 Display Stel buffer 0 of buffer 1 in als de nieuwe 'weergeefbuffer'.
Voor degenen die minder bekend zijn met binair: de formule voor het berekenen van de databyte is:
- Hex-versie Gegevens = (4 x update)
- + Weergave
- + 20 uur
- + Vlaggen
- Decimale versie Gegevens = (4 x update)
- + Weergave
- + 32
- + Vlaggen
- waarbij vlaggen = 16 (10 uur in hex) voor kopiëren;
- 8 voor flits;
- 0 anders
De standaardstatus is nul: niet knipperend; de updatebuffer is 0; de weergegeven buffer is ook 0. In deze modus worden alle LED-gegevens die naar Launch Control XL worden geschreven onmiddellijk weergegeven. Als u dit bericht verzendt, wordt ook de flitstimer gereset, zodat deze kan worden gebruikt om de flitssnelheden van alle Launch Control XL's die op een systeem zijn aangesloten opnieuw te synchroniseren
Schakel alle LED's in
- Zeskantige versie Bnh, 00h, 7D-7Fh
- Dec-versie 176+n, 0, 125-127
De laatste byte kan een van de drie waarden aannemen
| Zeshoek | Decimale | Betekenis |
| 7Dh | 125 | Lage helderheidstest. |
| 7 Eh | 126 | Middelmatige helderheidstest. |
| 7Fh | 127 | Volledige helderheidstest. |
Als u deze opdracht verzendt, worden alle andere gegevens gereset. Zie het bericht Reset Launch Control XL voor meer informatie. Het MIDI-kanaal n definieert de sjabloon waarvoor dit bericht is bedoeld (00h-07h (0-7) voor de 8 gebruikerssjablonen en 08h-0Fh (8-15) voor de 8 fabriekssjablonen).
Launch Control XL-systeem Exclusieve protocolset-LED's
System Exclusive-berichten kunnen worden gebruikt om de LED-waarden voor elke knop of pot in elk sjabloon in te stellen, ongeacht welk sjabloon momenteel is geselecteerd. Dit gebeurt aan de hand van het volgende bericht
- Hex-versie F0h 00h 20h 29h 02h 11h 78h Sjabloonindexwaarde F7h
- Dec-versie 240 0 32 41 2 17 120 Sjabloonindexwaarde 247
Waarbij Sjabloon 00h-07h (0-7) is voor de 8 gebruikerssjablonen, en 08h-0Fh (8-15) voor de 8 fabriekssjablonen; Index is de index van de button of pot (zie hieronder); en Waarde is de snelheidsbyte die de helderheidswaarden van zowel de rode als de groene LED's definieert.
Meerdere LED's kunnen in één bericht worden geadresseerd door meerdere LED-waardebyteparen op te nemen.
Indices zijn als volgt:
- 00-07h (0-7) : Bovenste rij knoppen, van links naar rechts
- 08-0Fh (8-15): Middelste rij knoppen, van links naar rechts
- 10-17u (16-23) : Onderste rij knoppen, van links naar rechts
- 18-1Fh (24-31): Bovenste rij 'kanaal'-knoppen, van links naar rechts
- 20-27u (32-39) : Onderste rij 'kanaal'-knoppen, van links naar rechts
- 28-2Bh (40-43): Knoppen Apparaat, Mute, Solo, Recordarm
- 2C-2Fh (44-47): Knoppen omhoog, omlaag, links, rechts
Schakel knopstatussen in
De status van knoppen waarvan het gedrag is ingesteld op 'Toggle' (in plaats van 'Momentary') kan worden bijgewerkt door System Exclusive-berichten. Dit gebeurt met behulp van het volgende bericht:
- Hex-versie F0h 00h 20h 29h 02h 11h 7Bh Sjabloonindexwaarde F7h
- Dec-versie 240 0 32 41 2 17 123 Sjabloonindexwaarde 247
Waarbij Sjabloon 00h-07h (0-7) is voor de 8 gebruikerssjablonen, en 08h-0Fh (8-15) voor de 8 fabriekssjablonen; Index is de index van de knop (zie hieronder); en Waarde is 00h (0) voor uit of 7Fh (127) voor aan. Berichten voor knoppen die niet op 'Toggle' staan, worden genegeerd.
Meerdere knoppen kunnen in één bericht worden geadresseerd door meerdere index-waarde-byteparen op te nemen.
Indices zijn als volgt:
- 00-07h (0-7) : Bovenste rij 'kanaal'-knoppen, van links naar rechts
- 08-0Fh (8-15): Onderste rij 'kanaal'-knoppen, van links naar rechts
- 10-13u (16-19) : Knoppen Apparaat, Mute, Solo, Recordarm
- 14-17u (20-23): Knoppen omhoog, omlaag, links, rechts
Wijzig huidige sjabloon
Het volgende bericht kan worden gebruikt om de huidige sjabloon van het apparaat te wijzigen:
- Hex-versie F0h 00h 20h 29h 02h 11h 77h Sjabloon F7h
- December-versie 240 0 32 41 2 17 119 Sjabloon 247
Waarbij Sjabloon 00h-07h (0-7) is voor de 8 gebruikerssjablonen, en 08h-0Fh (8-15) voor de 8 fabriekssjablonen.
Apparaat-naar-computer-berichten
Knop ingedrukt
- Hex-versie 9nh, Opmerking, Snelheid
- Dec-versie 144+n, Note, Velocity OR
- Hex-versie Bnh, CC, Velocity
- Dec-versie 176+n, CC, Velocity
Knoppen kunnen nootberichten of CC-berichten uitvoeren op een nul-geïndexeerd MIDI-kanaal n. Wanneer er op een knop wordt gedrukt, wordt er een bericht verzonden met een snelheid van 7Fh; een tweede bericht wordt verzonden met snelheid 0 wanneer het wordt vrijgegeven. De editor kan worden gebruikt om de noot/CC-waarde en de snelheidswaarde van elke knop te wijzigen bij het indrukken/loslaten.
Sjabloon gewijzigd
Launch Control XL verzendt het volgende System Exclusive-bericht bij het wijzigen van de sjabloon:
- Hex-versie F0h 00h 20h 29h 02h 11h 77h Sjabloon F7h
- December-versie 240 0 32 41 2 17 119 Sjabloon 247
Waarbij Sjabloon 00h-07h (0-7) is voor de 8 gebruikerssjablonen, en 08h-0Fh (8-15) voor de 8 fabriekssjablonen.
LED-verlichting via notitieberichten
Hier ziet u de notitieberichten die worden gebruikt om de LED's onder de draaiknoppen op de Launch Control XL te laten oplichten.
LED dubbel bufferend en knipperend
De Launch Control XL heeft twee LED-buffers, 0 en 1. Beide kunnen worden weergegeven terwijl beide worden bijgewerkt door binnenkomende LED-instructies. In de praktijk kan dit de prestaties van Launch Control XL op twee manieren verbeteren:
- Door een grootschalige LED-update mogelijk te maken die, hoewel het 100 milliseconden kan duren om in te stellen, voor de gebruiker onmiddellijk lijkt te zijn.
- Door automatisch geselecteerde LED's te laten knipperen
Om dubbele buffering voor het eerste doel te benutten, zijn er zeer weinig aanpassingen aan bestaande toepassingen nodig. Het kan op de volgende manier worden geïntroduceerd
- Verzend Bnh, 00h, 31h (176+n, 0, 49) bij het opstarten, waarbij n de sjabloon definieert waarvoor dit bericht bedoeld is (00h-07h (0-7) voor de 8 gebruikerssjablonen, en 08h-0Fh (8-15) voor de 8 fabriekssjablonen). Hierdoor wordt buffer 1 ingesteld als de weergegeven buffer, en buffer 0 als de updatebuffer. Launch Control XL zal niet langer nieuwe LED-gegevens weergeven die ernaar zijn geschreven.
- Schrijf zoals gewoonlijk LED's naar de Launch Control XL en zorg ervoor dat de Copy- en Clear-bits niet zijn ingesteld.
- Wanneer deze update is voltooid, verzendt u Bnh, 00h, 34h (176+n, 0, 52). Hiermee wordt buffer 0 ingesteld als
de weergegeven buffer, en buffer 1 als de updatebuffer. De nieuwe LED-gegevens worden onmiddellijk zichtbaar. De huidige inhoud van buffer 0 wordt automatisch gekopieerd naar buffer 1. - Schrijf meer LED's naar de Launch Control XL, waarbij de Copy- en Clear-bits op nul staan.
- Wanneer deze update is voltooid, verzendt u Bnh, 00h, 31h (176+n, 0, 49) opnieuw. Hierdoor wordt teruggeschakeld naar de eerste toestand. De nieuwe LED-gegevens worden zichtbaar en de inhoud van buffer 1 wordt terug gekopieerd naar buffer 0.
- Ga verder vanaf stap 2.
- Om deze modus ten slotte uit te schakelen, verzendt u Bnh, 00h, 30h (176+n, 0, 48).
Als alternatief kunnen gekozen LED's worden laten knipperen. Om automatisch knipperen in te schakelen, waardoor Launch Control XL zijn eigen flitssnelheid kan gebruiken, verzendt u:
- Hex-versie Bnh, 00h, 28h
- Dec-versie 176+n, 0, 40
Als er een externe tijdlijn nodig is om de LED's met een bepaalde snelheid te laten knipperen, wordt de volgende volgorde voorgesteld:
- Knipperende LED's inschakelen Bnh, 00h, 20h (decimale versie 176+n, 0, 32)
- Schakel knipperende LED's uit Bnh, 00h, 20h (decimale versie 176+n, 0, 33)
Zoals eerder vermeld, is het een goede gewoonte om de Clear- en Copy-bits ingesteld te houden terwijl LED's in het algemeen worden aangesproken, zodat een toepassing gemakkelijk kan worden uitgebreid met knipperen. Anders zullen er onbedoelde effecten optreden als u het later probeert te introduceren.
Documenten / Bronnen
 |
Novation Launch Control Xl Programmeur [pdf] Gebruikershandleiding Launch Control Xl-programmeur, Launch Control, Xl-programmeur, programmeur |
