.TH "CEC-FOLLOWER" "1" "August 2016" "v4l-utils 1.32.0" "User Commands"
.SH "نام (NAME)"
cec-follower \- برنامه‌ای برای شبیه‌سازی پیروهای CEC
.SH "خلاصه دستور (SYNOPSIS)"
.B cec-follower
[\fI-h\fR] [\fI-d <dev>\fR] [سایر گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
ابزار \fBcec-follower\fR برای شبیه‌سازی پیروهای CEC (یا followerها) به کار می‌رود. بر پایهٔ نشانی(های) منطقی پیکربندی‌شده برای دستگاه CEC، رفتار CEC را متناسب با آن شبیه‌سازی می‌کند.

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

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

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

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

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

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

هنگام اجرای آزمون‌های تطابق با \fBcec-compliance\fR، باید \fBcec-follower\fR روی همان دستگاه اجرا شود تا به پیام‌های ورودی که پاسخ پیام‌های ارسال‌شده توسط ابزار آزمون تطابق نیستند، واکنش نشان دهد. پیش از اجرای هر آزمون، در صورت در حال اجرا بودن \fBcec-follower\fR باید آن را بازراه‌اندازی کرد تا دستگاه شبیه‌سازی‌شده با یک وضعیت اولیهٔ پاک و شناخته‌شده مقداردهی شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-device\fR \fI<dev>\fR
استفاده از دستگاه <dev> به عنوان دستگاه CEC. اگر <dev> یک عدد باشد، از /dev/cec<dev> استفاده می‌شود.
.TP
\fB\-D\fR, \fB\-\-driver\fR \fI<drv>\fR
استفاده از یک دستگاه cec که نام درایور آن \fI<drv>\fR است، مطابق آنچه توسط ioctl مقدار CEC_ADAP_G_CAPS بازگردانده شده است. این گزینه می‌تواند با \fB\-a\fR ترکیب شود تا بدون نیاز به تکیه بر شمارهٔ گره دستگاه، دستگاه CEC را به‌طور یکتا مشخص کند.
.TP
\fB\-a\fR, \fB\-\-adapter\fR \fI<adap-name>\fR
استفاده از یک دستگاه cec که نام آداپتور آن \fI<adap-name>\fR است، مطابق آنچه توسط ioctl مقدار CEC_ADAP_G_CAPS بازگردانده شده است. این گزینه می‌تواند با \fB\-D\fR ترکیب شود تا بدون نیاز به تکیه بر شمارهٔ گره دستگاه، دستگاه CEC را به‌طور یکتا مشخص کند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال کردن گزارش‌دهی پرجزئیات.
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه.
.TP
\fB\-w\fR, \fB\-\-wall\-clock\fR
نمایش برچسب‌های زمانی به صورت زمان واقعی ساعت دیواری (wall-clock time). این گزینه گزارش‌دهی پرجزئیات را نیز فعال می‌کند.
.TP
\fB\-T\fR, \fB\-\-trace\fR
ردیابی تمامی ioctlهای فراخوانی‌شده. مناسب برای اشکال‌زدایی.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ پیام راهنما.
.TP
\fB\-n\fR, \fB\-\-no\-warnings\fR
غیرفعال کردن پیام‌های هشدار.
.TP
\fB\-e\fR, \fB\-\-exclusive\fR
در صورت تعیین، پیرو از حالت انحصاری (CEC_MODE_EXCL_FOLLOWER) استفاده می‌کند.
.TP
\fB\-m\fR, \fB\-\-show\-msgs\fR
نمایش پیام‌های دریافتی.
.TP
\fB\-s\fR, \fB\-\-show\-state\fR
نمایش تغییرات وضعیت دستگاه شبیه‌سازی‌شده.
.TP
\fB\-\-service\-by\-dig\-id\fR
گزارش سرویس‌های دیجیتال بر اساس شناسه دیجیتال (digital ID) به جای گزارش بر اساس کانال.
.TP
\fB\-\-standby\fR
راه‌اندازی پیرو در وضعیت Standby (آماده‌به‌کار).
.TP
\fB\-\-toggle\-power\-status\fR \fI<secs>\fR
تغییر دادن متناوب وضعیت برق هر <secs> ثانیه یک‌بار. تنها در صورتی پشتیبانی می‌شود که پیرو در حال شبیه‌سازی یک TV باشد.
.TP
\fB\-i\fR, \fB\-\-ignore\fR \fI<la>,<opcode>\fR
نادیده گرفتن پیام‌ها از نشانی منطقی \fI<la>\fR و کد دستور \fI<opcode>\fR. می‌توان از \(aqall\(aq برای \fI<la>\fR یا \fI<opcode>\fR استفاده کرد تا با تمامی نشانی‌های منطقی یا کدهای دستور مطابقت پیدا کند.
.TP
\fB\-\-ignore\-standby\fR \fI<n>\fR
نادیده گرفتن هر <n>امین پیام دریافتی Standby.
.TP
\fB\-\-ignore\-view\-on\fR \fI<n>\fR
نادیده گرفتن هر <n>امین پیام دریافتی Image/Text View On.

.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، کد خطا را برمی‌گرداند.
.SH "گزارش باگ‌ها (BUGS)"
این صفحهٔ راهنما در دست توسعه و تکمیل است.

گزارش‌های باگ یا پرسش‌ها دربارهٔ این ابزار باید به فهرست پستی linux-media@vger.kernel.org ارسال شوند.
.SH "همچنین ببینید (SEE ALSO)"
\fBcec-compliance\fR(1), \fBcec-ctl\fR(1)