DIY USB DJ Controller (14 / 16 steg)
Steg 14: Software - Program bearbetning
Detta program ansluter till den seriella porten av startfönstret så vi kan få input. Det blir meddelandena, avkodar dem, och formaterar ett MIDI-meddelande och skickar det. Den innehåller också ett användargränssnitt som gör det möjligt att välja rätt serieport och MIDI-anslutning. Du kan spela några ganska kusliga piano med knappsatsen om du ansluter till Microsoft MIDI Synth! Hur som helst, jag ska ge en översikt av hur programmet fungerar och sedan berätta hur man konfigurerar den. Vi behöver ett par saker först.
Material:
- Bearbetning IDE
- proMIDI 1.0 bibliotek
- controlP5 bibliotek
Se föregående steg för länkar
Att få setup
Börja med att installera biblioteken. Hitta din bearbetning mapp (vanligtvis i dokument) och gå till Processing\libraries. Extrahera bibliotek till den här mappen och du bör vara redo (det är samma som installerar bibliotek för Energia eller Arduino).
Förstå koden
Det finns vissa delar av koden inte är relaterade till bearbetning input från DJ-Controller. Dessa inkluderar hantering av seriell port och MIDI-anslutningar samt skapa användargränssnittet. Jag kommer inte täcka dessa delar av koden. Se sidan för vissa biblioteket i fråga om du vill ha en förklaring av hur allt fungerar.
Data från registeransvarige registrerar våra program i funktionen kallas "serialEvent." I denna funktion, två separata byte av meddelandet kombineras till en 16-bitars char (inte heltal... eftersom behandlingen inte har osignerade datatyper, se kodkommentarer för mer information och avvikelser). Sedan anropar funktionen "ParseMessage"...
ParseMessage är utgångspunkten för bearbetning av bitarna vi får från registeransvarige. Bitvis matematik används för att avkoda den ID-nummer och typ av kontroll som skickade meddelandet. Baserat på dessa egenskaper, kan det sedan skicka meddelandet till rätt funktion som ska bearbetas.
Om kontrollen är en analog kontroll, kallar det "ProcessAnalog". Denna funktion avkodar det 10-bitars värdet i kontrollen och omvandlar den till en MIDI-värde mellan 0 och 127. Det skickar sedan kontroll ändra MIDI-meddelanden genom att ringa "SendControlChange". En kontroll förändring är en typ av MIDI-kontroll som har en variabelindata i stället för en anteckning, som har en på / av-stat.
Om kontrollen är en digital kontroll, har 3 val i hur att behandla det: om ID-numret är 0, numret är reserverad för knappsatsen så skickas det till "ProcessKeypad". Om ID-numret är 1, är numret reserverad för rotary encoder så skickas det till "ProcessRotary". Om ID-numret är ingen av dessa reserverade värden, bearbetar det som en allmän digital ingång (aka knappen) genom att skicka meddelandet till 'ProcessDigital'.
ProcessKeypad avkodar vad knapptryckningen, dess/på tillstånd, som var utvald vid tidpunkten och däck som valdes på gång. Det skickar sedan en MIDI-not baserat på denna information. MIDI-notera antalet beräknas med en speciell algoritm som ger varje kombination ett unikt notvärde.
ProcessRotary avkodar vad värdet av meddelandet och om knappen integrerad sköts medan rotary encoder vändes. De värden varierar från 0 till 2, med 0 vilket innebär Medsols rotation, 1 menande moturs rotation och 2 vilket innebär en dubbel klick (används för att läsa in låtar till valda däck). Den superspeed biten är satt till 1 om knappen integrerad pressades samtidigt vrida, och om det trycktes ner, skickar programmet 10 MIDI-meddelanden. Eftersom rotary encoder är avsedd att användas för att bläddra ett bibliotek, kan du rulla snabbare genom låtar.
ProcessDigital helt enkelt avkodar den sista biten i meddelandet och som berättar om att skicka en på eller en av MIDI-meddelanden för specifika noteringen förknippade med kontrollen.
Mer information om det protokoll som används i detta projekt finns det första steget i avsnittet Firmware.
Kör koden och konfigurera programvaran
Nu när du förstår koden, kan få igång det!
Du kommer att märka när du först öppna bearbetning som är nästan identisk med Energia. De bygger upp samma sak typ av (ledningar, tror jag). Detta gör det super intuitivt att komma igång! Kopiera och klistra in min kod i editorfönstret och klicka på Play-knappen i det övre vänstra hörnet ("Run").
Ett litet fönster bör dyka upp som har två nedrullningsbara menyer och tre knappar. Dessa kontroller kan du välja vilka MIDI-utgång för anslutning till och vad seriell port ingång för att lyssna på. Uppdateringsknappen kan du uppdatera listorna om du koppla ur/plugg i din launchpad eller MIDI-anslutning. För våra syften, Anslut MIDI Out raden till loopMIDI (Windows) eller virtual MIDI-port du skapat tidigare (Mac/Linux). Anslut registeransvarige och ansluta den seriella porten till den seriella porten som registeransvarige på. Det bör vara den som du använde med Energia. MIDI-ingång från handkontrollen bör nu nå vad är ansluten till den andra änden av din virtual MIDI-port.