-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathsc88sysex.1
118 lines (95 loc) · 2.64 KB
/
sc88sysex.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
.TH SC88SYSEX 1 "20 Feb 2005"
.SH NAME
sc88sysex \- Roland SC-88 System Exclusive Librarian
.SH SYNOPSIS
.B sc88sysex
[-v] [-h] [-p PORT] [-d DEVICEID] [-t TIMEOUT] {-a ADDRESS -z SIZE | -c
COMMAND} [-r|-s FILENAME]
.SH DESCRIPTION
.B sc88sysex
is a command-line utility that helps to send and receive system exclusive data
to/from a Roland SC-88 device using ALSA raw MIDIports. This program is a Bash
script using
.B amidi(1).
.SH OPTIONS
.TP
.I -h
Prints a help message.
.TP
.I -v
Prints more verbose messages.
.TP
.I -p PORT
Sets the raw MIDI port to which receive and send SYSEX messages.
.TP
.I -d DEVICEID
Sets the device number assigned to the SC-88 in the MIDI network.
.TP
.I -t TIMEOUT
Sets the number of seconds to wait for data before closing the
receiving session.
.TP
.I -a ADDRESS
Sets the address of the system exclusive data to be transferred.
It can be a symbolic name or three hex constants. See the output of
.I -h
to get a list of the predefined symbolic addresses.
.TP
.I -z SIZE
Sets the size of the system exclusive transfer. It can be a symbolic
name or three hex constants. See the output of
.I -h
to get a list of the predefined symbolic sizes.
.TP
.I -c COMMAND
Sets a command to be sent to the SC-88 as a system exclusive message.
It can be a symbolic name or three hex constants. See the output of
.I -h
to get a list of the predefined commands.
.TP
.I -r FILE
Save the receive data under this file name (optional).
If not specified, the file name is built upon the given address
and size arguments.
.TP
.I -s FILE
Sends the contents of this file name.
.SH FILES
.I ~/.sc88sysexrc
personal configuration
.br
.I /etc/sc88sysexrc
system wide configuration
.br
You can set your preferred default options in a config file either in your
home directory or as a global configuration file in /etc. The format is simply
a set of lines having a expression of VARIABLE=value type. You can add more
symbolic addresses, sizes and commands here.
If you don't provide one, the following default options take effect:
.br
.I MIDIPORT="hw:0"
.br
.I DEVICEID=10
.br
.I TIMEOUT=3
.br
.I LIBDIR=~/SC88LIB
.SH EXAMPLES
.TP
.B sc88sysex -a BULKDUMP -z ALL
Sends a bulk dump request using the default MIDI port to the SC-88, and stores
the received data in a file named "sc88_bulkdump_all.syx"
.TP
.B sc88sysex -c GSRESET
Sends a GS reset command to the SC-88
.TP
.B sc88sysex -s dump.syx
Sends a data file "dump.syx" to the SC-88.
.TP
.B sc88sysex -a '40 00 00' -z '00 00 04' -r deftune.syx
Gets the master tune parameter from the SC-88 saving it on a file named
"deftune.syx"
.SH SEE ALSO
amidi(1)
.SH AUTHOR
Pedro Lopez-Cabanillas <[email protected]>