novation Launch Control Xl Programmer
Start Control XL Programmer's Reference Guide
Produktinformation
Launch Control XL er en MIDI-controller med LED-lys, der kan programmeres via to forskellige protokoller: den traditionelle Launchpad MIDI-protokol og Launch Control XL System Exclusive-protokollen. LED-lysene kan indstilles til fire forskellige lysstyrkeniveauer og kan manipuleres ved hjælp af Copy og Clear bits til dobbeltbuffring.
Produktanvendelse
For at indstille LED-lysene på Launch Control XL kan du bruge enten Launchpad MIDI-protokollen eller Launch Control XL System Exclusive-protokollen.
Launchpad MIDI-protokol
Hvis du bruger Launchpad MIDI-protokollen, skal du vælge en skabelon, der indeholder en knap, hvis node/CC og MIDI-kanal svarer til den indgående besked. For at indstille LED-lysene skal du sende en meddelelse med en enkelt byte-struktur, der inkluderer lysstyrkeniveauet for både de røde og grønne LED'er samt Kopier og Slet flag.
Bytestruktur:
- Bit 6: Skal være 0
- Bits 5-4: Grøn LED lysstyrkeniveau (0-3)
- Bit 3: Ryd flag (1 for at rydde anden buffers kopi af LED)
- Bit 2: Kopier flag (1 for at skrive LED-data til begge buffere)
- Bits 1-0: Rød LED-lysstyrkeniveau (0-3)
Hver LED kan indstilles til et af fire lysstyrkeniveauer:
- Lysstyrke 0: Fra
- Lysstyrke 1: Lav lysstyrke
- Lysstyrke 2: Medium lysstyrke
- Lysstyrke 3: Fuld lysstyrke
Det er god praksis at beholde kopierings- og sletflaggene indstillet, når lysdioder tændes eller slukkes, hvis dobbeltbufferfunktionerne ikke er i brug.
For at beregne hastighedsværdier skal du bruge følgende formel:
- Hex version: Hastighed = (10h x Grøn) + Rød + Flag
- Decimalversion: Hastighed = (16 x Grøn) + Rød + Flag
- Flag = 12 (OCh i hex) til normal brug; 8 for at få LED'en til at blinke, hvis den er konfigureret; 0, hvis du bruger dobbeltbuffring.
Start Control XL System Exclusive Protocol
Hvis du bruger Launch Control XL System Exclusive-protokollen, vil den påkrævede knap blive opdateret uanset dens node/CC-værdi eller MIDI-kanal. For at indstille LED-lysene skal du sende en meddelelse med en enkelt-byte-struktur, der inkluderer lysstyrkeniveauet for både de røde og grønne LED'er samt Kopier og Slet flag.
Bytestruktur:
- Bit 6: Skal være 0
- Bits 5-4: Grøn LED lysstyrkeniveau (0-3)
- Bit 3: Ryd flag (1 for at rydde anden buffers kopi af LED)
- Bit 2: Kopier flag (1 for at skrive LED-data til begge buffere)
- Bits 1-0: Rød LED-lysstyrkeniveau (0-3)
Hver LED kan indstilles til et af fire lysstyrkeniveauer:
- Lysstyrke 0: Fra
- Lysstyrke 1: Lav lysstyrke
- Lysstyrke 2: Medium lysstyrke
- Lysstyrke 3: Fuld lysstyrke
Styr dobbeltbuffering
Launch Control XL har også dobbeltbuffer til LED-belysning. For at bruge dobbeltbuffring skal du sende en kontrol-dobbeltbuffermeddelelse med en værdi på 0 for at slå den til eller 1 for at slå den fra. Når du bruger dobbeltbuffring, kan kopierings- og rydningsflaget bruges til at manipulere bufferen, der skrives til.
Indledning
- Denne manual beskriver Launch Control XLs MIDI-kommunikationsformat. Dette er al den proprietære information, du behøver for at kunne skrive patches og programmer, der er tilpasset til Launch Control XL.
- Det antages, at du allerede har en grundlæggende viden om MIDI og noget passende software til at skrive interaktive MIDI-applikationer (f.eks.ample, Max for Live, Max/MSP eller Pure Data).
- Tal i denne vejledning er angivet i både hexadecimal og decimal. For at undgå enhver tvetydighed efterfølges hexadecimale tal altid af et lille h.
Start Control XL MIDI Overview
- Launch Control XL er en klassekompatibel USB-enhed, der kan prale af 24 potter, 8 fadere og 24 programmerbare knapper. De 16 'kanal'-knapper indeholder hver en tofarvet LED med et rødt element og et grønt element; lyset fra disse elementer kan blandes til rav. De fire retningsknapper indeholder hver en enkelt rød LED. Knapperne 'Device', 'Mute', 'Solo' og 'Record Arm' indeholder hver en enkelt gul LED. Launch Control XL har 16 skabeloner: 8 brugerskabeloner, som kan ændres, og 8 fabriksskabeloner, som ikke kan. Brugerskabeloner optager pladser 00h07h (0-7), mens fabriksskabeloner optager pladser 08-0Fh (8-15). Brug Launch Control XL Editor (tilgængelig på Novation website) for at ændre dine 8 brugerskabeloner.
- Launch Control XL har en enkelt MIDI-port ved navn 'Launch Control XL n', hvor n er enheds-id'et på din enhed (ikke vist for enheds-ID 1). Knappens LED'er for enhver skabelon kan styres via System Exclusive-meddelelser. Alternativt kan knap-LED'er for den aktuelt valgte skabelon styres via MIDI note-on, node-off og kontrol ændring (CC) beskeder, i henhold til den originale Launchpad protokol.
- Launch Control XL bruger en System Exclusive-protokol til at opdatere tilstanden for enhver knap på enhver skabelon, uanset den aktuelt valgte skabelon. For at bevare kompatibiliteten med Launchpad og Launchpad S, overholder Launch Control XL også den traditionelle Launchpad LED-belysningsprotokol via note-on, note-off og CC-meddelelser. Sådanne beskeder vil dog kun blive behandlet, hvis den aktuelt valgte skabelon indeholder en knap/pot, hvis node/CC-værdi og MIDI-kanal matcher dem i den indkommende besked. Brugere rådes derfor til at anvende den nye System Exclusive-protokol.
- Derudover understøtter Launch Control XL også den originale Launchpad-dobbeltbuffer, blinkende og sæt-/nulstil alle LED-beskeder, hvor beskedens MIDI-kanal definerer den skabelon, som beskeden er beregnet til. Disse beskeder kan derfor sendes til enhver tid, uanset hvilken skabelon der er valgt i øjeblikket.
- Status for hver LED gemmes, når skabelonen ændres, og vil blive genkaldt, når skabelonen vælges igen. Alle lysdioder kan opdateres i baggrunden via SysEx.
Computer-til-enhed-meddelelser
LED'er på Launch Control XL kan indstilles via to forskellige protokoller: (1) den traditionelle Launchpad MIDI-protokol, som kræver, at den aktuelt valgte skabelon indeholder en knap, hvis node/CC og MIDI-kanal svarer til den indkommende besked; og (2) Launch Control XL System Exclusive-protokollen, som opdaterer den nødvendige knap uanset dens node/CC-værdi eller MIDI-kanal.
I begge protokoller bruges en enkelt byte til at indstille intensiteten af både de røde og grønne LED'er. Denne byte inkluderer også flagene Kopier og Slet. Byten er struktureret som følger (dem, der ikke er bekendt med binær notation, kan læse videre for formlen):
| Bit | Navn | Mening |
| 6 | Skal være 0 | |
| 5..4 | Grøn | Grøn LED lysstyrke |
| 3 | Klar | Hvis 1: Ryd den anden buffers kopi af denne LED |
| 2 | Kopi | Hvis 1: skriv disse LED-data til begge buffere |
| Bemærk: denne adfærd tilsidesætter Clear-adfærden, når begge dele | ||
| bits er sat | ||
| 1..0 | Rød | Rød LED lysstyrke |
Copy og Clear bits tillader manipulation af Launch Control XL's dobbeltbufferfunktion. Se meddelelsen 'Kontrol dobbeltbuffring' og appendiks for detaljer om, hvordan dette kan bruges.
Hver LED kan derfor indstilles til en af fire værdier:
- Lysstyrke Mening
- 0 Fra
- 1 Lav lysstyrke
- 2 Medium lysstyrke
- 3 Fuld lysstyrke
Hvis dobbeltbuffer-funktionerne ikke er i brug, er det god praksis at beholde Copy og Clear bits indstillet, når du tænder eller slukker LED'er. Dette gør det muligt at bruge de samme rutiner i blinkende tilstand uden at omarbejde dem. En formel til beregning af hastighedsværdier er:
| Hex version | Hastighed | = | (10 timer x grøn) |
| + | Rød | ||
| + | Flag | ||
| Decimal version | Hastighed | = | (16 x grøn) |
| + | Rød | ||
| + | Flag | ||
| hvor | Flag | = | 12 (OCh i hex) til normal brug; |
| 8 | for at få LED'en til at blinke, hvis den er konfigureret; | ||
| 0 | hvis du bruger dobbeltbuffring. |
Følgende tabeller med forudberegnede hastighedsværdier til normal brug kan også være nyttige:
| Hex | Decimal | Farve | Lysstyrke |
| 0Kan | 12 | Slukket | Slukket |
| 0Dh | 13 | Rød | Lav |
| 0Fh | 15 | Rød | Fuld |
| 1Dh | 29 | Rav | Lav |
| 3Fh | 63 | Rav | Fuld |
| 3Eh | 62 | Gul | Fuld |
| 1Kan | 28 | Grøn | Lav |
| 3Kan | 60 | Grøn | Fuld |
Værdier for blinkende lysdioder er
| Hex | Decimal | Farve | Lysstyrke |
| 0Bh | 11 | Rød | Fuld |
| 3Bh | 59 | Rav | Fuld |
| 3 Ah | 58 | Gul | Fuld |
| 38 timer | 56 | Grøn | Fuld |
Launchpad Protocol
Bemærk Til — Indstil knap-LED'er
- Hex version 9nh, Note, Velocity
- Dec version 144+n, Note, Velocity
En note-on-meddelelse ændrer tilstanden for alle knapper i den aktuelt valgte skabelon, hvis node/CC-værdi matcher den indgående nodeværdi, og hvis nulindekserede MIDI-kanal matcher MIDI-kanalen n i den indgående besked. Hastighed bruges til at indstille LED-farven.
Note Off — Sluk knap-LED'er
- Hex version 8nh, Note, Velocity
- Dec version 128+n, Note, Velocity
Denne besked fortolkes som en note-on besked med samme noteværdi, men med en hastighed på 0.
Velocity-byten ignoreres i denne meddelelse.
Nulstil Launch Control XL
- Hex version Bnh, 00h, 00h
- Dec version 176+n, 0, 0
Alle LED'er slukkes, og bufferindstillingerne og driftscyklussen nulstilles til deres standardværdier. MIDI-kanalen n definerer den skabelon, som denne besked er beregnet til (00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner).
Styr dobbeltbuffring
- Hex version Bnh, 00h, 20-3Dh
- Dec version 176+n, 0, 32-61
Denne meddelelse bruges til at styre knappernes dobbeltbuffertilstand. MIDI-kanalen n definerer den skabelon, som denne besked er beregnet til (00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner). Se appendiks for mere information om dobbelt buffering. Den sidste byte bestemmes som følger:
| Bit | Navn | Mening | |
| 6 | Skal være 0. | ||
| 5 | Skal være 1. | ||
| 4 | Kopi | Hvis 1: kopier LED-tilstandene fra den nye 'viste' buffer | til |
| de | ny 'opdaterings' buffer. | ||
| 3 | Blitz | Hvis 1: vend konstant 'viste' buffere for at vælge | |
| LED'er blinker. | |||
| 2 | Opdatering | Indstil buffer 0 eller buffer 1 som den nye 'opdaterings' buffer. | |
| 1 | Skal være 0. | ||
| 0 | Vise | Indstil buffer 0 eller buffer 1 som den nye 'visnings' buffer. |
For dem, der er mindre fortrolige med binær, er formlen til beregning af databyten
- Bit navns betydning
- 6 skal være 0.
- 5 skal være 1.
- 4 Kopier hvis 1: kopier LED-tilstandene fra den nye 'viste' buffer til den nye 'opdaterings'-buffer.
- 3 Blink Hvis 1: vend konstant 'viste' buffere for at få udvalgte LED'er til at blinke.
- 2 Opdatering Indstil buffer 0 eller buffer 1 som den nye 'opdaterings' buffer.
- 1 skal være 0.
- 0 Display Indstil buffer 0 eller buffer 1 som den nye 'visnings' buffer.
For dem, der er mindre fortrolige med binær, er formlen til beregning af databyten:
- Hex version Data = (4 x opdatering)
- + display
- + 20 timer
- + Flag
- Decimalversion Data = (4 x opdatering)
- + display
- + 32
- + Flag
- hvor flag = 16 (10 timer i hex) for kopi;
- 8 til Flash;
- 0 ellers
Standardtilstanden er nul: ingen blinkning; opdateringsbufferen er 0; den viste buffer er også 0. I denne tilstand vises alle LED-data, der er skrevet til Launch Control XL, med det samme. Sending af denne besked nulstiller også flash-timeren, så den kan bruges til at gensynkronisere flashhastighederne for alle Launch Control XL'er, der er tilsluttet et system
Tænd for alle lysdioder
- Hex version Bnh, 00h, 7D-7Fh
- Dec version 176+n, 0, 125-127
Den sidste byte kan have en af tre værdier
| Hex | Decimal | Mening |
| 7Dh | 125 | Lav lysstyrke test. |
| 7Eh | 126 | Medium lysstyrke test. |
| 7Fh | 127 | Fuld lysstyrketest. |
Sending af denne kommando nulstiller alle andre data — se Reset Launch Control XL-meddelelsen for mere information. MIDI-kanalen n definerer den skabelon, som denne besked er beregnet til (00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner).
Start Control XL System Exclusive Protocol Set LED'er
System Exclusive-meddelelser kan bruges til at indstille LED-værdierne for enhver knap eller pot i enhver skabelon, uanset hvilken skabelon der er valgt i øjeblikket. Dette gøres ved hjælp af følgende meddelelse
- Hex version F0h 00h 20h 29h 02h 11h 78h Skabelonindeksværdi F7h
- Dec version 240 0 32 41 2 17 120 Skabelonindeksværdi 247
Hvor skabelonen er 00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner; Indeks er indekset for knappen eller potten (se nedenfor); og Værdi er den hastighedsbyte, der definerer lysstyrkeværdierne for både de røde og grønne LED'er.
Flere LED'er kan adresseres i en enkelt besked ved at inkludere flere LED-Value bytepar.
Indeks er som følger:
- 00-07h (0-7): Øverste række af knopper, venstre mod højre
- 08-0Fh (8-15): Midterste række af knopper, venstre mod højre
- 10-17h (16-23): Nederste række af knopper, venstre mod højre
- 18-1Fh (24-31): Øverste række af 'kanal'-knapper, venstre mod højre
- 20-27 timer (32-39): Nederste række af 'kanal'-knapper, venstre mod højre
- 28-2Bh (40-43): Knappenhed, Mute, Solo, Record Arm
- 2C-2Fh (44-47): Knapper op, ned, venstre, højre
Skiftknaptilstande
Status for knapper, hvis adfærd er indstillet til 'Toggle' (i stedet for 'Momentary'), kan opdateres af System Exclusive-meddelelser. Dette gøres ved hjælp af følgende besked:
- Hex version F0h 00h 20h 29h 02h 11h 7Bh Skabelonindeksværdi F7h
- Dec version 240 0 32 41 2 17 123 Skabelonindeksværdi 247
Hvor skabelonen er 00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner; Indeks er indekset for knappen (se nedenfor); og værdien er enten 00h (0) for slukket eller 7Fh (127) for tændt. Beskeder for knapper, der ikke er indstillet til 'Toggle', vil blive ignoreret.
Flere knapper kan adresseres i en enkelt besked ved at inkludere flere indeks-værdi-bytepar.
Indeks er som følger:
- 00-07h (0-7): Øverste række af 'kanal'-knapper, venstre mod højre
- 08-0Fh (8-15): Nederste række af 'kanal'-knapper, venstre mod højre
- 10-13 timer (16-19): Knappenhed, Mute, Solo, Optagearm
- 14-17h (20-23): Knapper op, ned, venstre, højre
Skift nuværende skabelon
Følgende meddelelse kan bruges til at ændre den aktuelle skabelon for enheden:
- Hex version F0h 00h 20h 29h 02h 11h 77h Skabelon F7h
- Dec version 240 0 32 41 2 17 119 Skabelon 247
Hvor skabelonen er 00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner.
Enhed-til-computer-meddelelser
Knap trykket
- Hex version 9nh, Note, Velocity
- Dec version 144+n, Note, Velocity OR
- Hex version Bnh, CC, Velocity
- Dec version 176+n, CC, Velocity
Knapper kan udsende enten nodemeddelelser eller CC-beskeder på en nulindekseret MIDI-kanal n. En besked sendes med en hastighed på 7Fh, når der trykkes på en knap; en anden besked sendes med hastighed 0, når den slippes. Editoren kan bruges til at ændre hver knaps node/CC værdi og velocity værdi ved tryk/slip.
Skabelonen ændret
Launch Control XL sender følgende System Exclusive-meddelelse ud ved ændring af skabelon:
- Hex version F0h 00h 20h 29h 02h 11h 77h Skabelon F7h
- Dec version 240 0 32 41 2 17 119 Skabelon 247
Hvor skabelonen er 00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner.
LED-belysning via notemeddelelser
Her kan du se de notemeddelelser, der bruges til at tænde lysdioderne under skiverne på Launch Control XL.
LED dobbeltbuffer og blinker
Launch Control XL har to LED-buffere, 0 og 1. Hver af dem kan vises, mens begge er opdateret af indgående LED-instruktioner. I praksis kan dette forbedre ydeevnen af Launch Control XL på en af to måder:
- Ved at aktivere en storstilet LED-opdatering, som, selvom det kan tage 100 millisekunder at konfigurere, ser ud til at være øjeblikkelig for brugeren.
- Ved automatisk at blinke udvalgte lysdioder
At udnytte dobbeltbuffring til det første formål kræver meget lidt modifikation af eksisterende applikationer. Det kan introduceres på følgende måde
- Send Bnh, 00h, 31h (176+n, 0, 49) ved opstart, hvor n definerer den skabelon, som denne besked er beregnet til (00h-07h (0-7) for de 8 brugerskabeloner og 08h-0Fh (8-15) for de 8 fabriksskabeloner). Dette indstiller buffer 1 som den viste buffer og buffer 0 som opdateringsbuffer. Launch Control XL holder op med at vise nye LED-data, der er skrevet til den.
- Skriv LED'er til Launch Control XL som sædvanligt, og sørg for, at Copy og Clear bits ikke er indstillet.
- Når denne opdatering er færdig, send Bnh, 00h, 34h (176+n, 0, 52). Dette sætter buffer 0 som
den viste buffer og buffer 1 som opdateringsbuffer. De nye LED-data vil øjeblikkeligt blive synlige. Det aktuelle indhold af buffer 0 vil automatisk blive kopieret til buffer 1. - Skriv flere LED'er til Launch Control XL, med Copy og Clear bits sat til nul.
- Når denne opdatering er færdig, skal du sende Bnh, 00h, 31h (176+n, 0, 49) igen. Dette skifter tilbage til den første tilstand. De nye LED-data vil blive synlige, og indholdet af buffer 1 vil blive kopieret tilbage til buffer 0.
- Fortsæt fra trin 2.
- Til sidst, for at slå denne tilstand fra, send Bnh, 00h, 30h (176+n, 0, 48).
Alternativt kan valgte lysdioder fås til at blinke. For at aktivere automatisk blink, som lader Launch Control XL bruge sin egen blinkende hastighed, skal du sende:
- Hex version Bnh, 00h, 28h
- Dec version 176+n, 0, 40
Hvis der kræves en ekstern tidslinje for at få LED'erne til at blinke med en bestemt hastighed, foreslås følgende sekvens:
- Slå blinkende LED'er til Bnh, 00h, 20h (decimalversion 176+n, 0, 32)
- Slå blinkende LED'er fra Bnh, 00h, 20h (decimalversion 176+n, 0, 33)
Som tidligere nævnt er det god praksis at holde Clear og Copy bits indstillet, mens lysdioder generelt adresseres, så en applikation nemt kan udvides til at omfatte blink. Ellers vil der opstå utilsigtede effekter, når du forsøger at introducere det senere.
Dokumenter/ressourcer
 |
novation Launch Control Xl Programmer [pdfBrugervejledning Launch Control Xl Programmer, Launch Control, Xl Programmer, Programmer |
