ce4c1aebf4a2e95d404384f86d2ce82fa77e140c
[libsigrokdecode.git] / decoders / midi / lists.py
1 ##
2 ## This file is part of the libsigrokdecode project.
3 ##
4 ## Copyright (C) 2013-2016 Uwe Hermann <uwe@hermann-uwe.de>
5 ## Copyright (C) 2016 Chris Dreher <chrisdreher@hotmail.com>
6 ##
7 ## This program is free software; you can redistribute it and/or modify
8 ## it under the terms of the GNU General Public License as published by
9 ## the Free Software Foundation; either version 2 of the License, or
10 ## (at your option) any later version.
11 ##
12 ## This program is distributed in the hope that it will be useful,
13 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
14 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 ## GNU General Public License for more details.
16 ##
17 ## You should have received a copy of the GNU General Public License
18 ## along with this program; if not, write to the Free Software
19 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
20 ##
21
22 # Each status byte has 3 string names, each shorter than the previous
23 status_bytes = {
24     # Channel voice messages
25     0x80: ['note off', 'note off', 'N off'],
26     0x90: ['note on', 'note on', 'N on'], # However, velocity = 0 means "note off".
27     0xa0: ['polyphonic key pressure / aftertouch', 'key pressure', 'KP' ],
28     0xb0: ['control change', 'ctrl chg', 'CC'],
29     0xc0: ['program change', 'prgm chg', 'PC'],
30     0xd0: ['channel pressure / aftertouch', 'channel pressure', 'CP'],
31     0xe0: ['pitch bend change', 'pitch bend', 'PB'],
32
33     # Channel mode messages
34     # 0xb0: 'select channel mode', # Note: Same as 'control change'.
35
36     # System exclusive messages
37     0xf0: ['system exclusive', 'SysEx', 'SE'],
38
39     # System common messages
40     0xf1: ['MIDI time code quarter frame', 'MIDI time code', 'MIDI time'],
41     0xf2: ['song position pointer', 'song position', 'song pos'],
42     0xf3: ['song select', 'song select', 'song sel'],
43     0xf4: ['undefined 0xf4', 'undef 0xf4', 'undef'],
44     0xf5: ['undefined 0xf5', 'undef 0xf5', 'undef'],
45     0xf6: ['tune request', 'tune request', 'tune req'],
46     0xf7: ['end of system exclusive (EOX)', 'end of SysEx', 'EOX'],
47
48     # System real time messages
49     0xf8: ['timing clock', 'timing clock', 'clock'],
50     0xf9: ['undefined 0xf9', 'undef 0xf9', 'undef'],
51     0xfa: ['start', 'start', 's'],
52     0xfb: ['continue', 'continue', 'cont'],
53     0xfc: ['stop', 'stop', 'st'],
54     0xfd: ['undefined 0xfd', 'undef 0xfd', 'undef'],
55     0xfe: ['active sensing', 'active sensing', 'sensing'],
56     0xff: ['system reset', 'reset', 'rst'],
57 }
58
59 # Universal system exclusive (SysEx) messages, non-realtime (0x7e)
60 universal_sysex_nonrealtime = {
61     (0x00, None): 'unused',
62     (0x01, None): 'sample dump header',
63     (0x02, None): 'sample data packet',
64     (0x03, None): 'sample dump request',
65
66     (0x04, None): 'MIDI time code',
67     (0x04, 0x00): 'special',
68     (0x04, 0x01): 'punch in points',
69     (0x04, 0x02): 'punch out points',
70     (0x04, 0x03): 'delete punch in point',
71     (0x04, 0x04): 'delete punch out point',
72     (0x04, 0x05): 'event start point',
73     (0x04, 0x06): 'event stop point',
74     (0x04, 0x07): 'event start points with additional info',
75     (0x04, 0x08): 'event stop points with additional info',
76     (0x04, 0x09): 'delete event start point',
77     (0x04, 0x0a): 'delete event stop point',
78     (0x04, 0x0b): 'cue points',
79     (0x04, 0x0c): 'cue points with additional info',
80     (0x04, 0x0d): 'delete cue point',
81     (0x04, 0x0e): 'event name in additional info',
82
83     (0x05, None): 'sample dump extensions',
84     (0x05, 0x01): 'multiple loop points',
85     (0x05, 0x02): 'loop points request',
86
87     (0x06, None): 'general information',
88     (0x06, 0x01): 'identity request',
89     (0x06, 0x02): 'identity reply',
90
91     (0x07, None): 'file dump',
92     (0x07, 0x01): 'header',
93     (0x07, 0x02): 'data packet',
94     (0x07, 0x03): 'request',
95
96     (0x08, None): 'MIDI tuning standard',
97     (0x08, 0x00): 'bulk dump request',
98     (0x08, 0x01): 'bulk dump reply',
99
100     (0x09, None): 'general MIDI',
101     (0x09, 0x01): 'general MIDI system on',
102     (0x09, 0x02): 'general MIDI system off',
103
104     (0x7b, None): 'end of file',
105     (0x7c, None): 'wait',
106     (0x7d, None): 'cancel',
107     (0x7e, None): 'nak',
108     (0x7f, None): 'ack',
109 }
110
111 # Universal system exclusive (SysEx) messages, realtime (0x7f)
112 universal_sysex_realtime = {
113     (0x00, None): 'unused',
114
115     (0x01, None): 'MIDI time code',
116     (0x01, 0x01): 'full message',
117     (0x01, 0x02): 'user bits',
118
119     (0x02, None): 'MIDI show control',
120     (0x02, 0x00): 'MSC extensions',
121     # (0x02, TODO): 'TODO', # 0x01 - 0x7f: MSC commands.
122
123     (0x03, None): 'notation information',
124     (0x03, 0x01): 'bar number',
125     (0x03, 0x02): 'time signature (immediate)',
126     (0x03, 0x42): 'time signature (delayed)',
127
128     (0x04, None): 'device control',
129     (0x04, 0x01): 'master volume',
130     (0x04, 0x02): 'master balance',
131
132     (0x05, None): 'real time MTC cueing',
133     (0x05, 0x00): 'special',
134     (0x05, 0x01): 'punch in points',
135     (0x05, 0x02): 'punch out points',
136     (0x05, 0x03): 'reserved',
137     (0x05, 0x04): 'reserved',
138     (0x05, 0x05): 'event start points',
139     (0x05, 0x06): 'event stop points',
140     (0x05, 0x07): 'event start points with additional info',
141     (0x05, 0x08): 'event stop points with additional info',
142     (0x05, 0x09): 'reserved',
143     (0x05, 0x0a): 'reserved',
144     (0x05, 0x0b): 'cue points',
145     (0x05, 0x0c): 'cue points with additional info',
146     (0x05, 0x0d): 'reserved',
147     (0x05, 0x0e): 'event name in additional info',
148
149     (0x06, None): 'MIDI machine control commands',
150     # (0x06, TODO): 'TODO', # 0x00 - 0x7f: MMC commands.
151
152     (0x07, None): 'MIDI machine control responses',
153     # (0x07, TODO): 'TODO', # 0x00 - 0x7f: MMC commands.
154
155     (0x08, None): 'MIDI tuning standard',
156     (0x85, 0x02): 'note change',
157 }
158
159 # Note: Not all IDs are used/listed, i.e. there are some "holes".
160 sysex_manufacturer_ids = {
161     # American group (range 01-1f, 000001-001f7f)
162     (0x01,): 'Sequential',
163     (0x02,): 'IDP',
164     (0x03,): 'Voyetra/Octave-Plateau',
165     (0x04,): 'Moog',
166     (0x05,): 'Passport Designs',
167     (0x06,): 'Lexicon',
168     (0x07,): 'Kurzweil',
169     (0x08,): 'Fender',
170     (0x09,): 'Gulbransen',
171     (0x0a,): 'AKG Acoustics',
172     (0x0b,): 'Voyce Music',
173     (0x0c,): 'Waveframe Corp',
174     (0x0d,): 'ADA Signal Processors',
175     (0x0e,): 'Garfield Electronics',
176     (0x0f,): 'Ensoniq',
177     (0x10,): 'Oberheim',
178     (0x11,): 'Apple Computer',
179     (0x12,): 'Grey Matter Response',
180     (0x13,): 'Digidesign',
181     (0x14,): 'Palm Tree Instruments',
182     (0x15,): 'JLCooper Electronics',
183     (0x16,): 'Lowrey',
184     (0x17,): 'Adams-Smith',
185     (0x18,): 'Emu Systems',
186     (0x19,): 'Harmony Systems',
187     (0x1a,): 'ART',
188     (0x1b,): 'Baldwin',
189     (0x1c,): 'Eventide',
190     (0x1d,): 'Inventronics',
191     (0x1f,): 'Clarity',
192
193     (0x00, 0x00, 0x01): 'Time Warner Interactive',
194     (0x00, 0x00, 0x07): 'Digital Music Corp.',
195     (0x00, 0x00, 0x08): 'IOTA Systems',
196     (0x00, 0x00, 0x09): 'New England Digital',
197     (0x00, 0x00, 0x0a): 'Artisyn',
198     (0x00, 0x00, 0x0b): 'IVL Technologies',
199     (0x00, 0x00, 0x0c): 'Southern Music Systems',
200     (0x00, 0x00, 0x0d): 'Lake Butler Sound Company',
201     (0x00, 0x00, 0x0e): 'Alesis',
202     (0x00, 0x00, 0x10): 'DOD Electronics',
203     (0x00, 0x00, 0x11): 'Studer-Editech',
204     (0x00, 0x00, 0x14): 'Perfect Fretworks',
205     (0x00, 0x00, 0x15): 'KAT',
206     (0x00, 0x00, 0x16): 'Opcode',
207     (0x00, 0x00, 0x17): 'Rane Corp.',
208     (0x00, 0x00, 0x18): 'Anadi Inc.',
209     (0x00, 0x00, 0x19): 'KMX',
210     (0x00, 0x00, 0x1a): 'Allen & Heath Brenell',
211     (0x00, 0x00, 0x1b): 'Peavy Electronics',
212     (0x00, 0x00, 0x1c): '360 Systems',
213     (0x00, 0x00, 0x1d): 'Spectrum Design and Development',
214     (0x00, 0x00, 0x1e): 'Marquis Music',
215     (0x00, 0x00, 0x1f): 'Zeta Systems',
216
217     (0x00, 0x00, 0x20): 'Axxes',
218     (0x00, 0x00, 0x21): 'Orban',
219     (0x00, 0x00, 0x24): 'KTI',
220     (0x00, 0x00, 0x25): 'Breakaway Technologies',
221     (0x00, 0x00, 0x26): 'CAE',
222     (0x00, 0x00, 0x29): 'Rocktron Corp.',
223     (0x00, 0x00, 0x2a): 'PianoDisc',
224     (0x00, 0x00, 0x2b): 'Cannon Research Group',
225     (0x00, 0x00, 0x2d): 'Rogers Instrument Corp.',
226     (0x00, 0x00, 0x2e): 'Blue Sky Logic',
227     (0x00, 0x00, 0x2f): 'Encore Electronics',
228
229     (0x00, 0x00, 0x30): 'Uptown',
230     (0x00, 0x00, 0x31): 'Voce',
231     (0x00, 0x00, 0x32): 'CTI Audio, Inc. (Music. Intel Dev.)',
232     (0x00, 0x00, 0x33): 'S&S Research',
233     (0x00, 0x00, 0x34): 'Broderbund Software, Inc.',
234     (0x00, 0x00, 0x35): 'Allen Organ Co.',
235     (0x00, 0x00, 0x37): 'Music Quest',
236     (0x00, 0x00, 0x38): 'APHEX',
237     (0x00, 0x00, 0x39): 'Gallien Krueger',
238     (0x00, 0x00, 0x3a): 'IBM',
239     (0x00, 0x00, 0x3c): 'Hotz Instruments Technologies',
240     (0x00, 0x00, 0x3d): 'ETA Lighting',
241     (0x00, 0x00, 0x3e): 'NSI Corporation',
242     (0x00, 0x00, 0x3f): 'Ad Lib, Inc.',
243
244     (0x00, 0x00, 0x40): 'Richmond Sound Design',
245     (0x00, 0x00, 0x41): 'Microsoft',
246     (0x00, 0x00, 0x42): 'The Software Toolworks',
247     (0x00, 0x00, 0x43): 'Niche/RJMG',
248     (0x00, 0x00, 0x44): 'Intone',
249     (0x00, 0x00, 0x47): 'GT Electronics / Groove Tubes',
250     (0x00, 0x00, 0x49): 'Timeline Vista',
251     (0x00, 0x00, 0x4a): 'Mesa Boogie',
252     (0x00, 0x00, 0x4c): 'Sequoia Development',
253     (0x00, 0x00, 0x4d): 'Studio Electronics',
254     (0x00, 0x00, 0x4e): 'Euphonix',
255     (0x00, 0x00, 0x4f): 'InterMIDI, Inc.',
256
257     (0x00, 0x00, 0x50): 'MIDI Solutions',
258     (0x00, 0x00, 0x51): '3DO Company',
259     (0x00, 0x00, 0x52): 'Lightwave Research',
260     (0x00, 0x00, 0x53): 'Micro-W',
261     (0x00, 0x00, 0x54): 'Spectral Synthesis',
262     (0x00, 0x00, 0x55): 'Lone Wolf',
263     (0x00, 0x00, 0x56): 'Studio Technologies',
264     (0x00, 0x00, 0x57): 'Peterson EMP',
265     (0x00, 0x00, 0x58): 'Atari',
266     (0x00, 0x00, 0x59): 'Marion Systems',
267     (0x00, 0x00, 0x5a): 'Design Event',
268     (0x00, 0x00, 0x5b): 'Winjammer Software',
269     (0x00, 0x00, 0x5c): 'AT&T Bell Labs',
270     (0x00, 0x00, 0x5e): 'Symetrix',
271     (0x00, 0x00, 0x5f): 'MIDI the World',
272
273     (0x00, 0x00, 0x60): 'Desper Products',
274     (0x00, 0x00, 0x61): 'Micros\'N MIDI',
275     (0x00, 0x00, 0x62): 'Accordians Intl',
276     (0x00, 0x00, 0x63): 'EuPhonics',
277     (0x00, 0x00, 0x64): 'Musonix',
278     (0x00, 0x00, 0x65): 'Turtle Beach Systems',
279     (0x00, 0x00, 0x66): 'Mackie Designs',
280     (0x00, 0x00, 0x67): 'Compuserve',
281     (0x00, 0x00, 0x68): 'BES Technologies',
282     (0x00, 0x00, 0x69): 'QRS Music Rolls',
283     (0x00, 0x00, 0x6a): 'P G Music',
284     (0x00, 0x00, 0x6b): 'Sierra Semiconductor',
285     (0x00, 0x00, 0x6c): 'EpiGraf Audio Visual',
286     (0x00, 0x00, 0x6d): 'Electronics Deiversified',
287     (0x00, 0x00, 0x6e): 'Tune 1000',
288     (0x00, 0x00, 0x6f): 'Advanced Micro Devices',
289
290     (0x00, 0x00, 0x70): 'Mediamation',
291     (0x00, 0x00, 0x71): 'Sabine Music',
292     (0x00, 0x00, 0x72): 'Woog Labs',
293     (0x00, 0x00, 0x73): 'Micropolis',
294     (0x00, 0x00, 0x74): 'Ta Horng Musical Inst.',
295     (0x00, 0x00, 0x75): 'eTek (formerly Forte)',
296     (0x00, 0x00, 0x76): 'Electrovoice',
297     (0x00, 0x00, 0x77): 'Midisoft',
298     (0x00, 0x00, 0x78): 'Q-Sound Labs',
299     (0x00, 0x00, 0x79): 'Westrex',
300     (0x00, 0x00, 0x7a): 'NVidia',
301     (0x00, 0x00, 0x7b): 'ESS Technology',
302     (0x00, 0x00, 0x7c): 'MediaTrix Peripherals',
303     (0x00, 0x00, 0x7d): 'Brooktree',
304     (0x00, 0x00, 0x7e): 'Otari',
305     (0x00, 0x00, 0x7f): 'Key Electronics',
306
307     (0x00, 0x01, 0x01): 'Crystalake Multimedia',
308     (0x00, 0x01, 0x02): 'Crystal Semiconductor',
309     (0x00, 0x01, 0x03): 'Rockwell Semiconductor',
310
311     # European group (range 20-3f, 002000-003f7f)
312     (0x20,): 'Passac',
313     (0x21,): 'SIEL',
314     (0x22,): 'Synthaxe',
315     (0x24,): 'Hohner',
316     (0x25,): 'Twister',
317     (0x26,): 'Solton',
318     (0x27,): 'Jellinghaus MS',
319     (0x28,): 'Southworth Music Systems',
320     (0x29,): 'PPG',
321     (0x2a,): 'JEN',
322     (0x2b,): 'SSL Limited',
323     (0x2c,): 'Audio Veritrieb',
324     (0x2f,): 'Elka',
325
326     (0x30,): 'Dynacord',
327     (0x31,): 'Viscount',
328     (0x33,): 'Clavia Digital Instruments',
329     (0x34,): 'Audio Architecture',
330     (0x35,): 'GeneralMusic Corp.',
331     (0x39,): 'Soundcraft Electronics',
332     (0x3b,): 'Wersi',
333     (0x3c,): 'Avab Elektronik Ab',
334     (0x3d,): 'Digigram',
335     (0x3e,): 'Waldorf Electronics',
336     (0x3f,): 'Quasimidi',
337
338     (0x00, 0x20, 0x00): 'Dream',
339     (0x00, 0x20, 0x01): 'Strand Lighting',
340     (0x00, 0x20, 0x02): 'Amek Systems',
341     (0x00, 0x20, 0x04): 'Böhm Electronic',
342     (0x00, 0x20, 0x06): 'Trident Audio',
343     (0x00, 0x20, 0x07): 'Real World Studio',
344     (0x00, 0x20, 0x09): 'Yes Technology',
345     (0x00, 0x20, 0x0a): 'Audiomatica',
346     (0x00, 0x20, 0x0b): 'Bontempi/Farfisa',
347     (0x00, 0x20, 0x0c): 'F.B.T. Elettronica',
348     (0x00, 0x20, 0x0d): 'MidiTemp',
349     (0x00, 0x20, 0x0e): 'LA Audio (Larking Audio)',
350     (0x00, 0x20, 0x0f): 'Zero 88 Lighting Limited',
351
352     (0x00, 0x20, 0x10): 'Micon Audio Electronics GmbH',
353     (0x00, 0x20, 0x11): 'Forefront Technology',
354     (0x00, 0x20, 0x13): 'Kenton Electronics',
355     (0x00, 0x20, 0x15): 'ADB',
356     (0x00, 0x20, 0x16): 'Marshall Products',
357     (0x00, 0x20, 0x17): 'DDA',
358     (0x00, 0x20, 0x18): 'BSS',
359     (0x00, 0x20, 0x19): 'MA Lighting Technology',
360     (0x00, 0x20, 0x1a): 'Fatar',
361     (0x00, 0x20, 0x1b): 'QSC Audio',
362     (0x00, 0x20, 0x1c): 'Artisan Classic Organ',
363     (0x00, 0x20, 0x1d): 'Orla Spa',
364     (0x00, 0x20, 0x1e): 'Pinnacle Audio',
365     (0x00, 0x20, 0x1f): 'TC Electronics',
366
367     (0x00, 0x20, 0x20): 'Doepfer Musikelektronik',
368     (0x00, 0x20, 0x21): 'Creative Technology Pte',
369     (0x00, 0x20, 0x22): 'Minami/Seiyddo',
370     (0x00, 0x20, 0x23): 'Goldstar',
371     (0x00, 0x20, 0x24): 'Midisoft s.a.s di M. Cima',
372     (0x00, 0x20, 0x25): 'Samick',
373     (0x00, 0x20, 0x26): 'Penny and Giles',
374     (0x00, 0x20, 0x27): 'Acorn Computer',
375     (0x00, 0x20, 0x28): 'LSC Electronics',
376     (0x00, 0x20, 0x29): 'Novation EMS',
377     (0x00, 0x20, 0x2a): 'Samkyung Mechatronics',
378     (0x00, 0x20, 0x2b): 'Medeli Electronics',
379     (0x00, 0x20, 0x2c): 'Charlie Lab',
380     (0x00, 0x20, 0x2d): 'Blue Chip Music Tech',
381     (0x00, 0x20, 0x2e): 'BEE OH Corp',
382
383     # Japanese group (range 40-5f, 004000-005f7f)
384     (0x40,): 'Kawai',
385     (0x41,): 'Roland',
386     (0x42,): 'Korg',
387     (0x43,): 'Yamaha',
388     (0x44,): 'Casio',
389     (0x46,): 'Kamiya Studio',
390     (0x47,): 'Akai',
391     (0x48,): 'Japan Victor',
392     (0x49,): 'Mesosha',
393     (0x4a,): 'Hoshino Gakki',
394     (0x4b,): 'Fujitsu Elect',
395     (0x4c,): 'Sony',
396     (0x4d,): 'Nisshin Onpa',
397     (0x4e,): 'TEAC',
398     (0x50,): 'Matsushita Electric',
399     (0x51,): 'Fostex',
400     (0x52,): 'Zoom',
401     (0x53,): 'Midori Electronics',
402     (0x54,): 'Matsushita Communication Industrial',
403     (0x55,): 'Suzuki Musical Inst. Mfg.',
404
405     # Other (range 60-7c, 006000-007f7f)
406
407     # Special (7d-7f)
408     (0x7d,): 'Non-Commercial',
409     (0x7e,): 'Universal Non-Realtime',
410     (0x7f,): 'Universal Realtime',
411 }
412
413 control_functions = {
414     0x00: ['bank select MSB', 'bank MSB', 'bank-M'],
415     0x01: ['modulation wheel/lever MSB', 'modulation MSB', 'mod-M'],
416     0x02: ['breath controller MSB', 'breath MSB', 'breath-M'],
417     # 0x03: undefined MSB
418     0x04: ['foot controller MSB', 'foot MSB', 'foot-M'],
419     0x05: ['portamento time MSB', 'portamento MSB', 'porta-M'],
420     0x06: ['data entry MSB', 'data entry MSB', 'data-M'],
421     0x07: ['channel volume MSB (formerly main volume)', 'channel volume MSB', 'ch vol-M'],
422     0x08: ['balance MSB', 'bal MSB', 'bal-M'],
423     # 0x09: undefined MSB
424     0x0a: ['pan MSB', 'pan MSB', 'pan-M'],
425     0x0b: ['expression controller MSB', 'expression MSB', 'expr-M'],
426     0x0c: ['effect control 1 MSB', 'effect 1 MSB', 'eff-1-M'],
427     0x0d: ['effect control 2 MSB', 'effect 2 MSB', 'eff-2-M'],
428     # 0x0e-0x0f: undefined MSB
429     0x10: ['general purpose controller 1 MSB', 'GP ctrl 1 MSB', 'GPC-1-M'],
430     0x11: ['general purpose controller 2 MSB', 'GP ctrl 2 MSB', 'GPC-2-M'],
431     0x12: ['general purpose controller 3 MSB', 'GP ctrl 3 MSB', 'GPC-3-M'],
432     0x13: ['general purpose controller 4 MSB', 'GP ctrl 4 MSB', 'GPC-4-M'],
433     # 0x14-0x1f: undefined MSB
434     0x20: ['bank select LSB', 'bank LSB', 'bank-L'],
435     0x21: ['modulation wheel/lever LSB', 'modulation LSB', 'mod-L'],
436     0x22: ['breath controller LSB', 'breath LSB', 'breath-L'],
437     # 0x23: undefined LSB
438     0x24: ['foot controller LSB', 'foot LSB', 'foot-L'],
439     0x25: ['portamento time LSB', 'portamento LSB', 'porta-L'],
440     0x26: ['data entry LSB', 'data entry LSB', 'data-L'],
441     0x27: ['channel volume LSB (formerly main volume)', 'channel volume LSB', 'ch vol-L'],
442     0x28: ['balance LSB', 'bal LSB', 'bal-L'],
443     # 0x29: undefined LSB
444     0x2a: ['pan LSB', 'pan LSB', 'pan-L'],
445     0x2b: ['expression controller LSB', 'expression LSB', 'expr-L'],
446     0x2c: ['effect control 1 LSB', 'effect 1 LSB', 'eff-1-L'],
447     0x2d: ['effect control 2 LSB', 'effect 2 LSB', 'eff-2-L'],
448     # 0x2e-0x2f: undefined LSB
449     0x30: ['general purpose controller 1 LSB', 'GP ctrl 1 LSB', 'GPC-1-L'],
450     0x31: ['general purpose controller 2 LSB', 'GP ctrl 2 LSB', 'GPC-2-L'],
451     0x32: ['general purpose controller 3 LSB', 'GP ctrl 3 LSB', 'GPC-3-L'],
452     0x33: ['general purpose controller 4 LSB', 'GP ctrl 4 LSB', 'GPC-4-L'],
453     # 0x34-0x3f: undefined LSB
454     0x40: ['damper pedal (sustain)', 'sustain', 'sust'],
455     0x41: ['portamento on/off', 'porta on/off', 'porta on/off'],
456     0x42: ['sostenuto', 'sostenuto', 'sostenuto'],
457     0x43: ['soft pedal', 'soft pedal', 'soft pedal'],
458     0x44: ['legato footswitch', 'legato switch', 'legato'], # vv: 00-3f = normal, 40-7f = legato
459     0x45: ['hold 2', 'hold 2', 'hold 2'],
460     0x46: ['sound controller 1 (default: sound variation)', 'sound ctrl 1', 'snd ctrl 1'],
461     0x47: ['sound controller 2 (default: timbre / harmonic intensity)', 'sound ctrl 2', 'snd ctrl 2'],
462     0x48: ['sound controller 3 (default: release time)', 'sound ctrl 3', 'snd ctrl 3'],
463     0x49: ['sound controller 4 (default: attack time)', 'sound ctrl 4', 'snd ctrl 4'],
464     0x4a: ['sound controller 5 (default: brightness)', 'sound ctrl 5', 'snd ctrl 5'],
465     0x4b: ['sound controller 6 (GM2 default: decay time)', 'sound ctrl 6', 'snd ctrl 6'],
466     0x4c: ['sound controller 7 (GM2 default: vibrato rate)', 'sound ctrl 7', 'snd ctrl 7'],
467     0x4d: ['sound controller 8 (GM2 default: vibrato depth)', 'sound ctrl 8', 'snd ctrl 8'],
468     0x4e: ['sound controller 9 (GM2 default: vibrato delay)', 'sound ctrl 9', 'snd ctrl 9'],
469     0x4f: ['sound controller 10', 'sound ctrl 10', 'snd ctrl 10'],
470     0x50: ['general purpose controller 5', 'GP controller 5', 'GPC-5'],
471     0x51: ['general purpose controller 6', 'GP controller 6', 'GPC-6'],
472     0x52: ['general purpose controller 7', 'GP controller 7', 'GPC-7'],
473     0x53: ['general purpose controller 8', 'GP controller 8', 'GPC-8'],
474     0x54: ['portamento control', 'portamento ctrl', 'porta ctrl'],
475     # 0x55-0x5a: undefined
476     0x5b: ['effects 1 depth (formerly external effects depth)', 'effects 1 depth', 'eff 1 depth'],
477     0x5c: ['effects 2 depth (formerly tremolo depth)', 'effects 2 depth', 'eff 2 depth'],
478     0x5d: ['effects 3 depth (formerly chorus depth)', 'effects 3 depth', 'eff 3 depth'],
479     0x5e: ['effects 4 depth (formerly celeste/detune depth)', 'effects 4 depth', 'eff 4 depth'],
480     0x5f: ['effects 5 depth (formerly phaser depth)', 'effects 5 depth', 'eff 5 depth'],
481     0x60: ['data increment', 'data inc', 'data++'],
482     0x61: ['data decrement', 'data dec', 'data--'],
483     0x62: ['Non-Registered Parameter Number LSB', 'NRPN LSB', 'NRPN-L'],
484     0x63: ['Non-Registered Parameter Number MSB', 'NRPN MSB', 'NRPN-M'],
485     0x64: ['Registered Parameter Number LSB', 'RPN LSB', 'RPN-L'],
486     0x65: ['Registered Parameter Number MSB', 'RPN MSB', 'RPN-M'],
487     # 0x66-0x77: undefined
488     # 0x78-0x7f: reserved for channel mode messages
489     0x78: ['all sound off', 'all snd off', 'snd off'],
490     0x79: ['reset all controllers', 'reset all ctrls', 'reset ctrls'],
491     0x7a: ['local control', 'local ctrl', 'local ctrl'],
492     0x7b: ['all notes off', 'notes off', 'notes off'],
493     0x7c: ['omni mode off', 'omni off', 'omni off'], # all notes off
494     0x7d: ['omni mode on', 'omni on', 'omni on'], # all notes off
495     0x7e: ['mono mode on', 'mono on', 'mono'], # mono mode on, all notes off
496     0x7f: ['poly mode on', 'poly on', 'poly'], # mono mode off, all notes off
497 }
498
499 gm_instruments = {
500     1:   'Acoustic Grand Piano',
501     2:   'Bright Acoustic Piano',
502     3:   'Electric Grand Piano',
503     4:   'Honky-tonk Piano',
504     5:   'Electric Piano 1',
505     6:   'Electric Piano 2',
506     7:   'Harpsichord',
507     8:   'Clavi',
508     9:   'Celesta',
509     10:  'Glockenspiel',
510     11:  'Music Box',
511     12:  'Vibraphone',
512     13:  'Marimba',
513     14:  'Xylophone',
514     15:  'Tubular Bells',
515     16:  'Dulcimer',
516     17:  'Drawbar Organ',
517     18:  'Percussive Organ',
518     19:  'Rock Organ',
519     20:  'Church Organ',
520     21:  'Reed Organ',
521     22:  'Accordion',
522     23:  'Harmonica',
523     24:  'Tango Accordion',
524     25:  'Acoustic Guitar (nylon)',
525     26:  'Acoustic Guitar (steel)',
526     27:  'Electric Guitar (jazz)',
527     28:  'Electric Guitar (clean)',
528     29:  'Electric Guitar (muted)',
529     30:  'Overdriven Guitar',
530     31:  'Distortion Guitar',
531     32:  'Guitar harmonics',
532     33:  'Acoustic Bass',
533     34:  'Electric Bass (finger)',
534     35:  'Electric Bass (pick)',
535     36:  'Fretless Bass',
536     37:  'Slap Bass 1',
537     38:  'Slap Bass 2',
538     39:  'Synth Bass 1',
539     40:  'Synth Bass 2',
540     41:  'Violin',
541     42:  'Viola',
542     43:  'Cello',
543     44:  'Contrabass',
544     45:  'Tremolo Strings',
545     46:  'Pizzicato Strings',
546     47:  'Orchestral Harp',
547     48:  'Timpani',
548     49:  'String Ensemble 1',
549     50:  'String Ensemble 2',
550     51:  'SynthStrings 1',
551     52:  'SynthStrings 2',
552     53:  'Choir Aahs',
553     54:  'Voice Oohs',
554     55:  'Synth Voice',
555     56:  'Orchestra Hit',
556     57:  'Trumpet',
557     58:  'Trombone',
558     59:  'Tuba',
559     60:  'Muted Trumpet',
560     61:  'French Horn',
561     62:  'Brass Section',
562     63:  'SynthBrass 1',
563     64:  'SynthBrass 2',
564     65:  'Soprano Sax',
565     66:  'Alto Sax',
566     67:  'Tenor Sax',
567     68:  'Baritone Sax',
568     69:  'Oboe',
569     70:  'English Horn',
570     71:  'Bassoon',
571     72:  'Clarinet',
572     73:  'Piccolo',
573     74:  'Flute',
574     75:  'Recorder',
575     76:  'Pan Flute',
576     77:  'Blown Bottle',
577     78:  'Shakuhachi',
578     79:  'Whistle',
579     80:  'Ocarina',
580     81:  'Lead 1 (square)',
581     82:  'Lead 2 (sawtooth)',
582     83:  'Lead 3 (calliope)',
583     84:  'Lead 4 (chiff)',
584     85:  'Lead 5 (charang)',
585     86:  'Lead 6 (voice)',
586     87:  'Lead 7 (fifths)',
587     88:  'Lead 8 (bass + lead)',
588     89:  'Pad 1 (new age)',
589     90:  'Pad 2 (warm)',
590     91:  'Pad 3 (polysynth)',
591     92:  'Pad 4 (choir)',
592     93:  'Pad 5 (bowed)',
593     94:  'Pad 6 (metallic)',
594     95:  'Pad 7 (halo)',
595     96:  'Pad 8 (sweep)',
596     97:  'FX 1 (rain)',
597     98:  'FX 2 (soundtrack)',
598     99:  'FX 3 (crystal)',
599     100: 'FX 4 (atmosphere)',
600     101: 'FX 5 (brightness)',
601     102: 'FX 6 (goblins)',
602     103: 'FX 7 (echoes)',
603     104: 'FX 8 (sci-fi)',
604     105: 'Sitar',
605     106: 'Banjo',
606     107: 'Shamisen',
607     108: 'Koto',
608     109: 'Kalimba',
609     110: 'Bag pipe',
610     111: 'Fiddle',
611     112: 'Shanai',
612     113: 'Tinkle Bell',
613     114: 'Agogo',
614     115: 'Steel Drums',
615     116: 'Woodblock',
616     117: 'Taiko Drum',
617     118: 'Melodic Tom',
618     119: 'Synth Drum',
619     120: 'Reverse Cymbal',
620     121: 'Guitar Fret Noise',
621     122: 'Breath Noise',
622     123: 'Seashore',
623     124: 'Bird Tweet',
624     125: 'Telephone Ring',
625     126: 'Helicopter',
626     127: 'Applause',
627     128: 'Gunshot',
628 }
629
630 drum_kit = {
631     1:   'GM Standard Kit',
632     9:   'GS Room Kit',
633     17:  'GS Power Kit',
634     25:  'GS Power Kit',
635     26:  'GS TR-808 Kit',
636     33:  'GS Jazz Kit',
637     41:  'GS Brush Kit',
638     49:  'GS Orchestra Kit',
639     57:  'GS Sound FX Kit',
640     128: 'GS CM-64/CM-32 Kit',
641 }
642
643 # Each quarter frame type has 2 string names, each shorter than the previous
644 quarter_frame_type = {
645     0: ['frame count LS nibble', 'frame LSN'],
646     1: ['frame count MS nibble', 'frame MSN'],
647     2: ['seconds LS nibble', 'sec LSN'],
648     3: ['seconds MS nibble', 'sec MSN'],
649     4: ['minutes LS nibble', 'min LSN'],
650     5: ['minutes MS nibble', 'min MSN'],
651     6: ['hours LS nibble', 'hrs LSN'],
652     7: ['hours MS nibble and SMPTE type', 'hrs MSN'],
653 }
654
655 smpte_type = {
656     0: '24 fps',
657     1: '25 fps',
658     2: '30 fps (drop-frame)',
659     3: '30 fps (non-drop)',
660 }
661
662 chromatic_notes = {
663     0: 'C-1',
664     1: 'C#-1',
665     2: 'D-1',
666     3: 'D#-1',
667     4: 'E-1',
668     5: 'F-1',
669     6: 'F#-1',
670     7: 'G-1',
671     8: 'G#-1',
672     9: 'A-1',
673     10: 'A#-1',
674     11: 'B-1',
675     12: 'C0',
676     13: 'C#0',
677     14: 'D0',
678     15: 'D#0',
679     16: 'E0',
680     17: 'F0',
681     18: 'F#0',
682     19: 'G0',
683     20: 'G#0',
684     21: 'A0',
685     22: 'A#0',
686     23: 'B0',
687     24: 'C1',
688     25: 'C#1',
689     26: 'D1',
690     27: 'D#1',
691     28: 'E1',
692     29: 'F1',
693     30: 'F#1',
694     31: 'G1',
695     32: 'G#1',
696     33: 'A1',
697     34: 'A#1',
698     35: 'B1',
699     36: 'C2',
700     37: 'C#2',
701     38: 'D2',
702     39: 'D#2',
703     40: 'E2',
704     41: 'F2',
705     42: 'F#2',
706     43: 'G2',
707     44: 'G#2',
708     45: 'A2',
709     46: 'A#2',
710     47: 'B2',
711     48: 'C3',
712     49: 'C#3',
713     50: 'D3',
714     51: 'D#3',
715     52: 'E3',
716     53: 'F3',
717     54: 'F#3',
718     55: 'G3',
719     56: 'G#3',
720     57: 'A3',
721     58: 'A#3',
722     59: 'B3',
723     60: 'C4',
724     61: 'C#4',
725     62: 'D4',
726     63: 'D#4',
727     64: 'E4',
728     65: 'F4',
729     66: 'F#4',
730     67: 'G4',
731     68: 'G#4',
732     69: 'A4',
733     70: 'A#4',
734     71: 'B4',
735     72: 'C5',
736     73: 'C#5',
737     74: 'D5',
738     75: 'D#5',
739     76: 'E5',
740     77: 'F5',
741     78: 'F#5',
742     79: 'G5',
743     80: 'G#5',
744     81: 'A5',
745     82: 'A#5',
746     83: 'B5',
747     84: 'C6',
748     85: 'C#6',
749     86: 'D6',
750     87: 'D#6',
751     88: 'E6',
752     89: 'F6',
753     90: 'F#6',
754     91: 'G6',
755     92: 'G#6',
756     93: 'A6',
757     94: 'A#6',
758     95: 'B6',
759     96: 'C7',
760     97: 'C#7',
761     98: 'D7',
762     99: 'D#7',
763     100: 'E7',
764     101: 'F7',
765     102: 'F#7',
766     103: 'G7',
767     104: 'G#7',
768     105: 'A7',
769     106: 'A#7',
770     107: 'B7',
771     108: 'C8',
772     109: 'C#8',
773     110: 'D8',
774     111: 'D#8',
775     112: 'E8',
776     113: 'F8',
777     114: 'F#8',
778     115: 'G8',
779     116: 'G#8',
780     117: 'A8',
781     118: 'A#8',
782     119: 'B8',
783     120: 'C9',
784     121: 'C#9',
785     122: 'D9',
786     123: 'D#9',
787     124: 'E9',
788     125: 'F9',
789     126: 'F#9',
790     127: 'G9',
791 }
792
793 percussion_notes = {
794     35: 'Acoustic Bass Drum',
795     36: 'Bass Drum 1',
796     37: 'Side Stick',
797     38: 'Acoustic Snare',
798     39: 'Hand Clap',
799     40: 'Electric Snare',
800     41: 'Low Floor Tom',
801     42: 'Closed Hi Hat',
802     43: 'High Floor Tom',
803     44: 'Pedal Hi-Hat',
804     45: 'Low Tom',
805     46: 'Open Hi-Hat',
806     47: 'Low-Mid Tom',
807     48: 'Hi Mid Tom',
808     49: 'Crash Cymbal 1',
809     50: 'High Tom',
810     51: 'Ride Cymbal 1',
811     52: 'Chinese Cymbal',
812     53: 'Ride Bell',
813     54: 'Tambourine',
814     55: 'Splash Cymbal',
815     56: 'Cowbell',
816     57: 'Crash Cymbal 2',
817     58: 'Vibraslap',
818     59: 'Ride Cymbal 2',
819     60: 'Hi Bongo',
820     61: 'Low Bongo',
821     62: 'Mute Hi Conga',
822     63: 'Open Hi Conga',
823     64: 'Low Conga',
824     65: 'High Timbale',
825     66: 'Low Timbale',
826     67: 'High Agogo',
827     68: 'Low Agogo',
828     69: 'Cabasa',
829     70: 'Maracas',
830     71: 'Short Whistle',
831     72: 'Long Whistle',
832     73: 'Short Guiro',
833     74: 'Long Guiro',
834     75: 'Claves',
835     76: 'Hi Wood Block',
836     77: 'Low Wood Block',
837     78: 'Mute Cuica',
838     79: 'Open Cuica',
839     80: 'Mute Triangle',
840     81: 'Open Triangle',
841 }