KORG microX utility.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

99 lines
2.2 KiB

.TH ASYSEX 1 2012-04-03 "asysex @PACKAGE_VERSION@"
asysex - A SysEx Utility
.SY asysex
.RB [ \-h | --help ]
.RB [ \-v | --version ]
.RB [ \-p | --port
.IR port ]
.RB [ \-I | --inquiry ]
.RB [ \-r | --raw ]
.RB [ \-H | --hex ]
.B asysex
reads hexadecimal SysEx messages from standard input, sents
them to a specified MIDI port and reads back and prints out
a single SysEx message.
.BR -h ", " --help
Display the help message.
.BR -v ", " --version
Display the version message.
.BR -p ", " --port " " \fIport\fR
Connect to the specified MIDI \fIport\fR.
If not specified, default is \(lq@DEFAULT_MIDI_PORT@\(rq.
.BR -I ", " --inquiry
Identify the connected MIDI device and exit.
.BR -r ", " --raw
Write MIDI output in raw binary format. This allows for
example to pipe the output to hexdump(1) to have it
displayed in any suitable format.
.BR -H ", " --hex
Write MIDI output in hexadecimal format. This is the
default behavior.
.B asysex
expects hexadecimal input. All characters others than [0-9],
[a-f] and [A-F] are ignored. The \(aq#\(aq character
introduces a comment which lasts until the next end-of-line,
and in which all characters are ignored, including
hexadecimal characters. Two hexadecimal characters (even
separated by other characters or a comment) are read as a
single byte.
The first byte \fBmust\fR be \(aqF0\(aq (\(lqSysEx message
begin\(rq), and the last byte \fBmust\fR be \(aqF7\(aq
(\(lqSysEx message end\(rq).
The following examples are valid input:
F0 7F000401007F F7 # Set Master Volume
# Send a Program Parameter Dump Request to a Korg device
F0 # Begin of SysEx message
42 # Korg ID
30 # Global MIDI channel is 1
7A # End of SysEx header
1C # Function is Program Parameter Dump
2 # Dump a single Program
1 # Select Bank B
09 # Select Program 10
00 # Reserved
F7 # End of SysEx message
Report bugs to
Damien Goutte-Gattat
.ME .
.ad l
Copyright \(co 2012 Damien Goutte-Gattat
This program is released under the GNU General Public License.
See the COPYING file in the source distribution or
.UR http://www.gnu.org/licenses/gpl.html
.UE .