Subversion Repositories svn.mios

Rev

Rev 1107 | Rev 1117 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 1107 Rev 1113
Line 3... Line 3...
3
<P CLASS=INFO><B><A HREF="midibox_ng_manual.html">Back to main page...</A></B></P>
3
<P CLASS=INFO><B><A HREF="midibox_ng_manual.html">Back to main page...</A></B></P>
4
4
5
<H1>MIDIbox NG</H1>
5
<H1>MIDIbox NG</H1>
6
<H1>User Manual --- Standard Control Surface</H1>
6
<H1>User Manual --- Standard Control Surface</H1>
7
7
8
<P CLASS=INFO>The optional control surface allows to edit some (but not all) configuration values without the need of a computer.
8
<P CLASS=INFO>The optional Standard Control Surface (SCS) allows to edit some (but not all) configuration values without the need of a computer.
9
9
10
<center><img src="midio128/midio128_v3_cs.jpg" width="550" height=554></IMG></center>
10
<center><img src="midio128/midio128_v3_cs.jpg" width="550" height=554></IMG></center>
11
11
12
12
13
<H2> <IMG SRC="images/bullet.gif" ALT=""> Hardware: the original SCS </H2>
13
<H2> <IMG SRC="images/bullet.gif" ALT=""> Hardware: the original SCS </H2>
14
14
15
<P CLASS=INFO>Actually we've two ways how to access the SCS menu system. First let's describe the original SCS:</P>
15
<P CLASS=INFO>Actually we've two ways how to access the SCS menu system. First let's describe the original SCS:</P>
16
16
17
<P CLASS=INFO>A rotary encoder and 6 buttons are directly connected to J10 of the MBHP_CORE_LPC17 module to control the menu system:<BR>
17
<P CLASS=INFO>A <B>detented</B> rotary encoder and 6 buttons are directly connected to J10 of the MBHP_CORE_LPC17 module to control the menu system:<BR>
18
<a href="midibox_ng/mbng_scs.pdf">Schematic of the Standard Control Surface</A><BR>
18
<a href="midibox_ng/mbng_scs.pdf">Schematic of the Standard Control Surface</A><BR>
19
In addition a LCD is required. The recommended size is at least 2x20! Graphical LCDs (GLCDs) are supported as well.</P>
19
In addition a LCD is required. The recommended size is at least 2x20! Graphical LCDs (GLCDs) are supported as well.</P>
20
20
21
<P CLASS=INFO>The <A HREF="midio128.html">MIDIO128 project</A> uses the same control surface, which means that users who built a MIDIO128 can upload the MIDIbox NG firmware and control it with their existing hardware, and vice versa!
21
<P CLASS=INFO>The <A HREF="midio128.html">MIDIO128 project</A> uses the same control surface, which means that users who built a MIDIO128 can upload the MIDIbox NG firmware and control it with their existing hardware, and vice versa!
22
22
Line 61... Line 61...
61
61
62
<P CLASS=INFO>The SOFT1..4 and SHIFT button, as well as the encoder have no effect in the main page by default, but they can emulate controller ids!
62
<P CLASS=INFO>The SOFT1..4 and SHIFT button, as well as the encoder have no effect in the main page by default, but they can emulate controller ids!
63
63
64
<P CLASS=INFO>E.g. with following configuration, the SOFT buttons can be used to select a bank, and the SHIFT button is used to enable the FAST mode for rotary encoders:
64
<P CLASS=INFO>E.g. with following configuration, the SOFT buttons can be used to select a bank, and the SHIFT button is used to enable the FAST mode for rotary encoders:
65
65
66
<TT><PRE style="margin-left:50px">
66
<TT><PRE style="margin-left:20px; font-size:8pt">
67
# the SCS should emulate button/enc functions in main page
67
# the SCS should emulate button/enc functions in main page
68
SCS soft1_button_emu_id=2000 \
68
SCS soft1_button_emu_id=2000 \
69
    soft2_button_emu_id=2001 \
69
    soft2_button_emu_id=2001 \
70
    soft3_button_emu_id=2002 \
70
    soft3_button_emu_id=2002 \
71
    soft4_button_emu_id=2003 \
71
    soft4_button_emu_id=2003 \
Line 91... Line 91...
91
91
92
92
93
<H2> <IMG SRC="images/bullet.gif" ALT=""> Menu Pages </H2>
93
<H2> <IMG SRC="images/bullet.gif" ALT=""> Menu Pages </H2>
94
94
95
<P CLASS=DESC>The SCS menu will be entered by pressing the EXIT button in the main page:<BR>
95
<P CLASS=DESC>The SCS menu will be entered by pressing the EXIT button in the main page:<BR>
96
<IMG SRC="midibox_ng/cs/root1.gif" width=362 height=38 ALT="Screen"></IMG><BR>
96
<IMG SRC="midibox_ng/cs/root1.gif" width=422 height=38 ALT="Screen"></IMG><BR>
97
The pages are described in more details below.<BR>
97
The pages are described in more details below.<BR>
98
Note that the 2x20 LCD will only display 4 of these items at once. Use the rotary encoder to scroll through the menu, and use a soft button to select the item above the button. Use the Exit button to get back to the previous page.</P>
98
Note that the 2x20 LCD will only display 4 of these items at once. Use the rotary encoder to scroll through the menu, and use a soft button to select the item above the button. Use the Exit button to get back to the previous page.</P>
99
99
100
<P CLASS=DESC>By pressing the Shift button a special page will pop up:<BR>
100
<P CLASS=DESC>By pressing the Shift button a special page will pop up:<BR>
101
<IMG SRC="midibox_ng/cs/shift1.gif" width=242 height=38 ALT="Screen"></IMG><BR>
101
<IMG SRC="midibox_ng/cs/shift1.gif" width=242 height=38 ALT="Screen"></IMG><BR>
Line 104... Line 104...
104
  <LI><B>BPM:</B> <I>no function yet!</I>
104
  <LI><B>BPM:</B> <I>no function yet!</I>
105
  <LI><B>DOUT:</B> allows to disable all DOUT pins (like "All Notes Off") from any page
105
  <LI><B>DOUT:</B> allows to disable all DOUT pins (like "All Notes Off") from any page
106
  <LI><B>MSD:</B> enables/disables the Mass Storage Device driver as descriped in the "Integrated SD Card Reader" topic
106
  <LI><B>MSD:</B> enables/disables the Mass Storage Device driver as descriped in the "Integrated SD Card Reader" topic
107
</UL>
107
</UL>
108
108
-
 
109
109
<P CLASS=DESC>The <B>Var(iable)</B> page:<BR>
110
<H2> <IMG SRC="images/bullet.gif" ALT=""> Var(iable) </H2>
-
 
111
110
<IMG SRC="midibox_ng/cs/var1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
112
<IMG SRC="midibox_ng/cs/var1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
111
allows to change SysEx dump related variables directly from the control surface:
113
<P CLASS=DESC>The Var page allows to change SysEx dump related variables directly from the control surface:
112
<UL CLASS=CL>
114
<UL CLASS=CL>
113
  <LI><B>Dev:</B> the device number <I>^dev</I>
115
  <LI><B>Dev:</B> the device number <I>^dev</I>
114
  <LI><B>Pat:</B> the patch number <I>^pat</I>
116
  <LI><B>Pat:</B> the patch number <I>^pat</I>
115
  <LI><B>Bnk:</B> the bank number <I>^bnk</I>
117
  <LI><B>Bnk:</B> the bank number <I>^bnk</I>
116
  <LI><B>Ins:</B> the instrument number <I>^ins</I>
118
  <LI><B>Ins:</B> the instrument number <I>^ins</I>
Line 118... Line 120...
118
</UL>
120
</UL>
119
121
120
<P CLASS=DESC>The variables could also be used for other purposes of course, they are only placeholders for typical usecases.
122
<P CLASS=DESC>The variables could also be used for other purposes of course, they are only placeholders for typical usecases.
121
123
122
124
123
<P CLASS=DESC>The <B>Router</B> page:<BR>
125
<H2> <IMG SRC="images/bullet.gif" ALT=""> Router </H2>
-
 
126
124
<IMG SRC="midibox_ng/cs/rout1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
127
<IMG SRC="midibox_ng/cs/rout1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
125
allows to configure the integrated MIDI Router.<BR>
128
<P CLASS=DESC>The Router page allows to configure the integrated MIDI Router.<BR>
126
The router consists of 16 "nodes".<BR>
129
The router consists of 16 "nodes".<BR>
127
Each node can be connected to an individual source and destination port.<BR>
130
Each node can be connected to an individual source and destination port.<BR>
128
A node is activated by selecting a source MIDI channel != "--", e.g. 1..16 or All (for all channels).<BR>
131
A node is activated by selecting a source MIDI channel != "--", e.g. 1..16 or All (for all channels).<BR>
129
The node will forward a MIDI event to the destination port. Either to the original channel ("All"), or to a changed channel (1..16)
132
The node will forward a MIDI event to the destination port. Either to the original channel ("All"), or to a changed channel (1..16)
130
133
Line 135... Line 138...
135
  <LI><B>DstP:</B> the destination port
138
  <LI><B>DstP:</B> the destination port
136
  <LI><B>Chn.:</B> the destination channel ("--" to disable, 1..16 to change the channel, or "All" to keep it untouched)
139
  <LI><B>Chn.:</B> the destination channel ("--" to disable, 1..16 to change the channel, or "All" to keep it untouched)
137
</UL>
140
</UL>
138
141
139
142
140
<P CLASS=DESC>The <B>OSC</B> page:<BR>
143
<H2> <IMG SRC="images/bullet.gif" ALT=""> OSC </H2>
141
144
142
<P CLASS=DESC>Aside from the possibility to configure Ethernet and OSC Server/Client from the MIOS Terminal as described at the <A HREF="midibox_osc.html">MIDIbox OSC page</A>, it's also possible to change the settings from the control surface:<BR>
145
<P CLASS=DESC>Aside from the possibility to configure Ethernet and OSC Server/Client from the MIOS Terminal as described at the <A HREF="midibox_osc.html">MIDIbox OSC page</A>, it's also possible to change the settings from the control surface:<BR>
143
<IMG SRC="midibox_ng/cs/osc1.gif" width=422 height=38 ALT="Screen"></IMG><BR>
146
<IMG SRC="midibox_ng/cs/osc1.gif" width=422 height=38 ALT="Screen"></IMG><BR>
144
allows to configure the OSC ports 1..4.<BR>
147
allows to configure the OSC ports 1..4.<BR>
145
Each OSC port has an individual remote IP, a remote port (to which OSC packets will be sent) and a local port (from which OSC packets will be received). Various packet formats are supported, additional modes can be added in future on request.
148
Each OSC port has an individual remote IP, a remote port (to which OSC packets will be sent) and a local port (from which OSC packets will be received). Various packet formats are supported, additional modes can be added in future on request.
Line 158... Line 161...
158
      <LI><B>TOSC (TouchOSC):</B> selects format which is used by <A HREF="http://hexler.net/software/touchosc" TARGET="_blank">TouchOSC</A>
161
      <LI><B>TOSC (TouchOSC):</B> selects format which is used by <A HREF="http://hexler.net/software/touchosc" TARGET="_blank">TouchOSC</A>
159
    </UL>
162
    </UL>
160
</UL>
163
</UL>
161
</P>
164
</P>
162
165
163
<P CLASS=DESC>See the <A HREF="midibox_osc.html">MIDIbox OSC page</A> for more details about the OSC protocol.</P>
166
<P CLASS=DESC>See the <A HREF="midibox_osc.html">MIDIbox OSC chapter</A> for more details about the OSC protocol.</P>
-
 
167
-
 
168
-
 
169
<H2> <IMG SRC="images/bullet.gif" ALT=""> Network </H2>
164
170
165
<P CLASS=DESC>The <B>Network</B> page:<BR>
-
 
166
<IMG SRC="midibox_ng/cs/netw1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
171
<IMG SRC="midibox_ng/cs/netw1.gif" width=302 height=38 ALT="Screen"></IMG><BR>
167
allows to configure the Ethernet interface of the <A HREF="mbhp_core_lpc17.html">MBHP_CORE_LPC17</A> module.
172
<P CLASS=DESC>The Network page allows to configure the Ethernet interface of the <A HREF="mbhp_core_lpc17.html">MBHP_CORE_LPC17</A> module.
168
173
169
<UL CLASS=CL>
174
<UL CLASS=CL>
170
  <LI><B>DHCP:</B> if enabled (default), the Host IP, Network Mask and Gateway address will be requested from a DHCP Daemon (e.g. your wireless router) automatically whenever the ethernet cable is connected. The configuration could take some seconds depending on the responsiveness of your router.
175
  <LI><B>DHCP:</B> if enabled (default), the Host IP, Network Mask and Gateway address will be requested from a DHCP Daemon (e.g. your wireless router) automatically whenever the ethernet cable is connected. The configuration could take some seconds depending on the responsiveness of your router.
171
  <LI><B>IP Host:</B> if DHCP on: displays the current IP address, if DHCP off: allows to enter the IP address of your MIDIbox NG manually
176
  <LI><B>IP Host:</B> if DHCP on: displays the current IP address, if DHCP off: allows to enter the IP address of your MIDIbox NG manually
172
  <LI><B>Netmask:</B> if DHCP on: displays the current netmask, if DHCP off: allows to enter the netmask of your MIDIbox NG manually
177
  <LI><B>Netmask:</B> if DHCP on: displays the current netmask, if DHCP off: allows to enter the netmask of your MIDIbox NG manually
173
  <LI><B>IP Gateway:</B> if DHCP on: displays the current gateway address, if DHCP off: allows to enter the gateway of the ethernet network manually
178
  <LI><B>IP Gateway:</B> if DHCP on: displays the current gateway address, if DHCP off: allows to enter the gateway of the ethernet network manually
174
</UL>
179
</UL>
175
180
-
 
181
176
<P CLASS=DESC>The <B>Monitor</B> page:<BR>
182
<H2> <IMG SRC="images/bullet.gif" ALT=""> Monitor </H2>
-
 
183
177
<IMG SRC="midibox_ng/cs/mon1.gif" width=722 height=38 ALT="Screen"></IMG><BR>
184
<IMG SRC="midibox_ng/cs/mon1.gif" width=722 height=38 ALT="Screen"></IMG><BR>
178
shows all IN ports at the upper line, and OUT ports at the lower line.</P>
185
<P CLASS=DESC>The Monitor page shows all IN ports at the upper line, and OUT ports at the lower line.</P>
179
186
180
<P CLASS=DESC>Whenever an event is received or sent, the appr. item will show the event for a short moment.<BR>
187
<P CLASS=DESC>Whenever an event is received or sent, the appr. item will show the event for a short moment.<BR>
181
This gives you a great overview of the MIDI activity, especially to analyze the current track and MIDI router setup.</P>
188
This gives you a great overview of the MIDI activity, especially to analyze the current track and MIDI router setup.</P>
182
189
183
190
-
 
191
-
 
192
<H2> <IMG SRC="images/bullet.gif" ALT=""> Learn </H2>
-
 
193
184
<P CLASS=DESC>The <B>Disk</B> page:<BR>
194
<P CLASS=DESC>The MIDI Learn function allows to assign a received MIDI event (Note/Aftertouch/CC/Program Change/PitchBender) to a controller (button/encoder/pot/motorfader). In NRPN mode it's even possible to assign an incoming NRPN event. In this learn mode, CC#6/38/98/99 will be transformed to an NRPN and can't be learned "standalone", therefore it's provided as a separate selection.
-
 
195
-
 
196
<P CLASS=DESC>The usage is simple:<BR>
-
 
197
<IMG SRC="midibox_ng/cs/learn1.gif" width=242 height=38 ALT="Screen"></IMG><BR>
-
 
198
<P CLASS=DESC>Select either "Common" or "NRPN" to start the learning procedure. Thereafter following screen will appear:<BR>
-
 
199
<IMG SRC="midibox_ng/cs/learn2.gif" width=242 height=38 ALT="Screen"></IMG><BR>
-
 
200
which tells you that MBNG is waiting for an incoming MIDI event.
-
 
201
-
 
202
<P CLASS=DESC>The incoming MIDI event should be sent over the full range (e..g. 0...127) to define the min/max value of the event which should be learnt:
-
 
203
<IMG SRC="midibox_ng/cs/learn3.gif" width=242 height=38 ALT="Screen"></IMG><BR>
-
 
204
Once the values have been received, just move the controller (button/encoder/pot/motorfader) to which the new event should be assigned.</P>
-
 
205
-
 
206
<P CLASS=DESC>-&gt; done!</P>
-
 
207
-
 
208
<P CLASS=DESC>Please note that it's also possible to assign the MIDI Learn function to a dedicated button by using a <A HREF="midibox_ng_manual_ngc.html">Meta Function</A>.</P>
-
 
209
-
 
210
<H2> <IMG SRC="images/bullet.gif" ALT=""> Disk </H2>
-
 
211
185
<IMG SRC="midibox_ng/cs/disk1.gif" width=242 height=38 ALT="Screen"></IMG><BR>
212
<IMG SRC="midibox_ng/cs/disk1.gif" width=242 height=38 ALT="Screen"></IMG><BR>
186
allows to store and restore a patch on SD Card of a given name.
213
<P CLASS=DESC>The Disk page allows to store and restore a patch on SD Card of a given name.
187
214
188
<UL CLASS=CL>
215
<UL CLASS=CL>
189
  <LI><B>Load:</B> opens a filename browser for all .MIO files found on SD Card:<BR>
216
  <LI><B>Load:</B> opens a filename browser for all .MIO files found on SD Card:<BR>
190
      <IMG SRC="midibox_ng/cs/disk2.gif" width=242 height=38 ALT="Screen"></IMG><BR>
217
      <IMG SRC="midibox_ng/cs/disk2.gif" width=242 height=38 ALT="Screen"></IMG><BR>
191
      Select one of these files to load the patch (or press the Exit button to cancel this operation).
218
      Select one of these files to load the patch (or press the Exit button to cancel this operation).