.TH MODE2 "1" "Last change: Jan 2017 "mode2 0.10.2" "User Commands"
.SH "نام (NAME)"
.P
\fBmode2\fR \- نمایش خروجی هسته در دسترس برای راه‌اندازهای LIRC

.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBmode2\fR --driver <\fIdriver\fR> [--device <\fIdevice\fR>]
[\fIother options\fR]
.P
\fBmode2\fR --raw --device <\fIdevice\fR> [\fIother options\fR]
.P
\fBmode2\fR --driver <\fIdriver\fR>  --list-devices

.SH "توضیحات (DESCRIPTION)"
.P
هدف اصلی این برنامه، بررسی عملکرد سخت‌افزارهای گیرندهٔ دست‌ساز LIRC و مشاهدهٔ شکل موج فروسرخ (IR) کنترل از راه دور بدون نیاز به یک اسیلوسکوپ گران‌قیمت بوده است.
به مرور زمان، \fBmode2\fR به ابزاری عمومی برای بررسی نوع خروجی ارائه‌شده توسط هسته برای lirc تکامل یافته است.
.P
دستور mode2 برای راه‌اندازهایی که از LIRC_MODE_MODE2 پشتیبانی می‌کنند، صرفاً طول پالس (pulse) و فاصله (space) را در خروجی استاندارد چاپ می‌کند. برای راه‌اندازهایی که از LIRC_MODE_LIRCCODE پشتیبانی می‌کنند (مانند کارت‌های تلویزیون و راه‌انداز irman)، مقادیر صحیح رمزگشایی‌شده را می‌نویسد.
.P
از نسخهٔ 0.9.4، \fBmode2\fR همچنین می‌تواند دستگاه‌های موجود برای یک راه‌انداز مشخص را فهرست کند. این قابلیت نیازمند پشتیبانی از شمارش (enumeration) است که در بیشتر راه‌اندازها (اما نه همهٔ آن‌ها) در دسترس است.
.P
در صورت مشخص کردن راه‌انداز صحیح، mode2 همواره باید کار کند. بدون راه‌انداز، گزینهٔ --raw باید همواره برای دستگاه‌های /dev/lirc* کار کند. در زمان نگارش این مستند، دستگاه‌های usb نیز در بیشتر موارد کار می‌کنند. با این حال، از آنجا که به‌دست آوردن مسیر دستگاه usb دشوار است، معمولاً بهتر است از طریق یک راه‌انداز به چنین دستگاه‌هایی دسترسی پیدا کرد.
.P
همهٔ راه‌اندازها به یک دستگاه نیاز ندارند.
.P

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

.TP
\fB\-d\fR \fB\-\-device\fR=\fIdevice\fR
خواندن از دستگاه مشخص‌شده.
.TP
\fB\-H\fR \fB\-\-driver\fR=\fIdriver\fR
استفاده از راه‌انداز مشخص‌شده.
.TP
\fB\-m\fR \fB\-\-mode\fR
نوشتن داده‌های پالس/فاصله به عنوان فایل‌های پیکربندی خام (raw). روی راه‌اندازهای LIRCCODE تأثیری ندارد.
.TP
\fB\-s\fR \fB\-\-scope\fR=\fItime\fR
فعال‌سازی نمایشی شبیه به اسیلوسکوپ با زمان میکروثانیه (us) بر نویسه. روی راه‌اندازهای lirccode تأثیری ندارد.
.TP
\fB\-k\fR \fB\-\-keep-root\fR
عدم رهاسازی امتیازهای ریشه (root) پس از باز کردن دستگاه. بخش «اجرا به عنوان ریشه (RUNNING AS ROOT)» را ببینید.
.TP
\fB\-l\fR \fB\-\-list\-devices\fR
فهرست کردن تمام دستگاه‌های موجود برای راه‌انداز مشخص‌شده. نیازمند پشتیبانی است که در همهٔ راه‌اندازها وجود ندارد.
.TP
\fB\-g\fR \fB\-\-gap\fR=\fItime\fR
در نظر گرفتن فاصله‌های طولانی‌تر از زمان مشخص‌شده به عنوان شکاف (gap). زمان بر حسب میکروثانیه است.
.TP
\fB\-r\fR \fB\-\-raw\fR
دسترسی مستقیم به دستگاه. این گزینه در درجهٔ اول برای استفاده با راه‌اندازهای rc هسته در نظر گرفته شده است، یعنی هنگام دسترسی به دستگاه‌های \fI/dev/lirc*\fR. استفاده از سایر دستگاه‌ها ممکن است کار کند، اما در کل رفتاری تعریف‌نشده است.
.TP
\fB\-A\fR \fB\-\-driver\-options\fR=\fIkey:value[|key:value...]\fR
تنظیم گزینهٔ مختص راه‌انداز با نام key به مقدار مشخص‌شده.
.TP
\fB\-U\fR \fB\-\-plugindir\fR=\fIdirectory\fR
بارگذاری راه‌اندازها از دایرکتوری مشخص‌شده. بخش «بارگذاری راه‌انداز (DRIVER LOADING)» را ببینید.
.TP
\fB\-O, \fB\-\-options-file\fR <\fIpath\fR>
فایل حاوی مقادیر پیش‌فرض برای تمام گزینه‌ها. مسیر نسبی بر مبنای دایرکتوری جاری تفسیر می‌شود. بخش [فایل‌ها (FILES)] در زیر را ببینید.
.TP
\fB\-D\fR \fB\-\-loglevel\fR=\fIlevel\fR
تعیین میزان اطلاعات لاگ‌گیری. [level] می‌تواند یکی از سطوح نمادین syslog باشد: 'error'، 'warning'، 'info'، 'notice' یا 'debug'. همچنین lirc سه سطح اضافی 'trace'، 'trace1' و 'trace2' را تعریف می‌کند که پیام‌های بیشتری ارائه می‌دهند ('trace2' بیشترین پیام‌ها را دارد). با این حال، در گزارش لاگ این پیام‌ها به عنوان 'debug' علامت‌گذاری می‌شوند.
این سطح همچنین می‌تواند یک عدد صحیح در بازهٔ ۳ (تقریباً بدون پیام) تا ۱۰ باشد.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش خلاصهٔ استفاده از دستور.
.TP
\fB\-v\fR \fB\-\-version\fR
نمایش نسخه.

.SH "اجرا به عنوان ریشه (RUNNING AS ROOT)"
در بسیاری از موارد mode2 باید به عنوان کاربر ریشه اجرا شود تا به دستگاه‌هایی دسترسی یابد که در اختیار کاربران عادی نیستند. از سوی دیگر، اجرا با دسترسی ریشه مشکلاتی چون مالکیت فایل‌های لاگ توسط ریشه، نگرانی‌های امنیتی و غیره را به وجود می‌آورد.
.P
به منظور مقابله با این مسئله، mode2 به صورت پیش‌فرض پس از باز کردن دستگاه ورودی، امتیازهای ریشه را رها می‌کند. این سازوکار مبتنی بر این است که مجوزهای ریشه با استفاده از sudo(1) به دست آمده باشند، مثلاً با اجرای:
.nf

        $ sudo mode2 --raw /dev/lirc0

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

        # SUDO_USER=$LOGNAME mode2 --raw /dev/lirc0

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

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

هنگام اجرا با یک راه‌انداز از نوع MODE2، دستور \fBmode2\fR زمان‌بندی‌های پالس/فاصله (space/mark) را چاپ می‌کند:
.nf
     al@snorken $ ./mode2 --driver default --device /dev/lirc0
     Using driver default on device /dev/lirc0
     Trying device: /dev/lirc0
     Using device: /dev/lirc0
     pulse 2750
     space 800
     pulse 500
     space 350
     pulse 550
     space 350
     pulse 550
     ...
.if

.P

هنگام اجرا با یک راه‌انداز از نوع LIRCCODE، دستور \fBmode2\fR مقادیر رمزگشایی‌شده را چاپ می‌کند:

.nf
     $ ./mode2 --driver atilibusb
     Using driver atilibusb on device /dev/lirc0
     Trying device: /dev/bus/usb/001/007
     Using device: /dev/bus/usb/001/007
     code: 0x14709b0000
     code: 0x14709b0000
     code: 0x14709b0000
     code: 0x14709b0000
     code: 0x14709b0000
     ...
.if

.P

هنگام اجرا با استفاده از \fBmode2 --list-devices\fR برای راه‌انداز devinput در حالی که یک دستگاه usb از نوع X10 RF متصل است:
.nf
    $ ./mode2 --list-devices --driver devinput
    /dev/input/event12 [0bc7:0006] X10 WTI RF receiver vers:  1.10 serial: ?
    /dev/input/by-id/usb-X10_WTI_RF_receiver-event-if00 -> ../event12
    /dev/input/by-path/pci-0000:0b:00.0-usb-0:1:1.0-event -> ../event12
.if

.P

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

.SH "محیط (ENVIRONMENT)"
.TP 4
.B LIRC_LOGLEVEL
در صورت عدم وجود گزینهٔ --loglevel، به عنوان جایگزین استفاده می‌شود. نحو آن همانند --loglevel است؛ بخش «گزینه‌ها (OPTIONS)» را ببینید.

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

.TP 4
.B ~/.cache/mode2.log
لاگ اشکال‌زدایی (Debug log). مقداردهی به متغیر محیطی XDG_CACHE_HOME مکان این فایل را به $XDG_CACHE_HOME/mode2.log منتقل می‌کند. میزان گزارش‌گیری از متغیر محیطی LIRC_LOGLEVEL پیروی می‌کند که به طور پیش‌فرض روی مقدار \fidebug\fR در فایل lirc_options.conf تنظیم شده است.


.SH "همچنین ببینید (SEE ALSO)"
xmode2(1)
.br
lirc(4)

مستندات
.B lirc
به صورت صفحات html نگهداری می‌شوند. این مستندات در مسیر html/ در دایرکتوری مستندات قرار دارند.