alsa-utils/seq/aseqsend/aseqsend.1
Takashi Iwai c95db638c0 aseqsend: Support UMP mode
Add a new option -u to specify the UMP MIDI1 or MIDI2 mode.  As
default (-u 0), the program reads the legacy MIDI 1.0 byte stream,
while in UMP mode, it reads as UMP packets and send to the target.
The UMP packet bytes are encoded in big endian.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
2024-07-22 19:47:25 +02:00

66 lines
1.6 KiB
Groff

.TH ASEQSEND 1 "11 Mar 2024"
.SH NAME
.B aseqsend
\- send arbitrary messages to selected ALSA MIDI seqencer port
.SH SYNOPSIS
aseqsend \-p client:port -s file-name|"hex encoded byte-string"
.SH DESCRIPTION
.B aseqsend
is a command-line utility which allows one to send SysEx (system exclusive) data to ALSA MIDI seqencer port.
It can also send any other MIDI commands.
Messages to be send can be given in the last argument as hex encoded byte string or can be read from raw binary file.
When sending several SysEx messages at once there is a delay of 1ms after each message as deafult and can be set to different value with option \-i.
A client can be specified by its number, its name, or a prefix of its
name. A port is specified by its number; for port 0 of a client, the
":0" part of the port specification can be omitted.
.SH OPTIONS
.TP
\-h
Prints a list of options.
.TP
\-V
Prints the current version.
.TP
\-l
Prints a list of possible output ports.
.TP
\-v
Prints number of bytes actually sent
.TP
\-p
Target port by number or name
.TP
\-s
Send raw binary data from given file name
.TP
\-i
Interval between SysEx messages in miliseconds
.TP
\-u
Specify the MIDI version. 0 for the legacy MIDI 1.0 (default),
1 for UMP MIDI 1.0 protocol and 2 for UMP MIDI 2.0 protocol.
When UMP MIDI 1.0 or MIDI 2.0 protocol is specified, \fBaseqsend\fP
reads the input as raw UMP packets, 4 each byte in big endian.
.SH EXAMPLES
aseqsend -p 128:0 "F0 41 10 00 00 64 12 18 00 21 06 59 41 59 4E F7"
aseqsend -p 128:0 -s I7BulkDump.syx
.SH AUTHOR
Miroslav Kovac <mixxoo@gmail.com>