نام (NAME)

v4l2-ctl - ابزاری برای کنترل درایورهای video4linux

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

v4l2-ctl [-h] [-d <dev>] [بسیاری گزینه‌های دیگر]

توضیحات (DESCRIPTION)

ابزار v4l2-ctl برای کنترل دستگاه‌های video4linux شامل ویدیو، vbi، رادیو یا swradio (هم ورودی و هم خروجی) به کار می‌رود. این ابزار قادر است تقریباً هر جنبه‌ای از چنین دستگاه‌هایی را کنترل کرده و تمام V4L2 API را پوشش دهد.

گزینه‌ها (OPTIONS)

-A, --list-devices: فهرست کردن تمام دستگاه‌های v4l. اگر -z داده شده باشد، تنها دستگاه‌های متعلق به دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده توسط گزینه -z فهرست می‌شوند.
-d, --device <dev>: استفاده از دستگاه <dev> به عنوان دستگاه V4L2. اگر <dev> با یک رقم آغاز شود، از /dev/video<dev> استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، <dev> نام موجودیت (entity name) یا شناسه رابط (interface ID، در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری (topology) دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه -z یافت می‌شود.
-v, --verbose: فعال کردن گزارش‌دهی پرگو (verbose).
--version: نمایش اطلاعات نسخه.
-w, --wrapper: استفاده از کتابخانه پوششی libv4l2 برای تمام دسترسی‌ها به دستگاه V4L2. به‌طور پیش‌فرض v4l2-ctl مستقیماً به دستگاه V4L2 دسترسی پیدا می‌کند، اما با این گزینه تمام دسترسی‌ها از طریق این کتابخانه پوششی انجام خواهد شد.
-h, --help: چاپ پیام راهنما.
--help-io: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن ورودی‌ها و خروجی‌ها، هم ویدیویی و هم صوتی.
--help-meta: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های فراداده (metadata).
--help-misc: چاپ پیام راهنما برای گزینه‌های متفرقه.
--help-overlay: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های overlay و framebuffer.
--help-sdr: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های رادیوی نرم‌افزاری (SDR).
--help-selection: چاپ پیام راهنما برای تمام گزینه‌های مربوط به انتخاب‌ها (برش و ترکیب‌بندی / cropping and composing).
--help-stds: چاپ پیام راهنما برای تمام گزینه‌های مربوط به استانداردهای SDTV و زمان‌بندی‌های ویدیوی دیجیتال.
--help-streaming: چاپ پیام راهنما برای تمام گزینه‌های مربوط به جریان‌سازی داده‌ها (streaming).
--help-subdev: چاپ پیام راهنما برای تمام گزینه‌های مربوط به دستگاه‌های v4l-subdevX.
--help-tuner: چاپ پیام راهنما برای تمام گزینه‌های مربوط به تیونرها و مدولاتورها.
--help-vbi: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های VBI.
--help-vidcap: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های دریافت/ضبط ویدیو (video capture).
--help-vidout: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های خروجی ویدیو (video output).
--help-edid: چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم EDIDها.
--help-all: چاپ پیام راهنما برای تمام گزینه‌ها.
--all: نمایش تمام اطلاعات موجود.
-C, --get-ctrl <ctrl>[,<ctrl>...]: دریافت مقدار کنترل‌ها [VIDIOC_G_EXT_CTRLS].
-c, --set-ctrl <ctrl>=<val>[,<ctrl>=<val>...]: تنظیم مقدار کنترل‌ها [VIDIOC_S_EXT_CTRLS].
-D, --info: نمایش اطلاعات درایور [VIDIOC_QUERYCAP].
-e, --out-device <dev>: استفاده از دستگاه <dev> برای جریان‌های خروجی به جای دستگاه پیش‌فرض تنظیم‌شده با --device. اگر <dev> با یک رقم آغاز شود، از /dev/video<dev> استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، <dev> نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه -z یافت می‌شود.
-E, --export-device <dev>: استفاده از دستگاه <dev> برای برون‌ریزی بافرهای DMA. اگر <dev> با یک رقم آغاز شود، از /dev/video<dev> استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، <dev> نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه -z یافت می‌شود.
-z, --media-bus-info <bus-info>: یافتن دستگاه چندرسانه‌ای با رشته <bus-info> داده‌شده. در صورت تنظیم، گزینه‌های -d، -e و -E می‌توانند از نام موجودیت یا شناسه رابط برای اشاره به گره‌های دستگاه استفاده کنند. مثال: v4l2-ctl -z platform:vivid-000 -d vivid-000-vid-cap
-k, --concise: ارائه خروجی خلاصه‌تر در صورت امکان.
-l, --list-ctrls: نمایش تمام کنترل‌ها و مقادیر آن‌ها [VIDIOC_QUERYCTRL].
-L, --list-ctrls-menus: نمایش تمام کنترل‌ها و منوهای آن‌ها [VIDIOC_QUERYMENU].
-r, --subset <ctrl>[,<offset>,<size>]+: زیرمجموعه آرایه N-بعدی برای دریافت/تنظیم جهت کنترل <ctrl>؛ برای هر بعد یک چندتایی (<offset>, <size>) داده می‌شود.
--list-devices-input <name>: مشابه --list-devices، اما تنها دستگاه‌هایی را نشان می‌دهد که نام ورودی فعلی آن‌ها با <name> مطابقت دارد.
--list-devices-output <name>: مشابه --list-devices، اما تنها دستگاه‌هایی را نشان می‌دهد که نام خروجی فعلی آن‌ها با <name> مطابقت دارد.
--log-status: ثبت وضعیت برد در لاگ‌های هسته [VIDIOC_LOG_STATUS].
--get-priority: پرس‌وجوی اولویت دسترسی فعلی [VIDIOC_G_PRIORITY].
--set-priority <prio>: تنظیم اولویت دسترسی جدید [VIDIOC_S_PRIORITY]. مقدار <prio> برابر است با 1 (پس‌زمینه)، 2 (تعاملی) یا 3 (ضبط).
--silent: تنها تنظیم کد نتیجه، بدون چاپ هیچ پیامی.
--sleep <secs>: توقف به مدت <secs> ثانیه، فراخوانی QUERYCAP و بستن دستگیره فایل.

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

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

مثال‌ها (EXAMPLES)

پرس‌وجوی اطلاعات دستگاه /dev/video1:

v4l2-ctl -d1 -D

جریان‌سازی ویدیو با استفاده از I/O جریانی MMAP از /dev/video0:

v4l2-ctl -d0 --stream-mmap

جریان‌سازی یک فریم ویدیو از /dev/video0 و ذخیره آن در یک فایل:

v4l2-ctl --stream-mmap --stream-count=1 --stream-to=file.raw

جریان‌سازی ویدیو از /dev/video0 و ارسال جریانی آن روی شبکه:

v4l2-ctl --stream-mmap --stream-to-host <hostname>

استفاده از 'qvidcap -p' روی میزبان برای مشاهده ویدیو.

جریان‌سازی ویدیو از /dev/video0 با استفاده از DMABUFهای صادرشده از /dev/video2:

v4l2-ctl --stream-dmabuf --export-device /dev/video2

جریان‌سازی ویدیو از یک دستگاه حافظه-به-حافظه (memory-to-memory):

v4l2-ctl --stream-mmap --stream-out-mmap

جریان‌سازی ویدیو از یک دستگاه ضبط ویدیویی (/dev/video1) به یک دستگاه خروجی ویدیویی (/dev/video2):

v4l2-ctl -d1 --stream-mmap --out-device /dev/video2 --stream-out-dmabuf

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

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

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