1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 254f38fcaSMauro Carvalho Chehab.. include:: <isonum.txt> 3059b1c5bSMauro Carvalho Chehab 454f38fcaSMauro Carvalho Chehab.. _v4l2spec: 554f38fcaSMauro Carvalho Chehab 654f38fcaSMauro Carvalho Chehab############################ 754f38fcaSMauro Carvalho ChehabPart I - Video for Linux API 854f38fcaSMauro Carvalho Chehab############################ 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho ChehabThis part describes the Video for Linux API version 2 (V4L2 API) specification. 1154f38fcaSMauro Carvalho Chehab 1254f38fcaSMauro Carvalho Chehab**Revision 4.5** 1354f38fcaSMauro Carvalho Chehab 1454f38fcaSMauro Carvalho Chehab.. toctree:: 15*58af6646SVegard Nossum :caption: Table of Contents 1654f38fcaSMauro Carvalho Chehab :numbered: 1754f38fcaSMauro Carvalho Chehab :maxdepth: 5 1854f38fcaSMauro Carvalho Chehab 1954f38fcaSMauro Carvalho Chehab common 2054f38fcaSMauro Carvalho Chehab pixfmt 2154f38fcaSMauro Carvalho Chehab io 2254f38fcaSMauro Carvalho Chehab devices 2354f38fcaSMauro Carvalho Chehab libv4l 2454f38fcaSMauro Carvalho Chehab compat 2554f38fcaSMauro Carvalho Chehab user-func 2654f38fcaSMauro Carvalho Chehab common-defs 2754f38fcaSMauro Carvalho Chehab videodev 2854f38fcaSMauro Carvalho Chehab capture-example 2954f38fcaSMauro Carvalho Chehab v4l2grab-example 3054f38fcaSMauro Carvalho Chehab biblio 3154f38fcaSMauro Carvalho Chehab 3254f38fcaSMauro Carvalho Chehab 3354f38fcaSMauro Carvalho Chehab********************** 3454f38fcaSMauro Carvalho ChehabRevision and Copyright 3554f38fcaSMauro Carvalho Chehab********************** 3654f38fcaSMauro Carvalho Chehab 3754f38fcaSMauro Carvalho ChehabAuthors, in alphabetical order: 3854f38fcaSMauro Carvalho Chehab 3954f38fcaSMauro Carvalho Chehab- Ailus, Sakari <sakari.ailus@iki.fi> 4054f38fcaSMauro Carvalho Chehab 4154f38fcaSMauro Carvalho Chehab - Subdev selections API. 4254f38fcaSMauro Carvalho Chehab 4354f38fcaSMauro Carvalho Chehab- Carvalho Chehab, Mauro <mchehab+samsung@kernel.org> 4454f38fcaSMauro Carvalho Chehab 4554f38fcaSMauro Carvalho Chehab - Documented libv4l, designed and added v4l2grab example, Remote Controller chapter. 4654f38fcaSMauro Carvalho Chehab 4754f38fcaSMauro Carvalho Chehab- Dirks, Bill 4854f38fcaSMauro Carvalho Chehab 4954f38fcaSMauro Carvalho Chehab - Original author of the V4L2 API and documentation. 5054f38fcaSMauro Carvalho Chehab 5154f38fcaSMauro Carvalho Chehab- Figa, Tomasz <tfiga@chromium.org> 5254f38fcaSMauro Carvalho Chehab 5354f38fcaSMauro Carvalho Chehab - Documented the memory-to-memory decoder interface. 549ec656cfSTomasz Figa - Documented the memory-to-memory encoder interface. 5554f38fcaSMauro Carvalho Chehab 5654f38fcaSMauro Carvalho Chehab- H Schimek, Michael <mschimek@gmx.at> 5754f38fcaSMauro Carvalho Chehab 5854f38fcaSMauro Carvalho Chehab - Original author of the V4L2 API and documentation. 5954f38fcaSMauro Carvalho Chehab 6054f38fcaSMauro Carvalho Chehab- Karicheri, Muralidharan <m-karicheri2@ti.com> 6154f38fcaSMauro Carvalho Chehab 6254f38fcaSMauro Carvalho Chehab - Documented the Digital Video timings API. 6354f38fcaSMauro Carvalho Chehab 6454f38fcaSMauro Carvalho Chehab- Osciak, Pawel <posciak@chromium.org> 6554f38fcaSMauro Carvalho Chehab 6654f38fcaSMauro Carvalho Chehab - Documented the memory-to-memory decoder interface. 679ec656cfSTomasz Figa - Documented the memory-to-memory encoder interface. 6854f38fcaSMauro Carvalho Chehab 6954f38fcaSMauro Carvalho Chehab- Osciak, Pawel <pawel@osciak.com> 7054f38fcaSMauro Carvalho Chehab 7154f38fcaSMauro Carvalho Chehab - Designed and documented the multi-planar API. 7254f38fcaSMauro Carvalho Chehab 7354f38fcaSMauro Carvalho Chehab- Palosaari, Antti <crope@iki.fi> 7454f38fcaSMauro Carvalho Chehab 7554f38fcaSMauro Carvalho Chehab - SDR API. 7654f38fcaSMauro Carvalho Chehab 7754f38fcaSMauro Carvalho Chehab- Ribalda, Ricardo 7854f38fcaSMauro Carvalho Chehab 7954f38fcaSMauro Carvalho Chehab - Introduce HSV formats and other minor changes. 8054f38fcaSMauro Carvalho Chehab 8154f38fcaSMauro Carvalho Chehab- Rubli, Martin 8254f38fcaSMauro Carvalho Chehab 8354f38fcaSMauro Carvalho Chehab - Designed and documented the VIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS ioctls. 8454f38fcaSMauro Carvalho Chehab 8554f38fcaSMauro Carvalho Chehab- Walls, Andy <awalls@md.metrocast.net> 8654f38fcaSMauro Carvalho Chehab 8754f38fcaSMauro Carvalho Chehab - Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV MPEG stream embedded, sliced VBI data format in this specification. 8854f38fcaSMauro Carvalho Chehab 8954f38fcaSMauro Carvalho Chehab- Verkuil, Hans <hverkuil@xs4all.nl> 9054f38fcaSMauro Carvalho Chehab 9154f38fcaSMauro Carvalho Chehab - Designed and documented the VIDIOC_LOG_STATUS ioctl, the extended control ioctls, major parts of the sliced VBI API, the MPEG encoder and decoder APIs and the DV Timings API. 9254f38fcaSMauro Carvalho Chehab 9354f38fcaSMauro Carvalho Chehab**Copyright** |copy| 1999-2018: Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab, Pawel Osciak, Sakari Ailus & Antti Palosaari, Tomasz Figa 9454f38fcaSMauro Carvalho Chehab 9554f38fcaSMauro Carvalho ChehabExcept when explicitly stated as GPL, programming examples within this 9654f38fcaSMauro Carvalho Chehabpart can be used and distributed without restrictions. 9754f38fcaSMauro Carvalho Chehab 9854f38fcaSMauro Carvalho Chehab**************** 9954f38fcaSMauro Carvalho ChehabRevision History 10054f38fcaSMauro Carvalho Chehab**************** 10154f38fcaSMauro Carvalho Chehab 10254f38fcaSMauro Carvalho Chehab:revision: 4.10 / 2016-07-15 (*rr*) 10354f38fcaSMauro Carvalho Chehab 10454f38fcaSMauro Carvalho ChehabIntroduce HSV formats. 10554f38fcaSMauro Carvalho Chehab 10654f38fcaSMauro Carvalho Chehab 10754f38fcaSMauro Carvalho Chehab:revision: 4.5 / 2015-10-29 (*rr*) 10854f38fcaSMauro Carvalho Chehab 10954f38fcaSMauro Carvalho ChehabExtend VIDIOC_G_EXT_CTRLS;. Replace ctrl_class with a new union with 11054f38fcaSMauro Carvalho Chehabctrl_class and which. Which is used to select the current value of the 11154f38fcaSMauro Carvalho Chehabcontrol or the default value. 11254f38fcaSMauro Carvalho Chehab 11354f38fcaSMauro Carvalho Chehab 11454f38fcaSMauro Carvalho Chehab:revision: 4.4 / 2015-05-26 (*ap*) 11554f38fcaSMauro Carvalho Chehab 11654f38fcaSMauro Carvalho ChehabRenamed V4L2_TUNER_ADC to V4L2_TUNER_SDR. Added 11754f38fcaSMauro Carvalho ChehabV4L2_CID_RF_TUNER_RF_GAIN control. Added transmitter support for 11854f38fcaSMauro Carvalho ChehabSoftware Defined Radio (SDR) Interface. 11954f38fcaSMauro Carvalho Chehab 12054f38fcaSMauro Carvalho Chehab 12154f38fcaSMauro Carvalho Chehab:revision: 4.1 / 2015-02-13 (*mcc*) 12254f38fcaSMauro Carvalho Chehab 12354f38fcaSMauro Carvalho ChehabFix documentation for media controller device nodes and add support for 12454f38fcaSMauro Carvalho ChehabDVB device nodes. Add support for Tuner sub-device. 12554f38fcaSMauro Carvalho Chehab 12654f38fcaSMauro Carvalho Chehab 12754f38fcaSMauro Carvalho Chehab:revision: 3.19 / 2014-12-05 (*hv*) 12854f38fcaSMauro Carvalho Chehab 12954f38fcaSMauro Carvalho ChehabRewrote Colorspace chapter, added new enum 13054f38fcaSMauro Carvalho Chehab:c:type:`v4l2_ycbcr_encoding` and enum 13154f38fcaSMauro Carvalho Chehab:c:type:`v4l2_quantization` fields to struct 13254f38fcaSMauro Carvalho Chehab:c:type:`v4l2_pix_format`, struct 13354f38fcaSMauro Carvalho Chehab:c:type:`v4l2_pix_format_mplane` and struct 13454f38fcaSMauro Carvalho Chehab:c:type:`v4l2_mbus_framefmt`. 13554f38fcaSMauro Carvalho Chehab 13654f38fcaSMauro Carvalho Chehab 13754f38fcaSMauro Carvalho Chehab:revision: 3.17 / 2014-08-04 (*lp, hv*) 13854f38fcaSMauro Carvalho Chehab 13954f38fcaSMauro Carvalho ChehabExtended struct :c:type:`v4l2_pix_format`. Added 14054f38fcaSMauro Carvalho Chehabformat flags. Added compound control types and VIDIOC_QUERY_EXT_CTRL. 14154f38fcaSMauro Carvalho Chehab 14254f38fcaSMauro Carvalho Chehab 14354f38fcaSMauro Carvalho Chehab:revision: 3.15 / 2014-02-03 (*hv, ap*) 14454f38fcaSMauro Carvalho Chehab 14554f38fcaSMauro Carvalho ChehabUpdate several sections of "Common API Elements": "Opening and Closing 14654f38fcaSMauro Carvalho ChehabDevices" "Querying Capabilities", "Application Priority", "Video Inputs 14754f38fcaSMauro Carvalho Chehaband Outputs", "Audio Inputs and Outputs" "Tuners and Modulators", "Video 14854f38fcaSMauro Carvalho ChehabStandards" and "Digital Video (DV) Timings". Added SDR API. 14954f38fcaSMauro Carvalho Chehab 15054f38fcaSMauro Carvalho Chehab 15154f38fcaSMauro Carvalho Chehab:revision: 3.14 / 2013-11-25 (*rr*) 15254f38fcaSMauro Carvalho Chehab 15354f38fcaSMauro Carvalho ChehabSet width and height as unsigned on v4l2_rect. 15454f38fcaSMauro Carvalho Chehab 15554f38fcaSMauro Carvalho Chehab 15654f38fcaSMauro Carvalho Chehab:revision: 3.11 / 2013-05-26 (*hv*) 15754f38fcaSMauro Carvalho Chehab 15854f38fcaSMauro Carvalho ChehabRemove obsolete VIDIOC_DBG_G_CHIP_IDENT ioctl. 15954f38fcaSMauro Carvalho Chehab 16054f38fcaSMauro Carvalho Chehab 16154f38fcaSMauro Carvalho Chehab:revision: 3.10 / 2013-03-25 (*hv*) 16254f38fcaSMauro Carvalho Chehab 16354f38fcaSMauro Carvalho ChehabRemove obsolete and unused DV_PRESET ioctls: VIDIOC_G_DV_PRESET, 16454f38fcaSMauro Carvalho ChehabVIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and 16554f38fcaSMauro Carvalho ChehabVIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output 16654f38fcaSMauro Carvalho Chehabcapability flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS. 16754f38fcaSMauro Carvalho ChehabAdded VIDIOC_DBG_G_CHIP_INFO. 16854f38fcaSMauro Carvalho Chehab 16954f38fcaSMauro Carvalho Chehab 17054f38fcaSMauro Carvalho Chehab:revision: 3.9 / 2012-12-03 (*sa, sn*) 17154f38fcaSMauro Carvalho Chehab 17254f38fcaSMauro Carvalho ChehabAdded timestamp types to v4l2_buffer. Added 17354f38fcaSMauro Carvalho ChehabV4L2_EVENT_CTRL_CH_RANGE control event changes flag. 17454f38fcaSMauro Carvalho Chehab 17554f38fcaSMauro Carvalho Chehab 17654f38fcaSMauro Carvalho Chehab:revision: 3.6 / 2012-07-02 (*hv*) 17754f38fcaSMauro Carvalho Chehab 17854f38fcaSMauro Carvalho ChehabAdded VIDIOC_ENUM_FREQ_BANDS. 17954f38fcaSMauro Carvalho Chehab 18054f38fcaSMauro Carvalho Chehab 18154f38fcaSMauro Carvalho Chehab:revision: 3.5 / 2012-05-07 (*sa, sn, hv*) 18254f38fcaSMauro Carvalho Chehab 18354f38fcaSMauro Carvalho ChehabAdded V4L2_CTRL_TYPE_INTEGER_MENU and V4L2 subdev selections API. 18454f38fcaSMauro Carvalho ChehabImproved the description of V4L2_CID_COLORFX control, added 18554f38fcaSMauro Carvalho ChehabV4L2_CID_COLORFX_CBCR control. Added camera controls 18654f38fcaSMauro Carvalho ChehabV4L2_CID_AUTO_EXPOSURE_BIAS, 18754f38fcaSMauro Carvalho ChehabV4L2_CID_AUTO_N_PRESET_WHITE_BALANCE, 18854f38fcaSMauro Carvalho ChehabV4L2_CID_IMAGE_STABILIZATION, V4L2_CID_ISO_SENSITIVITY, 18954f38fcaSMauro Carvalho ChehabV4L2_CID_ISO_SENSITIVITY_AUTO, V4L2_CID_EXPOSURE_METERING, 19054f38fcaSMauro Carvalho ChehabV4L2_CID_SCENE_MODE, V4L2_CID_3A_LOCK, 19154f38fcaSMauro Carvalho ChehabV4L2_CID_AUTO_FOCUS_START, V4L2_CID_AUTO_FOCUS_STOP, 19254f38fcaSMauro Carvalho ChehabV4L2_CID_AUTO_FOCUS_STATUS and V4L2_CID_AUTO_FOCUS_RANGE. Added 19354f38fcaSMauro Carvalho ChehabVIDIOC_ENUM_DV_TIMINGS, VIDIOC_QUERY_DV_TIMINGS and 19454f38fcaSMauro Carvalho ChehabVIDIOC_DV_TIMINGS_CAP. 19554f38fcaSMauro Carvalho Chehab 19654f38fcaSMauro Carvalho Chehab 19754f38fcaSMauro Carvalho Chehab:revision: 3.4 / 2012-01-25 (*sn*) 19854f38fcaSMauro Carvalho Chehab 19954f38fcaSMauro Carvalho ChehabAdded :ref:`JPEG compression control class. <jpeg-controls>` 20054f38fcaSMauro Carvalho Chehab 20154f38fcaSMauro Carvalho Chehab 20254f38fcaSMauro Carvalho Chehab:revision: 3.3 / 2012-01-11 (*hv*) 20354f38fcaSMauro Carvalho Chehab 20454f38fcaSMauro Carvalho ChehabAdded device_caps field to struct v4l2_capabilities. 20554f38fcaSMauro Carvalho Chehab 20654f38fcaSMauro Carvalho Chehab 20754f38fcaSMauro Carvalho Chehab:revision: 3.2 / 2011-08-26 (*hv*) 20854f38fcaSMauro Carvalho Chehab 20954f38fcaSMauro Carvalho ChehabAdded V4L2_CTRL_FLAG_VOLATILE. 21054f38fcaSMauro Carvalho Chehab 21154f38fcaSMauro Carvalho Chehab 21254f38fcaSMauro Carvalho Chehab:revision: 3.1 / 2011-06-27 (*mcc, po, hv*) 21354f38fcaSMauro Carvalho Chehab 21454f38fcaSMauro Carvalho ChehabDocumented that VIDIOC_QUERYCAP now returns a per-subsystem version 21554f38fcaSMauro Carvalho Chehabinstead of a per-driver one. Standardize an error code for invalid 21654f38fcaSMauro Carvalho Chehabioctl. Added V4L2_CTRL_TYPE_BITMASK. 21754f38fcaSMauro Carvalho Chehab 21854f38fcaSMauro Carvalho Chehab 21954f38fcaSMauro Carvalho Chehab:revision: 2.6.39 / 2011-03-01 (*mcc, po*) 22054f38fcaSMauro Carvalho Chehab 22154f38fcaSMauro Carvalho ChehabRemoved VIDIOC_*_OLD from videodev2.h header and update it to reflect 22254f38fcaSMauro Carvalho Chehablatest changes. Added the :ref:`multi-planar API <planar-apis>`. 22354f38fcaSMauro Carvalho Chehab 22454f38fcaSMauro Carvalho Chehab 22554f38fcaSMauro Carvalho Chehab:revision: 2.6.37 / 2010-08-06 (*hv*) 22654f38fcaSMauro Carvalho Chehab 22754f38fcaSMauro Carvalho ChehabRemoved obsolete vtx (videotext) API. 22854f38fcaSMauro Carvalho Chehab 22954f38fcaSMauro Carvalho Chehab 23054f38fcaSMauro Carvalho Chehab:revision: 2.6.33 / 2009-12-03 (*mk*) 23154f38fcaSMauro Carvalho Chehab 23254f38fcaSMauro Carvalho ChehabAdded documentation for the Digital Video timings API. 23354f38fcaSMauro Carvalho Chehab 23454f38fcaSMauro Carvalho Chehab 23554f38fcaSMauro Carvalho Chehab:revision: 2.6.32 / 2009-08-31 (*mcc*) 23654f38fcaSMauro Carvalho Chehab 23754f38fcaSMauro Carvalho ChehabNow, revisions will match the kernel version where the V4L2 API changes 23854f38fcaSMauro Carvalho Chehabwill be used by the Linux Kernel. Also added Remote Controller chapter. 23954f38fcaSMauro Carvalho Chehab 24054f38fcaSMauro Carvalho Chehab 24154f38fcaSMauro Carvalho Chehab:revision: 0.29 / 2009-08-26 (*ev*) 24254f38fcaSMauro Carvalho Chehab 24354f38fcaSMauro Carvalho ChehabAdded documentation for string controls and for FM Transmitter controls. 24454f38fcaSMauro Carvalho Chehab 24554f38fcaSMauro Carvalho Chehab 24654f38fcaSMauro Carvalho Chehab:revision: 0.28 / 2009-08-26 (*gl*) 24754f38fcaSMauro Carvalho Chehab 24854f38fcaSMauro Carvalho ChehabAdded V4L2_CID_BAND_STOP_FILTER documentation. 24954f38fcaSMauro Carvalho Chehab 25054f38fcaSMauro Carvalho Chehab 25154f38fcaSMauro Carvalho Chehab:revision: 0.27 / 2009-08-15 (*mcc*) 25254f38fcaSMauro Carvalho Chehab 25354f38fcaSMauro Carvalho ChehabAdded libv4l and Remote Controller documentation; added v4l2grab and 25454f38fcaSMauro Carvalho Chehabkeytable application examples. 25554f38fcaSMauro Carvalho Chehab 25654f38fcaSMauro Carvalho Chehab 25754f38fcaSMauro Carvalho Chehab:revision: 0.26 / 2009-07-23 (*hv*) 25854f38fcaSMauro Carvalho Chehab 25954f38fcaSMauro Carvalho ChehabFinalized the RDS capture API. Added modulator and RDS encoder 26054f38fcaSMauro Carvalho Chehabcapabilities. Added support for string controls. 26154f38fcaSMauro Carvalho Chehab 26254f38fcaSMauro Carvalho Chehab 26354f38fcaSMauro Carvalho Chehab:revision: 0.25 / 2009-01-18 (*hv*) 26454f38fcaSMauro Carvalho Chehab 26554f38fcaSMauro Carvalho ChehabAdded pixel formats VYUY, NV16 and NV61, and changed the debug ioctls 26654f38fcaSMauro Carvalho ChehabVIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT. Added camera 26754f38fcaSMauro Carvalho Chehabcontrols V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE, 26854f38fcaSMauro Carvalho ChehabV4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY. 26954f38fcaSMauro Carvalho Chehab 27054f38fcaSMauro Carvalho Chehab 27154f38fcaSMauro Carvalho Chehab:revision: 0.24 / 2008-03-04 (*mhs*) 27254f38fcaSMauro Carvalho Chehab 27354f38fcaSMauro Carvalho ChehabAdded pixel formats Y16 and SBGGR16, new controls and a camera controls 27454f38fcaSMauro Carvalho Chehabclass. Removed VIDIOC_G/S_MPEGCOMP. 27554f38fcaSMauro Carvalho Chehab 27654f38fcaSMauro Carvalho Chehab 27754f38fcaSMauro Carvalho Chehab:revision: 0.23 / 2007-08-30 (*mhs*) 27854f38fcaSMauro Carvalho Chehab 27954f38fcaSMauro Carvalho ChehabFixed a typo in VIDIOC_DBG_G/S_REGISTER. Clarified the byte order of 28054f38fcaSMauro Carvalho Chehabpacked pixel formats. 28154f38fcaSMauro Carvalho Chehab 28254f38fcaSMauro Carvalho Chehab 28354f38fcaSMauro Carvalho Chehab:revision: 0.22 / 2007-08-29 (*mhs*) 28454f38fcaSMauro Carvalho Chehab 28554f38fcaSMauro Carvalho ChehabAdded the Video Output Overlay interface, new MPEG controls, 28654f38fcaSMauro Carvalho ChehabV4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT, 28754f38fcaSMauro Carvalho ChehabVIDIOC_DBG_G/S_REGISTER, VIDIOC\_(TRY\_)ENCODER_CMD, 28854f38fcaSMauro Carvalho ChehabVIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats. 28954f38fcaSMauro Carvalho ChehabClarifications in the cropping chapter, about RGB pixel formats, the 29054f38fcaSMauro Carvalho Chehabmmap(), poll(), select(), read() and write() functions. Typographical 29154f38fcaSMauro Carvalho Chehabfixes. 29254f38fcaSMauro Carvalho Chehab 29354f38fcaSMauro Carvalho Chehab 29454f38fcaSMauro Carvalho Chehab:revision: 0.21 / 2006-12-19 (*mhs*) 29554f38fcaSMauro Carvalho Chehab 29654f38fcaSMauro Carvalho ChehabFixed a link in the VIDIOC_G_EXT_CTRLS section. 29754f38fcaSMauro Carvalho Chehab 29854f38fcaSMauro Carvalho Chehab 29954f38fcaSMauro Carvalho Chehab:revision: 0.20 / 2006-11-24 (*mhs*) 30054f38fcaSMauro Carvalho Chehab 30154f38fcaSMauro Carvalho ChehabClarified the purpose of the audioset field in struct v4l2_input and 30254f38fcaSMauro Carvalho Chehabv4l2_output. 30354f38fcaSMauro Carvalho Chehab 30454f38fcaSMauro Carvalho Chehab 30554f38fcaSMauro Carvalho Chehab:revision: 0.19 / 2006-10-19 (*mhs*) 30654f38fcaSMauro Carvalho Chehab 30754f38fcaSMauro Carvalho ChehabDocumented V4L2_PIX_FMT_RGB444. 30854f38fcaSMauro Carvalho Chehab 30954f38fcaSMauro Carvalho Chehab 31054f38fcaSMauro Carvalho Chehab:revision: 0.18 / 2006-10-18 (*mhs*) 31154f38fcaSMauro Carvalho Chehab 31254f38fcaSMauro Carvalho ChehabAdded the description of extended controls by Hans Verkuil. Linked 31354f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE. 31454f38fcaSMauro Carvalho Chehab 31554f38fcaSMauro Carvalho Chehab 31654f38fcaSMauro Carvalho Chehab:revision: 0.17 / 2006-10-12 (*mhs*) 31754f38fcaSMauro Carvalho Chehab 31854f38fcaSMauro Carvalho ChehabCorrected V4L2_PIX_FMT_HM12 description. 31954f38fcaSMauro Carvalho Chehab 32054f38fcaSMauro Carvalho Chehab 32154f38fcaSMauro Carvalho Chehab:revision: 0.16 / 2006-10-08 (*mhs*) 32254f38fcaSMauro Carvalho Chehab 32354f38fcaSMauro Carvalho ChehabVIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS are now part 32454f38fcaSMauro Carvalho Chehabof the API. 32554f38fcaSMauro Carvalho Chehab 32654f38fcaSMauro Carvalho Chehab 32754f38fcaSMauro Carvalho Chehab:revision: 0.15 / 2006-09-23 (*mhs*) 32854f38fcaSMauro Carvalho Chehab 32954f38fcaSMauro Carvalho ChehabCleaned up the bibliography, added BT.653 and BT.1119. 33054f38fcaSMauro Carvalho Chehabcapture.c/start_capturing() for user pointer I/O did not initialize the 33154f38fcaSMauro Carvalho Chehabbuffer index. Documented the V4L MPEG and MJPEG VID_TYPEs and 33254f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel formats. See 33354f38fcaSMauro Carvalho Chehabthe history chapter for API changes. 33454f38fcaSMauro Carvalho Chehab 33554f38fcaSMauro Carvalho Chehab 33654f38fcaSMauro Carvalho Chehab:revision: 0.14 / 2006-09-14 (*mr*) 33754f38fcaSMauro Carvalho Chehab 33854f38fcaSMauro Carvalho ChehabAdded VIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS proposal 33954f38fcaSMauro Carvalho Chehabfor frame format enumeration of digital devices. 34054f38fcaSMauro Carvalho Chehab 34154f38fcaSMauro Carvalho Chehab 34254f38fcaSMauro Carvalho Chehab:revision: 0.13 / 2006-04-07 (*mhs*) 34354f38fcaSMauro Carvalho Chehab 34454f38fcaSMauro Carvalho ChehabCorrected the description of struct v4l2_window clips. New V4L2_STD\_ 34554f38fcaSMauro Carvalho Chehaband V4L2_TUNER_MODE_LANG1_LANG2 defines. 34654f38fcaSMauro Carvalho Chehab 34754f38fcaSMauro Carvalho Chehab 34854f38fcaSMauro Carvalho Chehab:revision: 0.12 / 2006-02-03 (*mhs*) 34954f38fcaSMauro Carvalho Chehab 35054f38fcaSMauro Carvalho ChehabCorrected the description of struct v4l2_captureparm and 35154f38fcaSMauro Carvalho Chehabv4l2_outputparm. 35254f38fcaSMauro Carvalho Chehab 35354f38fcaSMauro Carvalho Chehab 35454f38fcaSMauro Carvalho Chehab:revision: 0.11 / 2006-01-27 (*mhs*) 35554f38fcaSMauro Carvalho Chehab 35654f38fcaSMauro Carvalho ChehabImproved the description of struct v4l2_tuner. 35754f38fcaSMauro Carvalho Chehab 35854f38fcaSMauro Carvalho Chehab 35954f38fcaSMauro Carvalho Chehab:revision: 0.10 / 2006-01-10 (*mhs*) 36054f38fcaSMauro Carvalho Chehab 36154f38fcaSMauro Carvalho ChehabVIDIOC_G_INPUT and VIDIOC_S_PARM clarifications. 36254f38fcaSMauro Carvalho Chehab 36354f38fcaSMauro Carvalho Chehab 36454f38fcaSMauro Carvalho Chehab:revision: 0.9 / 2005-11-27 (*mhs*) 36554f38fcaSMauro Carvalho Chehab 36654f38fcaSMauro Carvalho ChehabImproved the 525 line numbering diagram. Hans Verkuil and I rewrote the 36754f38fcaSMauro Carvalho Chehabsliced VBI section. He also contributed a VIDIOC_LOG_STATUS page. 36854f38fcaSMauro Carvalho ChehabFixed VIDIOC_S_STD call in the video standard selection example. 36954f38fcaSMauro Carvalho ChehabVarious updates. 37054f38fcaSMauro Carvalho Chehab 37154f38fcaSMauro Carvalho Chehab 37254f38fcaSMauro Carvalho Chehab:revision: 0.8 / 2004-10-04 (*mhs*) 37354f38fcaSMauro Carvalho Chehab 37454f38fcaSMauro Carvalho ChehabSomehow a piece of junk slipped into the capture example, removed. 37554f38fcaSMauro Carvalho Chehab 37654f38fcaSMauro Carvalho Chehab 37754f38fcaSMauro Carvalho Chehab:revision: 0.7 / 2004-09-19 (*mhs*) 37854f38fcaSMauro Carvalho Chehab 37954f38fcaSMauro Carvalho ChehabFixed video standard selection, control enumeration, downscaling and 38054f38fcaSMauro Carvalho Chehabaspect example. Added read and user pointer i/o to video capture 38154f38fcaSMauro Carvalho Chehabexample. 38254f38fcaSMauro Carvalho Chehab 38354f38fcaSMauro Carvalho Chehab 38454f38fcaSMauro Carvalho Chehab:revision: 0.6 / 2004-08-01 (*mhs*) 38554f38fcaSMauro Carvalho Chehab 38654f38fcaSMauro Carvalho Chehabv4l2_buffer changes, added video capture example, various corrections. 38754f38fcaSMauro Carvalho Chehab 38854f38fcaSMauro Carvalho Chehab 38954f38fcaSMauro Carvalho Chehab:revision: 0.5 / 2003-11-05 (*mhs*) 39054f38fcaSMauro Carvalho Chehab 39154f38fcaSMauro Carvalho ChehabPixel format erratum. 39254f38fcaSMauro Carvalho Chehab 39354f38fcaSMauro Carvalho Chehab 39454f38fcaSMauro Carvalho Chehab:revision: 0.4 / 2003-09-17 (*mhs*) 39554f38fcaSMauro Carvalho Chehab 39654f38fcaSMauro Carvalho ChehabCorrected source and Makefile to generate a PDF. SGML fixes. Added 39754f38fcaSMauro Carvalho Chehablatest API changes. Closed gaps in the history chapter. 39854f38fcaSMauro Carvalho Chehab 39954f38fcaSMauro Carvalho Chehab 40054f38fcaSMauro Carvalho Chehab:revision: 0.3 / 2003-02-05 (*mhs*) 40154f38fcaSMauro Carvalho Chehab 40254f38fcaSMauro Carvalho ChehabAnother draft, more corrections. 40354f38fcaSMauro Carvalho Chehab 40454f38fcaSMauro Carvalho Chehab 40554f38fcaSMauro Carvalho Chehab:revision: 0.2 / 2003-01-15 (*mhs*) 40654f38fcaSMauro Carvalho Chehab 40754f38fcaSMauro Carvalho ChehabSecond draft, with corrections pointed out by Gerd Knorr. 40854f38fcaSMauro Carvalho Chehab 40954f38fcaSMauro Carvalho Chehab 41054f38fcaSMauro Carvalho Chehab:revision: 0.1 / 2002-12-01 (*mhs*) 41154f38fcaSMauro Carvalho Chehab 41254f38fcaSMauro Carvalho ChehabFirst draft, based on documentation by Bill Dirks and discussions on the 41354f38fcaSMauro Carvalho ChehabV4L mailing list. 414