.TH AMIDI 1 "30 Aug 2016"

.SH "نام (NAME)"
amidi \- خواندن از و نوشتن در درگاه‌های ALSA RawMIDI

.SH "خلاصه دستور (SYNOPSIS)"
\fBamidi\fP [\fI\-p port\fP] [\fI\-s file\fP | \fI\-S data\fP]
[\fI\-r file\fP] [\fI\-d\fP] [\fI\-t seconds\fP] [\fI\-a\fP]

.SH "توضیحات (DESCRIPTION)"
دستور
.B amidi
یک ابزار خط فرمانی است که امکان دریافت و ارسال داده‌های
SysEx (سیستمی اختصاصی / system exclusive)
از یا به دستگاه‌های خارجی MIDI را فراهم می‌کند. این ابزار همچنین می‌تواند هرگونه دستور MIDI دیگری را ارسال کند.
.PP
دستور
.B amidi
تنها فایل‌های حاوی دستورات خام MIDI را که فاقد اطلاعات زمان‌بندی (timing) هستند، مدیریت می‌کند.
دستور
.B amidi
از فایل‌های استاندارد MIDI (با پسوند .mid) پشتیبانی نمی‌کند، اما دستورات
.B aplaymidi(1)
و
.B arecordmidi(1)
از آن‌ها پشتیبانی می‌کنند.

.SH "گزینه‌ها (OPTIONS)"

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

.TP
.I \-h, \-\-help
راهنما: فهرستی از گزینه‌ها را چاپ می‌کند.

.TP
.I \-V, \-\-version
نسخه فعلی را چاپ می‌کند.

.TP
.I \-l, \-\-list\-devices
فهرستی از تمام درگاه‌های سخت‌افزاری MIDI را چاپ می‌کند.

.TP
.I \-x, \-\-list\-inactive
همراه با گزینه
\fI\-l\fP
استفاده می‌شود. تمام درگاه‌های MIDI شامل درگاه‌های غیرفعال را چاپ می‌کند.

.TP
.I \-L, \-\-list\-rawmidis
تمام تعاریف RawMIDI را چاپ می‌کند (هنگام اشکال‌زدایی فایل‌های پیکربندی استفاده می‌شود).

.TP
.I \-p, \-\-port=name
نام درگاه ALSA RawMIDI مورد استفاده را تنظیم می‌کند. اگر این گزینه مشخص نشود،
.B amidi
از درگاه پیش‌فرض تعریف‌شده در فایل پیکربندی استفاده می‌کند (پیش‌فرض آن درگاه 0 روی کارت 0 است که ممکن است وجود نداشته باشد).

.TP
.I \-s, \-\-send=filename
محتویات فایل مشخص‌شده را به درگاه MIDI ارسال می‌کند. این فایل باید حاوی دستورات خام MIDI باشد (مانند یک فایل syx.)؛ برای فایل‌های استاندارد MIDI (با پسوند mid.)، از
.B aplaymidi(1)
استفاده کنید.

.TP
.I \-r, \-\-receive=filename
داده‌های دریافت شده از درگاه MIDI را در فایل مشخص‌شده می‌نویسد. این فایل حاوی دستورات خام MIDI خواهد بود (مانند یک فایل syx.)؛ برای ضبط فایل استاندارد MIDI (با پسوند mid.)، از
.B arecordmidi(1)
استفاده کنید.
.PP
دستور
.B amidi
بایت‌های Active Sensing و Clock (شامل FEh و F8h) را فیلتر کرده و نادیده می‌گیرد، مگر اینکه گزینه‌های
.I \-a
یا
.I \-c
مشخص شده باشند.

.TP
.I \-S, \-\-send\-hex="..."
بایت‌های مشخص‌شده به عنوان اعداد هگزادسیمال را به درگاه MIDI ارسال می‌کند.

.TP
.I \-d, \-\-dump
داده‌های دریافت شده از درگاه MIDI را به صورت بایت‌های هگزادسیمال چاپ می‌کند. بایت‌های Active Sensing و Clock (شامل FEh و F8h) نمایش داده نخواهند شد، مگر اینکه گزینه‌های
.I \-a
یا
.I \-c
مشخص شده باشند.
.PP
این گزینه برای اشکال‌زدایی مفید است.

.TP
.I \-t, \-\-timeout=seconds
هنگامی که برای مدت زمان مشخص‌شده هیچ داده‌ای دریافت نشود، دریافت داده را متوقف می‌کند.
.PP
اگر این گزینه مشخص نشده باشد، برای توقف دریافت داده باید کلیدهای Ctrl+C را فشار دهید (یا فرایند
.B amidi\fR
را متوقف کنید).

.TP
.I \-a, \-\-active\-sensing
هنگام ذخیره یا چاپ دستورات MIDI دریافتی، بایت‌های Active Sensing (مقدار FEh) را نادیده نمی‌گیرد.

.TP
.I \-c, \-\-clock
هنگام ذخیره یا چاپ دستورات MIDI دریافتی، بایت‌های Clock (مقدار F8h) را نادیده نمی‌گیرد.

.TP
.I \-i, \-\-sysex-interval=mseconds
یک تاخیر (بر حسب میلی‌ثانیه) بین هر پیام SysEx ارسالی به یک دستگاه اضافه می‌کند. این ویژگی هنگام ارسال به‌روزرسانی‌های میان‌افزار (firmware) از طریق پیام‌های SysEx به یک دستگاه راه دور مفید است.

.SH "مثال‌ها (EXAMPLES)"

.TP
.B amidi \-p hw:0 \-s my_settings.syx
دستورات MIDI موجود در
.I my_settings.syx
را به درگاه
.I hw:0
ارسال می‌کند.

.TP
.B amidi \-p hw:1,0,0 \-s firmware.syx \-i 100
دستورات MIDI موجود در
.I firmware.syx
را به درگاه
.I hw:1,0,0
با ۱۰۰ میلی‌ثانیه تاخیر میان هر پیام SysEx ارسال می‌کند.

.TP
.B amidi \-S 'F0 43 10 4C 00 00 7E 00 F7'
یک پیام بازنشانی XG Reset را به درگاه پیش‌فرض ارسال می‌کند.

.TP
.B amidi \-p hw:1,2 \-S F0411042110C000000000074F7 \-r dump.syx \-t 1
یک \(lqParameter Dump Request\(rq به یک دستگاه GS ارسال کرده، داده‌های پارامتر دریافتی را در فایل
.I dump.syx
ذخیره می‌کند و پس از اتمام ارسال داده توسط دستگاه (زمانی که به مدت یک ثانیه هیچ داده‌ای دریافت نشود) متوقف می‌شود.

.TP
.B amidi \-p virtual \-d
یک درگاه RawMIDI مجازی ایجاد کرده و تمام داده‌های ارسال‌شده به این درگاه را چاپ می‌کند.

.SH "فایل‌ها (FILES)"
.I /usr/share/alsa/alsa.conf
تعاریف پیش‌فرض rawmidi
.br
.I /etc/asound.conf
تعاریف rawmidi در سطح کل سیستم
.br
.I ~/.asoundrc
تعاریف rawmidi مختص کاربر

.SH "همچنین ببینید (SEE ALSO)"
aplaymidi(1)
.br
arecordmidi(1)

.SH "نویسندگان (AUTHORS)"
Clemens Ladisch <clemens@ladisch.de>