V4L2-CTL(1) User Commands V4L2-CTL(1) نام (NAME) v4l2-ctl - ابزاری برای کنترل درایورهای video4linux خلاصه دستور (SYNOPSIS) v4l2-ctl [-h] [-d ] [بسیاری گزینه‌های دیگر] توضیحات (DESCRIPTION) ابزار v4l2-ctl برای کنترل دستگاه‌های video4linux شامل ویدیو، vbi، رادیو یا swradio (هم ورودی و هم خروجی) به کار می‌رود. این ابزار قادر است تقریباً هر جنبه‌ای از چنین دستگاه‌هایی را کنترل کرده و تمام V4L2 API را پوشش دهد. گزینه‌ها (OPTIONS) -A, --list-devices فهرست کردن تمام دستگاه‌های v4l. اگر -z داده شده باشد، تنها دستگاه‌های متعلق به دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده توسط گزینه -z فهرست می‌شوند. -d, --device استفاده از دستگاه به عنوان دستگاه V4L2. اگر با یک رقم آغاز شود، از /dev/video استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، نام موجودیت (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 [,...] دریافت مقدار کنترل‌ها [VIDIOC_G_EXT_CTRLS]. -c, --set-ctrl =[,=...] تنظیم مقدار کنترل‌ها [VIDIOC_S_EXT_CTRLS]. -D, --info نمایش اطلاعات درایور [VIDIOC_QUERYCAP]. -e, --out-device استفاده از دستگاه برای جریان‌های خروجی به جای دستگاه پیش‌فرض تنظیم‌شده با --device. اگر با یک رقم آغاز شود، از /dev/video استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه -z یافت می‌شود. -E, --export-device استفاده از دستگاه برای برون‌ریزی بافرهای DMA. اگر با یک رقم آغاز شود، از /dev/video استفاده می‌شود. در غیر این صورت اگر پیش‌تر -z مشخص شده باشد، نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه -z یافت می‌شود. -z, --media-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 [,,]+ زیرمجموعه آرایه N-بعدی برای دریافت/تنظیم جهت کنترل ؛ برای هر بعد یک چندتایی (, ) داده می‌شود. --list-devices-input مشابه --list-devices، اما تنها دستگاه‌هایی را نشان می‌دهد که نام ورودی فعلی آن‌ها با مطابقت دارد. --list-devices-output مشابه --list-devices، اما تنها دستگاه‌هایی را نشان می‌دهد که نام خروجی فعلی آن‌ها با مطابقت دارد. --log-status ثبت وضعیت برد در لاگ‌های هسته [VIDIOC_LOG_STATUS]. --get-priority پرس‌وجوی اولویت دسترسی فعلی [VIDIOC_G_PRIORITY]. --set-priority تنظیم اولویت دسترسی جدید [VIDIOC_S_PRIORITY]. مقدار برابر است با 1 (پس‌زمینه)، 2 (تعاملی) یا 3 (ضبط). --silent تنها تنظیم کد نتیجه، بدون چاپ هیچ پیامی. --sleep توقف به مدت ثانیه، فراخوانی 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 استفاده از '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 ارسال شوند. v4l-utils 1.32.0 March 2015 V4L2-CTL(1)