نام (NAME)

cec-follower - برنامه‌ای برای شبیه‌سازی پیروهای CEC

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

cec-follower [-h] [-d <dev>] [سایر گزینه‌ها]

توضیحات (DESCRIPTION)

ابزار cec-follower برای شبیه‌سازی پیروهای CEC (یا followerها) به کار می‌رود. بر پایهٔ نشانی(های) منطقی پیکربندی‌شده برای دستگاه CEC، رفتار CEC را متناسب با آن شبیه‌سازی می‌کند.

پیکربندی دستگاه CEC با استفاده از cec-ctl انجام می‌شود. عملکردهای مشخصی از CEC تنها در صورتی شبیه‌سازی می‌شوند که پرچم متناظر با آن‌ها در Device Features تنظیم شده باشد (این پرچم‌ها هنگام پیکربندی با cec-ctl تنظیم می‌شوند). این قابلیت‌ها عبارتند از:

- Audio Return Channel (RX and TX)
- Audio Rate Control
- Deck Control
- Record TV screen

cec-follower در اصل یک حلقهٔ پیام است که منتظر دریافت پیام‌ها می‌ماند و متناسب با هر پیام اقدام لازم را انجام می‌دهد (پیام‌های دریافتی را می‌توان با گزینهٔ --show-msgs مشاهده کرد). پیرو وضعیت داخلی مشخصی را با پارامترهای مناسب مانند بلندی صدا، منبع فعال فعلی، وضعیت برق و انرژی و غیره نگهداری می‌کند (تغییرات وضعیت را می‌توان با گزینهٔ --show-state مشاهده کرد).

این ابزار همچنین قصد دارد یک پیاده‌سازی مرجع در رابطه با نحوهٔ رفتار یک پیرو باشد.

cec-follower پیام‌های دریافتی را رصد کرده و تخطی از مشخصات CEC را در رابطه با زمان‌بندی‌ها بررسی می‌کند. برای مثال، اگر در فاصلهٔ کمتر از ۲۰۰ میلی‌ثانیه پس از آن‌که به پیامی با <Feature Abort> ["Unrecognized Opcode"] پاسخ داد، مجدداً همان پیام را دریافت کند هشدار می‌دهد، و همچنین بررسی می‌کند که رفتار فشردن و نگه‌داشتن کلیدها (press and hold) به درستی پیاده‌سازی شده باشد.

cec-follower به صورت دوره‌ای پیام‌های پیمایشی (polling) ارسال می‌کند تا متوجه شود چه زمانی یک دستگاه دوردست جدا شده یا دستگاه جدیدی اضافه شده است. هنگامی که دستگاهی جدا شود، اطلاعات ثبت‌شدهٔ مربوط به آن پاک می‌گردد. هر نشانی منطقی حدوداً هر ۱۵ ثانیه یک‌بار پیمایش (poll) می‌شود. در فاصلهٔ بین پیمایش‌ها، جدا کردن یک دستگاه دوردست یا جایگزینی آن با دستگاهی جدید تشخیص داده نمی‌شود.

هنگام اجرای آزمون‌های تطابق با cec-compliance، باید cec-follower روی همان دستگاه اجرا شود تا به پیام‌های ورودی که پاسخ پیام‌های ارسال‌شده توسط ابزار آزمون تطابق نیستند، واکنش نشان دهد. پیش از اجرای هر آزمون، در صورت در حال اجرا بودن cec-follower باید آن را بازراه‌اندازی کرد تا دستگاه شبیه‌سازی‌شده با یک وضعیت اولیهٔ پاک و شناخته‌شده مقداردهی شود.

گزینه‌ها (OPTIONS)

-d, --device <dev>

استفاده از دستگاه <dev> به عنوان دستگاه CEC. اگر <dev> یک عدد باشد، از /dev/cec<dev> استفاده می‌شود.

-D, --driver <drv>

استفاده از یک دستگاه cec که نام درایور آن <drv> است، مطابق آنچه توسط ioctl مقدار CEC_ADAP_G_CAPS بازگردانده شده است. این گزینه می‌تواند با -a ترکیب شود تا بدون نیاز به تکیه بر شمارهٔ گره دستگاه، دستگاه CEC را به‌طور یکتا مشخص کند.

-a, --adapter <adap-name>

استفاده از یک دستگاه cec که نام آداپتور آن <adap-name> است، مطابق آنچه توسط ioctl مقدار CEC_ADAP_G_CAPS بازگردانده شده است. این گزینه می‌تواند با -D ترکیب شود تا بدون نیاز به تکیه بر شمارهٔ گره دستگاه، دستگاه CEC را به‌طور یکتا مشخص کند.

-v, --verbose

فعال کردن گزارش‌دهی پرجزئیات.

--version

نمایش اطلاعات نسخه.

-w, --wall-clock

نمایش برچسب‌های زمانی به صورت زمان واقعی ساعت دیواری (wall-clock time). این گزینه گزارش‌دهی پرجزئیات را نیز فعال می‌کند.

-T, --trace

ردیابی تمامی ioctlهای فراخوانی‌شده. مناسب برای اشکال‌زدایی.

-h, --help

چاپ پیام راهنما.

-n, --no-warnings

غیرفعال کردن پیام‌های هشدار.

-e, --exclusive

در صورت تعیین، پیرو از حالت انحصاری (CEC_MODE_EXCL_FOLLOWER) استفاده می‌کند.

-m, --show-msgs

نمایش پیام‌های دریافتی.

-s, --show-state

نمایش تغییرات وضعیت دستگاه شبیه‌سازی‌شده.

--service-by-dig-id

گزارش سرویس‌های دیجیتال بر اساس شناسه دیجیتال (digital ID) به جای گزارش بر اساس کانال.

--standby

راه‌اندازی پیرو در وضعیت Standby (آماده‌به‌کار).

--toggle-power-status <secs>

تغییر دادن متناوب وضعیت برق هر <secs> ثانیه یک‌بار. تنها در صورتی پشتیبانی می‌شود که پیرو در حال شبیه‌سازی یک TV باشد.

-i, --ignore <la>,<opcode>

نادیده گرفتن پیام‌ها از نشانی منطقی <la> و کد دستور <opcode>. می‌توان از 'all' برای <la> یا <opcode> استفاده کرد تا با تمامی نشانی‌های منطقی یا کدهای دستور مطابقت پیدا کند.

--ignore-standby <n>

نادیده گرفتن هر <n>امین پیام دریافتی Standby.

--ignore-view-on <n>

نادیده گرفتن هر <n>امین پیام دریافتی Image/Text View On.

وضعیت خروج (EXIT STATUS)

در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، کد خطا را برمی‌گرداند.

گزارش باگ‌ها (BUGS)

این صفحهٔ راهنما در دست توسعه و تکمیل است.

گزارش‌های باگ یا پرسش‌ها دربارهٔ این ابزار باید به فهرست پستی linux-media@vger.kernel.org ارسال شوند.

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

cec-compliance(1), cec-ctl(1)