نام (NAME)

amidi - خواندن از و نوشتن در درگاه‌های ALSA RawMIDI

خلاصه دستور (SYNOPSIS)

amidi [-p port] [-s file | -S data] [-r file] [-d] [-t seconds] [-a]

توضیحات (DESCRIPTION)

دستور amidi یک ابزار خط فرمانی است که امکان دریافت و ارسال داده‌های SysEx (سیستمی اختصاصی / system exclusive) از یا به دستگاه‌های خارجی MIDI را فراهم می‌کند. این ابزار همچنین می‌تواند هرگونه دستور MIDI دیگری را ارسال کند.

دستور amidi تنها فایل‌های حاوی دستورات خام MIDI را که فاقد اطلاعات زمان‌بندی (timing) هستند، مدیریت می‌کند. دستور amidi از فایل‌های استاندارد MIDI (با پسوند .mid) پشتیبانی نمی‌کند، اما دستورات aplaymidi(1) و arecordmidi(1) از آن‌ها پشتیبانی می‌کنند.

گزینه‌ها (OPTIONS)

از گزینه‌های -h, -V, -l, یا -L برای نمایش اطلاعات استفاده کنید؛ یا حداقل از یکی از گزینه‌های -s, -r, -S, یا -d برای تعیین داده‌های ارسالی یا دریافتی استفاده نمایید.

-h, --help: راهنما: فهرستی از گزینه‌ها را چاپ می‌کند.
-V, --version: نسخه فعلی را چاپ می‌کند.
-l, --list-devices: فهرستی از تمام درگاه‌های سخت‌افزاری MIDI را چاپ می‌کند.
-x, --list-inactive: همراه با گزینه -l استفاده می‌شود. تمام درگاه‌های MIDI شامل درگاه‌های غیرفعال را چاپ می‌کند.
-L, --list-rawmidis: تمام تعاریف RawMIDI را چاپ می‌کند (هنگام اشکال‌زدایی فایل‌های پیکربندی استفاده می‌شود).
-p, --port=name: نام درگاه ALSA RawMIDI مورد استفاده را تنظیم می‌کند. اگر این گزینه مشخص نشود، amidi از درگاه پیش‌فرض تعریف‌شده در فایل پیکربندی استفاده می‌کند (پیش‌فرض آن درگاه 0 روی کارت 0 است که ممکن است وجود نداشته باشد).
-s, --send=filename: محتویات فایل مشخص‌شده را به درگاه MIDI ارسال می‌کند. این فایل باید حاوی دستورات خام MIDI باشد (مانند یک فایل syx.)؛ برای فایل‌های استاندارد MIDI (با پسوند mid.)، از aplaymidi(1) استفاده کنید.
-r, --receive=filename: داده‌های دریافت شده از درگاه MIDI را در فایل مشخص‌شده می‌نویسد. این فایل حاوی دستورات خام MIDI خواهد بود (مانند یک فایل syx.)؛ برای ضبط فایل استاندارد MIDI (با پسوند mid.)، از arecordmidi(1) استفاده کنید.

دستور amidi بایت‌های Active Sensing و Clock (شامل FEh و F8h) را فیلتر کرده و نادیده می‌گیرد، مگر اینکه گزینه‌های -a یا -c مشخص شده باشند.

-S, --send-hex="...": بایت‌های مشخص‌شده به عنوان اعداد هگزادسیمال را به درگاه MIDI ارسال می‌کند.
-d, --dump: داده‌های دریافت شده از درگاه MIDI را به صورت بایت‌های هگزادسیمال چاپ می‌کند. بایت‌های Active Sensing و Clock (شامل FEh و F8h) نمایش داده نخواهند شد، مگر اینکه گزینه‌های -a یا -c مشخص شده باشند.

این گزینه برای اشکال‌زدایی مفید است.

-t, --timeout=seconds: هنگامی که برای مدت زمان مشخص‌شده هیچ داده‌ای دریافت نشود، دریافت داده را متوقف می‌کند.

اگر این گزینه مشخص نشده باشد، برای توقف دریافت داده باید کلیدهای Ctrl+C را فشار دهید (یا فرایند amidi را متوقف کنید).

-a, --active-sensing: هنگام ذخیره یا چاپ دستورات MIDI دریافتی، بایت‌های Active Sensing (مقدار FEh) را نادیده نمی‌گیرد.
-c, --clock: هنگام ذخیره یا چاپ دستورات MIDI دریافتی، بایت‌های Clock (مقدار F8h) را نادیده نمی‌گیرد.
-i, --sysex-interval=mseconds: یک تاخیر (بر حسب میلی‌ثانیه) بین هر پیام SysEx ارسالی به یک دستگاه اضافه می‌کند. این ویژگی هنگام ارسال به‌روزرسانی‌های میان‌افزار (firmware) از طریق پیام‌های SysEx به یک دستگاه راه دور مفید است.

مثال‌ها (EXAMPLES)

amidi -p hw:0 -s my_settings.syx: دستورات MIDI موجود در my_settings.syx را به درگاه hw:0 ارسال می‌کند.
amidi -p hw:1,0,0 -s firmware.syx -i 100: دستورات MIDI موجود در firmware.syx را به درگاه hw:1,0,0 با ۱۰۰ میلی‌ثانیه تاخیر میان هر پیام SysEx ارسال می‌کند.
amidi -S 'F0 43 10 4C 00 00 7E 00 F7': یک پیام بازنشانی XG Reset را به درگاه پیش‌فرض ارسال می‌کند.
amidi -p hw:1,2 -S F0411042110C000000000074F7 -r dump.syx -t 1: یک “Parameter Dump Request” به یک دستگاه GS ارسال کرده، داده‌های پارامتر دریافتی را در فایل dump.syx ذخیره می‌کند و پس از اتمام ارسال داده توسط دستگاه (زمانی که به مدت یک ثانیه هیچ داده‌ای دریافت نشود) متوقف می‌شود.
amidi -p virtual -d: یک درگاه RawMIDI مجازی ایجاد کرده و تمام داده‌های ارسال‌شده به این درگاه را چاپ می‌کند.

فایل‌ها (FILES)

/usr/share/alsa/alsa.conf تعاریف پیش‌فرض rawmidi
/etc/asound.conf تعاریف rawmidi در سطح کل سیستم
~/.asoundrc تعاریف rawmidi مختص کاربر

همچنین ببینید (SEE ALSO)

aplaymidi(1)
arecordmidi(1)

نویسندگان (AUTHORS)

Clemens Ladisch <clemens@ladisch.de>