Subversion Repositories svn.mios

Rev

Rev 1105 | Rev 1117 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1057 tk 1
HEADER 3 MIDIbox KB
2
 
3
<H1>MIDIbox KB</H1>
1066 tk 4
<H2>Keyboard Controller with MIDI, USB-MIDI and Ethernet interface</H1>
1057 tk 5
 
6
<P CLASS=INFO>This page collects some preliminary informations about the MIDIbox KB project.</P>
7
 
1077 tk 8
<P CLASS=INFO>MIDIbox KB utilizes the new <A HREF="mbhp_core_lpc17.html">MBHP_CORE_LPC17</A> and <A HREF="mbhp_dio_matrix.html">MBHP_DIO_MATRIX</A> modules.</P>
9
 
10
<P CLASS=INFO>Currently following features are already implemented:
11
<UL CLASS=CL>
1113 tk 12
<LI> up to 2 keyboard matrices can be scanned separately at a very high scan rate (around 200 uS)</A>
1077 tk 13
<LI> optional support for velocity!</A>
1105 tk 14
<LI> 6 analog inputs of the core module can be used to connect pitchwheels, modulation wheels and sustain pedal (or aftertouch)</A>
15
<LI> analog inputs can be calibrated</A>
1077 tk 16
<LI> two MIDI IN and two MIDI OUT ports
17
<LI> USB MIDI port with much higher transfer rate (ca. 100x faster!) than common MIDI
1086 tk 18
<LI> Ethernet port to send/receive events via <A HREF="midibox_osc.html">OSC</A>
1077 tk 19
<LI> support for DHCP - connect the module to a wireless router without additional configuration
20
<LI> different OSC modes are prepared for popular PC/Mac/iPhone/iPad apps, extensions can be added on request
21
<LI> integrated MIDI router with 16 configurable nodes
22
<LI> can also be used as USB/MIDI interface, or even as OSC/MIDI interface
23
<LI> configuration done via the MIOS Terminal of <A HREF="mios_studio.html">MIOS Studio</A>
24
<LI> configuration is stored in on-board EEPROM of LPCXPRESSO module
25
</UL>
26
</P>
27
 
1113 tk 28
<P CLASS=DESC>Please note: the same keyboard driver is also available in <A HREF="midibox_ng.html">MIDIbox NG</A>. If you are searching for more capabilities (e.g. integrated controller with many pots, encoders, buttons, leds), consider to use the MBNG firmware instead of MBKB.</P>
1077 tk 29
 
1113 tk 30
<P CLASS=DESC>The main difference between the two applications is, that MIDIbox KB is optimized for high scan speeds! MIDIbox NG scans the keyboard 10 times slower to give the core more processing time for other tasks. However, with MBNG the latency to scan the whole keyboard is still lower than 3 mS (MBKB: 260 uS)!</P>
31
 
32
 
1066 tk 33
<H2> <IMG SRC="images/bullet.gif" ALT=""> Schematics </H2>
34
 
1057 tk 35
<P CLASS=INFO>All schematics are subject to change without notice!</P>
36
 
37
  <TABLE WIDTH="100%" BORDER=0 CELLSPACING=5 CELLPADDING=0>
38
    <TR>
39
      <TD COLSPAN=2 CLASS=TABCOLOR1><FONT SIZE=3>Supported Keyboard Types</FONT></TD>
40
    </TR>
41
    <TR>
42
      <TD CLASS=TABCOLOR1><FONT SIZE=2><STRONG>Schematic</STRONG></FONT></td>
43
      <TD NOWRAP CLASS=TABCOLOR1><FONT SIZE=2><STRONG>Description</STRONG></FONT></TD>
44
    </TR>
45
    <TR>
46
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_scanmatrix_type1.pdf">midibox_kb_scanmatrix_type1.pdf</A></TD>
47
      <TD CLASS=TABCOLOR2>Type #1 Keyboard without velocity</TD>
48
    </TR>
49
    <TR>
50
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_scanmatrix_type2.pdf">midibox_kb_scanmatrix_type2.pdf</A></TD>
51
      <TD CLASS=TABCOLOR2>Type #2 Keyboard with Velocity (e.g. Fatar DR type)</TD>
52
    </TR>
53
    <TR>
54
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_scanmatrix_type3.pdf">midibox_kb_scanmatrix_type3.pdf</A></TD>
55
      <TD CLASS=TABCOLOR2>Type #3 Keyboard with Velocity (alternating switch)</TD>
56
    </TR>
57
    <TR>
58
      <TD COLSPAN=2 CLASS=TABCOLOR1><FONT SIZE=3>Fatar DR Adapters to <A HREF="mbhp_dio_matrix.html">MBHP_DIO_MATRIX</A> module</FONT></TD>
59
    </TR>
60
    <TR>
61
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_fatar_df_61_interconnections.pdf">midibox_kb_fatar_df_61_interconnections.pdf</A></TD>
62
      <TD CLASS=TABCOLOR2>Fatar DF Type with 61 keys</TD>
63
    </TR>
64
    <TR>
65
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_fatar_df_76_interconnections.pdf">midibox_kb_fatar_df_76_interconnections.pdf</A></TD>
66
      <TD CLASS=TABCOLOR2>Fatar DF Type with 76 keys</TD>
67
    </TR>
68
    <TR>
69
      <TD CLASS=TABCOLOR2><A HREF="midibox_kb/midibox_kb_fatar_df_88_interconnections.pdf">midibox_kb_fatar_df_88_interconnections.pdf</A></TD>
70
      <TD CLASS=TABCOLOR2>Fatar DF Type with 88 keys</TD>
71
    </TR>
72
  </TABLE>
73
 
1066 tk 74
 
75
<H2> <IMG SRC="images/bullet.gif" ALT=""> Terminal Commands </H2>
76
 
77
<P CLASS=INFO>MIDIbox KB can be completely configured from the MIOS Terminal of <A HREF="mios_studio.html">MIOS Studio</A>.</P>
78
 
79
<P CLASS=DESC>Enter 'help' to get a list of available commands.<BR>
80
Here a more detailed description of most commands:</P>
81
 
82
<P CLASS=DESC>
83
<TABLE CLASS=BOX WIDTH=700 ALIGN=CENTER BORDER CELLSPACING=2 CELLPADDING=3 >
84
  <TR>
85
    <TD WIDTH=200> <SPAN CLASS=NORM><I>help</I></TD>
86
    <TD WIDTH=500> <SPAN CLASS=NORM>Lists all available commands (some of them are maybe not listed here)
87
    </SPAN></TD>
88
  </TR>
89
 
90
  <TR>
91
    <TD WIDTH=100> <SPAN CLASS=NORM><I>store</I></TD>
92
    <TD WIDTH=475> <SPAN CLASS=NORM>Stores the complete configuration (not only keyboard parameters, but also router, etc...) into the EEPROM of the LPCXPRESSO module, so that they will be restored during startup.<BR>
93
    Usually a firmware update doesn't overwrite the stored parameters if not noticed in the ChangeLog.<BR>
94
    Please enter the <I>store</I> command once you've adapted the parameters for your keyboard setup.
95
    </SPAN></TD>
96
  </TR>
97
 
98
  <TR>
99
    <TD WIDTH=100> <SPAN CLASS=NORM><I>restore</I></TD>
100
    <TD WIDTH=475> <SPAN CLASS=NORM>Restores the complete configuration from EEPROM. This command could become useful if you messed up the configuration, just type <I>restore</I> to undo the changes.
101
    </SPAN></TD>
102
  </TR>
103
 
104
  <TR>
105
    <TD WIDTH=100> <SPAN CLASS=NORM><I>system</I></TD>
106
    <TD WIDTH=475> <SPAN CLASS=NORM>Prints some system informations, such as the name and version number of the application.
107
    </SPAN></TD>
108
  </TR>
109
 
110
  <TR>
111
    <TD WIDTH=100> <SPAN CLASS=NORM><I>reset</I></TD>
112
    <TD WIDTH=475> <SPAN CLASS=NORM>Restarts the application remotely. Mainly intended for development.
113
    </SPAN></TD>
114
  </TR>
115
 
116
  <TR>
117
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set srio_num &lt;1..16&gt;</I></TD>
118
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the number of DIN/DOUT shift registers (resp. 74HC165 and 74HC595) which should be scanned.<BR>
119
      <SPAN CLASS=NORM><B>Examples:</B><BR>
120
         <I>set srio_num 2</I>: two DIN and two DOUTs should be scanned<BR>
121
         <I>set srio_num 4</I>: four DIN and four DOUTs should be scanned<BR>
122
         <I>set srio_num 6</I>: e.g. if six DIN and four DOUTs should be scanned - more DINs than DOUTs, therefore the number of DINs is relevant here!<BR>
123
      </SPAN>
124
      <SPAN CLASS=NORM>Than more shift registers are scanned, than higher the latency of your keyboards. Therefore the minimum value is desired.<BR>
125
      <I>2</I> is typically a good choice if only one keyboard should be scanned, and <I>4</I> if two keyboard should be scanned.
126
      </SPAN></TD>
127
  </TR>
128
 
129
  <TR>
130
    <TD WIDTH=100> <SPAN CLASS=NORM><I>kb &lt;1|2&gt;</I><BR><I>keyboard &lt;1|2&gt;</I></TD>
131
    <TD WIDTH=475> <SPAN CLASS=NORM>Prints a list of all keyboard parameters. MIDIbox KB can handle up to 2 keyboards in parallel, please specify the keyboard number with:<BR>
132
      <I>kb 1</I> or <I>kb 2</I>
133
      </SPAN></TD>
134
  </TR>
135
 
136
  <TR>
137
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; debug &lt;on|off&gt;</I></TD>
138
    <TD WIDTH=475> <SPAN CLASS=NORM>Enables some useful debugging messages for troubleshooting the hardware. This switch is not stored in EEPROM. Means: on each reset/power-on MIDIbox KB starts with debug mode disabled, and you have to enable it again.<BR>
139
      <SPAN CLASS=NORM><B>Examples:</B><BR>
140
         <I>set kb 1 debug on</I>: print some useful debugging messages for keyboard 1<BR>
141
      </SPAN></TD>
142
  </TR>
143
 
144
  <TR>
145
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; midi_ports &lt;ports&gt;</I></TD>
146
    <TD WIDTH=475> <SPAN CLASS=NORM>Each keyboard can send to one or multiple MIDI ports. They are currently (unfortunately) entered via a hexadecimal number, which is a nice short cut for techies, but probably difficult to understand for normal users. A more comfortable solution will be available once I found the time to improve the parser.<BR>
147
      Coding:</SPAN>
148
      <UL CLASS=CL>
149
        <LI><B>Bit 0:</B> USB1</LI>
150
        <LI><B>Bit 1:</B> USB2</LI>
151
        <LI><B>Bit 2:</B> USB3</LI>
152
        <LI><B>Bit 3:</B> USB4</LI>
153
        <LI><B>Bit 4:</B> MIDI OUT1</LI>
154
        <LI><B>Bit 5:</B> MIDI OUT2</LI>
155
        <LI><B>Bit 12:</B> OSC1</LI>
156
        <LI><B>Bit 13:</B> OSC2</LI>
157
        <LI><B>Bit 14:</B> OSC3</LI>
158
        <LI><B>Bit 15:</B> OSC4</LI>
159
      </UL>
160
      <SPAN CLASS=NORM><B>Examples:</B><BR>
161
         <I>set kb 1 midi_ports 0x1011</I>: keyboard 1 will send to USB1, OUT1 and OSC1<BR>
162
         <I>set kb 1 midi_ports 0x0020</I>: keyboard 1 will only send to OUT2<BR>
163
         <I>set kb 2 midi_ports 0x0030</I>: keyboard 2 will send to OUT1 and OUT2
164
      </SPAN></TD>
165
  </TR>
166
 
167
  <TR>
168
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; midi_chn &lt;channel&gt;</I></TD>
169
    <TD WIDTH=475> <SPAN CLASS=NORM>Each keyboard can send to a dedicated MIDI channel.<BR>
170
       Select 1..16 for MIDI Channel 1..16. 0 will disable MIDI (no events will be sent to any channel)<BR></SPAN>
171
      <SPAN CLASS=NORM><B>Examples:</B><BR>
172
         <I>set kb 1 midi_chn 1</I>: keyboard 1 will send MIDI Channel 1<BR>
173
         <I>set kb 2 midi_chn 5</I>: keyboard 2 will send MIDI Channel 5
174
      </SPAN></TD>
175
  </TR>
176
 
177
  <TR>
178
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; note_offset &lt;0-127&gt;</I></TD>
179
    <TD WIDTH=475> <SPAN CLASS=NORM>Sets the starting note of the leftmost key of your keyboard. The value is entered in decimal format.<BR>
180
      Most important values:</SPAN>
181
      <UL CLASS=CL>
1113 tk 182
        <LI><B>28:</B> C-1 for Fatar DF Type with 61 or 76 keys
183
        <LI><B>21:</B> C-1 for Fatar DF Type with 88 keys
1066 tk 184
      </UL>
185
      <SPAN CLASS=NORM><B>Examples:</B><BR>
1113 tk 186
         <I>set kb 1 note_offset 28</I>: a Fatar 61 or 76 keys will start with C-1<BR>
187
         <I>set kb 2 note_offset 21</I>: a Fatar 88 keys will start with A-1<BR>
1066 tk 188
      </SPAN></TD>
189
  </TR>
190
 
191
  <TR>
192
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; rows &lt;0-16&gt;</I></TD>
193
    <TD WIDTH=475> <SPAN CLASS=NORM>Specifies how many rows of the keyboard matrix have to be scanned.<BR>
194
       If rows &lt; 9, and a second DOUT is specified, the selection signal will be available on both DOUTs (perfect for 1:1 connection to a Fatar Keyboard with 61 keys)<BR>
195
      <SPAN CLASS=NORM><B>Examples:</B><BR>
196
         <I>set kb 1 rows 8</I>: keyboard 1 will scan 8 rows of the matrix -&gt; up to 128 inputs = 64 break/make contacts (keys)<BR>
197
         <I>set kb 1 rows 16</I>: for a different hardware: keyboard 1 will scan 16 rows of the matrix -&gt; up to 256 inputs = 128 break/make contacts (keys)<BR>
198
         <I>set kb 2 rows 11</I>: keyboard 2 will scan 11 rows of the matrix -&gt; up to 176 inputs = 88 break/make contacts (keys)<BR>
199
      </SPAN></TD>
200
  </TR>
201
 
202
  <TR>
203
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; velocity &lt;on|off&gt;</I></TD>
204
    <TD WIDTH=475> <SPAN CLASS=NORM><B>off:</B> each row will send a MIDI event with maximum velocity. Has to be used for keyboard with only one contact per key<BR>
205
      <B>on:</B> one row is connect to "make" contacts, the next row to "break" contacts; period. This allows to measure the delay between contact activation in order to generate a velocity between 1 and 127 (see Fatar keyboard configuration examples below)<BR>
206
      <SPAN CLASS=NORM><B>Examples:</B><BR>
207
         <I>set kb 1 velocity on</I>: keyboard 1 provides two contacts to measure velocity<BR>
208
         <I>set kb 1 velocity off</I>: keyboard 1 provides only one contact, resp. a common button matrix is used<BR>
209
      </SPAN></TD>
210
  </TR>
211
 
212
  <TR>
213
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; optimized &lt;on|off&gt;</I></TD>
214
    <TD WIDTH=475> <SPAN CLASS=NORM>Only valid in velocity mode.<BR>
215
      <B>off:</B> break and make contacts are always scanned. This is the default configuration and should be used for debugging!<BR>
1113 tk 216
      -&gt; The resulting scan latency of a complete Fatar 63 keys keyboard is ca. <B>260 uS</B><BR>
217
      <B>on:</B> make contacts will only be scanned if break contacts are active. This reduces the scan latency in most cases (no or only some keys are played). Won't work with <A HREF="midibox_kb/midibox_kb_scanmatrix_type3.pdf">Keyboard Type #3!</A><BR>
1066 tk 218
      -&gt; The resulting scan latency of a complete Fatar 63 keys keyboard is ca. <B>130 uS</B><BR>
219
      <SPAN CLASS=NORM><B>Examples:</B><BR>
220
         <I>set kb 1 optimized off</I>: keyboard 1 should be debugged because it doesn't send notes (e.g. type <I>set kb 1 debug on</I> thereafter).<BR>
221
         <I>set kb 1 optimized on</I>: keyboard 1 should run in low-latency mode. Type <I>store</I> thereafter if the keyboard works as expected!<BR>
222
      </SPAN></TD>
223
  </TR>
224
 
225
  <TR>
226
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; dout_sr1 &lt;0-16&gt;</I></TD>
227
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the first DOUT shift register which is used to select the keyboard matrix rows.<BR>
228
      <SPAN CLASS=NORM><B>Examples:</B><BR>
229
         <I>set kb 1 dout_sr1 1</I>: row selection lines 1..8 of keyboard 1 are connected to first DOUT shift register.<BR>
230
         <I>set kb 2 dout_sr1 3</I>: row selection lines 1..8 of keyboard 2 are connected to third DOUT shift register.<BR>
231
         <I>set kb 1 dout_sr1 0</I>: disable this function for keyboard 1 (use DOUT for other purposes)<BR>
232
      </SPAN></TD>
233
  </TR>
234
 
235
  <TR>
236
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; dout_sr2 &lt;0-16&gt;</I></TD>
237
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the second DOUT shift register which is used to select the keyboard matrix rows.<BR>
238
      <SPAN CLASS=NORM><B>Examples:</B><BR>
239
         <I>set kb 1 dout_sr2 2</I>: row selection lines 9..16 of keyboard 1 are connected to the second DOUT shift register (if rows &lt; 9, this DOUT will output the same pattern as dout_sr1)<BR>
240
         <I>set kb 2 dout_sr2 4</I>: row selection lines 9..16 of keyboard 2 are connected to the fourth DOUT shift register (if rows &lt; 9, this DOUT will output the same pattern as dout_sr1)<BR>
241
         <I>set kb 1 dout_sr2 0</I>: disable this function for keyboard 1 (use DOUT for other purposes)<BR>
242
      </SPAN></TD>
243
  </TR>
244
 
245
  <TR>
246
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; din_sr1 &lt;0-16&gt;</I></TD>
247
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the first DIN shift register which is used to scan a keyboard matrix row.<BR>
248
      <SPAN CLASS=NORM><B>Examples:</B><BR>
249
         <I>set kb 1 din_sr1 1</I>: left side of keyboard 1 is connected to first DIN shift register.<BR>
250
         <I>set kb 2 din_sr1 3</I>: left side of keyboard 2 is connected to third DIN shift register.<BR>
251
         <I>set kb 1 din_sr1 0</I>: disable this function for keyboard 1 (use DIN for other purposes)<BR>
252
      </SPAN></TD>
253
  </TR>
254
 
255
  <TR>
256
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; din_sr2 &lt;0-16&gt;</I></TD>
257
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the second DIN shift register which is used to scan a keyboard matrix row.<BR>
258
      <SPAN CLASS=NORM><B>Examples:</B><BR>
259
         <I>set kb 1 din_sr2 2</I>: right side of keyboard 1 is connected to second DIN shift register.<BR>
260
         <I>set kb 2 din_sr2 4</I>: right side of keyboard 2 is connected to fourthDIN shift register.<BR>
261
         <I>set kb 1 din_sr1 0</I>: disable this function for keyboard 1 (use DIN for other purposes)<BR>
262
      </SPAN></TD>
263
  </TR>
264
 
265
  <TR>
266
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; din_key_offset &lt;0-127&gt;</I></TD>
267
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the offset which is added to the keys of the right half. Typically 32 for velocity keyboards (64 contacts), and 64 for non-velocity keyboards.<BR>
268
      <SPAN CLASS=NORM><B>Examples:</B><BR>
269
         <I>set kb 1 din_key_offset 32</I>: key number starts at 32 for the right side of keyboard 1 (velocity sensitive)<BR>
270
         <I>set kb 1 din_key_offset 64</I>: key number starts at 64 for the right side of keyboard 1 (no velocity)<BR>
271
      </SPAN></TD>
272
  </TR>
273
 
274
  <TR>
275
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; din_inverted &lt;on|off&gt;</I></TD>
276
    <TD WIDTH=475> <SPAN CLASS=NORM>This option should be enabled if diodes are used with the opposite polarity, and pull-downs are connected to DINs.<BR>
277
      <SPAN CLASS=NORM><B>Examples:</B><BR>
278
         <I>set kb 1 din_inverted off</I>: diodes with "normal" direction and pull-up resistors at 74HC165<BR>
279
         <I>set kb 1 din_inverted on</I>: diodes with opposite direction and pull-down resistors at 74HC165<BR>
280
      </SPAN></TD>
281
  </TR>
282
 
283
  <TR>
284
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; break_inverted &lt;on|off&gt;</I></TD>
285
    <TD WIDTH=475> <SPAN CLASS=NORM>This option should be enabled for velocity keyboards with single switches (instead of break/make swicthes).<BR>
286
      <SPAN CLASS=NORM><B>Examples:</B><BR>
287
         <I>set kb 1 break_inverted off</I>: we have a break and make switch per key -&gt; <A HREF="midibox_kb/midibox_kb_scanmatrix_type2.pdf">Type #2</A><BR>
288
         <I>set kb 1 break_inverted on</I>: we have only a single switch per key -&gt; <A HREF="midibox_kb/midibox_kb_scanmatrix_type3.pdf">Type #3</A><BR>
289
      </SPAN></TD>
290
  </TR>
291
 
292
  <TR>
293
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; delay_fastest &lt;0-65535&gt;</I></TD>
294
    <TD WIDTH=475> <SPAN CLASS=NORM>Only relevant for velocity sensitive keyboards: selects the minimum delay value at which the maximum velocity (=127) should be sent. Use <I>debug</I> mode to display the minimum delay when keys are hit strongly!<BR>
295
      <SPAN CLASS=NORM><B>Examples:</B><BR>
296
         <I>set kb 1 delay_fastest 100</I>: send maximum velocity when delay is &lt;= 100<BR>
297
         <I>set kb 1 delay_fastest 200</I>: send maximum velocity when delay is &lt;= 200<BR>
298
      </SPAN></TD>
299
  </TR>
300
 
301
  <TR>
302
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; delay_slowest &lt;0-65535&gt;</I></TD>
303
    <TD WIDTH=475> <SPAN CLASS=NORM>Only relevant for velocity sensitive keyboards: selects the maximum delay value at which the minimum velocity (=1) should be sent. Use <I>debug</I> mode to display the maximum delay when keys are hit softly!<BR>
304
      <SPAN CLASS=NORM><B>Examples:</B><BR>
1105 tk 305
         <I>set kb 1 delay_slowest 1000</I>: send maximum velocity when delay is &gt;= 1000<BR>
1066 tk 306
         <I>set kb 1 delay_slowest 2000</I>: send maximum velocity when delay is &gt;= 2000<BR>
307
      </SPAN></TD>
308
  </TR>
309
 
310
  <TR>
311
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ain_pitchwheel &lt;0-5 or off&gt;</I></TD>
312
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the J5.Ax input to which the PitchWheel pot is connected. Use <I>off</I> if no PitchWheel is used to avoid that the unconnected analog input will send random MIDI events!<BR>
313
      <SPAN CLASS=NORM><B>Examples:</B><BR>
314
         <I>set kb 1 ain_pitchwheel 0</I>: PitchWheel of keyboard 1 connected to J5.A0 of the core module<BR>
1105 tk 315
         <I>set kb 2 ain_pitchwheel 3</I>: PitchWheel of keyboard 2 connected to J5.A3 of the core module<BR>
1066 tk 316
         <I>set kb 1 ain_pitchwheel off</I>: no PitchWheel connected<BR>
317
      </SPAN></TD>
318
  </TR>
319
 
320
  <TR>
321
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ctrl_pitchwheel &lt;0-129&gt;</I></TD>
322
    <TD WIDTH=475> <SPAN CLASS=NORM>What kind of MIDI events should be sent by the PitchWheel?
323
      <UL CLASS=CL>
324
        <LI><B>0..127:</B> CC#0 .. CC#127
325
        <LI><B>128:</B> PitchBend (default)
326
        <LI><B>129:</B> Aftertouch
327
      </UL>
328
      <SPAN CLASS=NORM><B>Examples:</B><BR>
329
         <I>set kb 1 ctrl_pitchwheel 128</I>: the PitchWheel of keyboard 1 sends PitchBend MIDI events<BR>
330
         <I>set kb 1 ctrl_pitchwheel 129</I>: the PitchWheel of keyboard 2 sends Aftertouch MIDI events<BR>
331
      </SPAN></TD>
332
  </TR>
333
 
334
  <TR>
335
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ain_modwheel &lt;0-5 or off&gt;</I></TD>
336
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the J5.Ax input to which the ModWheel pot is connected. Use <I>off</I> if no ModWheel is used to avoid that the unconnected analog input will send random MIDI events!<BR>
337
      <SPAN CLASS=NORM><B>Examples:</B><BR>
338
         <I>set kb 1 ain_modwheel 1</I>: ModWheel of keyboard 1 connected to J5.A1 of the core module<BR>
1105 tk 339
         <I>set kb 2 ain_modwheel 4</I>: ModWheel of keyboard 2 connected to J5.A4 of the core module<BR>
1066 tk 340
         <I>set kb 1 ain_modwheel off</I>: no ModWheel connected<BR>
341
      </SPAN></TD>
342
  </TR>
343
 
344
  <TR>
345
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ctrl_modwheel &lt;0-129&gt;</I></TD>
346
    <TD WIDTH=475> <SPAN CLASS=NORM>What kind of MIDI events should be sent by the ModWheel?
347
      <UL CLASS=CL>
348
        <LI><B>0..127:</B> CC#0 .. CC#127 (default: CC#1)
349
        <LI><B>128:</B> PitchBend
350
        <LI><B>129:</B> Aftertouch
351
      </UL>
352
      <SPAN CLASS=NORM><B>Examples:</B><BR>
353
         <I>set kb 1 ctrl_modwheel 1</I>: the ModWheel of keyboard 1 sends CC#1 (CC Modulation)<BR>
354
         <I>set kb 2 ctrl_modwheel 7</I>: the ModWheel of keyboard 2 sends CC#7 (CC Volume)<BR>
355
      </SPAN></TD>
356
  </TR>
357
 
1105 tk 358
  <TR>
359
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ain_sustain &lt;0-5 or off&gt;</I></TD>
360
    <TD WIDTH=475> <SPAN CLASS=NORM>Selects the J5.Ax input to which a Sustain Pedal is connected. Use <I>off</I> if no Pedal is used to avoid that the unconnected analog input will send random MIDI events!<BR>
361
      <SPAN CLASS=NORM><B>Examples:</B><BR>
362
         <I>set kb 1 ain_sustain 2</I>: Sustain Pedal of keyboard 1 connected to J5.A2 of the core module<BR>
363
         <I>set kb 2 ain_sustain 5</I>: Sustain Pedal of keyboard 2 connected to J5.A5 of the core module<BR>
364
         <I>set kb 1 ain_sustain off</I>: no Sustain Pedal connected<BR>
365
      </SPAN></TD>
366
  </TR>
367
 
368
  <TR>
369
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; ctrl_sustain &lt;0-129&gt;</I></TD>
370
    <TD WIDTH=475> <SPAN CLASS=NORM>What kind of MIDI events should be sent by the Sustain Pedal?
371
      <UL CLASS=CL>
372
        <LI><B>0..127:</B> CC#0 .. CC#127 (default: CC#64)
373
        <LI><B>128:</B> PitchBend
374
        <LI><B>129:</B> Aftertouch
375
      </UL>
376
      <SPAN CLASS=NORM><B>Examples:</B><BR>
377
         <I>set kb 1 ctrl_sustain 64</I>: the Sustain Pedal of keyboard 1 sends CC#64 (CC Sustain)<BR>
378
         <I>set kb 2 ctrl_sustain 65</I>: the Sustain Pedal of keyboard 2 sends CC#65 (CC Portamento On)<BR>
379
      </SPAN></TD>
380
  </TR>
381
 
382
  <TR>
383
    <TD WIDTH=100> <SPAN CLASS=NORM><I>set kb &lt;1|2&gt; calibration &lt;off|pitchwheel|modwheel|sustain&gt;</I></TD>
384
    <TD WIDTH=475> <SPAN CLASS=NORM>Starts the calibration of PitchWheel/ModWheel/Sustain potentiometers (or switches) to determine the minimum/maximum value.<BR>
385
       After the calibration, just enter 'set kb 1 calibration off' to stop the calibration (and to test the behaviour), thereafter type 'store' to save the new values.
386
  </TR>
387
 
1066 tk 388
</TABLE>
389
 
390
 
391
<H2> <IMG SRC="images/bullet.gif" ALT=""> Recommended Configurations </H2>
392
 
393
<P CLASS=INFO>Configuration examples for various keyboards - this list will be enhanced whenever new configurations have been tested:</P>
394
 
395
<P CLASS=DESC>
396
<TABLE CLASS=BOX WIDTH=700 ALIGN=CENTER BORDER CELLSPACING=2 CELLPADDING=3 >
397
  <TR>
398
    <TD WIDTH=300> <SPAN CLASS=NORM>Fatar DF Type with 61 keys (<A HREF="midibox_kb/midibox_kb_fatar_df_61_interconnections.pdf">schematic</A>)
399
    <TD WIDTH=400>
400
      <UL CLASS=CL>
1113 tk 401
        <LI><I>set kb 1 note_offset 28</I>
1066 tk 402
        <LI><I>set kb 1 rows 8</I>
403
        <LI><I>set kb 1 velocity on</I>
404
        <LI><I>set kb 1 optimized on</I>
405
        <LI><I>set kb 1 dout_sr1 1</I>
406
        <LI><I>set kb 1 dout_sr2 2</I>
407
        <LI><I>set kb 1 din_sr1 1</I>
408
        <LI><I>set kb 1 din_sr2 2</I>
409
        <LI><I>set kb 1 din_key_offset 32</I>
410
        <LI><I>set kb 1 din_inverted off</I>
411
        <LI><I>set kb 1 break_inverted off</I>
1105 tk 412
        <LI><I>set kb 1 delay_fastest 50</I>
413
        <LI><I>set kb 1 delay_slowest 1000</I>
1066 tk 414
        <LI><I>store</I>
415
      </UL>
416
    </SPAN></TD>
417
  </TR>
418
 
419
 
420
  <TR>
421
    <TD WIDTH=300> <SPAN CLASS=NORM>Fatar DF Type with 76 keys (<A HREF="midibox_kb/midibox_kb_fatar_df_76_interconnections.pdf">schematic</A>)
422
    <TD WIDTH=400>
423
      <UL CLASS=CL>
1084 tk 424
        <LI><I>set kb 1 note_offset 28</I>
425
        <LI><I>set kb 1 rows 12</I>
1066 tk 426
        <LI><I>set kb 1 velocity on</I>
427
        <LI><I>set kb 1 optimized on</I>
428
        <LI><I>set kb 1 dout_sr1 1</I>
429
        <LI><I>set kb 1 dout_sr2 2</I>
430
        <LI><I>set kb 1 din_sr1 1</I>
431
        <LI><I>set kb 1 din_sr2 2</I>
432
        <LI><I>set kb 1 din_key_offset 32</I>
433
        <LI><I>set kb 1 din_inverted off</I>
434
        <LI><I>set kb 1 break_inverted off</I>
1105 tk 435
        <LI><I>set kb 1 delay_fastest 50</I>
436
        <LI><I>set kb 1 delay_slowest 1000</I>
1066 tk 437
        <LI><I>store</I>
438
      </UL>
439
    </SPAN></TD>
440
  </TR>
441
 
442
 
443
  <TR>
444
    <TD WIDTH=300> <SPAN CLASS=NORM>Fatar DF Type with 88 keys (<A HREF="midibox_kb/midibox_kb_fatar_df_88_interconnections.pdf">schematic</A>)
445
    <TD WIDTH=400>
446
      <UL CLASS=CL>
1113 tk 447
        <LI><I>set kb 1 note_offset 21</I>
1066 tk 448
        <LI><I>set kb 1 rows 12</I>
449
        <LI><I>set kb 1 velocity on</I>
450
        <LI><I>set kb 1 optimized on</I>
451
        <LI><I>set kb 1 dout_sr1 1</I>
452
        <LI><I>set kb 1 dout_sr2 2</I>
453
        <LI><I>set kb 1 din_sr1 1</I>
454
        <LI><I>set kb 1 din_sr2 2</I>
455
        <LI><I>set kb 1 din_key_offset 40</I>
456
        <LI><I>set kb 1 din_inverted off</I>
457
        <LI><I>set kb 1 break_inverted off</I>
1105 tk 458
        <LI><I>set kb 1 delay_fastest 50</I>
459
        <LI><I>set kb 1 delay_slowest 1000</I>
1066 tk 460
        <LI><I>store</I>
461
      </UL>
462
    </SPAN></TD>
463
  </TR>
464
 
465
  <TR>
466
    <TD WIDTH=300> <SPAN CLASS=NORM>Two "Refurbished Organ" keyboards with 63 keys (<A HREF="midibox_kb/midibox_kb_scanmatrix_type3.pdf">schematic</A>)
467
    <TD WIDTH=400>
468
      <UL CLASS=CL>
469
        <LI><I>set srio_num 4</I>
470
        <LI><I>set kb 1 note_offset 36</I>
471
        <LI><I>set kb 1 rows 8</I>
472
        <LI><I>set kb 1 velocity on</I>
473
        <LI><I>set kb 1 optimized off</I>
474
        <LI><I>set kb 1 dout_sr1 1</I>
475
        <LI><I>set kb 1 dout_sr2 2</I>
476
        <LI><I>set kb 1 din_sr1 1</I>
477
        <LI><I>set kb 1 din_sr2 2</I>
478
        <LI><I>set kb 1 din_key_offset 32</I>
479
        <LI><I>set kb 1 din_inverted off</I>
480
        <LI><I>set kb 1 break_inverted on</I>
1105 tk 481
        <LI><I>set kb 1 delay_fastest 50</I>
482
        <LI><I>set kb 1 delay_slowest 1000</I>
1066 tk 483
        <LI><I>set kb 2 note_offset 36</I>
484
        <LI><I>set kb 2 rows 8</I>
485
        <LI><I>set kb 2 velocity on</I>
486
        <LI><I>set kb 2 optimized off</I>
487
        <LI><I>set kb 2 dout_sr1 3</I>
488
        <LI><I>set kb 2 dout_sr2 4</I>
489
        <LI><I>set kb 2 din_sr1 3</I>
490
        <LI><I>set kb 2 din_sr2 4</I>
491
        <LI><I>set kb 2 din_key_offset 32</I>
492
        <LI><I>set kb 2 din_inverted off</I>
493
        <LI><I>set kb 2 break_inverted on</I>
1105 tk 494
        <LI><I>set kb 2 delay_fastest 50</I>
495
        <LI><I>set kb 2 delay_slowest 1000</I>
1066 tk 496
        <LI><I>store</I>
497
      </UL>
498
    </SPAN></TD>
499
  </TR>
500
 
501
  <TR>
1105 tk 502
    <TD WIDTH=300> <SPAN CLASS=NORM>Adding a Pitch Wheel to J5.A0<BR>and a Modulation Wheel to J5.A1<BR>and a Sustain Pedal to J5.A2<BR>(no schematic yet)
1066 tk 503
    <TD WIDTH=400>
504
      <UL CLASS=CL>
505
        <LI><I>set kb 1 ain_pitchwheel 0</I>
506
        <LI><I>set kb 1 ctrl_pitchwheel 128</I>
507
        <LI><I>set kb 1 ain_modwheel 1</I>
508
        <LI><I>set kb 1 ctrl_modwheel 1</I>
1105 tk 509
        <LI><I>set kb 1 ain_sustain 2</I>
510
        <LI><I>set kb 1 ctrl_sustain 64</I>
1066 tk 511
        <LI><I>store</I>
512
      </UL>
1105 tk 513
      Use following commands to calibrate the potentiometers (resp. switches):
514
      <UL CLASS=CL>
515
        <LI><I>set kb 1 calibration pitchwheel</I><BR>-&gt; move the PitchWheel to min/max position
516
        <LI><I>set kb 1 calibration modwheel</I><BR>-&gt; move the PitchWheel to min/max position
517
        <LI><I>set kb 1 calibration sustain</I><BR>-&gt; turn on/off the Sustain Pedal
518
        <LI><I>set kb 1 calibration off</I>
519
        <LI><I>store</I>
520
      </UL>
1066 tk 521
    </SPAN></TD>
522
  </TR>
523
 
524
</TABLE>
525
 
526
 
527
<H2> <IMG SRC="images/bullet.gif" ALT=""> Firmware Download </H2>
528
 
529
<P CLASS=INFO>The precompiled application can be downloaded from the <A HREF="mios32_download.html">MIOS32 Download</A> page.</P>
530
 
1057 tk 531
FOOTER