| ASEQSEND(1) | General Commands Manual | ASEQSEND(1) |
نام (NAME)
aseqsend - ارسال پیامهای دلخواه به درگاه انتخابشدهٔ ترتیبسنج ALSA MIDI
خلاصه دستور (SYNOPSIS)
aseqsend -p client:port -s
file-name
aseqsend -p client:port "hex encoded
byte-string"
توضیحات (DESCRIPTION)
دستور aseqsend یک ابزار خط فرمان است که امکان ارسال دادههای SysEx (مخصوص سیستم یا System Exclusive) را به درگاه ترتیبسنج (sequencer) ALSA MIDI فراهم میکند. همچنین میتواند هر دستور دیگر MIDI را نیز ارسال کند. پیامهای ارسالی را میتوان در آرگومان پایانی بهصورت یک رشتهٔ بایتی با کدگذاری هگزادسیمال (hex) مشخص کرد یا آنها را از یک فایل باینری خام (raw binary) خواند. هنگام ارسال همزمان چندین پیام SysEx، بهطور پیشفرض تاخیری معادل ۱ میلیثانیه پس از هر پیام وجود دارد که با استفاده از گزینهٔ -i میتوان آن را به مقدار دیگری تغییر داد.
یک کلاینت را میتوان با شماره، نام یا پیشوندی از نام آن مشخص کرد. یک درگاه با شمارهاش مشخص میشود؛ برای درگاه 0 یک کلاینت، میتوان بخش ":0" از مشخصه درگاه را نادیده گرفت.
همچنین aseqsend میتواند با تعیین گزینهٔ -u بستههای UMP را بهعنوان یک دستگاه MIDI 2.0 ارسال کند، در حالی که عملکرد پیشفرض آن، جریان بایتی سنتی (legacy) در MIDI 1.0 است.
گزینهها (OPTIONS)
- -h, --help
- فهرستی از گزینهها را چاپ میکند.
- -V, --version
- نسخهٔ فعلی را چاپ میکند.
- -l, --list
- فهرستی از درگاههای خروجی ممکن را چاپ میکند.
- -v, --verbose
- تعداد بایتهای واقعاً ارسالشده را چاپ میکند.
- -p, --port=client:port
- درگاه مقصد را با شماره یا نام مشخص میکند.
- -s, --file=filename
- دادههای باینری خام را از نام فایل دادهشده ارسال میکند.
- -i, --interval=msec
- فاصلهٔ زمانی بین پیامهای SysEx بر حسب میلیثانیه.
- -u, --ump=version
- نسخهٔ MIDI را مشخص میکند؛ مقدار 0 برای MIDI 1.0 سنتی (پیشفرض)، مقدار 1 برای پروتکل UMP MIDI 1.0 و مقدار 2 برای پروتکل UMP MIDI 2.0 است.
هنگامی که پروتکل UMP MIDI 1.0 یا MIDI 2.0 مشخص شده باشد، aseqsend ورودی را بهصورت بستههای خام UMP، هر ۴ بایت در قالب اندیان بزرگ (big endian) میخواند.
مثالها (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
همچنین ببینید (SEE ALSO)
نویسندگان (AUTHORS)
Miroslav Kovac <mixxoo@gmail.com>
| 11 Mar 2024 |