نام (NAME)

xmode2 - نمایش گرافیکی طول پالس و فاصله سیگنال‌های مادون قرمز

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

xmode2 [گزینه‌ها]

توضیحات (DESCRIPTION)

هدف اصلی xmode2 بررسی عملکرد سخت‌افزار گیرنده دست‌ساز LIRC و مشاهده شکل موج مادون قرمز (IR) کنترل از راه دور بدون نیاز به اسیلوسکوپ گران‌قیمت است. این برنامه برای اشکال‌زدایی بسیار کاربردی است. البته این برنامه روی سخت‌افزارهایی که سیگنال‌ها را به صورت خودکار رمزگشایی می‌کنند (مانند کارت‌های تلویزیون یا Irman) کار نمی‌کند؛ به این معنی که تنها با درایورهای نوع LIRC_MODE_MODE2 کار می‌کند.

دستور xmode2 یک نمایش گرافیکی ساده از طول پالس‌ها و فاصله‌ها ارائه می‌دهد. این ابزار از چند دستور از جمله تغییرات پایه زمانی پشتیبانی می‌کند؛ برای اطلاعات بیشتر به خروجی xmode2 -h مراجعه کنید.

ابزار lirc-lsplugins(1) امکان بررسی اینکه آیا یک درایور از نوع LIRC_MODE2 است یا خیر را فراهم می‌کند.

گزینه‌ها (OPTIONS)

-h, --help: نمایش خلاصه نحوه استفاده
-v, --version: نمایش نگارش برنامه
-d, --device=دستگاه: خواندن از دستگاه مشخص‌شده
-H, --driver=درایور: استفاده از درایور مشخص‌شده
-m, --mode: فعال‌سازی حالت نمایش جایگزین
-r, --raw: دسترسی مستقیم به دستگاه

اجرا به عنوان ریشه (RUNNING AS ROOT)

در بسیاری از موارد xmode2 برای دسترسی به دستگاه‌هایی که در دسترس کاربران عادی نیست، نیاز به اجرا با دسترسی کاربر ریشه (root) دارد. از سوی دیگر، اجرا با دسترسی ریشه مشکلاتی مانند ایجاد فایل‌های لاگ متعلق به ریشه، دغدغه‌های امنیتی و غیره ایجاد می‌کند.

برای مقابله با این موضوع، xmode2 به صورت پیش‌فرض پس از باز کردن دستگاه ورودی، دسترسی‌های ریشه را لغو می‌کند. این سازوکار مبتنی بر آن است که مجوزهای ریشه با استفاده از sudo(1) کسب شده باشند؛ به عنوان مثال:

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

در صورت عدم استفاده از sudo، رفتار مشابهی را می‌توان با استفاده از متغیر محیطی SUDO_USER انجام داد؛ به عنوان مثال:

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

گزینه --keep-root باعث می‌شود xmode2 دسترسی‌های ریشه خود را در تمام مدت اجرا حفظ کند.

بارگذاری درایور (DRIVER LOADING)

درایورها به صورت پویا بارگذاری می‌شوند. مسیر جستجوی مورد استفاده برای این کار با اولویت نزولی زیر تعیین می‌شود:

گزینه --plugindir.
مدخل «plugindir» در بخش [lircd] از فایل lirc_options.conf.
متغیر محیطی LIRC_PLUGINDIR.
مقدار پیش‌فرض کامپایل‌شده (معمولاً /usr/lib[64]/lirc/plugins).

فایل‌ها (FILES)

~/.cache/xmode2.log: خروجی اشکال‌زدایی. تنظیم متغیر محیطی XDG_CACHE_HOME این فایل را به مسیر $XDG_CACHE_HOME/mode2.log منتقل می‌کند.

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

mode2(1)
lirc-lsplugins(1)

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