Warning: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"? in /www/htdocs/w0069e04/sonic-potions/wiki/includes/json/FormatJson.php on line 297
Deprecated: Optional parameter $ellipsis declared before required parameter $getSubstring is implicitly treated as a required parameter in /www/htdocs/w0069e04/sonic-potions/wiki/languages/Language.php on line 3560
Deprecated: Optional parameter $adjustLength declared before required parameter $getSubstring is implicitly treated as a required parameter in /www/htdocs/w0069e04/sonic-potions/wiki/languages/Language.php on line 0
Deprecated: Optional parameter $prefix declared before required parameter $code is implicitly treated as a required parameter in /www/htdocs/w0069e04/sonic-potions/wiki/languages/Language.php on line 4478
Warning: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"? in /www/htdocs/w0069e04/sonic-potions/wiki/languages/LanguageConverter.php on line 773
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::open($save_path, $session_name) should either be compatible with SessionHandlerInterface::open(string $path, string $name): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 199
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::close() should either be compatible with SessionHandlerInterface::close(): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 214
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::read($id) should either be compatible with SessionHandlerInterface::read(string $id): string|false, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 228
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::write($id, $dataStr) should either be compatible with SessionHandlerInterface::write(string $id, string $data): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 256
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::destroy($id) should either be compatible with SessionHandlerInterface::destroy(string $id): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 362
Deprecated: Return type of MediaWiki\Session\PHPSessionHandler::gc($maxlifetime) should either be compatible with SessionHandlerInterface::gc(int $max_lifetime): int|false, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/PHPSessionHandler.php on line 383
Deprecated: Return type of Wikimedia\Rdbms\IResultWrapper::current() should either be compatible with Iterator::current(): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/libs/rdbms/database/resultwrapper/IResultWrapper.php on line 70
Deprecated: Return type of Wikimedia\Rdbms\IResultWrapper::next() should either be compatible with Iterator::next(): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/libs/rdbms/database/resultwrapper/IResultWrapper.php on line 80
Deprecated: Return type of Wikimedia\Rdbms\IResultWrapper::key() should either be compatible with Iterator::key(): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/libs/rdbms/database/resultwrapper/IResultWrapper.php on line 75
Deprecated: Return type of Wikimedia\Rdbms\ResultWrapper::valid() should either be compatible with Iterator::valid(): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/libs/rdbms/database/resultwrapper/ResultWrapper.php on line 117
Deprecated: Return type of Wikimedia\Rdbms\ResultWrapper::rewind() should either be compatible with Iterator::rewind(): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/libs/rdbms/database/resultwrapper/ResultWrapper.php on line 90
Deprecated: Return type of MediaWiki\Session\Session::count() should either be compatible with Countable::count(): int, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 625
Deprecated: Return type of MediaWiki\Session\Session::current() should either be compatible with Iterator::current(): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 631
Deprecated: Return type of MediaWiki\Session\Session::next() should either be compatible with Iterator::next(): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 643
Deprecated: Return type of MediaWiki\Session\Session::key() should either be compatible with Iterator::key(): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 637
Deprecated: Return type of MediaWiki\Session\Session::valid() should either be compatible with Iterator::valid(): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 655
Deprecated: Return type of MediaWiki\Session\Session::rewind() should either be compatible with Iterator::rewind(): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 649
Deprecated: Return type of MediaWiki\Session\Session::offsetExists($offset) should either be compatible with ArrayAccess::offsetExists(mixed $offset): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 665
Deprecated: Return type of & MediaWiki\Session\Session::offsetGet($offset) should either be compatible with ArrayAccess::offsetGet(mixed $offset): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 678
Deprecated: Return type of MediaWiki\Session\Session::offsetSet($offset, $value) should either be compatible with ArrayAccess::offsetSet(mixed $offset, mixed $value): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 688
Deprecated: Return type of MediaWiki\Session\Session::offsetUnset($offset) should either be compatible with ArrayAccess::offsetUnset(mixed $offset): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /www/htdocs/w0069e04/sonic-potions/wiki/includes/session/Session.php on line 693
Deprecated: Optional parameter $style declared before required parameter $ts is implicitly treated as a required parameter in /www/htdocs/w0069e04/sonic-potions/wiki/vendor/wikimedia/timestamp/src/ConvertibleTimestamp.php on line 176
Deprecated: Creation of dynamic property ApiMain::$mCommit is deprecated in /www/htdocs/w0069e04/sonic-potions/wiki/includes/api/ApiMain.php on line 296 http://wiki.sonic-potions.com/api.php?action=feedcontributions&feedformat=atom&user=RstephaneSonic Potions Wiki - User contributions [en]2026-04-29T08:54:21ZUser contributionsMediaWiki 1.31.0http://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=246How to create and add a new function to the LXR2014-05-12T11:11:57Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', Add in the section 'enum ParamEnums' the new parameter. In our case : PAR_LOOP<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7, // <--- YOUR parameters comes right after thoses lines...<br />
// You have to add all the new parameters right after a dedicated section in the code declaration <br />
//(otherwise you want link later the knob with the function you want to execute):<br />
'''PAR_LOOP,''' <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we declare our parameter and its type :<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/'''*PAR_LOOP*/ DTYPE_1B16,''' // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU (we want that our knob display a name 'LEN')<br />
<br />
* in our case, we add TEXT_LOOP and PAR_ROLL:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We also need to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', go to section 'NamesEnum', add at the end the text 'TEXT_LOOP" : <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
'''{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // We declare it at the end of the section :-)''<br />
<br />
<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters marked in bold:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
'''{"LEN"}''', // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
'''{"Loop"}''', // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results: under the PERF sub menu, your should see 'LEN' on the first knob.<br />
* Now, '''we will create our function'''<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// When the knob is turned , it send the CC2_LOOP message<br />
'''CC2_LOOP,'''<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void '''midiParser_ccHandler'''(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
//<br />
// rstephane MY FUNCTIONS<br />
'''case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break;''' <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file, add the line : <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file, add the function:<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine with the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=245How to create and add a new function to the LXR2014-05-11T21:36:57Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', Add in the section 'enum ParamEnums' the new parameter. In our case : PAR_LOOP<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7, // <--- YOUR parameters comes right after thoses lines...<br />
// You have to add all the new parameters right after a dedicated section in the code declaration <br />
//(otherwise you want link later the knob with the function you want to execute):<br />
'''PAR_LOOP,''' <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we declare our parameter and its type :<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/'''*PAR_LOOP*/ DTYPE_1B16,''' // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU (we want that our knob display a name 'LEN')<br />
<br />
* in our case, we add TEXT_LOOP and PAR_ROLL:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We also need to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', go to section 'NamesEnum', add at the end the text 'TEXT_LOOP" : <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no really needed, well pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
'''{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // We declare it at the end of the section :-)''<br />
<br />
<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters marked in bold:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
'''{"LEN"}''', // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
'''{"Loop"}''', // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results: under the PERF sub menu, your should see 'LEN' on the first knob.<br />
* Now, '''we will create our function'''<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// When the knob is turned , it send the CC2_LOOP message<br />
'''CC2_LOOP,'''<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void '''midiParser_ccHandler'''(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
//<br />
// rstephane MY FUNCTIONS<br />
'''case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break;''' <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file, add the line : <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file, add the function:<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine with the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=244How to create and add a new function to the LXR2014-05-11T21:32:41Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', Add in the section 'enum ParamEnums' the new parameter. In our case : PAR_LOOP<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7, // <--- YOUR parameters comes right after thoses lines...<br />
// You have to add all the new parameters right after a dedicated section in the code declaration <br />
//(otherwise you want link later the knob with the function you want to execute):<br />
'''PAR_LOOP,''' <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we declare our parameter and its type :<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/'''*PAR_LOOP*/ DTYPE_1B16,''' // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU (we want that our knob display a name 'LEN')<br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', go to section 'NamesEnum', add at the end the text 'TEXT_LOOP" : <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no really needed, well pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
'''{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // We declare it at the end of the section :-)''<br />
<br />
<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
'''{"LEN"}''', // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
'''{"Loop"}''', // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
'''CC2_LOOP,'''<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void '''midiParser_ccHandler'''(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
//<br />
// rstephane MY FUNCTIONS<br />
'''case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break;''' <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file, add the line : <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file, add the function:<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine with the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=243How to create and add a new function to the LXR2014-05-11T21:29:06Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', Add in the section 'enum ParamEnums' the new parameter. In our case : PAR_LOOP<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7, // <--- YOUR parameters comes right after thoses lines...<br />
// You have to add all the new parameters right after a dedicated section in the code declaration <br />
//(otherwise you want link later the knob with the function you want to execute):<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we declare our parameter and its type :<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU (we want that our knob display a name 'LEN')<br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', go to section 'NamesEnum', add at the end the text 'TEXT_LOOP" : <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no really needed, well pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
CC2_LOOP,<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
//<br />
// rstephane MY FUNCTIONS<br />
case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file<br />
* add the function <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file, add:<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine with the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=242How to create and add a new function to the LXR2014-05-11T21:23:50Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', Add in the section 'enum ParamEnums' the new parameter. In our case : PAR_LOOP<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7, // <--- YOUR parameters comes right after thoses lines...<br />
// You have to add all the new parameters right after a dedicated section in the code declaration <br />
//(otherwise you want link later the knob with the function you want to execute):<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we declare our parameter and its type :<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU (we want that our knob display a name 'LEN')<br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no really needed, well pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
CC2_LOOP,<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
//<br />
// rstephane MY FUNCTIONS<br />
case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file<br />
* add the function <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file, add:<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine with the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=241How to create and add a new function to the LXR2014-05-11T21:18:13Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we want that our knob display a name 'LEN'<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU <br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no really needed, well pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
CC2_LOOP,<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file<br />
* add the function void randomDrumVoice123(const uint8_t voiceNr); <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=236How to create and add a new function to the LXR2014-05-09T21:58:02Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we want that our knob display a name 'LEN'<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU <br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no needed, weelll pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
CC2_LOOP,<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
case CC2_LOOP:<br />
if(msg.data2 == 16) // reset the loop ! <br />
{ // we stop the loop effect and<br />
// go back to prevoious track lenght<br />
seq_setLoopLength(16);<br />
}<br />
else<br />
{ // we change the tracks lenght<br />
seq_setLoopLength(msg.data2);<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file<br />
* add the function void randomDrumVoice123(const uint8_t voiceNr); <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=235How to create and add a new function to the LXR2014-05-09T21:54:43Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL:<br />
* We will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu: when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
* another aim is to make you look at the difrent files, inspect them and start undestand the logic of the LXR drum system that Julian made :-)<br />
<br />
* First step, we start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we want that our knob display a name 'LEN'<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU <br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section (i need to explain and complete this section)<br />
<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_LOOP, PAR_LOOP}, // rstephane : added LOOP button <- no needed, weelll pass trough this step <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
CC2_LOOP,<br />
....<br />
}<br />
Param2Enums;<br />
<br />
* open '''MidiParser.c''' file <br />
<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
<br />
* open '''sequencer.h''' file<br />
* add the function void randomDrumVoice123(const uint8_t voiceNr); <br />
void seq_setLoopLength(uint8_t length);<br />
<br />
<br />
* open '''sequencer.c''' file<br />
void seq_setLoopLength(uint8_t length)<br />
{<br />
uint8_t i;<br />
// we set the new Loop Track Lenght<br />
for(i=0;i<NUM_TRACKS;i++) {<br />
seq_setTrackLength(i, length); <br />
}<br />
}<br />
<br />
* compile !<br />
* upload on the machine the new firmware<br />
* test!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=234How to create and add a new function to the LXR2014-05-09T15:48:17Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL, we will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu, when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
<br />
* We start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we want that our knob display a name 'LEN'<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU <br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section <br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, '''we will create our function'''<br />
* We will add a link between this function and our knob.<br />
<br />
* open '''midimessage.h''' file<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=233How to create and add a new function to the LXR2014-05-09T15:46:39Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL, we will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu, when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
<br />
* We start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file ''''Parameters.h'''', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
<br />
enum ParamEnums = {<br />
...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
...<br />
<br />
<br />
* We need to open the '''menu.c''' file. we want that our knob display a name 'LEN'<br />
<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
* Place your parameter at a special place, right after the section:<br />
<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
/*PAR_LOOP*/ DTYPE_1B16, // Values goes from 1 to 16 steps<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
...<br />
<br />
<br />
Here the list of parameters you can choose from...<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
* oki, once this done, we need to fill other information in the code<br />
<br />
* Open the file '''menuPages.h'''<br />
<br />
* This array hold the whole menu structure. each voice has different pages. The pages hold the top and bottom enums to indicate which values and descriptors to show<br />
<br />
* in the section: const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM ... add your MENU <br />
<br />
* in our case, we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
}, <br />
...<br />
//Page 10<br />
//---------------- Performance Mode Menu pages ---------------------------<br />
//These pages are shown when the selected mode is the "mute/pattern select" page<br />
//there is only one page with subpages shown for the whole mode<br />
{<br />
{ <br />
TEXT_SHUFFLE, TEXT_ROLL_SPEED, TEXT_X_FADE, TEXT_SAMPLE_RATE, '''TEXT_LOOP''', TEXT_EMPTY,<br />
PAR_SHUFFLE, '''PAR_ROLL''', PAR_MORPH, PAR_VOICE_DECIMATION_ALL, PAR_LOOP,<br />
},<br />
...<br />
<br />
<br />
* We need now to declare the TEXT_LOOP and PAR_LOOP in other files :-)<br />
<br />
* Open file '''menu.h''', and go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
* Add at the end, the text 'TEXT_LOOP" : <br />
<br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
'''TEXT_LOOP''', // rstephane: LOOP text <br />
NUM_NAMES<br />
};<br />
<br />
* Open '''Cc2Text.c''' file and under the section <br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
<br />
* Open the '''menu.c''' file, go to section '''valueNames'''<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
<br />
* Add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_LOOP, CAT_SEQUENCER, LONG_LOOP}, // rstephane: TEXT_LOOP<br />
<br />
<br />
* We NEED declare it at the end of the section :-)<br />
<br />
* now, open the '''MenuText.h''' file to declare the '''short and long version of the TEXT''' (TEXT_LOOP)<br />
* go to section 'const char longNames[][16] PROGMEM = ' and 'const char shortNames[][4] PROGMEM = '<br />
* add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"LEN"}, // rstephane: LEN for LOOP :-)<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Loop"}, // rstephane: LOOP LONG text<br />
};<br />
<br />
<br />
* If you want you can already compile and see the results under the menu PERF menu (normally under the second page, your should see 'LEN' on the first knob).<br />
<br />
* Now, we will create our function<br />
* We will add a link between this function and our knob.<br />
<br />
<br />
/////<br />
<br />
call the function relative to the encoder:<br />
<br />
open midimessage.h<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=232How to create and add a new function to the LXR2014-05-09T15:33:49Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL, we will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu, when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
<br />
* We start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file 'Parameters.h', we first declare our parameter and its type.<br />
<br />
* Add in the section: 'enum ParamEnums' your new parameter. In our case we will add the parameter : PAR_LOOP<br />
<br />
* You have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
example: <br />
enum ParamEnums ...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
--<br />
<br />
Now, let's go the the menu text, we want that our knob display a name 'FILTER' or in our case 'RANDOM' .. well we will set it to 'RND' to make it short on the LCD screen.<br />
<br />
We need to open the menu.c file.<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
Again, place your parameter at a special place, right after the section:<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
/*PAR_RND_VOICE1*/ DTYPE_ON_OFF, // choose the type of your parameter, a definition of the parameter type is shown right after....<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
....<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
<br />
oki, once this done, we need to fill other infformation in the code<br />
<br />
Open the* menuPages.h<br />
<br />
/** This array hold the whole menu structure.<br />
each voice has different pages. The pages hold the top and bottom enums to indicate which values and desriptors to show<br />
*/<br />
<br />
in the section: <br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
....<br />
add your MENU ! <br />
<br />
in our case: we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
<br />
so we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
},<br />
<br />
<br />
you will noticed two parameters:<br />
TEXT_RND_VOICE and PAR_RND_VOICE1<br />
<br />
those parameter are important as the program will display on the LCD the menu names that appears in this section, so if we want to show a new menu or function, we need to add it in this section/file.<br />
<br />
but we need now to declare the TEXT_RND_VOICE1 and PAR_RND_VOICE1 in other files :-)<br />
<br />
Open file menu.h<br />
go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
add at the end, the text 'TEXT_RND_VOICE1" : <br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
TEXT_RND_VOICE, // rstephane: random text <br />
NUM_NAMES<br />
};<br />
<br />
+<br />
<br />
Open Cc2Text.c<br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
Now,<br />
Open the menu.c file<br />
go to section valueNames:<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_RND, CAT_OSC, LONG_RND_VOICE}, // rstephane: TEXT_RND_VOICE<br />
};<br />
<br />
we declare it at the end of the section :-)<br />
<br />
now, open the * MenuText.h file to declare the short and long version of the TEXT (TEXT_RND_VOICE1)<br />
go to section<br />
<br />
const char longNames[][16] PROGMEM = <br />
et const char shortNames[][4] PROGMEM = <br />
<br />
add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"RND"}, // rstephane: RND VOice<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Random"}, // rstephane: RND VOice LONG text<br />
};<br />
<br />
<br />
Now, we will create our function<br />
and will add a link between this function and our knob.<br />
<br />
If you want you can already compile and see the results under the menu OSC of the VOICE1, normally right after COARSE, FINE, WAV, should appear RND.<br />
<br />
<br />
/////<br />
<br />
call the function relative to the encoder:<br />
<br />
open midimessage.h<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=231How to create and add a new function to the LXR2014-05-09T15:33:09Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
* GOAL, we will implement a function that change the length of all the tracks at once. A sort of loop/divide (like on the arturia spark machine). We will add a special knob in the PERF menu, when this knob is turned, the length of the tracks changes from 1 to 16 making the whole pattern ROLL :-)<br />
<br />
- We start by adding a new knob 'LEN' (for Length) in the PERF menu on the LCD display.<br />
<br />
* Open the file 'Parameters.h', we first declare our parameter and its type.<br />
<br />
add in the section: 'enum ParamEnums' ... your new parameter. In our case we wil add the parameter : PAR_LOOP<br />
<br />
you have to add all the new parameters right after a dedicated section in the code declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
enum ParamEnums ...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR LOOP FUNCTION<br />
PAR_LOOP, <br />
--<br />
<br />
Now, let's go the the menu text, we want that our knob display a name 'FILTER' or in our case 'RANDOM' .. well we will set it to 'RND' to make it short on the LCD screen.<br />
<br />
We need to open the menu.c file.<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
Again, place your parameter at a special place, right after the section:<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
/*PAR_RND_VOICE1*/ DTYPE_ON_OFF, // choose the type of your parameter, a definition of the parameter type is shown right after....<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
....<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
<br />
oki, once this done, we need to fill other infformation in the code<br />
<br />
Open the* menuPages.h<br />
<br />
/** This array hold the whole menu structure.<br />
each voice has different pages. The pages hold the top and bottom enums to indicate which values and desriptors to show<br />
*/<br />
<br />
in the section: <br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
....<br />
add your MENU ! <br />
<br />
in our case: we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
<br />
so we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
},<br />
<br />
<br />
you will noticed two parameters:<br />
TEXT_RND_VOICE and PAR_RND_VOICE1<br />
<br />
those parameter are important as the program will display on the LCD the menu names that appears in this section, so if we want to show a new menu or function, we need to add it in this section/file.<br />
<br />
but we need now to declare the TEXT_RND_VOICE1 and PAR_RND_VOICE1 in other files :-)<br />
<br />
Open file menu.h<br />
go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
add at the end, the text 'TEXT_RND_VOICE1" : <br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
TEXT_RND_VOICE, // rstephane: random text <br />
NUM_NAMES<br />
};<br />
<br />
+<br />
<br />
Open Cc2Text.c<br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
Now,<br />
Open the menu.c file<br />
go to section valueNames:<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_RND, CAT_OSC, LONG_RND_VOICE}, // rstephane: TEXT_RND_VOICE<br />
};<br />
<br />
we declare it at the end of the section :-)<br />
<br />
now, open the * MenuText.h file to declare the short and long version of the TEXT (TEXT_RND_VOICE1)<br />
go to section<br />
<br />
const char longNames[][16] PROGMEM = <br />
et const char shortNames[][4] PROGMEM = <br />
<br />
add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"RND"}, // rstephane: RND VOice<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Random"}, // rstephane: RND VOice LONG text<br />
};<br />
<br />
<br />
Now, we will create our function<br />
and will add a link between this function and our knob.<br />
<br />
If you want you can already compile and see the results under the menu OSC of the VOICE1, normally right after COARSE, FINE, WAV, should appear RND.<br />
<br />
<br />
/////<br />
<br />
call the function relative to the encoder:<br />
<br />
open midimessage.h<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=230How to create and add a new function to the LXR2014-05-09T14:51:17Z<p>Rstephane: </p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
We start with the LCD display menu part<br />
<br />
- we first declare our parameter and its type.<br />
<br />
open the file 'Parameters.h'<br />
<br />
add in the section: 'enum ParamEnums' ... your new parameter<br />
<br />
for instance, in our case we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
so we open the 'parameters.h' file and in the section 'enum ParamEnums', we add: 'PAR_RND_VOICE1,' <br />
<br />
you have to add all the new parameters right after the following declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
enum ParamEnums ...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
PAR_RND_VOICE1, // rstephane: randomize drum1 / voice 1<br />
<br />
//#########################################<br />
//######## End of sound Parameters ########<br />
//#########################################<br />
<br />
//all parameters in this section are only there to be referenced from the menu<br />
//they are not saved anywhere<br />
END_OF_SOUND_PARAMETERS,<br />
//the parameter declaration continues but don't changed it, don't add your parameters below... etc.<br />
....<br />
<br />
--<br />
<br />
Now, let's go the the menu text, we want that our knob display a name 'FILTER' or in our case 'RANDOM' .. well we will set it to 'RND' to make it short on the LCD screen.<br />
<br />
We need to open the menu.c file.<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
Again, place your parameter at a special place, right after the section:<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
/*PAR_RND_VOICE1*/ DTYPE_ON_OFF, // choose the type of your parameter, a definition of the parameter type is shown right after....<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
....<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
<br />
oki, once this done, we need to fill other infformation in the code<br />
<br />
Open the* menuPages.h<br />
<br />
/** This array hold the whole menu structure.<br />
each voice has different pages. The pages hold the top and bottom enums to indicate which values and desriptors to show<br />
*/<br />
<br />
in the section: <br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
....<br />
add your MENU ! <br />
<br />
in our case: we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
<br />
so we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
},<br />
<br />
<br />
you will noticed two parameters:<br />
TEXT_RND_VOICE and PAR_RND_VOICE1<br />
<br />
those parameter are important as the program will display on the LCD the menu names that appears in this section, so if we want to show a new menu or function, we need to add it in this section/file.<br />
<br />
but we need now to declare the TEXT_RND_VOICE1 and PAR_RND_VOICE1 in other files :-)<br />
<br />
Open file menu.h<br />
go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
add at the end, the text 'TEXT_RND_VOICE1" : <br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
TEXT_RND_VOICE, // rstephane: random text <br />
NUM_NAMES<br />
};<br />
<br />
+<br />
<br />
Open Cc2Text.c<br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
Now,<br />
Open the menu.c file<br />
go to section valueNames:<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_RND, CAT_OSC, LONG_RND_VOICE}, // rstephane: TEXT_RND_VOICE<br />
};<br />
<br />
we declare it at the end of the section :-)<br />
<br />
now, open the * MenuText.h file to declare the short and long version of the TEXT (TEXT_RND_VOICE1)<br />
go to section<br />
<br />
const char longNames[][16] PROGMEM = <br />
et const char shortNames[][4] PROGMEM = <br />
<br />
add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"RND"}, // rstephane: RND VOice<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Random"}, // rstephane: RND VOice LONG text<br />
};<br />
<br />
<br />
Now, we will create our function<br />
and will add a link between this function and our knob.<br />
<br />
If you want you can already compile and see the results under the menu OSC of the VOICE1, normally right after COARSE, FINE, WAV, should appear RND.<br />
<br />
<br />
/////<br />
<br />
call the function relative to the encoder:<br />
<br />
open midimessage.h<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=How_to_create_and_add_a_new_function_to_the_LXR&diff=222How to create and add a new function to the LXR2014-05-08T21:56:54Z<p>Rstephane: Created page with "This is a DRAFT !!!! I will correct it during the next days :-) We start with the LCD display menu part - we first declare our parameter and its type. open the file 'Parame..."</p>
<hr />
<div>This is a DRAFT !!!! I will correct it during the next days :-)<br />
<br />
We start with the LCD display menu part<br />
<br />
- we first declare our parameter and its type.<br />
<br />
open the file 'Parameters.h'<br />
<br />
add in the section: 'enum ParamEnums' ... your new parameter<br />
<br />
for instance, in our case we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
so we open the 'parameters.h' file and in the section 'enum ParamEnums', we add: 'PAR_RND_VOICE1,' <br />
<br />
you have to add all the new parameters right after the following declaration (otherwise you want link later the knob with the function you want to execute):<br />
<br />
enum ParamEnums ...<br />
PAR_MIDI_NOTE1,<br />
PAR_MIDI_NOTE2,<br />
PAR_MIDI_NOTE3,<br />
PAR_MIDI_NOTE4,<br />
PAR_MIDI_NOTE5,<br />
PAR_MIDI_NOTE6,<br />
PAR_MIDI_NOTE7,<br />
// YOUR parameters comes right after thoses lines...<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
PAR_RND_VOICE1, // rstephane: randomize drum1 / voice 1<br />
<br />
//#########################################<br />
//######## End of sound Parameters ########<br />
//#########################################<br />
<br />
//all parameters in this section are only there to be referenced from the menu<br />
//they are not saved anywhere<br />
END_OF_SOUND_PARAMETERS,<br />
//the parameter declaration continues but don't changed it, don't add your parameters below... etc.<br />
....<br />
<br />
--<br />
<br />
Now, let's go the the menu text, we want that our knob display a name 'FILTER' or in our case 'RANDOM' .. well we will set it to 'RND' to make it short on the LCD screen.<br />
<br />
We need to open the menu.c file.<br />
<br />
menu.c<br />
//---------------------------------------------------------------<br />
// Parameter types. These correspond with ParamEnums and entries in parameter_values<br />
const enum Datatypes PROGMEM parameter_dtypes[NUM_PARAMS] = {<br />
/*PAR_NONE*/ DTYPE_0B127, // 0<br />
/*PAR_OSC_WAVE_DRUM1*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM2*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_DRUM3*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
/*PAR_OSC_WAVE_SNARE*/ DTYPE_MENU | (MENU_WAVEFORM<<4),<br />
....<br />
<br />
Again, place your parameter at a special place, right after the section:<br />
/*PAR_MIDI_NOTE1*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE2*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE3*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE4*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE5*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE6*/ DTYPE_NOTE_NAME,<br />
/*PAR_MIDI_NOTE7*/ DTYPE_NOTE_NAME,<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
/*PAR_RND_VOICE1*/ DTYPE_ON_OFF, // choose the type of your parameter, a definition of the parameter type is shown right after....<br />
<br />
/*PAR_ROLL*/ DTYPE_MENU | (MENU_ROLL_RATES<<4),<br />
/*PAR_MORPH*/ DTYPE_0B255,<br />
....<br />
<br />
Type of parameters:<br />
//-----------------------------------------------------------------<br />
enum Datatypes<br />
{<br />
DTYPE_0B255, //0:255<br />
DTYPE_0B127, //0-127<br />
DTYPE_PM100, //-100:100<br />
DTYPE_MENU, //text type outputs <br />
DTYPE_PM63, //-63 <-> 63<br />
DTYPE_1B16, //1-16<br />
DTYPE_ON_OFF, //0-1<br />
DTYPE_MIX_FM, //0-1<br />
DTYPE_TARGET_SELECTION_LFO,<br />
DTYPE_TARGET_SELECTION_VELO, <br />
DTYPE_VOICE_LFO,<br />
DTYPE_AUTOM_TARGET,<br />
DTYPE_0b1,<br />
DTYPE_NOTE_NAME, // --AS eg C#0, D 1 for note name<br />
DTYPE_0B15, //0-15<br />
/*15*/<br />
/*16*/<br />
// --AS warning, we can only have 16 on this list the way things are laid out<br />
};<br />
<br />
<br />
oki, once this done, we need to fill other infformation in the code<br />
<br />
Open the* menuPages.h<br />
<br />
/** This array hold the whole menu structure.<br />
each voice has different pages. The pages hold the top and bottom enums to indicate which values and desriptors to show<br />
*/<br />
<br />
in the section: <br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
....<br />
add your MENU ! <br />
<br />
in our case: we want to create an random knob for its voice. this new button/parameter will appear when we have selected the 'OSC' menu<br />
<br />
so we have:<br />
<br />
const Page menuPages[NUM_PAGES][NUM_SUB_PAGES] PROGMEM =<br />
{<br />
//page 1 - Voice 1<br />
{<br />
//sub page 1 - Oscillator<br />
{<br />
TEXT_COARSE, TEXT_FINE, TEXT_WAVEFORM, TEXT_RND_VOICE,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,TEXT_EMPTY,<br />
PAR_COARSE1, PAR_FINE1, PAR_OSC_WAVE_DRUM1, PAR_RND_VOICE1,PAR_NONE,PAR_NONE,PAR_NONE,PAR_NONE<br />
},<br />
<br />
<br />
you will noticed two parameters:<br />
TEXT_RND_VOICE and PAR_RND_VOICE1<br />
<br />
those parameter are important as the program will display on the LCD the menu names that appears in this section, so if we want to show a new menu or function, we need to add it in this section/file.<br />
<br />
but we need now to declare the TEXT_RND_VOICE1 and PAR_RND_VOICE1 in other files :-)<br />
<br />
Open file menu.h<br />
go to section <br />
<br />
enum NamesEnum<br />
{<br />
TEXT_EMPTY = 0, //0<br />
TEXT_COARSE,<br />
TEXT_FINE,<br />
TEXT_ATTACK,<br />
TEXT_DECAY,<br />
TEXT_PITCH_DECAY,<br />
TEXT_MOD_AMOUNT, <br />
....<br />
<br />
add at the end, the text 'TEXT_RND_VOICE1" : <br />
....<br />
TEXT_BAR_RESET_MODE,<br />
TEXT_MIDI_CHAN_GLOBAL,<br />
TEXT_RND_VOICE, // rstephane: random text <br />
NUM_NAMES<br />
};<br />
<br />
+<br />
<br />
Open CcNr2Text.c<br />
<br />
//Voice 1 - Drum 1<br />
// 1 Oscillator<br />
{TEXT_COARSE, PAR_COARSE1}, //2<br />
{TEXT_FINE, PAR_FINE1},<br />
{TEXT_WAVEFORM, PAR_OSC_WAVE_DRUM1},<br />
{TEXT_RND_VOICE, PAR_RND_VOICE1}, // rstephane : added random button <br />
<br />
Now,<br />
Open the menu.c file<br />
go to section valueNames:<br />
<br />
const Name valueNames[NUM_NAMES] PROGMEM =<br />
{<br />
{SHORT_EMPTY,CAT_EMPTY,LONG_EMPTY},<br />
....<br />
add the following information:<br />
....<br />
{SHORT_BAR_RESET_MODE, CAT_SEQUENCER, LONG_BAR_RESET_MODE}, // TEXT_BAR_RESET_MODE<br />
{SHORT_CHANNEL, CAT_MIDI, LONG_MIDI_CHANNEL}, // TEXT_MIDI_CHAN_GLOBAL<br />
{SHORT_RND, CAT_OSC, LONG_RND_VOICE}, // rstephane: TEXT_RND_VOICE<br />
};<br />
<br />
we declare it at the end of the section :-)<br />
<br />
now, open the * MenuText.h file to declare the short and long version of the TEXT (TEXT_RND_VOICE1)<br />
go to section<br />
<br />
const char longNames[][16] PROGMEM = <br />
et const char shortNames[][4] PROGMEM = <br />
<br />
add the parameters:<br />
<br />
const char shortNames[][4] PROGMEM = <br />
{<br />
{""},<br />
{"coa"},<br />
{"fin"},<br />
{"atk"},<br />
{"dec"},<br />
{"eg2"},<br />
....<br />
<br />
{"co2"}, // trigger clock out2 ppq<br />
{"pcr"}, // pattern change resets bar counter<br />
{"RND"}, // rstephane: RND VOice<br />
<br />
}; <br />
<br />
const char longNames[][16] PROGMEM = <br />
{<br />
{""},<br />
//01234567<br />
{"Coarse"},<br />
{"Fine"},<br />
{"Attack"},<br />
{"Decay"},<br />
{"Amount"},<br />
....<br />
{"Out2 PPQ"},<br />
{"Gate Mode"},<br />
{"PCReset" }, // reset bar counter on manual pattern change<br />
{"Random"}, // rstephane: RND VOice LONG text<br />
};<br />
<br />
<br />
Now, we will create our function<br />
and will add a link between this function and our knob.<br />
<br />
If you want you can already compile and see the results under the menu OSC of the VOICE1, normally right after COARSE, FINE, WAV, should appear RND.<br />
<br />
<br />
/////<br />
<br />
call the function relative to the encoder:<br />
<br />
open midimessage.h<br />
<br />
<br />
//for all parameters above 127 <- our case<br />
enum<br />
{<br />
....<br />
// Again, place your parameter at a special place, right after the section:<br />
CC2_MIDI_NOTE1,<br />
CC2_MIDI_NOTE2,<br />
CC2_MIDI_NOTE3,<br />
CC2_MIDI_NOTE4,<br />
CC2_MIDI_NOTE5,<br />
CC2_MIDI_NOTE6,<br />
CC2_MIDI_NOTE7, // s/b 111 i think<br />
<br />
// YOUR PARAMETER comes right here and not elsewhere!!!!!<br />
// rstephane MY VALUES ADDED FOR RANDOM FUNCTION<br />
// rstephane : RND button :-) for CASE switch in MidiParser.C<br />
CC2_RND_VOICE1,<br />
....<br />
}Param2Enums;<br />
<br />
open <br />
* MidiParser.c<br />
//-----------------------------------------------------------<br />
/** handle all incoming CCs and invoke action*/<br />
void midiParser_ccHandler(MidiMsg msg, uint8_t updateOriginalValue)<br />
{<br />
<br />
...<br />
<br />
else //MIDI_CC2<br />
{<br />
const uint16_t paramNr = msg.data1+1 + 127;<br />
<br />
if(updateOriginalValue) {<br />
midiParser_originalCcValues[paramNr] = msg.data2;<br />
}<br />
switch(msg.data1)<br />
{<br />
<br />
case CC2_TRANS1_WAVE:<br />
voiceArray[0].transGen.waveform = msg.data2;<br />
break;<br />
<br />
case CC2_TRANS1_VOL:<br />
voiceArray[0].transGen.volume = msg.data2/127.f;<br />
break;<br />
<br />
...<br />
case CC2_MUTE_1:<br />
case CC2_MUTE_2:<br />
case CC2_MUTE_3:<br />
case CC2_MUTE_4:<br />
case CC2_MUTE_5:<br />
case CC2_MUTE_6:<br />
case CC2_MUTE_7:<br />
{<br />
const uint8_t voiceNr = msg.data1 - CC2_MUTE_1;<br />
if(msg.data2 == 0)<br />
{<br />
seq_setMute(voiceNr,0);<br />
}<br />
else<br />
{<br />
seq_setMute(voiceNr,1);<br />
}<br />
<br />
}<br />
break;<br />
// rstephane MY FUNCTIONS<br />
// rstephane : Handle the RND button<br />
case CC2_RND_VOICE1:<br />
if(msg.data2 == 1)<br />
{<br />
// RND is ON<br />
randomDrumVoice123(0); //voice1 = 0, voice2 = 1 etc...<br />
}<br />
break; <br />
<br />
default:<br />
break;<br />
<br />
....<br />
<br />
<br />
+ <br />
open drumvoice.h<br />
<br />
<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
void randomDrumVoice123(const uint8_t voiceNr); <br />
<br />
<br />
<br />
+<br />
open drumvoice.c<br />
<br />
<br />
// rstephane : pour random functions<br />
#include "valueShaper.h"<br />
<br />
+<br />
<br />
//---------------------------------------------------<br />
// rstephane : my functions<br />
//random all the parameters for voice 1 2 and 3<br />
//---------------------------------------------------<br />
void randomDrumVoice123(const uint8_t voiceNr)<br />
{<br />
uint8_t rndData; // , new_min, new_max;<br />
// uint32_t rndDataTemp, old_min, old_max;<br />
// COARSE<br />
rndData = (uint8_t) GetRngValue();<br />
//clear upper nibble<br />
voiceArray[voiceNr].osc.midiFreq &= 0x00ff;<br />
//set upper nibble<br />
voiceArray[voiceNr].osc.midiFreq |= rndData << 8;<br />
osc_recalcFreq(&voiceArray[voiceNr].osc);<br />
//OSC1_DIST:<br />
rndData = (uint8_t) GetRngValue();<br />
#if USE_FILTER_DRIVE<br />
voiceArray[voiceNr].filter.drive = 0.5f + (rndData/127.f) *6;<br />
#else<br />
setDistortionShape(&voiceArray[voiceNr].distortion,rndData);<br />
#endif <br />
<br />
}</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=Main_Page&diff=221Main Page2014-05-08T21:50:00Z<p>Rstephane: /* Users contributions */</p>
<hr />
<div>Welcome to the Sonic Potions Wiki.<br />
<br />
== LXR ==<br />
===Manual===<br />
* [[LXR Owners Manual]]<br />
<br />
===Sourcing parts===<br />
* [[BOMs for LXR projects]]<br />
<br />
===Firmware updates===<br />
* [[Updating the firmware]]<br />
* [[Changelog]]<br />
<br />
=== Troubleshooting ===<br />
* [[LXR Troubleshooting]]<br />
<br />
=== Design Files ===<br />
* [[Enclosure SVG]]<br />
<br />
=== Building the firmware from source ===<br />
* [[LXR Linux build instructions]]<br />
* [[LXR Windows build instructions]]<br />
* [[LXR OSX build instructions]]<br />
<br />
=== Users contributions ===<br />
* [[Demos]]<br />
* [[Compilations]]<br />
* [[How to create and add a new function to the LXR ]]<br />
<br />
== Wiki help ==<br />
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=LXR_OSX_build_instructions&diff=215LXR OSX build instructions2014-05-07T17:27:38Z<p>Rstephane: /* Compile */</p>
<hr />
<div><br />
Tested on 10.8.x and 10.9.2; likely needs Xcode installed also (https://developer.apple.com/xcode/downloads/)<br />
<br />
== General steps == <br />
The LXR code is divided into two mains code parts that we will compile "separately" using two different tools<br />
*the AVR Atmel CODE (LCD, front panel control, USB, SD card)<br />
*the ARM CODE (main LXR code for the voices / sounds)<br />
<br />
- We need "specific compilers and librairies" for each CODE. We need to change the PATH in your .bash_profile, we need MAKEFILES to build the firmware, and, finally, we will compile the code :)<br />
<br />
Let's do it! <br />
<br />
== AVR COMPILER & LIBS == <br />
* Download of Atmel AVR 8-bit toolchain from http://www.obdev.at/products/crosspack/download.html<br />
* You will get a .dmg file that you should extract and install (CrossPack-AVR-20131216.dmg is the most recent as of 2015/05/02)<br />
* The compiler and libs are installed under /usr/local/CrossPack-AVR-20131216/<br />
* Note that you will also find a folder like /usr/local/CrossPack-AVR/ (this folder is an alias to the previous folder - symlink).<br />
<br />
== GNU ARM COMPILER AND LIBS == <br />
* Download of GNU bare metal ARM toolchain from https://launchpad.net/gcc-arm-embedded (v4.8)<br />
* Take the MAC version (something like : gcc-arm-none-eabi-4_8-2014q1-20140314-mac.tar.bz2 )<br />
* Extract the compressed/tar file.<br />
* Copy the extracted folder under /usr/local/<br />
* Nothing else to do !<br />
<br />
== Change your PATH == <br />
* We need to add a specific PATH for both compilers (and libs) for the MAC. Here is mine...<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* in a terminal window, execute "source ./.bash_profile" to update the PATH to your system.<br />
* for the moment, don't try to understand what are ARM_TOOLKIT / AVR_TOLLKIT variables, we will explain why we need this later.<br />
<br />
== Grab the LXR Code == <br />
We advice you to grab the code either from :<br />
<br />
Julian repository on GITHUB (https://github.com/SonicPotions/LXR)<br />
PLD repository (https://github.com/patrickdowling/LXR)<br />
rudeog repository (https://github.com/rudeog/LXR) -> extra features compared to Julian code.<br />
rstephane repository (https://github.com/rstephane/LXR) -> equivalent to Julian CODE. <br />
<br />
- of course once downloaded, you should extract the code and copy it to any folder you like.<br />
On our side we copied it under: /Users/music/Documents/workspace/LXR/<br />
<br />
== MACOS specific makefiles == <br />
We advice you to grab the makefiles either from :<br />
<br />
PLD repository (https://github.com/patrickdowling/LXR) <br />
rstephane (@egnouf) repository (https://github.com/rstephane/LXR)<br />
RUDEOG repository https://github.com/patrickdowling/LXR<br />
<br />
- You will find on the root path of both repository a file called MAKEFILE. You will also need the other makefiles:<br />
<br />
https://github.com/patrickdowling/LXR/blob/makefiles/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/front/AVR/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/mainboard/firmware/DrumSynth_FPU/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/tools/FirmwareImageBuilder/Makefile<br />
<br />
* Once downloaded, copy them at the root PATH of the code (1) and in subfolders (2,3,4) you dowloaded in STEP 4.<br />
* '''If you have taken the whole LXR code from @PLD or rstephane or @RUDEOG you don't need to download once more the Makefiles, they are provided within !'''<br />
<br />
Now, let's go back to the .bash_profile file:<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* You can notice the two variables '''ARM_TOOLKIT_ROOT''' and '''AVR_TOOLKIT_ROOT'''.<br />
* They are used by the MAKEFILE that has created @PLD (and also used by rstephane).<br />
* Change their values appropriately, according to your system path, where you installed the libs... etc.<br />
<br />
== Compile == <br />
<br />
* Open a terminal window, go under your LXR code root path i.e cd /Users/music/Documents/workspace/LXR/<br />
* Launch the command "make firmware" from a MAC terminal window. To clean the "code" you can execute "make clean".<br />
* You will get a FIRMWARE.BIN image (in fact, we compiled two programs and the makefile combine both to one single file !), copy this file on your SD CARD and follow instruction to upload your new firmware.<br />
<br />
If you have downloaded rstephane code, similar to @Julian and @PLD, you will noticed that when you power on the machine, it displays "LXR-Drums-V" instead of "LXR Drums V". If so, you have successfully loaded (and compiled) LXR CODE!!!!<br />
<br />
Well done and happy hacking!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=LXR_OSX_build_instructions&diff=214LXR OSX build instructions2014-05-07T17:27:22Z<p>Rstephane: /* Compile */</p>
<hr />
<div><br />
Tested on 10.8.x and 10.9.2; likely needs Xcode installed also (https://developer.apple.com/xcode/downloads/)<br />
<br />
== General steps == <br />
The LXR code is divided into two mains code parts that we will compile "separately" using two different tools<br />
*the AVR Atmel CODE (LCD, front panel control, USB, SD card)<br />
*the ARM CODE (main LXR code for the voices / sounds)<br />
<br />
- We need "specific compilers and librairies" for each CODE. We need to change the PATH in your .bash_profile, we need MAKEFILES to build the firmware, and, finally, we will compile the code :)<br />
<br />
Let's do it! <br />
<br />
== AVR COMPILER & LIBS == <br />
* Download of Atmel AVR 8-bit toolchain from http://www.obdev.at/products/crosspack/download.html<br />
* You will get a .dmg file that you should extract and install (CrossPack-AVR-20131216.dmg is the most recent as of 2015/05/02)<br />
* The compiler and libs are installed under /usr/local/CrossPack-AVR-20131216/<br />
* Note that you will also find a folder like /usr/local/CrossPack-AVR/ (this folder is an alias to the previous folder - symlink).<br />
<br />
== GNU ARM COMPILER AND LIBS == <br />
* Download of GNU bare metal ARM toolchain from https://launchpad.net/gcc-arm-embedded (v4.8)<br />
* Take the MAC version (something like : gcc-arm-none-eabi-4_8-2014q1-20140314-mac.tar.bz2 )<br />
* Extract the compressed/tar file.<br />
* Copy the extracted folder under /usr/local/<br />
* Nothing else to do !<br />
<br />
== Change your PATH == <br />
* We need to add a specific PATH for both compilers (and libs) for the MAC. Here is mine...<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* in a terminal window, execute "source ./.bash_profile" to update the PATH to your system.<br />
* for the moment, don't try to understand what are ARM_TOOLKIT / AVR_TOLLKIT variables, we will explain why we need this later.<br />
<br />
== Grab the LXR Code == <br />
We advice you to grab the code either from :<br />
<br />
Julian repository on GITHUB (https://github.com/SonicPotions/LXR)<br />
PLD repository (https://github.com/patrickdowling/LXR)<br />
rudeog repository (https://github.com/rudeog/LXR) -> extra features compared to Julian code.<br />
rstephane repository (https://github.com/rstephane/LXR) -> equivalent to Julian CODE. <br />
<br />
- of course once downloaded, you should extract the code and copy it to any folder you like.<br />
On our side we copied it under: /Users/music/Documents/workspace/LXR/<br />
<br />
== MACOS specific makefiles == <br />
We advice you to grab the makefiles either from :<br />
<br />
PLD repository (https://github.com/patrickdowling/LXR) <br />
rstephane (@egnouf) repository (https://github.com/rstephane/LXR)<br />
RUDEOG repository https://github.com/patrickdowling/LXR<br />
<br />
- You will find on the root path of both repository a file called MAKEFILE. You will also need the other makefiles:<br />
<br />
https://github.com/patrickdowling/LXR/blob/makefiles/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/front/AVR/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/mainboard/firmware/DrumSynth_FPU/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/tools/FirmwareImageBuilder/Makefile<br />
<br />
* Once downloaded, copy them at the root PATH of the code (1) and in subfolders (2,3,4) you dowloaded in STEP 4.<br />
* '''If you have taken the whole LXR code from @PLD or rstephane or @RUDEOG you don't need to download once more the Makefiles, they are provided within !'''<br />
<br />
Now, let's go back to the .bash_profile file:<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* You can notice the two variables '''ARM_TOOLKIT_ROOT''' and '''AVR_TOOLKIT_ROOT'''.<br />
* They are used by the MAKEFILE that has created @PLD (and also used by rstephane).<br />
* Change their values appropriately, according to your system path, where you installed the libs... etc.<br />
<br />
== Compile == <br />
<br />
* Open a terminal window, go under your LXR code root path i.e cd /Users/music/Documents/workspace/LXR/)<br />
* Launch the command "make firmware" from a MAC terminal window. To clean the "code" you can execute "make clean".<br />
* You will get a FIRMWARE.BIN image (in fact, we compiled two programs and the makefile combine both to one single file !), copy this file on your SD CARD and follow instruction to upload your new firmware.<br />
<br />
If you have downloaded rstephane code, similar to @Julian and @PLD, you will noticed that when you power on the machine, it displays "LXR-Drums-V" instead of "LXR Drums V". If so, you have successfully loaded (and compiled) LXR CODE!!!!<br />
<br />
Well done and happy hacking!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=LXR_OSX_build_instructions&diff=213LXR OSX build instructions2014-05-07T17:25:58Z<p>Rstephane: /* Compile */</p>
<hr />
<div><br />
Tested on 10.8.x and 10.9.2; likely needs Xcode installed also (https://developer.apple.com/xcode/downloads/)<br />
<br />
== General steps == <br />
The LXR code is divided into two mains code parts that we will compile "separately" using two different tools<br />
*the AVR Atmel CODE (LCD, front panel control, USB, SD card)<br />
*the ARM CODE (main LXR code for the voices / sounds)<br />
<br />
- We need "specific compilers and librairies" for each CODE. We need to change the PATH in your .bash_profile, we need MAKEFILES to build the firmware, and, finally, we will compile the code :)<br />
<br />
Let's do it! <br />
<br />
== AVR COMPILER & LIBS == <br />
* Download of Atmel AVR 8-bit toolchain from http://www.obdev.at/products/crosspack/download.html<br />
* You will get a .dmg file that you should extract and install (CrossPack-AVR-20131216.dmg is the most recent as of 2015/05/02)<br />
* The compiler and libs are installed under /usr/local/CrossPack-AVR-20131216/<br />
* Note that you will also find a folder like /usr/local/CrossPack-AVR/ (this folder is an alias to the previous folder - symlink).<br />
<br />
== GNU ARM COMPILER AND LIBS == <br />
* Download of GNU bare metal ARM toolchain from https://launchpad.net/gcc-arm-embedded (v4.8)<br />
* Take the MAC version (something like : gcc-arm-none-eabi-4_8-2014q1-20140314-mac.tar.bz2 )<br />
* Extract the compressed/tar file.<br />
* Copy the extracted folder under /usr/local/<br />
* Nothing else to do !<br />
<br />
== Change your PATH == <br />
* We need to add a specific PATH for both compilers (and libs) for the MAC. Here is mine...<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* in a terminal window, execute "source ./.bash_profile" to update the PATH to your system.<br />
* for the moment, don't try to understand what are ARM_TOOLKIT / AVR_TOLLKIT variables, we will explain why we need this later.<br />
<br />
== Grab the LXR Code == <br />
We advice you to grab the code either from :<br />
<br />
Julian repository on GITHUB (https://github.com/SonicPotions/LXR)<br />
PLD repository (https://github.com/patrickdowling/LXR)<br />
rudeog repository (https://github.com/rudeog/LXR) -> extra features compared to Julian code.<br />
rstephane repository (https://github.com/rstephane/LXR) -> equivalent to Julian CODE. <br />
<br />
- of course once downloaded, you should extract the code and copy it to any folder you like.<br />
On our side we copied it under: /Users/music/Documents/workspace/LXR/<br />
<br />
== MACOS specific makefiles == <br />
We advice you to grab the makefiles either from :<br />
<br />
PLD repository (https://github.com/patrickdowling/LXR) <br />
rstephane (@egnouf) repository (https://github.com/rstephane/LXR)<br />
RUDEOG repository https://github.com/patrickdowling/LXR<br />
<br />
- You will find on the root path of both repository a file called MAKEFILE. You will also need the other makefiles:<br />
<br />
https://github.com/patrickdowling/LXR/blob/makefiles/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/front/AVR/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/mainboard/firmware/DrumSynth_FPU/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/tools/FirmwareImageBuilder/Makefile<br />
<br />
* Once downloaded, copy them at the root PATH of the code (1) and in subfolders (2,3,4) you dowloaded in STEP 4.<br />
* '''If you have taken the whole LXR code from @PLD or rstephane or @RUDEOG you don't need to download once more the Makefiles, they are provided within !'''<br />
<br />
Now, let's go back to the .bash_profile file:<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* You can notice the two variables '''ARM_TOOLKIT_ROOT''' and '''AVR_TOOLKIT_ROOT'''.<br />
* They are used by the MAKEFILE that has created @PLD (and also used by rstephane).<br />
* Change their values appropriately, according to your system path, where you installed the libs... etc.<br />
<br />
== Compile == <br />
<br />
* You just have to launch the command "make firmware" from a MAC terminal window (under your LXR code root path i.e /Users/music/Documents/workspace/LXR/)<br />
). To clean the code you can execute "make clean".<br />
* You will get a FIRMWARE.BIN image (in fact, we compiled two programs and the makefile combine both to one single file !), copy this file on your SD CARD and follow instruction to upload your new firmware.<br />
<br />
If you have downloaded rstephane code, similar to @Julian and @PLD, you will noticed that when you power on the machine, it displays "LXR-Drums-V" instead of "LXR Drums V". If so, you have successfully loaded (and compiled) LXR CODE!!!!<br />
<br />
Well done and happy hacking!</div>Rstephanehttp://wiki.sonic-potions.com/index.php?title=LXR_OSX_build_instructions&diff=212LXR OSX build instructions2014-05-07T17:23:36Z<p>Rstephane: </p>
<hr />
<div><br />
Tested on 10.8.x and 10.9.2; likely needs Xcode installed also (https://developer.apple.com/xcode/downloads/)<br />
<br />
== General steps == <br />
The LXR code is divided into two mains code parts that we will compile "separately" using two different tools<br />
*the AVR Atmel CODE (LCD, front panel control, USB, SD card)<br />
*the ARM CODE (main LXR code for the voices / sounds)<br />
<br />
- We need "specific compilers and librairies" for each CODE. We need to change the PATH in your .bash_profile, we need MAKEFILES to build the firmware, and, finally, we will compile the code :)<br />
<br />
Let's do it! <br />
<br />
== AVR COMPILER & LIBS == <br />
* Download of Atmel AVR 8-bit toolchain from http://www.obdev.at/products/crosspack/download.html<br />
* You will get a .dmg file that you should extract and install (CrossPack-AVR-20131216.dmg is the most recent as of 2015/05/02)<br />
* The compiler and libs are installed under /usr/local/CrossPack-AVR-20131216/<br />
* Note that you will also find a folder like /usr/local/CrossPack-AVR/ (this folder is an alias to the previous folder - symlink).<br />
<br />
== GNU ARM COMPILER AND LIBS == <br />
* Download of GNU bare metal ARM toolchain from https://launchpad.net/gcc-arm-embedded (v4.8)<br />
* Take the MAC version (something like : gcc-arm-none-eabi-4_8-2014q1-20140314-mac.tar.bz2 )<br />
* Extract the compressed/tar file.<br />
* Copy the extracted folder under /usr/local/<br />
* Nothing else to do !<br />
<br />
== Change your PATH == <br />
* We need to add a specific PATH for both compilers (and libs) for the MAC. Here is mine...<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* in a terminal window, execute "source ./.bash_profile" to update the PATH to your system.<br />
* for the moment, don't try to understand what are ARM_TOOLKIT / AVR_TOLLKIT variables, we will explain why we need this later.<br />
<br />
== Grab the LXR Code == <br />
We advice you to grab the code either from :<br />
<br />
Julian repository on GITHUB (https://github.com/SonicPotions/LXR)<br />
PLD repository (https://github.com/patrickdowling/LXR)<br />
rudeog repository (https://github.com/rudeog/LXR) -> extra features compared to Julian code.<br />
rstephane repository (https://github.com/rstephane/LXR) -> equivalent to Julian CODE. <br />
<br />
- of course once downloaded, you should extract the code and copy it to any folder you like.<br />
On our side we copied it under: /Users/music/Documents/workspace/LXR/<br />
<br />
== MACOS specific makefiles == <br />
We advice you to grab the makefiles either from :<br />
<br />
PLD repository (https://github.com/patrickdowling/LXR) <br />
rstephane (@egnouf) repository (https://github.com/rstephane/LXR)<br />
RUDEOG repository https://github.com/patrickdowling/LXR<br />
<br />
- You will find on the root path of both repository a file called MAKEFILE. You will also need the other makefiles:<br />
<br />
https://github.com/patrickdowling/LXR/blob/makefiles/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/front/AVR/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/mainboard/firmware/DrumSynth_FPU/Makefile<br />
https://github.com/patrickdowling/LXR/blob/makefiles/tools/FirmwareImageBuilder/Makefile<br />
<br />
* Once downloaded, copy them at the root PATH of the code (1) and in subfolders (2,3,4) you dowloaded in STEP 4.<br />
* '''If you have taken the whole LXR code from @PLD or rstephane or @RUDEOG you don't need to download once more the Makefiles, they are provided within !'''<br />
<br />
Now, let's go back to the .bash_profile file:<br />
<br />
export PATH=$PATH:/usr/local/CrossPack-AVR-20131216/bin:/usr/local/CrossPack-AVR-20131216/:/usr/include:/usr/local/CrossPack-AVR-20131216/avr/include:/usr/local/gcc-arm-none-eabi-4_8-2014q1/bin<br />
export ARM_TOOLKIT_ROOT=/usr/local/gcc-arm-none-eabi-4_8-2014q1<br />
export AVR_TOOLKIT_ROOT=/usr/local/CrossPack-AVR-20131216<br />
<br />
* You can notice the two variables '''ARM_TOOLKIT_ROOT''' and '''AVR_TOOLKIT_ROOT'''.<br />
* They are used by the MAKEFILE that has created @PLD (and also used by rstephane).<br />
* Change their values appropriately, according to your system path, where you installed the libs... etc.<br />
<br />
== Compile == <br />
<br />
* You just have to launch the command "make firmware" from a MAC terminal window. To clean the code you can execute "make clean".<br />
* You will get a FIRMWARE.BIN image (in fact, we compiled two programs and the makefile combine both to one single file !), copy this file on your SD CARD and follow instruction to upload your new firmware.<br />
<br />
If you have downloaded rstephane code, similar to @Julian and @PLD, you will noticed that when you power on the machine, it displays "LXR-Drums-V" instead of "LXR Drums V". If so, you have successfully loaded (and compiled) LXR CODE!!!!<br />
<br />
Well done and happy hacking!</div>Rstephane