Changes

Line 3: Line 3:  
This section contain documentation for some of this controller drivers.
 
This section contain documentation for some of this controller drivers.
   −
{{NoteBox|This documentation is valid for the "chain_manager" development branch. It's only partially valid for the current testing branch so you could find some differences.}}
+
{{NoteBox|This documentation is valid for the "oram" development branch. It's only partially valid for the current testing branch so you could find some differences.}}
    
<br clear=all>
 
<br clear=all>
Line 210: Line 210:  
[[File:akai_mpk_mini_mk3_mixer_mode.png|800px|right]]
 
[[File:akai_mpk_mini_mk3_mixer_mode.png|800px|right]]
   −
This is the default mode, but you can switch back to it with '''PROG CHANGE''':<code>PAD 5</code>. You should see <code>Zynthian MIXER</code> in the display of the MPK. In this mode, you can use the Knobs to adjust chains settings. The general rule is: <code>PAD x</code> + <code>Knob y</code> to adjust the setting '''x''' of chain '''y'''. You can adjust chains 1 to 8 in bank A, and chains 9 to 16 in bank B. The functions that you can change are:
+
This is the default mode, but you can switch back to it with '''PROG CHANGE''':<code>PAD 5 A</code>. You should see <code>Zynthian MIXER</code> in the display of the MPK. In this mode, you can use the Knobs to adjust chains settings. The general rule is: <code>PAD x</code> + <code>Knob y</code> to adjust the setting '''x''' of chain '''y'''. You can adjust chains 1 to 8 in bank A, and chains 9 to 16 in bank B. The functions that you can change are:
    
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
 
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
Line 240: Line 240:  
[[File:akai_mpk_mini_mk3_device_mode.png|800px|right]]
 
[[File:akai_mpk_mini_mk3_device_mode.png|800px|right]]
   −
This mode is used to control Zynthian's GUI. You can activate it by pressing '''PROG CHANGE''':<code>PAD 5</code> anytime. The MPK display will show the label <code>Zynthian DEVICE</code>. In this mode, you have the following options:
+
This mode is used to control Zynthian's GUI. You can activate it by pressing '''PROG CHANGE''':<code>PAD 6 A</code> anytime. The MPK display will show the label <code>Zynthian DEVICE</code>. In this mode, you have the following options:
    
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
 
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
Line 275: Line 275:  
[[File:akai_mpk_mini_mk3_pattern_mode.png|800px|right]]
 
[[File:akai_mpk_mini_mk3_pattern_mode.png|800px|right]]
   −
This mode works only in Zynthian's Zynpad, Arranger or Pattern Editor. To activate it, press '''PROG CHANGE''':<code>PAD 7</code>. You should see <code>Zynthian PATTERN</code> in the display of your MPK. Note that all the following PADs are assumed to be in '''bank A'''.
+
This mode works only in Zynthian's Zynpad, Arranger or Pattern Editor. To activate it, press '''PROG CHANGE''':<code>PAD 7 A</code>. You should see <code>Zynthian PATTERN</code> in the display of your MPK. Note that all the following PADs are assumed to be in '''bank A'''.
    
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
 
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
Line 281: Line 281:  
</p>
 
</p>
   −
En any screen (Zynpad, Arranger or Pattern Editor), you can:
+
In any screen (Zynpad, Arranger or Pattern Editor), you can:
    
* '''Move the cursor''' using the joystick, or <code>K2</code> for vertical and <code>K6</code> for horizontal displacement.
 
* '''Move the cursor''' using the joystick, or <code>K2</code> for vertical and <code>K6</code> for horizontal displacement.
Line 292: Line 292:  
* '''Toggle step''' in cursor's position, pressing <code>PAD 4</code>.
 
* '''Toggle step''' in cursor's position, pressing <code>PAD 4</code>.
 
* '''Adjust''' the selected step, using the following Knobs:
 
* '''Adjust''' the selected step, using the following Knobs:
** Step's '''duration''': <code>K7</code>. It will change in increments of 0.1 steps, or, by pressing <code>SHIFT</code> in 0.5 steps.
+
** Step's '''duration''': <code>K7</code>. It will change in increments of 0.1 steps, or, by pressing <code>SHIFT</code>, in 0.5 steps.
 
** Step's  '''velocity''': <code>K8</code>.  
 
** Step's  '''velocity''': <code>K8</code>.  
 
** Step's '''stutter count''': <code>K3</code>. Ranges from 0 to 32.
 
** Step's '''stutter count''': <code>K3</code>. Ranges from 0 to 32.
Line 300: Line 300:     
** Toggle '''playing''' the selected sequence, by pressing <code>PAD 4</code>.
 
** Toggle '''playing''' the selected sequence, by pressing <code>PAD 4</code>.
** If the MPK is in '''FULL LEVEL''', each PAD can launch/stop a sequence. PADs in bank A, for sequences between 1 and 8, and bank B for sequences 9-16. This
+
** If the MPK is in '''FULL LEVEL''', each PAD can launch/stop a sequence. PADs in bank A, for sequences between 1 and 8, and bank B for sequences 9-16.
    
<br clear=all>
 
<br clear=all>
Line 308: Line 308:  
[[File:akai_mpk_mini_mk3_notepad_mode.png|800px|right]]
 
[[File:akai_mpk_mini_mk3_notepad_mode.png|800px|right]]
   −
The purpose of this mode is to modify the notes that the PADs will send in ''note'' mode (i.e. neither CC or PROG CHANGE active). You can switch to this mode by pressing '''PROG CHANGE''':<code>PAD 8 A</code>.
+
The purpose of this mode is to modify the notes that the PADs will send in ''note'' mode (i.e. neither CC or PROG CHANGE active). You can switch to this mode by pressing '''PROG CHANGE''':<code>PAD 8 A</code>. You should see <code>Zynthian NOTEPAD</code> in the display of the MPK.
    
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
 
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
Line 314: Line 314:  
</p>
 
</p>
   −
To '''assign a note''' to a PAD, press that PAD and, without releasing it, press any key on the KeyBed. Press the pad again to check the note (it may be sent to a different chain, depending on PAD/KeyBed channels and Zynthian settings). In this mode, both banks A and B are available.  
+
To '''assign a note''' to a PAD, press that PAD and, without releasing it, press any key of the KeyBed. Press the pad again to check the note (it may be sent to a different chain, depending on PAD/KeyBed channels and Zynthian settings). In this mode, both banks A and B are available for note binding.  
    
You can '''remove a note''' from a PAD pressing that PAD and, without releasing it, turning <code>K8</code> counter clock-wise. The removal will be done when you release the PAD, so, if you didn't want to remove it (and didn't release the PAD), just turn the Knob clock-wise again.
 
You can '''remove a note''' from a PAD pressing that PAD and, without releasing it, turning <code>K8</code> counter clock-wise. The removal will be done when you release the PAD, so, if you didn't want to remove it (and didn't release the PAD), just turn the Knob clock-wise again.
   −
Using the Knob <code>K7</code> on a PAD will adjust its pitch (note) by a semitone.
+
Using the Knob <code>K7</code> on a PAD will adjust its pitch (note) by a semitone, up and down the scale.
    
<br clear=all>
 
<br clear=all>
Line 324: Line 324:  
====The User mode====
 
====The User mode====
   −
This mode is a special mode, with no other purpose that letting you all the available controls for MIDI learning. Only PC 0-7 and 12,13 are NOT available (as they are used for changing modes and Zynthian's shortcuts).  
+
This is a special mode, with no other purpose that letting you all the available controls for '''MIDI learning'''. Only PC 0-7 and 12,13 are NOT available (as they are used for changing modes and Zynthian's shortcuts). You can switch to this mode by pressing '''PROG CHANGE''':<code>PAD 5 B</code>. You should see <code>Zynthian USER</code> in the display of the MPK.
   −
These is the available configuration:
+
This is the available configuration:
    
* PADs channel is the assigned in Config mode (see below).
 
* PADs channel is the assigned in Config mode (see below).
 
* PAD notes are the assigned in NotePad.
 
* PAD notes are the assigned in NotePad.
 
* PAD CCs are in range [40-47] for bank A, and [48-55] for bank B.
 
* PAD CCs are in range [40-47] for bank A, and [48-55] for bank B.
* PAD PCs 8,9,10,11 and 14,15 (all in bank B) are available.
+
* PC PADs 1, 2, 3, 4, 7 and 8 (all in bank B) are available.
 
* All Knobs are available, and their CCs goes from 56 to 63.
 
* All Knobs are available, and their CCs goes from 56 to 63.
 
* Joystick Y channel is mapped as pitchbend.
 
* Joystick Y channel is mapped as pitchbend.
Line 341: Line 341:     
[[File:akai_mpk_mini_mk3_config_mode.png|800px|right]]
 
[[File:akai_mpk_mini_mk3_config_mode.png|800px|right]]
 +
 +
This is also a special mode, used to '''configure the MPK device''' internal settings, like the channel where the PADs will send their notes, or the '''arpeggiator''' settings.
 +
 +
'''Rationale:''' while you can use the MPK arpeggiator or NOTE REPEAT buttons to change some of these settings, they will be overwritten on next mode change (as they are inside the MPK and could not be retrieved). Moreover, there are settings that could only be changed using the MPK Program Editor, so this mode will help you in that case. Zynthian will store the changes you made here per snapshot basis, so that's another reason for using this mode.
 +
 +
<p style="margin: 1em 0 1.5em; padding: 1em; background-color: #fef6e7; display:table-cell">
 +
'''NOTE''': Remember to put PAD CONTROLS in '''CC mode'''. The pads in ''note'' mode will only trigger the assigned notes. ALSO, ensure that KeyBed octave is '''in the middle''' (neither <code>OCT+</code> nor <code>OCT-</code> is brightly lit).
 +
</p>
 +
 +
In this mode, all notes of the KeyBed are used as shortcuts for the '''arpeggiator settings'''. See the MPK KeyBed labels to check the purpose of each one. Also note that:
 +
 +
* <code>PAD 3 A</code> in CC mode is used as '''SHIFT'''.
 +
* <code>PAD 4 A</code> in CC mode toggles '''on/off''' the arpeggiator.
 +
 +
For other settings, you can use the Knobs. Move a Knob to see in the MPK display its function (but it won't change anything), and <code>SHIFT</code> + move Knob to actually change that property (changes are applied on <code>SHIFT</code> release). This is the settings mapping:
 +
 +
* <code>K1</code>: changes '''tempo taps''', the number of times you need to press the button <code>TAP TEMPO</code> to change it. Ranges from 2 to 4.
 +
* <code>K2</code>: to modify the '''arpeggiator swing''', giving you a finer adjustment than using the KeyBed shortcuts.
 +
* <code>K3</code>: to change the '''PADs aftertouch''' settings. Values are 0: Off, 1: Channel Aftertouch, 2: Polyphonic Aftetouch.
 +
* <code>K4</code>: for changing the KeyBed octave. A value of 4 is the default middle octave, less than 4 is for lowering the octave, and bigger that 4 increases the octave. '''NOTE:''' If you want to change this value, please note that it will affect the KeyBed immediately, so any shortcut that you use later on would be displaced. Just adjust this as the last value, or reset octave before using the shortcuts.
 +
* <code>K6</code>: for setting the '''arpeggiator clock''' source as EXT (external). Set it to 1 for using an external clock, or 0 to use the internal clock.
 +
* <code>K7</code>: lets you change the '''channel of the PADs'''.
 +
* <code>K8</code>: to modify the '''channel of the KeyBed'''.
    
<br clear=all>
 
<br clear=all>