.TH IRRECORD "1" "Last change: May 2017" "irrecord 0.10.2" "User Commands"
.SH "نام (NAME)"
.P
\fBirrecord\fR \- ابزار ضبط کدهای فروسرخ (IR) جهت استفاده با LIRC
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBirrecord\fR [\fI-f\fR] [\fI-n\fR] [\fI-H driver\fR] [\fI-d device\fR] [\fIfile\fR]
.P
\fBirrecord\fR -a <\fIfile\fR>
.P
\fBirrecord\fR -l
.P
\fBirrecord\fR \--help | --version

.SH "توضیحات (DESCRIPTION)"
این برنامه سیگنال‌های دریافتی از کنترل از راه دور شما را ضبط کرده و یک فایل پیکربندی برای lircd ایجاد می‌کند. با وجود تلاش‌های بسیاری که برای این برنامه صورت گرفته، اغلب شناسایی خودکار تمام ویژگی‌های یک کنترل از راه دور امکان‌پذیر نیست. بخش «نکات استفاده» در ادامه را ببینید.
.P
اگر \fIfile\fR مشخص نشده باشد، مقدار پیش‌فرض آن "irrecord.lircd.conf" خواهد بود.
.P
اگر \fIfile\fR از قبل وجود داشته باشد و حاوی یک پیکربندی معتبر باشد، irrecord از توضیحات پروتکل موجود در آن استفاده خواهد کرد و تنها برای ضبط دکمه‌ها تلاش می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR \fB\-\-analyse\fR
تحلیل یک فایل پیکربندی raw_codes و تلاش برای تبدیل آن به یک پیکربندی عادی.
.TP
\fB\-u\fR \fB\-\-update\fR
افزودن دکمه‌های جدید به یک فایل پیکربندی موجود. هیچ‌یک از اطلاعات پروتکل به‌روزرسانی نمی‌شود.
.TP
\fB\-f\fR \fB\-\-force\fR
اجبار به استفاده از حالت خام (raw). در صورتی که ضبط در حالت عادی با شکست مواجه شد، از این گزینه استفاده کنید. این کار یک فایل پیکربندی کدهای خام ایجاد می‌کند که می‌تواند به همان شکل استفاده شود یا با استفاده از گزینه -a تبدیل گردد.
.TP
\fB\-n\fR \fB\-\-disable\-namespace\fR
غیرفعال کردن بررسی‌های فضای نام (namespace).
.TP
\fB\-l\fR \fB\-\-list\-namespace\fR
فهرست کردن نام‌های معتبر برای دکمه‌ها.
.TP
\fB\-H\fR \fB\-\-driver\fR=\fIdriver\fR
استفاده از راه‌انداز مشخص‌شده. دستور -H help راه‌اندازهای موجود را فهرست می‌کند.
.TP
\fB\-d\fR \fB\-\-device\fR=\fIdevice\fR
خواندن از دستگاه داده‌شده. برای دیدن فهرست دستگاه‌های موجود برای یک راه‌انداز از \fBmode2(1) --list-devices\fR استفاده کنید.
.TP
\fB\-U\fR \fB\-\-plugindir\fR=\fIdirectory\fR
بارگذاری راه‌اندازها از دایرکتوری مشخص‌شده. بخش «مسیر بارگذاری راه‌انداز» را ببینید.
.TP
\fB\-k\fR \fB\-\-keep-root\fR
عدم رهاسازی امتیازات کاربر ریشه (root) پس از باز کردن دستگاه. بخش «اجرا به عنوان ریشه» را ببینید.
.TP
\fB-A, --driver-options\fR \fIkey:value[|key:value...]\fR
تنظیم یک یا چند گزینه برای راه‌انداز. این آرگومان فهرستی از جفت‌های کلید:مقدار (key:value) است که با '|' از یکدیگر جدا شده‌اند. کلید نمی‌تواند شامل فاصله باشد، اما استفاده از فاصله در بخش مقدار مجاز است. برخی نویسه‌ها از جمله '#' و ';' به عنوان نشانگر کامنت در فایل پیکربندی استفاده می‌شوند و استفاده از آن‌ها در هیچ بخشی مجاز نیست.
.TP
\fB\-D\fR \fB\-\-loglevel\fR=\fIlevel\fR
تعیین میزان اطلاعات گزارش‌گیری (logging). مقدار [level] می‌تواند یکی از سطوح نمادین syslog باشد: 'error'، 'warning'، 'info'، 'notice' یا 'debug'. برنامه lirc همچنین سه سطح اضافی 'trace'، 'trace1' و 'trace2' را تعریف می‌کند که پیام‌های بیشتری تولید می‌کنند ('trace2' بیشترین پیام را تولید می‌کند). با این حال، در فایل گزارش این پیام‌ها با عنوان 'debug' علامت‌گذاری می‌شوند.
سطح گزارش می‌تواند یک عدد صحیح در بازهٔ ۳ (تقریباً بدون پیام) تا ۱۰ نیز باشد.
.TP
\fB\-O, \fB\-\-options-file\fR <\fIpath\fR>
فایل حاوی مقادیر پیش‌فرض برای تمامی گزینه‌ها. مسیر نسبی نسبت به دایرکتوری جاری تفسیر می‌شود. بخش [فایل‌ها] در ادامه را ببینید.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش این پیام راهنما.
.TP
\fB\-v\fR \fB\-\-version\fR
نمایش نسخه.

.SH "نکات استفاده (USAGE NOTES)"
.P
گزینه‌های اصلی \-\-driver و معمولاً همچنین \-\-device هستند (برخی راه‌اندازها نیازی به \-\-device ندارند). در صورتی که \fIirrecord\fR با مشکل مواجه شود، می‌توان این موارد را با استفاده از mode2(1) بررسی کرد.
.P
هنگامی که راه‌انداز و دستگاه مشخص شدند، به‌روزرسانی lirc_options.conf با مقادیر جدید موجب صرفه‌جویی در کار خواهد شد. برنامه irrecord از بخش [lircd] به عنوان پشتیبان استفاده می‌کند، بنابراین با یک فایل lirc_options.conf مناسب، irrecord می‌تواند بدون گزینه‌های خط فرمان اجرا شود.
.P
گاهی اوقات استفاده از یک فایل موجود به عنوان الگو برای کارکرد صحیح \fIirrecord\fR الزامی است. استفاده از یکی از الگوهای عمومی (generic) می‌تواند زمان‌بندی دقیق‌تری را نیز فراهم کند. بخش «پارامترهای پروتکل و الگوها» را ببینید.
.P
اگر برنامه نتواند پروتکل کنترل از راه دور را شناسایی کند، می‌توانید از گزینه \-\-force استفاده کنید تا حداقل یک فایل پیکربندی در حالت خام (raw) ایجاد شود.

.SH "ماسک‌های تکرار (REPEAT MASKS)"
پس از ضبط چند دکمه با irrecord، باید ماسک‌های تکرار را بررسی کنید. این موارد برای مدیریت فشردن‌های مکرر دکمه‌ها، که بسیار رایج هستند، مورد نیاز می‌باشند.
.P
با استفاده از فایل پیکربندی، lircd و irw را اجرا کنید. با پایین نگه داشتن یک دکمه، باید چیزی شبیه به این را مشاهده کنید:
.nf

        0000000000f40bf0 00 KEY_1 ANIMAX
        0000000000f40bf0 01 KEY_1 ANIMAX
        0000000000f40bf0 02 KEY_1 ANIMAX
        0000000000f40bf0 03 KEY_1 ANIMAX
        0000000000f40bf0 04 KEY_1 ANIMAX
        0000000000f40bf0 05 KEY_1 ANIMAX
.fi
.P
توجه کنید که چگونه فیلد دوم افزایش می‌یابد. این سازوکار برای عملکرد صحیح دستگاه باید به درستی کار کند.

.SH "پارامترهای پروتکل و الگوها (PROTOCOL PARAMETERS AND TEMPLATES)"
در واقع irrecord در دو مرحله کار می‌کند. در مرحله اول، سعی می‌کند پروتکل مورد استفاده توسط ریموت را شناسایی کند. اگرچه این روند اغلب به خوبی انجام می‌شود، اما استفاده از یک فایل موجود به عنوان الگو مزایایی به همراه دارد.
.P
یک دلیل برای استفاده از الگو زمانی است که irrecord در ابتدا موفق به تشخیص پروتکل نمی‌شود. در چنین مواردی، سعی کنید با دستوری شبیه به این، یک پیکربندی موجود از همان سازنده پیدا کنید:
.P
.nf
        $ irdb-get find motorola
          # lots of remotes listed...
        $ irdb-get download motorola/VIP_1200.lircd.conf  # Pick any
        $ cp VIP_1200.lircd.conf my_remote.lircd.conf
        $ irrecord my_remote.lircd.conf
.fi
.P
فراخوانی irrecord به این شیوه، پروتکل موجود را دوباره مورد استفاده قرار می‌دهد که معمولاً مؤثر است (سازندگان به ندرت پارامترهای پروتکل را تغییر می‌دهند).
.P
دلیل دیگر برای استفاده از یک فایل موجود، دستیابی به زمان‌بندی دقیق‌تر است که در صورت تمایل به ارسال سیگنال (blast) اهمیت بالایی دارد. در چنین مواردی، استفاده از یک الگوی عمومی که از طریق \fIirdb-get find generic\fR یافت می‌شود مزیت دارد، زیرا مقادیر زمان‌بندی در این الگوها بر اساس مشخصات فنی به‌صورت دستی تنظیم شده‌اند. با این حال، برای استفاده از این الگوها باید بدانید کنترل از راه دور شما از چه پروتکلی استفاده می‌کند.
.P
اگر رمزگشایی دستورات IR به صورت قابل اطمینان کار نمی‌کند، می‌توانید مقادیر eps و aeps را در فایل پیکربندی lircd تغییر دهید تا میزان تحمل (tolerance) طول سیگنال‌ها تنظیم شود. مقدار aeps یک مقدار مطلق است، در حالی که eps یک مقدار نسبی است که بر حسب درصد بیان می‌شود. lircd.conf(5) را ببینید.

.SH "عیب‌یابی (TROUBLESHOOTING)"
.P
.SS ریموت‌های چندحالته (Multiple-personalities remotes)
.P
برخی ریموت‌ها در واقع دو یا چند کنترل از راه دور را شبیه‌سازی می‌کنند. در صورتی که دکمه‌های مربوط به کنترل‌های منطقی مختلف در یک نوبت اجرا مخلوط شوند، به‌ویژه در شناسایی اولیه پروتکل، \fIirrecord\fR دچار مشکل می‌شود. برای چنین دستگاه‌هایی، irrecord باید برای هر دستگاه منطقی به طور جداگانه اجرا شود و در طول اجرا فقط دکمه‌های مربوط به همان دستگاه فشرده شوند.

.SS نویسه‌های نامفهوم هنگام استفاده از راه‌انداز پیش‌فرض
اگر هنگام اجرای irrecord با استفاده از راه‌انداز پیش‌فرض، نویسه‌های نامفهوم و غیرقابل چاپ روی صفحه ظاهر شود، پروتکل rc باید تنظیم گردد. با وجود یک دستگاه، می‌توان پروتکل را با دستورات زیر تنظیم و بررسی کرد:
.P
.nf
        sudo sh -c "echo 'lirc' > /sys/class/rc/rc0/protocol"
        cat /sys/class/rc/rc0/protocol
.fi

.SS اختلالات فیزیکی
در خصوص اختلالات فیزیکی، منبع اصلی نور مهتابی (فلورسنت) است. هنگام استفاده از irrecord نباید چنین نوری در محیط وجود داشته باشد. همچنین رعایت فاصله مناسب بین کنترل از راه دور و دستگاه گیرنده مهم است، که معمولاً کمتر از فاصله معمول در استفاده عادی است. با این حال، نزدیک کردن بیش از حد نیز ممکن است مشکلات دیگری ایجاد کند. در اولین تلاش، فاصله‌ای در حدود یک یا دو فوت (۳۰ تا ۶۰ سانتی‌متر) را امتحان کنید.

.SH "مسیر بارگذاری راه‌انداز (DRIVER LOAD PATH)"
راه‌اندازها به صورت پویا بارگذاری می‌شوند. این کار از یک مسیر سنتی *ux جداشده با نویسهٔ \':\' انجام می‌شود که در آن تمام بخش‌های مسیر مورد جستجو قرار می‌گیرند (ابتدا بخش‌های ابتدایی، در آخر بخش‌های انتهایی).
.P
مسیر مورد استفاده برای این منظور با اولویت‌های زیر (به ترتیب از بالا به پایین) تعیین می‌شود:
.IP \- 2
گزینه --plugindir.
.IP \- 2
مدخل 'plugindir' در بخش [lircd] از فایل lirc_options.conf.
.IP \- 2
متغیر محیطی LIRC_PLUGINDIR.
.IP \- 2
مقدار پیش‌فرض تعبیه‌شده در برنامه (/usr/lib/lirc/plugins).

.SH "اجرا به عنوان ریشه (RUNNING AS ROOT)"
در بسیاری از موارد irrecord برای دسترسی به دستگاه‌هایی که برای کاربران عادی در دسترس نیستند نیاز به اجرا به عنوان کاربر ریشه (root) دارد. از طرف دیگر، اجرا به عنوان root مسائلی مانند ایجاد فایل‌های گزارش با مالکیت root، نگرانی‌های امنیتی و غیره را در پی دارد.
.P
برای رفع این مشکل، irrecord به طور پیش‌فرض پس از باز کردن دستگاه ورودی، امتیازات کاربر ریشه را رها می‌کند. این سازوکار مبتنی بر این است که مجوزهای root با استفاده از sudo(1) به دست آمده باشند؛ برای نمونه با استفاده از:
.nf

        $ sudo irrecord --device /dev/lirc0 --driver default

.fi
در صورت عدم استفاده از sudo، همین رفتار را می‌توان با استفاده از متغیر محیطی SUDO_USER پیاده کرد؛ به عنوان مثال:
.nf

        # SUDO_USER=$LOGNAME irrecord --device /dev/lirc0 --driver default

.fi
گزینه --keep-root باعث می‌شود که irrecord امتیازات کاربر ریشه را در تمام طول اجرای برنامه حفظ کند.

.SH "فایل‌ها (FILES)"
.TP 4
.B /etc/lirc/lirc_options.conf
فایل گزینه‌ها شامل مقادیر پیش‌فرض برای گزینه‌های خط فرمان در بخش [irrecord]. برای برخی مقادیر از جمله debug، plugindir، driver و device، در صورتی که در بخش [irrecord] یافت نشوند، irrecord به بخش [lircd] رجوع می‌کند.
.IP \- 4
مکان این فایل را می‌توان با استفاده از گزینه خط فرمان -O/--options-file یا متغیر محیطی LIRC_OPTIONS_PATH تغییر داد.

.TP 4
.B ~/.cache/irrecord.log
خروجی اشکال‌زدایی. تنظیم متغیر محیطی XDG_CACHE_HOME مکان این فایل را به $XDG_CACHE_HOME/irrecord.log منتقل می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
https://sourceforge.net/p/lirc-remotes/wiki
.br
irdb-get(1)
.br
mode2(1)
.br
lircd.conf(5)