SysEx Format of pocketC

SysEx-Format pocketC

Every knob of pocketC can be assigned with 3 Parameters (all of them only 7 bits, means range 0-127).
This 3 parameters describe the midi-event the corresponding know will send, if you move the knob.

You can define a so called preset (all 3 parameters for each of the 16 knobs) with a dump of a suited sysex-message.
This preset can be stored non-volatile by another message to one of 128 different memory places.
You had to locate the memory place with the preset-nr byte in the sysex message.
To store the preset it is important to send the Single-Store message immediate after the dump. pocketC will test if the preset-nr form the last received single dump is identical with the number in the store message before storing.

Parameter 1:
This parameter defines a speical fixed midichannel (1-16) or if the event will get it's channel info from the masterchannel

Parameter 2:
This parameter describes the kind of event. You can choose between standart midi-commands, like, controller, pitch bend etc., to more complex controller combinations like several RPN and NRPN to complete complex sysex-string like Yamaha-XG-Strings or some Roland GS-Strings.
So it's not possible to assign a complete free defined string to a knob. You can only use the predefined strings lined up below.

Parameter 3:
Most of the coarse by parameter 2 described midi-events needs some finer describtion. For this you need parameter 3. The exact meaning of parameter 3 changes for every type of parameter 2.
F.e. im parameter2 is '0', which means controller, you have to specify, what controlelr number you need. For this you use parameter 3. F.e., if you want to create a Volume-Controller you have to set parameter 3 to '7'.

You could produce such a string simply by editing it in your sysex-editor of your f.e. sequencer or simply a file with an hex-editor.
It's a good idea to use one of the enclosed ready preset files, or simply copy the follwing string into your editor.

F0    00    20    20    14     00    20    00    00     01    02    03    04     05    06    07    08     09    0A    0B    0C     0D    0E    0F    10
00    00    00    00    00     00    00    00    00     00    00    00    00     00    00    00
07    07    07    07    07     07    07    07    07     07    07    07    07     07    07    07    F7
F0    00    20    20    14     00    30    00    00     F7

The detailed meaning of this string is described in the following table. It's Preset '0' of pocketC.

							Command	Preset Nr	Knob:	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16

Single-Dump:	F0	00	20	20	14	00	20	00	00	01	02	03	04	05	06	07	08	09	0A	0B	0C	0D	0E	0F	10		Parameter 1 (Midichannel) [16 Bytes*]

										00	00	00	00	00	00	00	00	00	00	00	00	00	00	00	00		Parameter 2 (Eventtype) [16 Bytes*]

										07	07	07	07	07	07	07	07	07	07	07	07	07	07	07	07	F7	Parameter 3 ([Event-Argument) 16 Bytes*]

Single-Store:	F0	00	20	20	14	00	30	00	00	F7
Single Dump Request	F0	00	20	20	14	00	26	00	00	F7
Thru/Masterchn - Dump	F0	00	20	20	14	00	50	TH	MC	F7
Thru/Masterchn - Dump Request	F0	00	20	20	14	00	56	00	00	F7
Version Request	F0	00	20	20	14	00	06	00	00	F7
Version Request- Answer	F0	00	20	20	14	00	00	VERS	SUBVERS	F7

Note:

TH.Bit.0    Channel-Events-THRU- On(=1)/Off(=0)
TH.Bit.1    SysEx-Events-THRU- On(=1)/Off(=0)
TH.Bit.2    Realtime-Events-THRU- On(=1)/Off(=0)

MC.Bits0..3: pocketC Masterchannel

VERS Version
SUBERS Subversion

F0	SysEx Status Byte
00	European Sub-ID
20	Doepfer Sub-ID 1
20	Doepfer Sub-ID 2
14	Device 'pocketC'
00	reserved
20	Command-Byte
00	Preset-Nr
00	reserved
...	Parameter 1 (Midichannel) [16 Bytes*]
...	Parameter 2 (Eventtype) [16 Bytes*]
...	Parameter 3 ([Event-Argument) 16 Bytes*]
F7

	* Bytes can only have 7 Bits -> Range 0-127
Commands
20	Single-Dump
26	Single Dump Request
30	Single-Store
50	Thru/Masterchn - Dump
56	Thru/Masterchn - Dump Request
06	Version Request
00	Version Request - Answer

		Parameter 1:
Dez.	Hex
0	00	Masterchannel
1-16	01-10	Midichannel 1- 16
> 17	> 11	undefined

		Parameter 2: [ range 0-127]
Dez.	Hex
0	00	Controller
1	01	PitchBend
2	02	MonoAftertouch
3	03	Prg-Change
4	04	PolyAftertouch
5	05	Note-On
6	06	Note-Off
7	07	free
8	08	RPN0_MSB
9	09	RPN0_LSB
10	0A	RPN1_MSB
11	0B	RPN1_LSB
12	0C	free
13	0D	free
14	0E	RPN127_MSB
15	0F	RPN127_LSB
16	10	NRPN0_MSB
17	11	NRPN0_LSB
18	12	NRPN1_MSB XG_Multi/GS
19	13	NRPN1_LSB XG_Multi/GS
20	14	NRPN8_MSB
21	15	NRPN8_LSB
22	16	NRPN9_MSB
23	17	NRPN9_LSB
24	18	NRPN10_MSB
25	19	NRPN10_LSB
26	1A	NRPN20_MSB XG Drum Instr. Cutoff
27	1B	NRPN20_LSB XG Drum Instr. Cutoff
28	1C	NRPN21_MSB XG Drum Instr. Resonance
29	1D	NRPN21_LSB XG Drum Instr. Resonance
30	1E	NRPN22_MSB XG Drum Instr. EG Attack
31	1F	NRPN22_LSB XG Drum Instr. EG Attack
32	20	NRPN23_MSB XG Drum Instr. EG Decay
33	21	NRPN23_LSB XG Drum Instr. EG Decay
34	22	NRPN24_MSB XG/GS Drum Instr. Pitch Coarse
35	23	NRPN24_LSB XG/GS Drum Instr. Pitch Coarse
36	24	NRPN25_MSB XG Drum Instr. Pitch Fine
37	25	NRPN25_LSB XG Drum Instr. Pitch Fine
38	26	NRPN26_MSB XG/GS Drum Instr. Level
39	27	NRPN26_LSB XG/GS Drum Instr. Coarse
40	28	NRPN28_MSB XG/GS Drum Instr. Panorama
41	29	NRPN28_LSB XG/GS Drum Instr. Panorama
42	2A	NRPN29_MSB XG/GS Drum Instr. Reverb Send
43	2B	NRPN29_LSB XG/GS Drum Instr. Reverb Send
44	2C	NRPN30_MSB XG/GS Drum Instr. Chorus Send
45	2D	NRPN30_LSB XG/GS Drum Instr. Chorus Send
46	2E	NRPN31_MSB XG/GS Drum Instr.Variation/Delay Send
47	2F	NRPN31_LSB XG/GS Drum Instr. Variation/Delay Send
48	30	NRPN32_MSB
49	31	NRPN32_LSB
50	32	NRPN33_MSB
51	33	NRPN33_LSB
52	34	NRPN99_MSB
53	35	NRPN99_LSB
54	36	NRPN100_MSB
55	37	NRPN100_LSB
56	38	NRPN102_MSB
57	39	NRPN102_LSB
58	3A	NRPN120_MSB EMU ABS
59	3B	NRPN120_LSB EMU ABS
60	3C	NRPN127_MSB SB AWE 32/64
61	3D	NRPN127_LSB SB AWE 32/64
62	3E	free
63	3F	free
64	40	XG-DRUM (SetupNr=Chn) Pitch Coarse
65	41	XG-DRUM (SetupNr=Chn) Pitch Fine
66	42	XG-DRUM (SetupNr=Chn) Level
67	43	XG-DRUM (SetupNr=Chn) Alternate Group
68	44	XG-DRUM (SetupNr=Chn) Panorama
69	45	XG-DRUM (SetupNr=Chn) Reverb Send
70	46	XG-DRUM (SetupNr=Chn) Chorus Send
71	47	XG-DRUM (SetupNr=Chn) Variation Send
72	48	XG-DRUM (SetupNr=Chn) Key Assign
73	49	XG-DRUM (SetupNr=Chn) Rcv Note off
74	4A	XG-DRUM (SetupNr=Chn) Rcv Note On
75	4B	XG-DRUM (SetupNr=Chn) Cutoff Freq.
76	4C	XG-DRUM (SetupNr=Chn) Resonance
77	4D	XG-DRUM (SetupNr=Chn) EG Attack Rate
78	4E	XG-DRUM (SetupNr=Chn) EG Decay1 Rate
79	4F	XG-DRUM (SetupNr=Chn) EG Decay2 Rate
80	50	XG Multipart
81	51	XG AD
82	52	XG-Effect
83	53	XG-Effect 2Byte
84	54	XG-Reverb Type
85	55	XG-Chorus Type
86	56	XG-Variation Type
87	57	XG-EQ
88	58	XG-Insertion1
89	59	XG-Insertion2
90	5A	XG-Insertion 1 Type
91	5B	XG-Insertion 2 Type
92	5C	free
93	5D	free
94	5E	free
95	5F	free
96	60	GS - Effect
97	61	MC303_Global
98	62	MC303_Channel
99	63	free
100	64	Strings
101	65	free
102	66	free
103	67	free
104	68	free
105	69	free
106	6A	free
107	6B	free
108	6C	free
109	6D	free
110	6E	free
111	6F	free
112	70	free
113	71	free
114	72	free
115	73	free
116	74	free
117	75	free
118	76	free
119	77	free
120	78	free
121	79	free
122	7A	free
123	7B	free
124	7C	free
125	7D	free
126	7E	free
127	7F	No-Event

		Parameter 3: [ range 0-127]
Dez.	Hex
0	00
..		meaning of parameter 3 depends on parameter 2
..		f.e if par2=0 is controller, then par3 = 7 means
127	7F	volume