.TH LIRCD-UINPUT "8" "Last change: Jun 2017" "lircd.uinput 0.10.2" "System Managers Manual"

." Copyright (c) 2015, Alec Leamas
."
." %%%LICENSE_START(GPLv2+_DOC_FULL)
." This is free documentation; you can redistribute it and/or
." modify it under the terms of the GNU General Public License as
." published by the Free Software Foundation; either version 2 of
." the License, or (at your option) any later version.
."
." The GNU General Public License's references to "object code"
." and "executables" are to be interpreted as the output of any
." document formatting or typesetting system, including
." intermediate and printed output.
."
." This manual is distributed in the hope that it will be useful,
." but WITHOUT ANY WARRANTY; without even the implied warranty of
." MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
." GNU General Public License for more details.
."
." You should have received a copy of the GNU General Public
." License along with this manual; if not, see
." <http://www.gnu.org/licenses>.
." %%%LICENSE_END

.SH "نام (NAME)"
.P
lircd-uinput \- بازپخش فشردن دکمه‌های lirc به عنوان رویدادهای uinput

.SH "خلاصه دستور (SYNOPSIS)"
.P
lircd-uinput [\fIگزینه‌ها\fP]... [\fIسوکت خروجی lircd\fP]
.br
lircd-uinput [\fIگزینه‌ها\fP]... [\fIفایل\fP]

.SH "توضیحات (DESCRIPTION)"

.B lircd-uinput
رویدادهای کدگشایی‌شده فشردن دکمه را از سوکت خروجی
.BR lircd(8)
می‌خواند و آن‌ها را به عنوان رویدادهای کلید به دستگاه uinput کرنل تزریق می‌کند.
کرنل این رویدادها را درست مانند سخت‌افزار ورودی معمولی، از طریق یک دستگاه
.I /dev/input/event
در دسترس برنامه‌های دیگر قرار می‌دهد.
.P
دستور
.B lircd-uinput
طوری طراحی شده است که به عنوان یک سرویس systemd اجرا شود.
.P
آرگومان
.I سوکت خروجی lircd
یک مسیر اختیاری به سوکت خروجی lircd است.
مقدار پیش‌فرض آن مقدار \fIoutput\fP در بخش [lircd] از فایل پیکربندی lirc_options است، و در صورت عدم تنظیم، به
.I /var/run/lirc/lircd
بازمی‌گردد.
.P
اگر به جای سوکت، یک فایل متنی ساده ارائه شود، فرض می‌شود حاوی رویدادهای فشرده‌شدن دکمه مطابق مستندات
.BR lircd(8)
است.
در این حالت،
.B lircd-uinput
کدهای موجود در این فایل را ارسال کرده و خارج می‌شود.
.P
برای اینکه این سازوکار درست کار کند، رویدادهای رهاسازی کلید (release) نیز باید به دستگاه uinput ارسال شوند.
بخش «مدیریت تکرار کلید» را مشاهده کنید.
.P
دستور
.B lircd-uinput
تنها می‌تواند رویدادهای دکمه‌هایی را پردازش کند که نام آن‌ها با استفاده از فضای نام رسمی تعریف شده باشد، یعنی دکمه‌هایی که برای کرنل شناخته‌شده هستند. بخش «نکات» را ببینید.
.P
مگر اینکه مجوزهای پیش‌فرض
.I /dev/uinput
تغییر یافته باشد،
.B lirc-uinput
باید با دسترسی مدیر سیستم (root) اجرا شود. بخش «نکات» را ببینید.
.P
یافتن دستگاه
.I /dev/input/event
ایجادشده توسط کرنل ممکن است پیچیده باشد و نام آن پایدار نیست.
بخش «نکات» را ببینید.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-u\fR \fB\-\-uinput\fR <\fIdevice\fR>
دستگاه هسته uinput؛ پیش‌فرض /dev/uinput است.
.TP
\fB\-r\fR \fB\-\-release-suffix\fR <\fIsuffix\fR>
دستور
.B lircd-uinput
بسته به اینکه آیا نام دکمه با \fIپسوند رهاسازی\fR پایان می‌یابد یا خیر، رویدادهای متفاوتی تولید می‌کند.
پیش‌فرض
.I _EVUP
است. بخش «مدیریت تکرار کلید» را ببینید.
.TP
\fB\-R\fR \fB\-\-repeat\fR <\fIdelay\fR[,\fIperiod\fR] | \fI,period\fR>
تنظیم پارامترهای تکرار خودکار هسته برای دستگاه
.I /dev/input/event
ایجادشده.
مقدار
.I delay
مدت زمان پیش از تکرار رویداد کلید است و
.I period
فاصله زمانی میان رویدادهای تکرار کلید است.
هر دو مقدار بر حسب میلی‌ثانیه بوده و با کاما از یکدیگر جدا می‌شوند.
هر مقداری را می‌توان حذف کرد یا روی 0 قرار داد که در این صورت پیش‌فرض‌های هسته یا سیستم استفاده می‌شوند.
بخش «مدیریت تکرار کلید» را ببینید.
.TP
\fB\-a\fR \fB\-\-add-release-events\fR
تولید رویدادهای رهاسازی کلید به صورت ساختگی (مصنوعی).
این گزینه الزامی است مگر اینکه
.BR lircd
از گزینه منسوخ‌شده
.I --release
استفاده کند.
مدت زمان وقفه (timeout) مورد استفاده را می‌توان با کلید
.I release-timeout
در بخش
.I lircd-uinput
از فایل
.BR lirc_options.conf
تغییر داد.
در صورت استفاده از یک فایل متنی به عنوان ورودی، این گزینه بی‌فایده است.
بخش «مدیریت تکرار کلید» را ببینید.
.TP
\fB\-d\fR \fB\-\-disabled\fR <\fIdisabled buttons file path\fR>
مسیر فایلی شامل نام دکمه‌هایی که باید غیرفعال شوند، در هر خط یک دکمه.
به صورت پیش‌فرض،
.B lircd-uinput
تمامی دکمه‌های یافت‌شده در ورودی را ارسال می‌کند.
بخش «نکات» را ببینید.
.TP
\fB\-O\fR \fB\-\-options-file\fR <\fIpath\fR>
فایل گزینه‌ها حاوی مقادیر پیش‌فرض. پیش‌فرض
.I /etc/lircd/lirc_options.conf
است.
.TP
\fB-L, --logfile\fR <\fIlogfile path\fR>
انتخاب فایل گزارش؛ می‌تواند رشته 'syslog' به معنای استفاده از syslog(1) یا مسیر یک فایل لاگ باشد.
پیش‌فرض استفاده از syslog است.
.TP
\fB-D, --loglevel\fR [\fIlevel\fR]
تعیین میزان جزئیات گزارش‌گیری.
مقدار
.I level
می‌تواند یکی از سطوح نمادین syslog باشد: 'error' ،'warning' ،'info' ،'notice' یا 'debug'.
همچنین
.B lircd-uinput
سه سطح اضافی 'trace' ،'trace1' و 'trace2' را تعریف می‌کند که پیام‌های باز هم بیشتری ارائه می‌دهند (سطح 'trace2' بیشترین پیام را دارد).
با این حال، این پیام‌ها در لاگ به عنوان 'debug' علامت‌گذاری می‌شوند.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش خلاصه نحوه استفاده.
.TP
\fB\-v\fR \fB\-\-version\fR
نمایش اطلاعات نسخه.

.SH "مدیریت تکرار کلید (REPEAT HANDLING)"

کرنل پس از دریافت رویداد فشردن کلید، ارسال رویدادهای تکرار به برنامه‌ها را آغاز می‌کند تا زمانی که
.B lircd-uinput
رویداد رهاسازی مربوطه را منتشر کند.
رویدادهای رهاسازی می‌توانند توسط
.BR lircd(8)
با استفاده از گزینه منسوخ‌شده
.I --release
تولید شوند.
چنین رویدادهایی معمولاً پسوند
.I _EVUP
را به رویداد فشردن کلید اصلی اضافه می‌کنند.
.P
رویکرد ترجیحی این است که
.B lircd-uinput
رویدادهای رهاسازی را با استفاده از گزینه
.I --add-release-events
ایجاد کند.
ترکیب هر دوی این گزینه‌ها ممکن است نتایج غیرمنتظره‌ای به دنبال داشته باشد.
.P
توجه داشته باشید که هسته لینوکس از نسخه ۴٫۷ به بعد از پسوند _UP (که پیش از ۰٫۱۰٫۰ توسط lircd استفاده می‌شد) برای مقاصد دیگری استفاده می‌کند.
.P
در هر حال، رویدادهای تکرار تولیدشده توسط هسته را می‌توان با استفاده از گزینه
.I --repeat
تنظیم کرد. این گزینه می‌تواند زمان میان فشردن کلید تا نخستین رویداد تکرار و همچنین فاصله زمانی میان هر رویداد تکرار را تعیین کند.
گزینه
.I --repeat
تنها زمانی باید استفاده شود که هیچ برنامه یا قاعده udev دیگری به صورت خودکار پارامترهای تکرار کلید را پیکربندی نکند.
از نظر طراحی، پارامترهای تکرار را نمی‌توان به صورت اتمیک در هنگام ثبت دستگاه ورودی تنظیم کرد؛ بنابراین این گزینه مستعد شرایط رقابتی (race conditions) است.
.P
دقت داشته باشید که مدیریت رویداد تکرار در
.B lircd-uinput
با
.BR lircd(8)
تفاوت دارد؛ زیرا lircd تکرار خودکار سخت‌افزاری را در رویدادهای ارسالی به uinput پیاده‌سازی (شبیه‌سازی) می‌کند (event.value == 2).
در مقابل،
.B lircd-uinput
تنها رویدادهای فشردن و رهاسازی کلید را ارسال می‌کند و به پشتیبانی هسته از تکرار خودکار اتکا دارد.

.SH "نکات (NOTES)"

به صورت پیش‌فرض، دستگاه
.I /dev/uinput
برای کاربران عادی قابل نوشتن نیست.
بنابراین
.B lircd-uinput
باید با دسترسی ریشه (root) اجرا شود مگر اینکه این مجوزها تغییر کرده باشند.
.P
یکی از راه‌های دستیابی به این موضوع، استفاده از یک قاعده udev است.
توزیع lirc حاوی یک قاعده نمونه است که دستگاه
.B lircd-uinput
را برای کاربران گروه lirc قابل نوشتن می‌کند.
روش دیگر، استفاده از
.BR lircd-setup(8)
جهت تغییر مجوزها است. فایل
.I lirc_options.conf
به صورتی که توزیع شده، شامل یک مثال کامنت‌شده با استفاده از
.BR setfacl(1)
است.
.P
دستور
.B lircd-uinput
تنها می‌تواند رویدادهای دکمه lircd را با نام‌هایی از فضای نام مجاز تعریف‌شده توسط هسته بازپخش کند.
فهرست کاملی از نام‌های ممکن دکمه‌ها در
.I /usr/include/linux/input-event-codes.h
و همچنین با استفاده از
.I irrecord -l
در دسترس است.
سایر نام‌های دکمه‌ها بدون اعلام قبلی نادیده گرفته و رها می‌شوند.
.P
کد کلید رویداد (keycode) به نامی بستگی دارد که در فایل پیکربندی lircd به دکمه داده شده است؛ برای نمونه، اگر دکمه نام \fIKEY_1\fR را داشته باشد، کد کلید \fI1\fR تولید خواهد شد.
.P
کرنل رویدادهای تولیدشده توسط
.B lircd-uinput
را روی دستگاهی از نوع
.I /dev/input
مانند
.I /dev/input/event12
در دسترس قرار می‌دهد.
این نام دستگاه پایدار نیست و معمولاً پس از راه‌اندازی مجدد سیستم تغییر می‌کند.
توزیع lirc حاوی یک قاعده udev است که در صورت نصب، یک پیوند نمادین با نام
.I /dev/lircd-uinput
می‌سازد که همواره قابل استفاده خواهد بود.
.P
دستور
.B lircd-uinput
طراحی شده تا جایگزین گزینه منسوخ‌شده
.I --uinput
در
.BR lircd(8)
شود.
با این حال،
.B lircd-uinput
تمامی رویدادها را بازپخش می‌کند مگر اینکه توسط گزینه
.I --disabled
مسدود شده باشند.
از سوی دیگر، گزینه
.I --uinput
در
.BR lircd
همه رویدادها را ارسال نمی‌کرد و روش‌های اکتشافی (heuristics) مورد استفاده در آن در طول نسخه‌ها تغییر یافته است.

.SH "اشکالات (BUGS)"

از آنجا که نام دستگاه ثابت است، تنها یک نمونه از
.B lircd-uinput
می‌تواند روی سیستم اجرا شود.

.SH "همچنین ببینید (SEE ALSO)"

.br
.BR lircd (8)
.br
.BR irrecord(1)
.br
.BR http://www.kernel.org/doc/Documentation/input/event-codes.txt