Eric Lee / smarc-fsl-linux-kernel

Commit 35c3017a29d278c4405a7f3ab30b814999d156d3

Authored by Laurent Pinchart 15 years ago

Committed by Mauro Carvalho Chehab 14 years ago

Exists in master and in 39 other branches

[media] v4l: v4l2_subdev userspace frame interval API

The three new ioctl VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL,
VIDIOC_SUBDEV_G_FRAME_INTERVAL and VIDIOC_SUBDEV_S_FRAME_INTERVAL can be
used to enumerate and configure a subdev's frame rate from userspace.

Two new video::g/s_frame_interval subdev operations are introduced to
support those ioctls. The existing video::g/s_parm operations are
deprecated and shouldn't be used anymore.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Sakari Ailus <sakari.ailus@iki.fi>
Acked-by: Hans Verkuil <hverkuil@xs4all.nl>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

Showing 7 changed files with 360 additions and 0 deletions Inline Diff

Documentation/DocBook/media-entities.tmpl
Documentation/DocBook/v4l/v4l2.xml
Documentation/DocBook/v4l/vidioc-subdev-enum-frame-interval.xml
Documentation/DocBook/v4l/vidioc-subdev-g-frame-interval.xml
drivers/media/video/v4l2-subdev.c
include/linux/v4l2-subdev.h
include/media/v4l2-subdev.h

Documentation/DocBook/media-entities.tmpl

Diff comments View file @ 35c3017

 <!-- Generated file! Do not edit. -->
 <!-- Functions -->
 <!ENTITY func-close "<link linkend='func-close'><function>close()</function></link>">
 <!ENTITY func-ioctl "<link linkend='func-ioctl'><function>ioctl()</function></link>">
 <!ENTITY func-mmap "<link linkend='func-mmap'><function>mmap()</function></link>">
 <!ENTITY func-munmap "<link linkend='func-munmap'><function>munmap()</function></link>">
 <!ENTITY func-open "<link linkend='func-open'><function>open()</function></link>">
 <!ENTITY func-poll "<link linkend='func-poll'><function>poll()</function></link>">
 <!ENTITY func-read "<link linkend='func-read'><function>read()</function></link>">
 <!ENTITY func-select "<link linkend='func-select'><function>select()</function></link>">
 <!ENTITY func-write "<link linkend='func-write'><function>write()</function></link>">
 <!ENTITY media-func-close "<link linkend='media-func-close'><function>close()</function></link>">
 <!ENTITY media-func-ioctl "<link linkend='media-func-ioctl'><function>ioctl()</function></link>">
 <!ENTITY media-func-open "<link linkend='media-func-open'><function>open()</function></link>">
 <!-- Ioctls -->
 <!ENTITY VIDIOC-CROPCAP "<link linkend='vidioc-cropcap'><constant>VIDIOC_CROPCAP</constant></link>">
 <!ENTITY VIDIOC-DBG-G-CHIP-IDENT "<link linkend='vidioc-dbg-g-chip-ident'><constant>VIDIOC_DBG_G_CHIP_IDENT</constant></link>">
 <!ENTITY VIDIOC-DBG-G-REGISTER "<link linkend='vidioc-dbg-g-register'><constant>VIDIOC_DBG_G_REGISTER</constant></link>">
 <!ENTITY VIDIOC-DBG-S-REGISTER "<link linkend='vidioc-dbg-g-register'><constant>VIDIOC_DBG_S_REGISTER</constant></link>">
 <!ENTITY VIDIOC-DQBUF "<link linkend='vidioc-qbuf'><constant>VIDIOC_DQBUF</constant></link>">
 <!ENTITY VIDIOC-DQEVENT "<link linkend='vidioc-dqevent'><constant>VIDIOC_DQEVENT</constant></link>">
 <!ENTITY VIDIOC-ENCODER-CMD "<link linkend='vidioc-encoder-cmd'><constant>VIDIOC_ENCODER_CMD</constant></link>">
 <!ENTITY VIDIOC-ENUMAUDIO "<link linkend='vidioc-enumaudio'><constant>VIDIOC_ENUMAUDIO</constant></link>">
 <!ENTITY VIDIOC-ENUMAUDOUT "<link linkend='vidioc-enumaudioout'><constant>VIDIOC_ENUMAUDOUT</constant></link>">
 <!ENTITY VIDIOC-ENUMINPUT "<link linkend='vidioc-enuminput'><constant>VIDIOC_ENUMINPUT</constant></link>">
 <!ENTITY VIDIOC-ENUMOUTPUT "<link linkend='vidioc-enumoutput'><constant>VIDIOC_ENUMOUTPUT</constant></link>">
 <!ENTITY VIDIOC-ENUMSTD "<link linkend='vidioc-enumstd'><constant>VIDIOC_ENUMSTD</constant></link>">
 <!ENTITY VIDIOC-ENUM-DV-PRESETS "<link linkend='vidioc-enum-dv-presets'><constant>VIDIOC_ENUM_DV_PRESETS</constant></link>">
 <!ENTITY VIDIOC-ENUM-FMT "<link linkend='vidioc-enum-fmt'><constant>VIDIOC_ENUM_FMT</constant></link>">
 <!ENTITY VIDIOC-ENUM-FRAMEINTERVALS "<link linkend='vidioc-enum-frameintervals'><constant>VIDIOC_ENUM_FRAMEINTERVALS</constant></link>">
 <!ENTITY VIDIOC-ENUM-FRAMESIZES "<link linkend='vidioc-enum-framesizes'><constant>VIDIOC_ENUM_FRAMESIZES</constant></link>">
 <!ENTITY VIDIOC-G-AUDIO "<link linkend='vidioc-g-audio'><constant>VIDIOC_G_AUDIO</constant></link>">
 <!ENTITY VIDIOC-G-AUDOUT "<link linkend='vidioc-g-audioout'><constant>VIDIOC_G_AUDOUT</constant></link>">
 <!ENTITY VIDIOC-G-CROP "<link linkend='vidioc-g-crop'><constant>VIDIOC_G_CROP</constant></link>">
 <!ENTITY VIDIOC-G-CTRL "<link linkend='vidioc-g-ctrl'><constant>VIDIOC_G_CTRL</constant></link>">
 <!ENTITY VIDIOC-G-DV-PRESET "<link linkend='vidioc-g-dv-preset'><constant>VIDIOC_G_DV_PRESET</constant></link>">
 <!ENTITY VIDIOC-G-DV-TIMINGS "<link linkend='vidioc-g-dv-timings'><constant>VIDIOC_G_DV_TIMINGS</constant></link>">
 <!ENTITY VIDIOC-G-ENC-INDEX "<link linkend='vidioc-g-enc-index'><constant>VIDIOC_G_ENC_INDEX</constant></link>">
 <!ENTITY VIDIOC-G-EXT-CTRLS "<link linkend='vidioc-g-ext-ctrls'><constant>VIDIOC_G_EXT_CTRLS</constant></link>">
 <!ENTITY VIDIOC-G-FBUF "<link linkend='vidioc-g-fbuf'><constant>VIDIOC_G_FBUF</constant></link>">
 <!ENTITY VIDIOC-G-FMT "<link linkend='vidioc-g-fmt'><constant>VIDIOC_G_FMT</constant></link>">
 <!ENTITY VIDIOC-G-FREQUENCY "<link linkend='vidioc-g-frequency'><constant>VIDIOC_G_FREQUENCY</constant></link>">
 <!ENTITY VIDIOC-G-INPUT "<link linkend='vidioc-g-input'><constant>VIDIOC_G_INPUT</constant></link>">
 <!ENTITY VIDIOC-G-JPEGCOMP "<link linkend='vidioc-g-jpegcomp'><constant>VIDIOC_G_JPEGCOMP</constant></link>">
 <!ENTITY VIDIOC-G-MPEGCOMP "<link linkend=''><constant>VIDIOC_G_MPEGCOMP</constant></link>">
 <!ENTITY VIDIOC-G-MODULATOR "<link linkend='vidioc-g-modulator'><constant>VIDIOC_G_MODULATOR</constant></link>">
 <!ENTITY VIDIOC-G-OUTPUT "<link linkend='vidioc-g-output'><constant>VIDIOC_G_OUTPUT</constant></link>">
 <!ENTITY VIDIOC-G-PARM "<link linkend='vidioc-g-parm'><constant>VIDIOC_G_PARM</constant></link>">
 <!ENTITY VIDIOC-G-PRIORITY "<link linkend='vidioc-g-priority'><constant>VIDIOC_G_PRIORITY</constant></link>">
 <!ENTITY VIDIOC-G-SLICED-VBI-CAP "<link linkend='vidioc-g-sliced-vbi-cap'><constant>VIDIOC_G_SLICED_VBI_CAP</constant></link>">
 <!ENTITY VIDIOC-G-STD "<link linkend='vidioc-g-std'><constant>VIDIOC_G_STD</constant></link>">
 <!ENTITY VIDIOC-G-TUNER "<link linkend='vidioc-g-tuner'><constant>VIDIOC_G_TUNER</constant></link>">
 <!ENTITY VIDIOC-LOG-STATUS "<link linkend='vidioc-log-status'><constant>VIDIOC_LOG_STATUS</constant></link>">
 <!ENTITY VIDIOC-OVERLAY "<link linkend='vidioc-overlay'><constant>VIDIOC_OVERLAY</constant></link>">
 <!ENTITY VIDIOC-QBUF "<link linkend='vidioc-qbuf'><constant>VIDIOC_QBUF</constant></link>">
 <!ENTITY VIDIOC-QUERYBUF "<link linkend='vidioc-querybuf'><constant>VIDIOC_QUERYBUF</constant></link>">
 <!ENTITY VIDIOC-QUERYCAP "<link linkend='vidioc-querycap'><constant>VIDIOC_QUERYCAP</constant></link>">
 <!ENTITY VIDIOC-QUERYCTRL "<link linkend='vidioc-queryctrl'><constant>VIDIOC_QUERYCTRL</constant></link>">
 <!ENTITY VIDIOC-QUERYMENU "<link linkend='vidioc-queryctrl'><constant>VIDIOC_QUERYMENU</constant></link>">
 <!ENTITY VIDIOC-QUERYSTD "<link linkend='vidioc-querystd'><constant>VIDIOC_QUERYSTD</constant></link>">
 <!ENTITY VIDIOC-QUERY-DV-PRESET "<link linkend='vidioc-query-dv-preset'><constant>VIDIOC_QUERY_DV_PRESET</constant></link>">
 <!ENTITY VIDIOC-REQBUFS "<link linkend='vidioc-reqbufs'><constant>VIDIOC_REQBUFS</constant></link>">
 <!ENTITY VIDIOC-STREAMOFF "<link linkend='vidioc-streamon'><constant>VIDIOC_STREAMOFF</constant></link>">
 <!ENTITY VIDIOC-STREAMON "<link linkend='vidioc-streamon'><constant>VIDIOC_STREAMON</constant></link>">
 <!ENTITY VIDIOC-SUBSCRIBE-EVENT "<link linkend='vidioc-subscribe-event'><constant>VIDIOC_SUBSCRIBE_EVENT</constant></link>">
 <!ENTITY VIDIOC-S-AUDIO "<link linkend='vidioc-g-audio'><constant>VIDIOC_S_AUDIO</constant></link>">
 <!ENTITY VIDIOC-S-AUDOUT "<link linkend='vidioc-g-audioout'><constant>VIDIOC_S_AUDOUT</constant></link>">
 <!ENTITY VIDIOC-S-CROP "<link linkend='vidioc-g-crop'><constant>VIDIOC_S_CROP</constant></link>">
 <!ENTITY VIDIOC-S-CTRL "<link linkend='vidioc-g-ctrl'><constant>VIDIOC_S_CTRL</constant></link>">
 <!ENTITY VIDIOC-S-DV-PRESET "<link linkend='vidioc-g-dv-preset'><constant>VIDIOC_S_DV_PRESET</constant></link>">
 <!ENTITY VIDIOC-S-DV-TIMINGS "<link linkend='vidioc-g-dv-timings'><constant>VIDIOC_S_DV_TIMINGS</constant></link>">
 <!ENTITY VIDIOC-S-EXT-CTRLS "<link linkend='vidioc-g-ext-ctrls'><constant>VIDIOC_S_EXT_CTRLS</constant></link>">
 <!ENTITY VIDIOC-S-FBUF "<link linkend='vidioc-g-fbuf'><constant>VIDIOC_S_FBUF</constant></link>">
 <!ENTITY VIDIOC-S-FMT "<link linkend='vidioc-g-fmt'><constant>VIDIOC_S_FMT</constant></link>">
 <!ENTITY VIDIOC-S-FREQUENCY "<link linkend='vidioc-g-frequency'><constant>VIDIOC_S_FREQUENCY</constant></link>">
 <!ENTITY VIDIOC-S-HW-FREQ-SEEK "<link linkend='vidioc-s-hw-freq-seek'><constant>VIDIOC_S_HW_FREQ_SEEK</constant></link>">
 <!ENTITY VIDIOC-S-INPUT "<link linkend='vidioc-g-input'><constant>VIDIOC_S_INPUT</constant></link>">
 <!ENTITY VIDIOC-S-JPEGCOMP "<link linkend='vidioc-g-jpegcomp'><constant>VIDIOC_S_JPEGCOMP</constant></link>">
 <!ENTITY VIDIOC-S-MPEGCOMP "<link linkend=''><constant>VIDIOC_S_MPEGCOMP</constant></link>">
 <!ENTITY VIDIOC-S-MODULATOR "<link linkend='vidioc-g-modulator'><constant>VIDIOC_S_MODULATOR</constant></link>">
 <!ENTITY VIDIOC-S-OUTPUT "<link linkend='vidioc-g-output'><constant>VIDIOC_S_OUTPUT</constant></link>">
 <!ENTITY VIDIOC-S-PARM "<link linkend='vidioc-g-parm'><constant>VIDIOC_S_PARM</constant></link>">
 <!ENTITY VIDIOC-S-PRIORITY "<link linkend='vidioc-g-priority'><constant>VIDIOC_S_PRIORITY</constant></link>">
 <!ENTITY VIDIOC-S-STD "<link linkend='vidioc-g-std'><constant>VIDIOC_S_STD</constant></link>">
 <!ENTITY VIDIOC-S-TUNER "<link linkend='vidioc-g-tuner'><constant>VIDIOC_S_TUNER</constant></link>">
 <!ENTITY VIDIOC-SUBDEV-ENUM-FRAME-SIZE "<link linkend='vidioc-subdev-enum-frame-size'><constant>VIDIOC_SUBDEV_ENUM_FRAME_SIZE</constant></link>">
 <!ENTITY VIDIOC-SUBDEV-ENUM-MBUS-CODE "<link linkend='vidioc-subdev-enum-mbus-code'><constant>VIDIOC_SUBDEV_ENUM_MBUS_CODE</constant></link>">
 <!ENTITY VIDIOC-SUBDEV-G-FMT "<link linkend='vidioc-subdev-g-fmt'><constant>VIDIOC_SUBDEV_G_FMT</constant></link>">
+<!ENTITY VIDIOC-SUBDEV-G-FRAME-INTERVAL "<link linkend='vidioc-subdev-g-frame-interval'><constant>VIDIOC_SUBDEV_G_FRAME_INTERVAL</constant></link>">
 <!ENTITY VIDIOC-SUBDEV-S-FMT "<link linkend='vidioc-subdev-g-fmt'><constant>VIDIOC_SUBDEV_S_FMT</constant></link>">
+<!ENTITY VIDIOC-SUBDEV-S-FRAME-INTERVAL "<link linkend='vidioc-subdev-g-frame-interval'><constant>VIDIOC_SUBDEV_S_FRAME_INTERVAL</constant></link>">
 <!ENTITY VIDIOC-TRY-ENCODER-CMD "<link linkend='vidioc-encoder-cmd'><constant>VIDIOC_TRY_ENCODER_CMD</constant></link>">
 <!ENTITY VIDIOC-TRY-EXT-CTRLS "<link linkend='vidioc-g-ext-ctrls'><constant>VIDIOC_TRY_EXT_CTRLS</constant></link>">
 <!ENTITY VIDIOC-TRY-FMT "<link linkend='vidioc-g-fmt'><constant>VIDIOC_TRY_FMT</constant></link>">
 <!ENTITY VIDIOC-UNSUBSCRIBE-EVENT "<link linkend='vidioc-subscribe-event'><constant>VIDIOC_UNSUBSCRIBE_EVENT</constant></link>">
 <!ENTITY MEDIA-IOC-DEVICE-INFO "<link linkend='media-ioc-device-info'><constant>MEDIA_IOC_DEVICE_INFO</constant></link>">
 <!ENTITY MEDIA-IOC-ENUM-ENTITIES "<link linkend='media-ioc-enum-entities'><constant>MEDIA_IOC_ENUM_ENTITIES</constant></link>">
 <!ENTITY MEDIA-IOC-ENUM-LINKS "<link linkend='media-ioc-enum-links'><constant>MEDIA_IOC_ENUM_LINKS</constant></link>">
 <!ENTITY MEDIA-IOC-SETUP-LINK "<link linkend='media-ioc-setup-link'><constant>MEDIA_IOC_SETUP_LINK</constant></link>">
 <!-- Types -->
 <!ENTITY v4l2-std-id "<link linkend='v4l2-std-id'>v4l2_std_id</link>">
 <!-- Enums -->
 <!ENTITY v4l2-buf-type "enum&nbsp;<link linkend='v4l2-buf-type'>v4l2_buf_type</link>">
 <!ENTITY v4l2-colorspace "enum&nbsp;<link linkend='v4l2-colorspace'>v4l2_colorspace</link>">
 <!ENTITY v4l2-ctrl-type "enum&nbsp;<link linkend='v4l2-ctrl-type'>v4l2_ctrl_type</link>">
 <!ENTITY v4l2-exposure-auto-type "enum&nbsp;<link linkend='v4l2-exposure-auto-type'>v4l2_exposure_auto_type</link>">
 <!ENTITY v4l2-field "enum&nbsp;<link linkend='v4l2-field'>v4l2_field</link>">
 <!ENTITY v4l2-frmivaltypes "enum&nbsp;<link linkend='v4l2-frmivaltypes'>v4l2_frmivaltypes</link>">
 <!ENTITY v4l2-frmsizetypes "enum&nbsp;<link linkend='v4l2-frmsizetypes'>v4l2_frmsizetypes</link>">
 <!ENTITY v4l2-mbus-pixelcode "enum&nbsp;<link linkend='v4l2-mbus-pixelcode'>v4l2_mbus_pixelcode</link>">
 <!ENTITY v4l2-memory "enum&nbsp;<link linkend='v4l2-memory'>v4l2_memory</link>">
 <!ENTITY v4l2-mpeg-audio-ac3-bitrate "enum&nbsp;<link linkend='v4l2-mpeg-audio-ac3-bitrate'>v4l2_mpeg_audio_ac3_bitrate</link>">
 <!ENTITY v4l2-mpeg-audio-crc "enum&nbsp;<link linkend='v4l2-mpeg-audio-crc'>v4l2_mpeg_audio_crc</link>">
 <!ENTITY v4l2-mpeg-audio-emphasis "enum&nbsp;<link linkend='v4l2-mpeg-audio-emphasis'>v4l2_mpeg_audio_emphasis</link>">
 <!ENTITY v4l2-mpeg-audio-encoding "enum&nbsp;<link linkend='v4l2-mpeg-audio-encoding'>v4l2_mpeg_audio_encoding</link>">
 <!ENTITY v4l2-mpeg-audio-l1-bitrate "enum&nbsp;<link linkend='v4l2-mpeg-audio-l1-bitrate'>v4l2_mpeg_audio_l1_bitrate</link>">
 <!ENTITY v4l2-mpeg-audio-l2-bitrate "enum&nbsp;<link linkend='v4l2-mpeg-audio-l2-bitrate'>v4l2_mpeg_audio_l2_bitrate</link>">
 <!ENTITY v4l2-mpeg-audio-l3-bitrate "enum&nbsp;<link linkend='v4l2-mpeg-audio-l3-bitrate'>v4l2_mpeg_audio_l3_bitrate</link>">
 <!ENTITY v4l2-mpeg-audio-mode "enum&nbsp;<link linkend='v4l2-mpeg-audio-mode'>v4l2_mpeg_audio_mode</link>">
 <!ENTITY v4l2-mpeg-audio-mode-extension "enum&nbsp;<link linkend='v4l2-mpeg-audio-mode-extension'>v4l2_mpeg_audio_mode_extension</link>">
 <!ENTITY v4l2-mpeg-audio-sampling-freq "enum&nbsp;<link linkend='v4l2-mpeg-audio-sampling-freq'>v4l2_mpeg_audio_sampling_freq</link>">
 <!ENTITY chroma-spatial-filter-type "enum&nbsp;<link linkend='chroma-spatial-filter-type'>v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type</link>">
 <!ENTITY luma-spatial-filter-type "enum&nbsp;<link linkend='luma-spatial-filter-type'>v4l2_mpeg_cx2341x_video_luma_spatial_filter_type</link>">
 <!ENTITY v4l2-mpeg-cx2341x-video-median-filter-type "enum&nbsp;<link linkend='v4l2-mpeg-cx2341x-video-median-filter-type'>v4l2_mpeg_cx2341x_video_median_filter_type</link>">
 <!ENTITY v4l2-mpeg-cx2341x-video-spatial-filter-mode "enum&nbsp;<link linkend='v4l2-mpeg-cx2341x-video-spatial-filter-mode'>v4l2_mpeg_cx2341x_video_spatial_filter_mode</link>">
 <!ENTITY v4l2-mpeg-cx2341x-video-temporal-filter-mode "enum&nbsp;<link linkend='v4l2-mpeg-cx2341x-video-temporal-filter-mode'>v4l2_mpeg_cx2341x_video_temporal_filter_mode</link>">
 <!ENTITY v4l2-mpeg-stream-type "enum&nbsp;<link linkend='v4l2-mpeg-stream-type'>v4l2_mpeg_stream_type</link>">
 <!ENTITY v4l2-mpeg-stream-vbi-fmt "enum&nbsp;<link linkend='v4l2-mpeg-stream-vbi-fmt'>v4l2_mpeg_stream_vbi_fmt</link>">
 <!ENTITY v4l2-mpeg-video-aspect "enum&nbsp;<link linkend='v4l2-mpeg-video-aspect'>v4l2_mpeg_video_aspect</link>">
 <!ENTITY v4l2-mpeg-video-bitrate-mode "enum&nbsp;<link linkend='v4l2-mpeg-video-bitrate-mode'>v4l2_mpeg_video_bitrate_mode</link>">
 <!ENTITY v4l2-mpeg-video-encoding "enum&nbsp;<link linkend='v4l2-mpeg-video-encoding'>v4l2_mpeg_video_encoding</link>">
 <!ENTITY v4l2-power-line-frequency "enum&nbsp;<link linkend='v4l2-power-line-frequency'>v4l2_power_line_frequency</link>">
 <!ENTITY v4l2-priority "enum&nbsp;<link linkend='v4l2-priority'>v4l2_priority</link>">
 <!ENTITY v4l2-subdev-format-whence "enum&nbsp;<link linkend='v4l2-subdev-format-whence'>v4l2_subdev_format_whence</link>">
 <!ENTITY v4l2-tuner-type "enum&nbsp;<link linkend='v4l2-tuner-type'>v4l2_tuner_type</link>">
 <!ENTITY v4l2-preemphasis "enum&nbsp;<link linkend='v4l2-preemphasis'>v4l2_preemphasis</link>">
 <!-- Structures -->
 <!ENTITY v4l2-audio "struct&nbsp;<link linkend='v4l2-audio'>v4l2_audio</link>">
 <!ENTITY v4l2-audioout "struct&nbsp;<link linkend='v4l2-audioout'>v4l2_audioout</link>">
 <!ENTITY v4l2-bt-timings "struct&nbsp;<link linkend='v4l2-bt-timings'>v4l2_bt_timings</link>">
 <!ENTITY v4l2-buffer "struct&nbsp;<link linkend='v4l2-buffer'>v4l2_buffer</link>">
 <!ENTITY v4l2-plane "struct&nbsp;<link linkend='v4l2-plane'>v4l2_plane</link>">
 <!ENTITY v4l2-capability "struct&nbsp;<link linkend='v4l2-capability'>v4l2_capability</link>">
 <!ENTITY v4l2-captureparm "struct&nbsp;<link linkend='v4l2-captureparm'>v4l2_captureparm</link>">
 <!ENTITY v4l2-clip "struct&nbsp;<link linkend='v4l2-clip'>v4l2_clip</link>">
 <!ENTITY v4l2-control "struct&nbsp;<link linkend='v4l2-control'>v4l2_control</link>">
 <!ENTITY v4l2-crop "struct&nbsp;<link linkend='v4l2-crop'>v4l2_crop</link>">
 <!ENTITY v4l2-cropcap "struct&nbsp;<link linkend='v4l2-cropcap'>v4l2_cropcap</link>">
 <!ENTITY v4l2-dbg-chip-ident "struct&nbsp;<link linkend='v4l2-dbg-chip-ident'>v4l2_dbg_chip_ident</link>">
 <!ENTITY v4l2-dbg-match "struct&nbsp;<link linkend='v4l2-dbg-match'>v4l2_dbg_match</link>">
 <!ENTITY v4l2-dbg-register "struct&nbsp;<link linkend='v4l2-dbg-register'>v4l2_dbg_register</link>">
 <!ENTITY v4l2-dv-enum-preset "struct&nbsp;<link linkend='v4l2-dv-enum-preset'>v4l2_dv_enum_preset</link>">
 <!ENTITY v4l2-dv-preset "struct&nbsp;<link linkend='v4l2-dv-preset'>v4l2_dv_preset</link>">
 <!ENTITY v4l2-dv-timings "struct&nbsp;<link linkend='v4l2-dv-timings'>v4l2_dv_timings</link>">
 <!ENTITY v4l2-enc-idx "struct&nbsp;<link linkend='v4l2-enc-idx'>v4l2_enc_idx</link>">
 <!ENTITY v4l2-enc-idx-entry "struct&nbsp;<link linkend='v4l2-enc-idx-entry'>v4l2_enc_idx_entry</link>">
 <!ENTITY v4l2-encoder-cmd "struct&nbsp;<link linkend='v4l2-encoder-cmd'>v4l2_encoder_cmd</link>">
 <!ENTITY v4l2-event "struct&nbsp;<link linkend='v4l2-event'>v4l2_event</link>">
 <!ENTITY v4l2-event-subscription "struct&nbsp;<link linkend='v4l2-event-subscription'>v4l2_event_subscription</link>">
 <!ENTITY v4l2-event-vsync "struct&nbsp;<link linkend='v4l2-event-vsync'>v4l2_event_vsync</link>">
 <!ENTITY v4l2-ext-control "struct&nbsp;<link linkend='v4l2-ext-control'>v4l2_ext_control</link>">
 <!ENTITY v4l2-ext-controls "struct&nbsp;<link linkend='v4l2-ext-controls'>v4l2_ext_controls</link>">
 <!ENTITY v4l2-fmtdesc "struct&nbsp;<link linkend='v4l2-fmtdesc'>v4l2_fmtdesc</link>">
 <!ENTITY v4l2-format "struct&nbsp;<link linkend='v4l2-format'>v4l2_format</link>">
 <!ENTITY v4l2-fract "struct&nbsp;<link linkend='v4l2-fract'>v4l2_fract</link>">
 <!ENTITY v4l2-framebuffer "struct&nbsp;<link linkend='v4l2-framebuffer'>v4l2_framebuffer</link>">
 <!ENTITY v4l2-frequency "struct&nbsp;<link linkend='v4l2-frequency'>v4l2_frequency</link>">
 <!ENTITY v4l2-frmival-stepwise "struct&nbsp;<link linkend='v4l2-frmival-stepwise'>v4l2_frmival_stepwise</link>">
 <!ENTITY v4l2-frmivalenum "struct&nbsp;<link linkend='v4l2-frmivalenum'>v4l2_frmivalenum</link>">
 <!ENTITY v4l2-frmsize-discrete "struct&nbsp;<link linkend='v4l2-frmsize-discrete'>v4l2_frmsize_discrete</link>">
 <!ENTITY v4l2-frmsize-stepwise "struct&nbsp;<link linkend='v4l2-frmsize-stepwise'>v4l2_frmsize_stepwise</link>">
 <!ENTITY v4l2-frmsizeenum "struct&nbsp;<link linkend='v4l2-frmsizeenum'>v4l2_frmsizeenum</link>">
 <!ENTITY v4l2-hw-freq-seek "struct&nbsp;<link linkend='v4l2-hw-freq-seek'>v4l2_hw_freq_seek</link>">
 <!ENTITY v4l2-input "struct&nbsp;<link linkend='v4l2-input'>v4l2_input</link>">
 <!ENTITY v4l2-jpegcompression "struct&nbsp;<link linkend='v4l2-jpegcompression'>v4l2_jpegcompression</link>">
 <!ENTITY v4l2-mbus-framefmt "struct&nbsp;<link linkend='v4l2-mbus-framefmt'>v4l2_mbus_framefmt</link>">
 <!ENTITY v4l2-modulator "struct&nbsp;<link linkend='v4l2-modulator'>v4l2_modulator</link>">
 <!ENTITY v4l2-mpeg-vbi-fmt-ivtv "struct&nbsp;<link linkend='v4l2-mpeg-vbi-fmt-ivtv'>v4l2_mpeg_vbi_fmt_ivtv</link>">
 <!ENTITY v4l2-output "struct&nbsp;<link linkend='v4l2-output'>v4l2_output</link>">
 <!ENTITY v4l2-outputparm "struct&nbsp;<link linkend='v4l2-outputparm'>v4l2_outputparm</link>">
 <!ENTITY v4l2-pix-format "struct&nbsp;<link linkend='v4l2-pix-format'>v4l2_pix_format</link>">
 <!ENTITY v4l2-pix-format-mplane "struct&nbsp;<link linkend='v4l2-pix-format-mplane'>v4l2_pix_format_mplane</link>">
 <!ENTITY v4l2-plane-pix-format "struct&nbsp;<link linkend='v4l2-plane-pix-format'>v4l2_plane_pix_format</link>">
 <!ENTITY v4l2-queryctrl "struct&nbsp;<link linkend='v4l2-queryctrl'>v4l2_queryctrl</link>">
 <!ENTITY v4l2-querymenu "struct&nbsp;<link linkend='v4l2-querymenu'>v4l2_querymenu</link>">
 <!ENTITY v4l2-rect "struct&nbsp;<link linkend='v4l2-rect'>v4l2_rect</link>">
 <!ENTITY v4l2-requestbuffers "struct&nbsp;<link linkend='v4l2-requestbuffers'>v4l2_requestbuffers</link>">
 <!ENTITY v4l2-sliced-vbi-cap "struct&nbsp;<link linkend='v4l2-sliced-vbi-cap'>v4l2_sliced_vbi_cap</link>">
 <!ENTITY v4l2-sliced-vbi-data "struct&nbsp;<link linkend='v4l2-sliced-vbi-data'>v4l2_sliced_vbi_data</link>">
 <!ENTITY v4l2-sliced-vbi-format "struct&nbsp;<link linkend='v4l2-sliced-vbi-format'>v4l2_sliced_vbi_format</link>">
+<!ENTITY v4l2-subdev-frame-interval "struct&nbsp;<link linkend='v4l2-subdev-frame-interval'>v4l2_subdev_frame_interval</link>">
+<!ENTITY v4l2-subdev-frame-interval-enum "struct&nbsp;<link linkend='v4l2-subdev-frame-interval-enum'>v4l2_subdev_frame_interval_enum</link>">
 <!ENTITY v4l2-subdev-frame-size-enum "struct&nbsp;<link linkend='v4l2-subdev-frame-size-enum'>v4l2_subdev_frame_size_enum</link>">
 <!ENTITY v4l2-subdev-format "struct&nbsp;<link linkend='v4l2-subdev-format'>v4l2_subdev_format</link>">
 <!ENTITY v4l2-subdev-mbus-code-enum "struct&nbsp;<link linkend='v4l2-subdev-mbus-code-enum'>v4l2_subdev_mbus_code_enum</link>">
 <!ENTITY v4l2-standard "struct&nbsp;<link linkend='v4l2-standard'>v4l2_standard</link>">
 <!ENTITY v4l2-streamparm "struct&nbsp;<link linkend='v4l2-streamparm'>v4l2_streamparm</link>">
 <!ENTITY v4l2-timecode "struct&nbsp;<link linkend='v4l2-timecode'>v4l2_timecode</link>">
 <!ENTITY v4l2-tuner "struct&nbsp;<link linkend='v4l2-tuner'>v4l2_tuner</link>">
 <!ENTITY v4l2-vbi-format "struct&nbsp;<link linkend='v4l2-vbi-format'>v4l2_vbi_format</link>">
 <!ENTITY v4l2-window "struct&nbsp;<link linkend='v4l2-window'>v4l2_window</link>">
 <!ENTITY media-device-info "struct&nbsp;<link linkend='media-device-info'>media_device_info</link>">
 <!ENTITY media-entity-desc "struct&nbsp;<link linkend='media-entity-desc'>media_entity_desc</link>">
 <!ENTITY media-links-enum "struct&nbsp;<link linkend='media-links-enum'>media_links_enum</link>">
 <!ENTITY media-pad-desc "struct&nbsp;<link linkend='media-pad-desc'>media_pad_desc</link>">
 <!ENTITY media-link-desc "struct&nbsp;<link linkend='media-link-desc'>media_link_desc</link>">
 <!-- Error Codes -->
 <!ENTITY EACCES "<errorcode>EACCES</errorcode> error code">
 <!ENTITY EAGAIN "<errorcode>EAGAIN</errorcode> error code">
 <!ENTITY EBADF "<errorcode>EBADF</errorcode> error code">
 <!ENTITY EBUSY "<errorcode>EBUSY</errorcode> error code">
 <!ENTITY EFAULT "<errorcode>EFAULT</errorcode> error code">
 <!ENTITY EIO "<errorcode>EIO</errorcode> error code">
 <!ENTITY EINTR "<errorcode>EINTR</errorcode> error code">
 <!ENTITY EINVAL "<errorcode>EINVAL</errorcode> error code">
 <!ENTITY ENFILE "<errorcode>ENFILE</errorcode> error code">
 <!ENTITY ENOMEM "<errorcode>ENOMEM</errorcode> error code">
 <!ENTITY ENOSPC "<errorcode>ENOSPC</errorcode> error code">
 <!ENTITY ENOTTY "<errorcode>ENOTTY</errorcode> error code">
 <!ENTITY ENXIO "<errorcode>ENXIO</errorcode> error code">
 <!ENTITY EMFILE "<errorcode>EMFILE</errorcode> error code">
 <!ENTITY EPERM "<errorcode>EPERM</errorcode> error code">
 <!ENTITY EPIPE "<errorcode>EPIPE</errorcode> error code">
 <!ENTITY ERANGE "<errorcode>ERANGE</errorcode> error code">
 <!-- Subsections -->
 <!ENTITY sub-biblio SYSTEM "v4l/biblio.xml">
 <!ENTITY sub-common SYSTEM "v4l/common.xml">
 <!ENTITY sub-planar-apis SYSTEM "v4l/planar-apis.xml">
 <!ENTITY sub-compat SYSTEM "v4l/compat.xml">
 <!ENTITY sub-controls SYSTEM "v4l/controls.xml">
 <!ENTITY sub-dev-capture SYSTEM "v4l/dev-capture.xml">
 <!ENTITY sub-dev-codec SYSTEM "v4l/dev-codec.xml">
 <!ENTITY sub-dev-event SYSTEM "v4l/dev-event.xml">
 <!ENTITY sub-dev-effect SYSTEM "v4l/dev-effect.xml">
 <!ENTITY sub-dev-osd SYSTEM "v4l/dev-osd.xml">
 <!ENTITY sub-dev-output SYSTEM "v4l/dev-output.xml">
 <!ENTITY sub-dev-overlay SYSTEM "v4l/dev-overlay.xml">
 <!ENTITY sub-dev-radio SYSTEM "v4l/dev-radio.xml">
 <!ENTITY sub-dev-raw-vbi SYSTEM "v4l/dev-raw-vbi.xml">
 <!ENTITY sub-dev-rds SYSTEM "v4l/dev-rds.xml">
 <!ENTITY sub-dev-sliced-vbi SYSTEM "v4l/dev-sliced-vbi.xml">
 <!ENTITY sub-dev-subdev SYSTEM "v4l/dev-subdev.xml">
 <!ENTITY sub-dev-teletext SYSTEM "v4l/dev-teletext.xml">
 <!ENTITY sub-driver SYSTEM "v4l/driver.xml">
 <!ENTITY sub-libv4l SYSTEM "v4l/libv4l.xml">
 <!ENTITY sub-lirc_device_interface SYSTEM "v4l/lirc_device_interface.xml">
 <!ENTITY sub-remote_controllers SYSTEM "v4l/remote_controllers.xml">
 <!ENTITY sub-fdl-appendix SYSTEM "v4l/fdl-appendix.xml">
 <!ENTITY sub-close SYSTEM "v4l/func-close.xml">
 <!ENTITY sub-ioctl SYSTEM "v4l/func-ioctl.xml">
 <!ENTITY sub-mmap SYSTEM "v4l/func-mmap.xml">
 <!ENTITY sub-munmap SYSTEM "v4l/func-munmap.xml">
 <!ENTITY sub-open SYSTEM "v4l/func-open.xml">
 <!ENTITY sub-poll SYSTEM "v4l/func-poll.xml">
 <!ENTITY sub-read SYSTEM "v4l/func-read.xml">
 <!ENTITY sub-select SYSTEM "v4l/func-select.xml">
 <!ENTITY sub-write SYSTEM "v4l/func-write.xml">
 <!ENTITY sub-io SYSTEM "v4l/io.xml">
 <!ENTITY sub-grey SYSTEM "v4l/pixfmt-grey.xml">
 <!ENTITY sub-nv12 SYSTEM "v4l/pixfmt-nv12.xml">
 <!ENTITY sub-nv12m SYSTEM "v4l/pixfmt-nv12m.xml">
 <!ENTITY sub-nv16 SYSTEM "v4l/pixfmt-nv16.xml">
 <!ENTITY sub-packed-rgb SYSTEM "v4l/pixfmt-packed-rgb.xml">
 <!ENTITY sub-packed-yuv SYSTEM "v4l/pixfmt-packed-yuv.xml">
 <!ENTITY sub-sbggr16 SYSTEM "v4l/pixfmt-sbggr16.xml">
 <!ENTITY sub-sbggr8 SYSTEM "v4l/pixfmt-sbggr8.xml">
 <!ENTITY sub-sgbrg8 SYSTEM "v4l/pixfmt-sgbrg8.xml">
 <!ENTITY sub-sgrbg8 SYSTEM "v4l/pixfmt-sgrbg8.xml">
 <!ENTITY sub-uyvy SYSTEM "v4l/pixfmt-uyvy.xml">
 <!ENTITY sub-vyuy SYSTEM "v4l/pixfmt-vyuy.xml">
 <!ENTITY sub-y16 SYSTEM "v4l/pixfmt-y16.xml">
 <!ENTITY sub-y41p SYSTEM "v4l/pixfmt-y41p.xml">
 <!ENTITY sub-yuv410 SYSTEM "v4l/pixfmt-yuv410.xml">
 <!ENTITY sub-yuv411p SYSTEM "v4l/pixfmt-yuv411p.xml">
 <!ENTITY sub-yuv420 SYSTEM "v4l/pixfmt-yuv420.xml">
 <!ENTITY sub-yuv420m SYSTEM "v4l/pixfmt-yuv420m.xml">
 <!ENTITY sub-yuv422p SYSTEM "v4l/pixfmt-yuv422p.xml">
 <!ENTITY sub-yuyv SYSTEM "v4l/pixfmt-yuyv.xml">
 <!ENTITY sub-yvyu SYSTEM "v4l/pixfmt-yvyu.xml">
 <!ENTITY sub-srggb10 SYSTEM "v4l/pixfmt-srggb10.xml">
 <!ENTITY sub-srggb8 SYSTEM "v4l/pixfmt-srggb8.xml">
 <!ENTITY sub-y10 SYSTEM "v4l/pixfmt-y10.xml">
 <!ENTITY sub-pixfmt SYSTEM "v4l/pixfmt.xml">
 <!ENTITY sub-cropcap SYSTEM "v4l/vidioc-cropcap.xml">
 <!ENTITY sub-dbg-g-register SYSTEM "v4l/vidioc-dbg-g-register.xml">
 <!ENTITY sub-encoder-cmd SYSTEM "v4l/vidioc-encoder-cmd.xml">
 <!ENTITY sub-enum-fmt SYSTEM "v4l/vidioc-enum-fmt.xml">
 <!ENTITY sub-enum-frameintervals SYSTEM "v4l/vidioc-enum-frameintervals.xml">
 <!ENTITY sub-enum-framesizes SYSTEM "v4l/vidioc-enum-framesizes.xml">
 <!ENTITY sub-enumaudio SYSTEM "v4l/vidioc-enumaudio.xml">
 <!ENTITY sub-enumaudioout SYSTEM "v4l/vidioc-enumaudioout.xml">
 <!ENTITY sub-enuminput SYSTEM "v4l/vidioc-enuminput.xml">
 <!ENTITY sub-enumoutput SYSTEM "v4l/vidioc-enumoutput.xml">
 <!ENTITY sub-enum-dv-presets SYSTEM "v4l/vidioc-enum-dv-presets.xml">
 <!ENTITY sub-g-dv-preset SYSTEM "v4l/vidioc-g-dv-preset.xml">
 <!ENTITY sub-query-dv-preset SYSTEM "v4l/vidioc-query-dv-preset.xml">
 <!ENTITY sub-g-dv-timings SYSTEM "v4l/vidioc-g-dv-timings.xml">
 <!ENTITY sub-enumstd SYSTEM "v4l/vidioc-enumstd.xml">
 <!ENTITY sub-g-audio SYSTEM "v4l/vidioc-g-audio.xml">
 <!ENTITY sub-g-audioout SYSTEM "v4l/vidioc-g-audioout.xml">
 <!ENTITY sub-dbg-g-chip-ident SYSTEM "v4l/vidioc-dbg-g-chip-ident.xml">
 <!ENTITY sub-g-crop SYSTEM "v4l/vidioc-g-crop.xml">
 <!ENTITY sub-g-ctrl SYSTEM "v4l/vidioc-g-ctrl.xml">
 <!ENTITY sub-g-enc-index SYSTEM "v4l/vidioc-g-enc-index.xml">
 <!ENTITY sub-g-ext-ctrls SYSTEM "v4l/vidioc-g-ext-ctrls.xml">
 <!ENTITY sub-g-fbuf SYSTEM "v4l/vidioc-g-fbuf.xml">
 <!ENTITY sub-g-fmt SYSTEM "v4l/vidioc-g-fmt.xml">
 <!ENTITY sub-g-frequency SYSTEM "v4l/vidioc-g-frequency.xml">
 <!ENTITY sub-g-input SYSTEM "v4l/vidioc-g-input.xml">
 <!ENTITY sub-g-jpegcomp SYSTEM "v4l/vidioc-g-jpegcomp.xml">
 <!ENTITY sub-g-modulator SYSTEM "v4l/vidioc-g-modulator.xml">
 <!ENTITY sub-g-output SYSTEM "v4l/vidioc-g-output.xml">
 <!ENTITY sub-g-parm SYSTEM "v4l/vidioc-g-parm.xml">
 <!ENTITY sub-g-priority SYSTEM "v4l/vidioc-g-priority.xml">
 <!ENTITY sub-g-sliced-vbi-cap SYSTEM "v4l/vidioc-g-sliced-vbi-cap.xml">
 <!ENTITY sub-g-std SYSTEM "v4l/vidioc-g-std.xml">
 <!ENTITY sub-g-tuner SYSTEM "v4l/vidioc-g-tuner.xml">
 <!ENTITY sub-log-status SYSTEM "v4l/vidioc-log-status.xml">
 <!ENTITY sub-overlay SYSTEM "v4l/vidioc-overlay.xml">
 <!ENTITY sub-qbuf SYSTEM "v4l/vidioc-qbuf.xml">
 <!ENTITY sub-querybuf SYSTEM "v4l/vidioc-querybuf.xml">
 <!ENTITY sub-querycap SYSTEM "v4l/vidioc-querycap.xml">
 <!ENTITY sub-queryctrl SYSTEM "v4l/vidioc-queryctrl.xml">
 <!ENTITY sub-querystd SYSTEM "v4l/vidioc-querystd.xml">
 <!ENTITY sub-reqbufs SYSTEM "v4l/vidioc-reqbufs.xml">
 <!ENTITY sub-s-hw-freq-seek SYSTEM "v4l/vidioc-s-hw-freq-seek.xml">
 <!ENTITY sub-streamon SYSTEM "v4l/vidioc-streamon.xml">
+<!ENTITY sub-subdev-enum-frame-interval SYSTEM "v4l/vidioc-subdev-enum-frame-interval.xml">
 <!ENTITY sub-subdev-enum-frame-size SYSTEM "v4l/vidioc-subdev-enum-frame-size.xml">
 <!ENTITY sub-subdev-enum-mbus-code SYSTEM "v4l/vidioc-subdev-enum-mbus-code.xml">
 <!ENTITY sub-subdev-formats SYSTEM "v4l/subdev-formats.xml">
 <!ENTITY sub-subdev-g-fmt SYSTEM "v4l/vidioc-subdev-g-fmt.xml">
+<!ENTITY sub-subdev-g-frame-interval SYSTEM "v4l/vidioc-subdev-g-frame-interval.xml">
 <!ENTITY sub-capture-c SYSTEM "v4l/capture.c.xml">
 <!ENTITY sub-keytable-c SYSTEM "v4l/keytable.c.xml">
 <!ENTITY sub-v4l2grab-c SYSTEM "v4l/v4l2grab.c.xml">
 <!ENTITY sub-videodev2-h SYSTEM "v4l/videodev2.h.xml">
 <!ENTITY sub-v4l2 SYSTEM "v4l/v4l2.xml">
 <!ENTITY sub-dqevent SYSTEM "v4l/vidioc-dqevent.xml">
 <!ENTITY sub-subscribe-event SYSTEM "v4l/vidioc-subscribe-event.xml">
 <!ENTITY sub-intro SYSTEM "dvb/intro.xml">
 <!ENTITY sub-frontend SYSTEM "dvb/frontend.xml">
 <!ENTITY sub-dvbproperty SYSTEM "dvb/dvbproperty.xml">
 <!ENTITY sub-demux SYSTEM "dvb/demux.xml">
 <!ENTITY sub-video SYSTEM "dvb/video.xml">
 <!ENTITY sub-audio SYSTEM "dvb/audio.xml">
 <!ENTITY sub-ca SYSTEM "dvb/ca.xml">
 <!ENTITY sub-net SYSTEM "dvb/net.xml">
 <!ENTITY sub-kdapi SYSTEM "dvb/kdapi.xml">
 <!ENTITY sub-examples SYSTEM "dvb/examples.xml">
 <!ENTITY sub-frontend-h SYSTEM "dvb/frontend.h.xml">
 <!ENTITY sub-dvbapi SYSTEM "dvb/dvbapi.xml">
 <!ENTITY sub-media SYSTEM "media.xml">
 <!ENTITY sub-media-entities SYSTEM "media-entities.tmpl">
 <!ENTITY sub-media-indices SYSTEM "media-indices.tmpl">
 <!ENTITY sub-media-controller SYSTEM "v4l/media-controller.xml">
 <!ENTITY sub-media-open SYSTEM "v4l/media-func-open.xml">
 <!ENTITY sub-media-close SYSTEM "v4l/media-func-close.xml">
 <!ENTITY sub-media-ioctl SYSTEM "v4l/media-func-ioctl.xml">
 <!ENTITY sub-media-ioc-device-info SYSTEM "v4l/media-ioc-device-info.xml">
 <!ENTITY sub-media-ioc-enum-entities SYSTEM "v4l/media-ioc-enum-entities.xml">
 <!ENTITY sub-media-ioc-enum-links SYSTEM "v4l/media-ioc-enum-links.xml">
 <!ENTITY sub-media-ioc-setup-link SYSTEM "v4l/media-ioc-setup-link.xml">
 <!-- Function Reference -->
 <!ENTITY close SYSTEM "v4l/func-close.xml">
 <!ENTITY ioctl SYSTEM "v4l/func-ioctl.xml">
 <!ENTITY mmap SYSTEM "v4l/func-mmap.xml">
 <!ENTITY munmap SYSTEM "v4l/func-munmap.xml">
 <!ENTITY open SYSTEM "v4l/func-open.xml">
 <!ENTITY poll SYSTEM "v4l/func-poll.xml">
 <!ENTITY read SYSTEM "v4l/func-read.xml">
 <!ENTITY select SYSTEM "v4l/func-select.xml">
 <!ENTITY write SYSTEM "v4l/func-write.xml">
 <!ENTITY grey SYSTEM "v4l/pixfmt-grey.xml">
 <!ENTITY nv12 SYSTEM "v4l/pixfmt-nv12.xml">
 <!ENTITY nv12m SYSTEM "v4l/pixfmt-nv12m.xml">
 <!ENTITY nv16 SYSTEM "v4l/pixfmt-nv16.xml">
 <!ENTITY packed-rgb SYSTEM "v4l/pixfmt-packed-rgb.xml">
 <!ENTITY packed-yuv SYSTEM "v4l/pixfmt-packed-yuv.xml">
 <!ENTITY sbggr16 SYSTEM "v4l/pixfmt-sbggr16.xml">
 <!ENTITY sbggr8 SYSTEM "v4l/pixfmt-sbggr8.xml">
 <!ENTITY sgbrg8 SYSTEM "v4l/pixfmt-sgbrg8.xml">
 <!ENTITY sgrbg8 SYSTEM "v4l/pixfmt-sgrbg8.xml">
 <!ENTITY uyvy SYSTEM "v4l/pixfmt-uyvy.xml">
 <!ENTITY vyuy SYSTEM "v4l/pixfmt-vyuy.xml">
 <!ENTITY y16 SYSTEM "v4l/pixfmt-y16.xml">
 <!ENTITY y41p SYSTEM "v4l/pixfmt-y41p.xml">
 <!ENTITY yuv410 SYSTEM "v4l/pixfmt-yuv410.xml">
 <!ENTITY yuv411p SYSTEM "v4l/pixfmt-yuv411p.xml">
 <!ENTITY yuv420 SYSTEM "v4l/pixfmt-yuv420.xml">
 <!ENTITY yuv420m SYSTEM "v4l/pixfmt-yuv420m.xml">
 <!ENTITY yuv422p SYSTEM "v4l/pixfmt-yuv422p.xml">
 <!ENTITY yuyv SYSTEM "v4l/pixfmt-yuyv.xml">
 <!ENTITY yvyu SYSTEM "v4l/pixfmt-yvyu.xml">
 <!ENTITY srggb10 SYSTEM "v4l/pixfmt-srggb10.xml">
 <!ENTITY srggb8 SYSTEM "v4l/pixfmt-srggb8.xml">
 <!ENTITY y10 SYSTEM "v4l/pixfmt-y10.xml">
 <!ENTITY cropcap SYSTEM "v4l/vidioc-cropcap.xml">
 <!ENTITY dbg-g-register SYSTEM "v4l/vidioc-dbg-g-register.xml">
 <!ENTITY encoder-cmd SYSTEM "v4l/vidioc-encoder-cmd.xml">
 <!ENTITY enum-fmt SYSTEM "v4l/vidioc-enum-fmt.xml">
 <!ENTITY enum-frameintervals SYSTEM "v4l/vidioc-enum-frameintervals.xml">
 <!ENTITY enum-framesizes SYSTEM "v4l/vidioc-enum-framesizes.xml">
 <!ENTITY enumaudio SYSTEM "v4l/vidioc-enumaudio.xml">
 <!ENTITY enumaudioout SYSTEM "v4l/vidioc-enumaudioout.xml">
 <!ENTITY enuminput SYSTEM "v4l/vidioc-enuminput.xml">
 <!ENTITY enumoutput SYSTEM "v4l/vidioc-enumoutput.xml">
 <!ENTITY enum-dv-presets SYSTEM "v4l/vidioc-enum-dv-presets.xml">
 <!ENTITY g-dv-preset SYSTEM "v4l/vidioc-g-dv-preset.xml">
 <!ENTITY query-dv-preset SYSTEM "v4l/vidioc-query-dv-preset.xml">
 <!ENTITY g-dv-timings SYSTEM "v4l/vidioc-g-dv-timings.xml">
 <!ENTITY enumstd SYSTEM "v4l/vidioc-enumstd.xml">
 <!ENTITY g-audio SYSTEM "v4l/vidioc-g-audio.xml">
 <!ENTITY g-audioout SYSTEM "v4l/vidioc-g-audioout.xml">
 <!ENTITY dbg-g-chip-ident SYSTEM "v4l/vidioc-dbg-g-chip-ident.xml">
 <!ENTITY g-crop SYSTEM "v4l/vidioc-g-crop.xml">
 <!ENTITY g-ctrl SYSTEM "v4l/vidioc-g-ctrl.xml">
 <!ENTITY g-enc-index SYSTEM "v4l/vidioc-g-enc-index.xml">
 <!ENTITY g-ext-ctrls SYSTEM "v4l/vidioc-g-ext-ctrls.xml">
 <!ENTITY g-fbuf SYSTEM "v4l/vidioc-g-fbuf.xml">
 <!ENTITY g-fmt SYSTEM "v4l/vidioc-g-fmt.xml">
 <!ENTITY g-frequency SYSTEM "v4l/vidioc-g-frequency.xml">
 <!ENTITY g-input SYSTEM "v4l/vidioc-g-input.xml">
 <!ENTITY g-jpegcomp SYSTEM "v4l/vidioc-g-jpegcomp.xml">
 <!ENTITY g-modulator SYSTEM "v4l/vidioc-g-modulator.xml">
 <!ENTITY g-output SYSTEM "v4l/vidioc-g-output.xml">
 <!ENTITY g-parm SYSTEM "v4l/vidioc-g-parm.xml">
 <!ENTITY g-priority SYSTEM "v4l/vidioc-g-priority.xml">
 <!ENTITY g-sliced-vbi-cap SYSTEM "v4l/vidioc-g-sliced-vbi-cap.xml">
 <!ENTITY g-std SYSTEM "v4l/vidioc-g-std.xml">
 <!ENTITY g-tuner SYSTEM "v4l/vidioc-g-tuner.xml">
 <!ENTITY log-status SYSTEM "v4l/vidioc-log-status.xml">
 <!ENTITY overlay SYSTEM "v4l/vidioc-overlay.xml">
 <!ENTITY qbuf SYSTEM "v4l/vidioc-qbuf.xml">
 <!ENTITY querybuf SYSTEM "v4l/vidioc-querybuf.xml">
 <!ENTITY querycap SYSTEM "v4l/vidioc-querycap.xml">
 <!ENTITY queryctrl SYSTEM "v4l/vidioc-queryctrl.xml">
 <!ENTITY querystd SYSTEM "v4l/vidioc-querystd.xml">
 <!ENTITY reqbufs SYSTEM "v4l/vidioc-reqbufs.xml">
 <!ENTITY s-hw-freq-seek SYSTEM "v4l/vidioc-s-hw-freq-seek.xml">
 <!ENTITY streamon SYSTEM "v4l/vidioc-streamon.xml">
 <!ENTITY dqevent SYSTEM "v4l/vidioc-dqevent.xml">
 <!ENTITY subscribe_event SYSTEM "v4l/vidioc-subscribe-event.xml">

Documentation/DocBook/v4l/v4l2.xml

Diff comments View file @ 35c3017

  <partinfo>
     <authorgroup>
       <author>
 	<firstname>Michael</firstname>
 	<surname>Schimek</surname>
 	<othername role="mi">H</othername>
 	<affiliation>
 	  <address>
 	    <email>mschimek@gmx.at</email>
 	  </address>
 	</affiliation>
       </author>
       <author>
 	<firstname>Bill</firstname>
 	<surname>Dirks</surname>
 	<!-- Commented until Bill opts in to be spammed.
 	<affiliation>
 	  <address>
 	    <email>bill@thedirks.org</email>
 	  </address>
 	</affiliation> -->
 	<contrib>Original author of the V4L2 API and
 documentation.</contrib>
       </author>
       <author>
 	<firstname>Hans</firstname>
 	<surname>Verkuil</surname>
 	<contrib>Designed and documented the VIDIOC_LOG_STATUS ioctl,
 the extended control ioctls and major parts of the sliced VBI
 API.</contrib>
 	<affiliation>
 	  <address>
 	    <email>hverkuil@xs4all.nl</email>
 	  </address>
 	</affiliation>
       </author>
       <author>
 	<firstname>Martin</firstname>
 	<surname>Rubli</surname>
 	<!--
 	<affiliation>
 	  <address>
 	    <email>martin_rubli@logitech.com</email>
 	  </address>
 	</affiliation> -->
 	<contrib>Designed and documented the VIDIOC_ENUM_FRAMESIZES
 and VIDIOC_ENUM_FRAMEINTERVALS ioctls.</contrib>
       </author>
       <author>
 	<firstname>Andy</firstname>
 	<surname>Walls</surname>
 	<contrib>Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV
 MPEG stream embedded, sliced VBI data format in this specification.
 </contrib>
 	<affiliation>
 	  <address>
 	    <email>awalls@md.metrocast.net</email>
 	  </address>
 	</affiliation>
       </author>
       <author>
 	<firstname>Mauro</firstname>
 	<surname>Carvalho Chehab</surname>
 	<contrib>Documented libv4l, designed and added v4l2grab example,
 Remote Controller chapter.</contrib>
 	<affiliation>
 	  <address>
 	    <email>mchehab@redhat.com</email>
 	  </address>
 	</affiliation>
       </author>
       <author>
 	<firstname>Muralidharan</firstname>
 	<surname>Karicheri</surname>
 	<contrib>Documented the Digital Video timings API.</contrib>
 	<affiliation>
 	  <address>
 	    <email>m-karicheri2@ti.com</email>
 	  </address>
 	</affiliation>
       </author>
       <author>
       	<firstname>Pawel</firstname>
 	<surname>Osciak</surname>
 	<contrib>Designed and documented the multi-planar API.</contrib>
 	<affiliation>
 	  <address>
 	    <email>pawel AT osciak.com</email>
 	  </address>
 	</affiliation>
       </author>
     </authorgroup>
     <copyright>
       <year>1999</year>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
 Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
 	Pawel Osciak</holder>
     </copyright>
     <legalnotice>
     <para>Except when explicitly stated as GPL, programming examples within
 	    this part can be used and distributed without restrictions.</para>
     </legalnotice>
     <revhistory>
       <!-- Put document revisions here, newest first. -->
       <!-- API revisions (changes and additions of defines, enums,
 structs, ioctls) must be noted in more detail in the history chapter
 (compat.xml), along with the possible impact on existing drivers and
 applications. -->
       <revision>
 	<revnumber>2.6.39</revnumber>
 	<date>2011-03-01</date>
 	<authorinitials>mcc</authorinitials>
 	<revremark>Removed VIDIOC_*_OLD from videodev2.h header and update it to reflect latest changes.
 	</revremark>
       </revision>
       <revision>
 	<revnumber>2.6.38</revnumber>
 	<date>2011-01-16</date>
 	<authorinitials>po</authorinitials>
 	<revremark>Added the <link linkend="planar-apis">multi-planar API</link>.
 	</revremark>
       </revision>
       <revision>
 	<revnumber>2.6.37</revnumber>
 	<date>2010-08-06</date>
 	<authorinitials>hv</authorinitials>
 	<revremark>Removed obsolete vtx (videotext) API.</revremark>
       </revision>
       <revision>
 	<revnumber>2.6.33</revnumber>
 	<date>2009-12-03</date>
 	<authorinitials>mk</authorinitials>
 	<revremark>Added documentation for the Digital Video timings API.</revremark>
       </revision>
       <revision>
 	<revnumber>2.6.32</revnumber>
 	<date>2009-08-31</date>
 	<authorinitials>mcc</authorinitials>
 	<revremark>Now, revisions will match the kernel version where
 the V4L2 API changes will be used by the Linux Kernel.
 Also added Remote Controller chapter.</revremark>
       </revision>
       <revision>
 	<revnumber>0.29</revnumber>
 	<date>2009-08-26</date>
 	<authorinitials>ev</authorinitials>
 	<revremark>Added documentation for string controls and for FM Transmitter controls.</revremark>
       </revision>
       <revision>
 	<revnumber>0.28</revnumber>
 	<date>2009-08-26</date>
 	<authorinitials>gl</authorinitials>
 	<revremark>Added V4L2_CID_BAND_STOP_FILTER documentation.</revremark>
       </revision>
       <revision>
 	<revnumber>0.27</revnumber>
 	<date>2009-08-15</date>
 	<authorinitials>mcc</authorinitials>
 	<revremark>Added libv4l and Remote Controller documentation;
 added v4l2grab and keytable application examples.</revremark>
       </revision>
       <revision>
 	<revnumber>0.26</revnumber>
 	<date>2009-07-23</date>
 	<authorinitials>hv</authorinitials>
 	<revremark>Finalized the RDS capture API. Added modulator and RDS encoder
 capabilities. Added support for string controls.</revremark>
       </revision>
       <revision>
 	<revnumber>0.25</revnumber>
 	<date>2009-01-18</date>
 	<authorinitials>hv</authorinitials>
 	<revremark>Added pixel formats VYUY, NV16 and NV61, and changed
 the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT.
 Added camera controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE,
 V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY.</revremark>
       </revision>
       <revision>
 	<revnumber>0.24</revnumber>
 	<date>2008-03-04</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Added pixel formats Y16 and SBGGR16, new controls
 and a camera controls class. Removed VIDIOC_G/S_MPEGCOMP.</revremark>
       </revision>
       <revision>
 	<revnumber>0.23</revnumber>
 	<date>2007-08-30</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Fixed a typo in VIDIOC_DBG_G/S_REGISTER.
 Clarified the byte order of packed pixel formats.</revremark>
       </revision>
       <revision>
 	<revnumber>0.22</revnumber>
 	<date>2007-08-29</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Added the Video Output Overlay interface, new MPEG
 controls, V4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT,
 VIDIOC_DBG_G/S_REGISTER, VIDIOC_(TRY_)ENCODER_CMD,
 VIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats.
 Clarifications in the cropping chapter, about RGB pixel formats, the
 mmap(), poll(), select(), read() and write() functions. Typographical
 fixes.</revremark>
       </revision>
       <revision>
 	<revnumber>0.21</revnumber>
 	<date>2006-12-19</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Fixed a link in the VIDIOC_G_EXT_CTRLS section.</revremark>
       </revision>
       <revision>
 	<revnumber>0.20</revnumber>
 	<date>2006-11-24</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Clarified the purpose of the audioset field in
 struct v4l2_input and v4l2_output.</revremark>
       </revision>
       <revision>
 	<revnumber>0.19</revnumber>
 	<date>2006-10-19</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Documented V4L2_PIX_FMT_RGB444.</revremark>
       </revision>
       <revision>
 	<revnumber>0.18</revnumber>
 	<date>2006-10-18</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Added the description of extended controls by Hans
 Verkuil. Linked V4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE.</revremark>
       </revision>
       <revision>
 	<revnumber>0.17</revnumber>
 	<date>2006-10-12</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Corrected V4L2_PIX_FMT_HM12 description.</revremark>
       </revision>
       <revision>
 	<revnumber>0.16</revnumber>
 	<date>2006-10-08</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>VIDIOC_ENUM_FRAMESIZES and
 VIDIOC_ENUM_FRAMEINTERVALS are now part of the API.</revremark>
       </revision>
       <revision>
 	<revnumber>0.15</revnumber>
 	<date>2006-09-23</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Cleaned up the bibliography, added BT.653 and
 BT.1119. capture.c/start_capturing() for user pointer I/O did not
 initialize the buffer index. Documented the V4L MPEG and MJPEG
 VID_TYPEs and V4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel
 formats. See the history chapter for API changes.</revremark>
       </revision>
       <revision>
 	<revnumber>0.14</revnumber>
 	<date>2006-09-14</date>
 	<authorinitials>mr</authorinitials>
 	<revremark>Added VIDIOC_ENUM_FRAMESIZES and
 VIDIOC_ENUM_FRAMEINTERVALS proposal for frame format enumeration of
 digital devices.</revremark>
       </revision>
       <revision>
 	<revnumber>0.13</revnumber>
 	<date>2006-04-07</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Corrected the description of struct v4l2_window
 clips. New V4L2_STD_ and V4L2_TUNER_MODE_LANG1_LANG2
 defines.</revremark>
       </revision>
       <revision>
 	<revnumber>0.12</revnumber>
 	<date>2006-02-03</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Corrected the description of struct
 v4l2_captureparm and v4l2_outputparm.</revremark>
       </revision>
       <revision>
 	<revnumber>0.11</revnumber>
 	<date>2006-01-27</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Improved the description of struct
 v4l2_tuner.</revremark>
       </revision>
       <revision>
 	<revnumber>0.10</revnumber>
 	<date>2006-01-10</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>VIDIOC_G_INPUT and VIDIOC_S_PARM
 clarifications.</revremark>
       </revision>
       <revision>
 	<revnumber>0.9</revnumber>
 	<date>2005-11-27</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Improved the 525 line numbering diagram. Hans
 Verkuil and I rewrote the sliced VBI section. He also contributed a
 VIDIOC_LOG_STATUS page. Fixed VIDIOC_S_STD call in the video standard
 selection example. Various updates.</revremark>
       </revision>
       <revision>
 	<revnumber>0.8</revnumber>
 	<date>2004-10-04</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Somehow a piece of junk slipped into the capture
 example, removed.</revremark>
       </revision>
       <revision>
 	<revnumber>0.7</revnumber>
 	<date>2004-09-19</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Fixed video standard selection, control
 enumeration, downscaling and aspect example. Added read and user
 pointer i/o to video capture example.</revremark>
       </revision>
       <revision>
 	<revnumber>0.6</revnumber>
 	<date>2004-08-01</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>v4l2_buffer changes, added video capture example,
 various corrections.</revremark>
       </revision>
       <revision>
 	<revnumber>0.5</revnumber>
 	<date>2003-11-05</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Pixel format erratum.</revremark>
       </revision>
       <revision>
 	<revnumber>0.4</revnumber>
 	<date>2003-09-17</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Corrected source and Makefile to generate a PDF.
 SGML fixes. Added latest API changes. Closed gaps in the history
 chapter.</revremark>
       </revision>
       <revision>
 	<revnumber>0.3</revnumber>
 	<date>2003-02-05</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Another draft, more corrections.</revremark>
       </revision>
       <revision>
 	<revnumber>0.2</revnumber>
 	<date>2003-01-15</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>Second draft, with corrections pointed out by Gerd
 Knorr.</revremark>
       </revision>
       <revision>
 	<revnumber>0.1</revnumber>
 	<date>2002-12-01</date>
 	<authorinitials>mhs</authorinitials>
 	<revremark>First draft, based on documentation by Bill Dirks
 and discussions on the V4L mailing list.</revremark>
       </revision>
     </revhistory>
 </partinfo>
 <title>Video for Linux Two API Specification</title>
  <subtitle>Revision 2.6.38</subtitle>
   <chapter id="common">
     &sub-common;
   </chapter>
   <chapter id="pixfmt">
     &sub-pixfmt;
   </chapter>
   <chapter id="io">
     &sub-io;
   </chapter>
   <chapter id="devices">
     <title>Interfaces</title>
     <section id="capture"> &sub-dev-capture; </section>
     <section id="overlay"> &sub-dev-overlay; </section>
     <section id="output"> &sub-dev-output; </section>
     <section id="osd"> &sub-dev-osd; </section>
     <section id="codec"> &sub-dev-codec; </section>
     <section id="effect"> &sub-dev-effect; </section>
     <section id="raw-vbi"> &sub-dev-raw-vbi; </section>
     <section id="sliced"> &sub-dev-sliced-vbi; </section>
     <section id="ttx"> &sub-dev-teletext; </section>
     <section id="radio"> &sub-dev-radio; </section>
     <section id="rds"> &sub-dev-rds; </section>
     <section id="event"> &sub-dev-event; </section>
     <section id="subdev"> &sub-dev-subdev; </section>
   </chapter>
   <chapter id="driver">
 	  &sub-driver;
   </chapter>
   <chapter id="libv4l">
 	  &sub-libv4l;
   </chapter>
   <chapter id="compat">
 	  &sub-compat;
   </chapter>
   <appendix id="user-func">
   <title>Function Reference</title>
     <!-- Keep this alphabetically sorted. -->
     &sub-close;
     &sub-ioctl;
     <!-- All ioctls go here. -->
     &sub-cropcap;
     &sub-dbg-g-chip-ident;
     &sub-dbg-g-register;
     &sub-dqevent;
     &sub-encoder-cmd;
     &sub-enumaudio;
     &sub-enumaudioout;
     &sub-enum-dv-presets;
     &sub-enum-fmt;
     &sub-enum-framesizes;
     &sub-enum-frameintervals;
     &sub-enuminput;
     &sub-enumoutput;
     &sub-enumstd;
     &sub-g-audio;
     &sub-g-audioout;
     &sub-g-crop;
     &sub-g-ctrl;
     &sub-g-dv-preset;
     &sub-g-dv-timings;
     &sub-g-enc-index;
     &sub-g-ext-ctrls;
     &sub-g-fbuf;
     &sub-g-fmt;
     &sub-g-frequency;
     &sub-g-input;
     &sub-g-jpegcomp;
     &sub-g-modulator;
     &sub-g-output;
     &sub-g-parm;
     &sub-g-priority;
     &sub-g-sliced-vbi-cap;
     &sub-g-std;
     &sub-g-tuner;
     &sub-log-status;
     &sub-overlay;
     &sub-qbuf;
     &sub-querybuf;
     &sub-querycap;
     &sub-queryctrl;
     &sub-query-dv-preset;
     &sub-querystd;
     &sub-reqbufs;
     &sub-s-hw-freq-seek;
     &sub-streamon;
+    &sub-subdev-enum-frame-interval;
     &sub-subdev-enum-frame-size;
     &sub-subdev-enum-mbus-code;
     &sub-subdev-g-fmt;
+    &sub-subdev-g-frame-interval;
     &sub-subscribe-event;
     <!-- End of ioctls. -->
     &sub-mmap;
     &sub-munmap;
     &sub-open;
     &sub-poll;
     &sub-read;
     &sub-select;
     &sub-write;
   </appendix>
   <appendix id="videodev">
     <title>Video For Linux Two Header File</title>
     &sub-videodev2-h;
   </appendix>
   <appendix id="capture-example">
     <title>Video Capture Example</title>
     &sub-capture-c;
   </appendix>
   <appendix id="v4l2grab-example">
     <title>Video Grabber example using libv4l</title>
     <para>This program demonstrates how to grab V4L2 images in ppm format by
 using libv4l handlers. The advantage is that this grabber can potentially work
 with any V4L2 driver.</para>
     &sub-v4l2grab-c;
   </appendix>
   &sub-media-indices;
   &sub-biblio;

Documentation/DocBook/v4l/vidioc-subdev-enum-frame-interval.xml

Diff comments View file @ 35c3017

File was created	1	<refentry id="vidioc-subdev-enum-frame-interval">
	2	<refmeta>
	3	<refentrytitle>ioctl VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</refentrytitle>
	4	&manvol;
	5	</refmeta>
	6
	7	<refnamediv>
	8	<refname>VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</refname>
	9	<refpurpose>Enumerate frame intervals</refpurpose>
	10	</refnamediv>
	11
	12	<refsynopsisdiv>
	13	<funcsynopsis>
	14	<funcprototype>
	15	<funcdef>int <function>ioctl</function></funcdef>
	16	<paramdef>int <parameter>fd</parameter></paramdef>
	17	<paramdef>int <parameter>request</parameter></paramdef>
	18	<paramdef>struct v4l2_subdev_frame_interval_enum *
	19	<parameter>argp</parameter></paramdef>
	20	</funcprototype>
	21	</funcsynopsis>
	22	</refsynopsisdiv>
	23
	24	<refsect1>
	25	<title>Arguments</title>
	26
	27	<variablelist>
	28	<varlistentry>
	29	<term><parameter>fd</parameter></term>
	30	<listitem>
	31	<para>&fd;</para>
	32	</listitem>
	33	</varlistentry>
	34	<varlistentry>
	35	<term><parameter>request</parameter></term>
	36	<listitem>
	37	<para>VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</para>
	38	</listitem>
	39	</varlistentry>
	40	<varlistentry>
	41	<term><parameter>argp</parameter></term>
	42	<listitem>
	43	<para></para>
	44	</listitem>
	45	</varlistentry>
	46	</variablelist>
	47	</refsect1>
	48
	49	<refsect1>
	50	<title>Description</title>
	51
	52	<note>
	53	<title>Experimental</title>
	54	<para>This is an <link linkend="experimental">experimental</link>
	55	interface and may change in the future.</para>
	56	</note>
	57
	58	<para>This ioctl lets applications enumerate available frame intervals on a
	59	given sub-device pad. Frame intervals only makes sense for sub-devices that
	60	can control the frame period on their own. This includes, for instance,
	61	image sensors and TV tuners.</para>
	62
	63	<para>For the common use case of image sensors, the frame intervals
	64	available on the sub-device output pad depend on the frame format and size
	65	on the same pad. Applications must thus specify the desired format and size
	66	when enumerating frame intervals.</para>
	67
	68	<para>To enumerate frame intervals applications initialize the
	69	<structfield>index</structfield>, <structfield>pad</structfield>,
	70	<structfield>code</structfield>, <structfield>width</structfield> and
	71	<structfield>height</structfield> fields of
	72	&v4l2-subdev-frame-interval-enum; and call the
	73	<constant>VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</constant> ioctl with a pointer
	74	to this structure. Drivers fill the rest of the structure or return
	75	an &EINVAL; if one of the input fields is invalid. All frame intervals are
	76	enumerable by beginning at index zero and incrementing by one until
	77	<errorcode>EINVAL</errorcode> is returned.</para>
	78
	79	<para>Available frame intervals may depend on the current 'try' formats
	80	at other pads of the sub-device, as well as on the current active links. See
	81	&VIDIOC-SUBDEV-G-FMT; for more information about the try formats.</para>
	82
	83	<para>Sub-devices that support the frame interval enumeration ioctl should
	84	implemented it on a single pad only. Its behaviour when supported on
	85	multiple pads of the same sub-device is not defined.</para>
	86
	87	<table pgwide="1" frame="none" id="v4l2-subdev-frame-interval-enum">
	88	<title>struct <structname>v4l2_subdev_frame_interval_enum</structname></title>
	89	<tgroup cols="3">
	90	&cs-str;
	91	<tbody valign="top">
	92	<row>
	93	<entry>__u32</entry>
	94	<entry><structfield>index</structfield></entry>
	95	<entry>Number of the format in the enumeration, set by the
	96	application.</entry>
	97	</row>
	98	<row>
	99	<entry>__u32</entry>
	100	<entry><structfield>pad</structfield></entry>
	101	<entry>Pad number as reported by the media controller API.</entry>
	102	</row>
	103	<row>
	104	<entry>__u32</entry>
	105	<entry><structfield>code</structfield></entry>
	106	<entry>The media bus format code, as defined in
	107	<xref linkend="v4l2-mbus-format" />.</entry>
	108	</row>
	109	<row>
	110	<entry>__u32</entry>
	111	<entry><structfield>width</structfield></entry>
	112	<entry>Frame width, in pixels.</entry>
	113	</row>
	114	<row>
	115	<entry>__u32</entry>
	116	<entry><structfield>height</structfield></entry>
	117	<entry>Frame height, in pixels.</entry>
	118	</row>
	119	<row>
	120	<entry>&v4l2-fract;</entry>
	121	<entry><structfield>interval</structfield></entry>
	122	<entry>Period, in seconds, between consecutive video frames.</entry>
	123	</row>
	124	<row>
	125	<entry>__u32</entry>
	126	<entry><structfield>reserved</structfield>[9]</entry>
	127	<entry>Reserved for future extensions. Applications and drivers must
	128	set the array to zero.</entry>
	129	</row>
	130	</tbody>
	131	</tgroup>
	132	</table>
	133	</refsect1>
	134
	135	<refsect1>
	136	&return-value;
	137
	138	<variablelist>
	139	<varlistentry>
	140	<term><errorcode>EINVAL</errorcode></term>
	141	<listitem>
	142	<para>The &v4l2-subdev-frame-interval-enum;
	143	<structfield>pad</structfield> references a non-existing pad, one of
	144	the <structfield>code</structfield>, <structfield>width</structfield>
	145	or <structfield>height</structfield> fields are invalid for the given
	146	pad or the <structfield>index</structfield> field is out of bounds.
	147	</para>
	148	</listitem>
	149	</varlistentry>
	150	</variablelist>
	151	</refsect1>
	152	</refentry>
	153

Documentation/DocBook/v4l/vidioc-subdev-g-frame-interval.xml

Diff comments View file @ 35c3017

File was created	1	<refentry id="vidioc-subdev-g-frame-interval">
	2	<refmeta>
	3	<refentrytitle>ioctl VIDIOC_SUBDEV_G_FRAME_INTERVAL, VIDIOC_SUBDEV_S_FRAME_INTERVAL</refentrytitle>
	4	&manvol;
	5	</refmeta>
	6
	7	<refnamediv>
	8	<refname>VIDIOC_SUBDEV_G_FRAME_INTERVAL</refname>
	9	<refname>VIDIOC_SUBDEV_S_FRAME_INTERVAL</refname>
	10	<refpurpose>Get or set the frame interval on a subdev pad</refpurpose>
	11	</refnamediv>
	12
	13	<refsynopsisdiv>
	14	<funcsynopsis>
	15	<funcprototype>
	16	<funcdef>int <function>ioctl</function></funcdef>
	17	<paramdef>int <parameter>fd</parameter></paramdef>
	18	<paramdef>int <parameter>request</parameter></paramdef>
	19	<paramdef>struct v4l2_subdev_frame_interval *<parameter>argp</parameter>
	20	</paramdef>
	21	</funcprototype>
	22	</funcsynopsis>
	23	</refsynopsisdiv>
	24
	25	<refsect1>
	26	<title>Arguments</title>
	27
	28	<variablelist>
	29	<varlistentry>
	30	<term><parameter>fd</parameter></term>
	31	<listitem>
	32	<para>&fd;</para>
	33	</listitem>
	34	</varlistentry>
	35	<varlistentry>
	36	<term><parameter>request</parameter></term>
	37	<listitem>
	38	<para>VIDIOC_SUBDEV_G_FRAME_INTERVAL, VIDIOC_SUBDEV_S_FRAME_INTERVAL</para>
	39	</listitem>
	40	</varlistentry>
	41	<varlistentry>
	42	<term><parameter>argp</parameter></term>
	43	<listitem>
	44	<para></para>
	45	</listitem>
	46	</varlistentry>
	47	</variablelist>
	48	</refsect1>
	49
	50	<refsect1>
	51	<title>Description</title>
	52
	53	<note>
	54	<title>Experimental</title>
	55	<para>This is an <link linkend="experimental">experimental</link>
	56	interface and may change in the future.</para>
	57	</note>
	58
	59	<para>These ioctls are used to get and set the frame interval at specific
	60	subdev pads in the image pipeline. The frame interval only makes sense for
	61	sub-devices that can control the frame period on their own. This includes,
	62	for instance, image sensors and TV tuners. Sub-devices that don't support
	63	frame intervals must not implement these ioctls.</para>
	64
	65	<para>To retrieve the current frame interval applications set the
	66	<structfield>pad</structfield> field of a &v4l2-subdev-frame-interval; to
	67	the desired pad number as reported by the media controller API. When they
	68	call the <constant>VIDIOC_SUBDEV_G_FRAME_INTERVAL</constant> ioctl with a
	69	pointer to this structure the driver fills the members of the
	70	<structfield>interval</structfield> field.</para>
	71
	72	<para>To change the current frame interval applications set both the
	73	<structfield>pad</structfield> field and all members of the
	74	<structfield>interval</structfield> field. When they call the
	75	<constant>VIDIOC_SUBDEV_S_FRAME_INTERVAL</constant> ioctl with a pointer to
	76	this structure the driver verifies the requested interval, adjusts it based
	77	on the hardware capabilities and configures the device. Upon return the
	78	&v4l2-subdev-frame-interval; contains the current frame interval as would be
	79	returned by a <constant>VIDIOC_SUBDEV_G_FRAME_INTERVAL</constant> call.
	80	</para>
	81
	82	<para>Drivers must not return an error solely because the requested interval
	83	doesn't match the device capabilities. They must instead modify the interval
	84	to match what the hardware can provide. The modified interval should be as
	85	close as possible to the original request.</para>
	86
	87	<para>Sub-devices that support the frame interval ioctls should implement
	88	them on a single pad only. Their behaviour when supported on multiple pads
	89	of the same sub-device is not defined.</para>
	90
	91	<table pgwide="1" frame="none" id="v4l2-subdev-frame-interval">
	92	<title>struct <structname>v4l2_subdev_frame_interval</structname></title>
	93	<tgroup cols="3">
	94	&cs-str;
	95	<tbody valign="top">
	96	<row>
	97	<entry>__u32</entry>
	98	<entry><structfield>pad</structfield></entry>
	99	<entry>Pad number as reported by the media controller API.</entry>
	100	</row>
	101	<row>
	102	<entry>&v4l2-fract;</entry>
	103	<entry><structfield>interval</structfield></entry>
	104	<entry>Period, in seconds, between consecutive video frames.</entry>
	105	</row>
	106	<row>
	107	<entry>__u32</entry>
	108	<entry><structfield>reserved</structfield>[9]</entry>
	109	<entry>Reserved for future extensions. Applications and drivers must
	110	set the array to zero.</entry>
	111	</row>
	112	</tbody>
	113	</tgroup>
	114	</table>
	115	</refsect1>
	116
	117	<refsect1>
	118	&return-value;
	119
	120	<variablelist>
	121	<varlistentry>
	122	<term><errorcode>EBUSY</errorcode></term>
	123	<listitem>
	124	<para>The frame interval can't be changed because the pad is currently
	125	busy. This can be caused, for instance, by an active video stream on
	126	the pad. The ioctl must not be retried without performing another
	127	action to fix the problem first. Only returned by
	128	<constant>VIDIOC_SUBDEV_S_FRAME_INTERVAL</constant></para>
	129	</listitem>
	130	</varlistentry>
	131	<varlistentry>
	132	<term><errorcode>EINVAL</errorcode></term>
	133	<listitem>
	134	<para>The &v4l2-subdev-frame-interval; <structfield>pad</structfield>
	135	references a non-existing pad, or the pad doesn't support frame
	136	intervals.</para>
	137	</listitem>
	138	</varlistentry>
	139	</variablelist>
	140	</refsect1>
	141	</refentry>
	142

drivers/media/video/v4l2-subdev.c

Diff comments View file @ 35c3017

 /*
  * V4L2 sub-device
  *
  * Copyright (C) 2010 Nokia Corporation
  *
  * Contact: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  *	    Sakari Ailus <sakari.ailus@iki.fi>
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 #include <linux/ioctl.h>
 #include <linux/slab.h>
 #include <linux/types.h>
 #include <linux/videodev2.h>
 #include <media/v4l2-ctrls.h>
 #include <media/v4l2-device.h>
 #include <media/v4l2-ioctl.h>
 #include <media/v4l2-fh.h>
 #include <media/v4l2-event.h>
 static int subdev_fh_init(struct v4l2_subdev_fh *fh, struct v4l2_subdev *sd)
 {
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 	/* Allocate try format and crop in the same memory block */
 	fh->try_fmt = kzalloc((sizeof(*fh->try_fmt) + sizeof(*fh->try_crop))
 			      * sd->entity.num_pads, GFP_KERNEL);
 	if (fh->try_fmt == NULL)
 		return -ENOMEM;
 	fh->try_crop = (struct v4l2_rect *)
 		(fh->try_fmt + sd->entity.num_pads);
 #endif
 	return 0;
 }
 static void subdev_fh_free(struct v4l2_subdev_fh *fh)
 {
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 	kfree(fh->try_fmt);
 	fh->try_fmt = NULL;
 	fh->try_crop = NULL;
 #endif
 }
 static int subdev_open(struct file *file)
 {
 	struct video_device *vdev = video_devdata(file);
 	struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 	struct v4l2_subdev_fh *subdev_fh;
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	struct media_entity *entity = NULL;
 #endif
 	int ret;
 	subdev_fh = kzalloc(sizeof(*subdev_fh), GFP_KERNEL);
 	if (subdev_fh == NULL)
 		return -ENOMEM;
 	ret = subdev_fh_init(subdev_fh, sd);
 	if (ret) {
 		kfree(subdev_fh);
 		return ret;
 	}
 	ret = v4l2_fh_init(&subdev_fh->vfh, vdev);
 	if (ret)
 		goto err;
 	if (sd->flags & V4L2_SUBDEV_FL_HAS_EVENTS) {
 		ret = v4l2_event_init(&subdev_fh->vfh);
 		if (ret)
 			goto err;
 		ret = v4l2_event_alloc(&subdev_fh->vfh, sd->nevents);
 		if (ret)
 			goto err;
 	}
 	v4l2_fh_add(&subdev_fh->vfh);
 	file->private_data = &subdev_fh->vfh;
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	if (sd->v4l2_dev->mdev) {
 		entity = media_entity_get(&sd->entity);
 		if (!entity) {
 			ret = -EBUSY;
 			goto err;
 		}
 	}
 #endif
 	if (sd->internal_ops && sd->internal_ops->open) {
 		ret = sd->internal_ops->open(sd, subdev_fh);
 		if (ret < 0)
 			goto err;
 	}
 	return 0;
 err:
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	if (entity)
 		media_entity_put(entity);
 #endif
 	v4l2_fh_del(&subdev_fh->vfh);
 	v4l2_fh_exit(&subdev_fh->vfh);
 	subdev_fh_free(subdev_fh);
 	kfree(subdev_fh);
 	return ret;
 }
 static int subdev_close(struct file *file)
 {
 	struct video_device *vdev = video_devdata(file);
 	struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 	struct v4l2_fh *vfh = file->private_data;
 	struct v4l2_subdev_fh *subdev_fh = to_v4l2_subdev_fh(vfh);
 	if (sd->internal_ops && sd->internal_ops->close)
 		sd->internal_ops->close(sd, subdev_fh);
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	if (sd->v4l2_dev->mdev)
 		media_entity_put(&sd->entity);
 #endif
 	v4l2_fh_del(vfh);
 	v4l2_fh_exit(vfh);
 	subdev_fh_free(subdev_fh);
 	kfree(subdev_fh);
 	file->private_data = NULL;
 	return 0;
 }
 static long subdev_do_ioctl(struct file *file, unsigned int cmd, void *arg)
 {
 	struct video_device *vdev = video_devdata(file);
 	struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 	struct v4l2_fh *vfh = file->private_data;
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 	struct v4l2_subdev_fh *subdev_fh = to_v4l2_subdev_fh(vfh);
 #endif
 	switch (cmd) {
 	case VIDIOC_QUERYCTRL:
 		return v4l2_subdev_queryctrl(sd, arg);
 	case VIDIOC_QUERYMENU:
 		return v4l2_subdev_querymenu(sd, arg);
 	case VIDIOC_G_CTRL:
 		return v4l2_subdev_g_ctrl(sd, arg);
 	case VIDIOC_S_CTRL:
 		return v4l2_subdev_s_ctrl(sd, arg);
 	case VIDIOC_G_EXT_CTRLS:
 		return v4l2_subdev_g_ext_ctrls(sd, arg);
 	case VIDIOC_S_EXT_CTRLS:
 		return v4l2_subdev_s_ext_ctrls(sd, arg);
 	case VIDIOC_TRY_EXT_CTRLS:
 		return v4l2_subdev_try_ext_ctrls(sd, arg);
 	case VIDIOC_DQEVENT:
 		if (!(sd->flags & V4L2_SUBDEV_FL_HAS_EVENTS))
 			return -ENOIOCTLCMD;
 		return v4l2_event_dequeue(vfh, arg, file->f_flags & O_NONBLOCK);
 	case VIDIOC_SUBSCRIBE_EVENT:
 		return v4l2_subdev_call(sd, core, subscribe_event, vfh, arg);
 	case VIDIOC_UNSUBSCRIBE_EVENT:
 		return v4l2_subdev_call(sd, core, unsubscribe_event, vfh, arg);
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 	case VIDIOC_SUBDEV_G_FMT: {
 		struct v4l2_subdev_format *format = arg;
 		if (format->which != V4L2_SUBDEV_FORMAT_TRY &&
 		    format->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 			return -EINVAL;
 		if (format->pad >= sd->entity.num_pads)
 			return -EINVAL;
 		return v4l2_subdev_call(sd, pad, get_fmt, subdev_fh, format);
 	}
 	case VIDIOC_SUBDEV_S_FMT: {
 		struct v4l2_subdev_format *format = arg;
 		if (format->which != V4L2_SUBDEV_FORMAT_TRY &&
 		    format->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 			return -EINVAL;
 		if (format->pad >= sd->entity.num_pads)
 			return -EINVAL;
 		return v4l2_subdev_call(sd, pad, set_fmt, subdev_fh, format);
 	}
 	case VIDIOC_SUBDEV_ENUM_MBUS_CODE: {
 		struct v4l2_subdev_mbus_code_enum *code = arg;
 		if (code->pad >= sd->entity.num_pads)
 			return -EINVAL;
 		return v4l2_subdev_call(sd, pad, enum_mbus_code, subdev_fh,
 					code);
 	}
 	case VIDIOC_SUBDEV_ENUM_FRAME_SIZE: {
 		struct v4l2_subdev_frame_size_enum *fse = arg;
 		if (fse->pad >= sd->entity.num_pads)
 			return -EINVAL;
 		return v4l2_subdev_call(sd, pad, enum_frame_size, subdev_fh,
 					fse);
 	}
+	case VIDIOC_SUBDEV_G_FRAME_INTERVAL:
+		return v4l2_subdev_call(sd, video, g_frame_interval, arg);
+	case VIDIOC_SUBDEV_S_FRAME_INTERVAL:
+		return v4l2_subdev_call(sd, video, s_frame_interval, arg);
+	case VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL: {
+		struct v4l2_subdev_frame_interval_enum *fie = arg;
+		if (fie->pad >= sd->entity.num_pads)
+			return -EINVAL;
+		return v4l2_subdev_call(sd, pad, enum_frame_interval, subdev_fh,
+					fie);
+	}
 #endif
 	default:
 		return -ENOIOCTLCMD;
 	}
 	return 0;
 }
 static long subdev_ioctl(struct file *file, unsigned int cmd,
 	unsigned long arg)
 {
 	return video_usercopy(file, cmd, arg, subdev_do_ioctl);
 }
 static unsigned int subdev_poll(struct file *file, poll_table *wait)
 {
 	struct video_device *vdev = video_devdata(file);
 	struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 	struct v4l2_fh *fh = file->private_data;
 	if (!(sd->flags & V4L2_SUBDEV_FL_HAS_EVENTS))
 		return POLLERR;
 	poll_wait(file, &fh->events->wait, wait);
 	if (v4l2_event_pending(fh))
 		return POLLPRI;
 	return 0;
 }
 const struct v4l2_file_operations v4l2_subdev_fops = {
 	.owner = THIS_MODULE,
 	.open = subdev_open,
 	.unlocked_ioctl = subdev_ioctl,
 	.release = subdev_close,
 	.poll = subdev_poll,
 };
 void v4l2_subdev_init(struct v4l2_subdev *sd, const struct v4l2_subdev_ops *ops)
 {
 	INIT_LIST_HEAD(&sd->list);
 	BUG_ON(!ops);
 	sd->ops = ops;
 	sd->v4l2_dev = NULL;
 	sd->flags = 0;
 	sd->name[0] = '\0';
 	sd->grp_id = 0;
 	sd->dev_priv = NULL;
 	sd->host_priv = NULL;
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	sd->entity.name = sd->name;
 	sd->entity.type = MEDIA_ENT_T_V4L2_SUBDEV;
 #endif
 }
 EXPORT_SYMBOL(v4l2_subdev_init);

include/linux/v4l2-subdev.h

Diff comments View file @ 35c3017

 /*
  * V4L2 subdev userspace API
  *
  * Copyright (C) 2010 Nokia Corporation
  *
  * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  *	     Sakari Ailus <sakari.ailus@iki.fi>
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 #ifndef __LINUX_V4L2_SUBDEV_H
 #define __LINUX_V4L2_SUBDEV_H
 #include <linux/ioctl.h>
 #include <linux/types.h>
 #include <linux/v4l2-mediabus.h>
 /**
  * enum v4l2_subdev_format_whence - Media bus format type
  * @V4L2_SUBDEV_FORMAT_TRY: try format, for negotiation only
  * @V4L2_SUBDEV_FORMAT_ACTIVE: active format, applied to the device
  */
 enum v4l2_subdev_format_whence {
 	V4L2_SUBDEV_FORMAT_TRY = 0,
 	V4L2_SUBDEV_FORMAT_ACTIVE = 1,
 };
 /**
  * struct v4l2_subdev_format - Pad-level media bus format
  * @which: format type (from enum v4l2_subdev_format_whence)
  * @pad: pad number, as reported by the media API
  * @format: media bus format (format code and frame size)
  */
 struct v4l2_subdev_format {
 	__u32 which;
 	__u32 pad;
 	struct v4l2_mbus_framefmt format;
 	__u32 reserved[8];
 };
 /**
  * struct v4l2_subdev_mbus_code_enum - Media bus format enumeration
  * @pad: pad number, as reported by the media API
  * @index: format index during enumeration
  * @code: format code (from enum v4l2_mbus_pixelcode)
  */
 struct v4l2_subdev_mbus_code_enum {
 	__u32 pad;
 	__u32 index;
 	__u32 code;
 	__u32 reserved[9];
 };
 /**
  * struct v4l2_subdev_frame_size_enum - Media bus format enumeration
  * @pad: pad number, as reported by the media API
  * @index: format index during enumeration
  * @code: format code (from enum v4l2_mbus_pixelcode)
  */
 struct v4l2_subdev_frame_size_enum {
 	__u32 index;
 	__u32 pad;
 	__u32 code;
 	__u32 min_width;
 	__u32 max_width;
 	__u32 min_height;
 	__u32 max_height;
 	__u32 reserved[9];
 };
+/**
+ * struct v4l2_subdev_frame_interval - Pad-level frame rate
+ * @pad: pad number, as reported by the media API
+ * @interval: frame interval in seconds
+ */
+struct v4l2_subdev_frame_interval {
+	__u32 pad;
+	struct v4l2_fract interval;
+	__u32 reserved[9];
+};
+/**
+ * struct v4l2_subdev_frame_interval_enum - Frame interval enumeration
+ * @pad: pad number, as reported by the media API
+ * @index: frame interval index during enumeration
+ * @code: format code (from enum v4l2_mbus_pixelcode)
+ * @width: frame width in pixels
+ * @height: frame height in pixels
+ * @interval: frame interval in seconds
+ */
+struct v4l2_subdev_frame_interval_enum {
+	__u32 index;
+	__u32 pad;
+	__u32 code;
+	__u32 width;
+	__u32 height;
+	struct v4l2_fract interval;
+	__u32 reserved[9];
+};
 #define VIDIOC_SUBDEV_G_FMT	_IOWR('V',  4, struct v4l2_subdev_format)
 #define VIDIOC_SUBDEV_S_FMT	_IOWR('V',  5, struct v4l2_subdev_format)
+#define VIDIOC_SUBDEV_G_FRAME_INTERVAL \
+			_IOWR('V', 21, struct v4l2_subdev_frame_interval)
+#define VIDIOC_SUBDEV_S_FRAME_INTERVAL \
+			_IOWR('V', 22, struct v4l2_subdev_frame_interval)
 #define VIDIOC_SUBDEV_ENUM_MBUS_CODE \
 			_IOWR('V',  2, struct v4l2_subdev_mbus_code_enum)
 #define VIDIOC_SUBDEV_ENUM_FRAME_SIZE \
 			_IOWR('V', 74, struct v4l2_subdev_frame_size_enum)
+#define VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL \
+			_IOWR('V', 75, struct v4l2_subdev_frame_interval_enum)
 #endif

include/media/v4l2-subdev.h

Diff comments View file @ 35c3017

 /*
     V4L2 sub-device support header.
     Copyright (C) 2008  Hans Verkuil <hverkuil@xs4all.nl>
     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
     You should have received a copy of the GNU General Public License
     along with this program; if not, write to the Free Software
     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 #ifndef _V4L2_SUBDEV_H
 #define _V4L2_SUBDEV_H
 #include <linux/v4l2-subdev.h>
 #include <media/media-entity.h>
 #include <media/v4l2-common.h>
 #include <media/v4l2-dev.h>
 #include <media/v4l2-fh.h>
 #include <media/v4l2-mediabus.h>
 /* generic v4l2_device notify callback notification values */
 #define V4L2_SUBDEV_IR_RX_NOTIFY		_IOW('v', 0, u32)
 #define V4L2_SUBDEV_IR_RX_FIFO_SERVICE_REQ	0x00000001
 #define V4L2_SUBDEV_IR_RX_END_OF_RX_DETECTED	0x00000002
 #define V4L2_SUBDEV_IR_RX_HW_FIFO_OVERRUN	0x00000004
 #define V4L2_SUBDEV_IR_RX_SW_FIFO_OVERRUN	0x00000008
 #define V4L2_SUBDEV_IR_TX_NOTIFY		_IOW('v', 1, u32)
 #define V4L2_SUBDEV_IR_TX_FIFO_SERVICE_REQ	0x00000001
 struct v4l2_device;
 struct v4l2_ctrl_handler;
 struct v4l2_event_subscription;
 struct v4l2_fh;
 struct v4l2_subdev;
 struct v4l2_subdev_fh;
 struct tuner_setup;
 /* decode_vbi_line */
 struct v4l2_decode_vbi_line {
 	u32 is_second_field;	/* Set to 0 for the first (odd) field,
 				   set to 1 for the second (even) field. */
 	u8 *p; 			/* Pointer to the sliced VBI data from the decoder.
 				   On exit points to the start of the payload. */
 	u32 line;		/* Line number of the sliced VBI data (1-23) */
 	u32 type;		/* VBI service type (V4L2_SLICED_*). 0 if no service found */
 };
 /* Sub-devices are devices that are connected somehow to the main bridge
    device. These devices are usually audio/video muxers/encoders/decoders or
    sensors and webcam controllers.
    Usually these devices are controlled through an i2c bus, but other busses
    may also be used.
    The v4l2_subdev struct provides a way of accessing these devices in a
    generic manner. Most operations that these sub-devices support fall in
    a few categories: core ops, audio ops, video ops and tuner ops.
    More categories can be added if needed, although this should remain a
    limited set (no more than approx. 8 categories).
    Each category has its own set of ops that subdev drivers can implement.
    A subdev driver can leave the pointer to the category ops NULL if
    it does not implement them (e.g. an audio subdev will generally not
    implement the video category ops). The exception is the core category:
    this must always be present.
    These ops are all used internally so it is no problem to change, remove
    or add ops or move ops from one to another category. Currently these
    ops are based on the original ioctls, but since ops are not limited to
    one argument there is room for improvement here once all i2c subdev
    drivers are converted to use these ops.
  */
 /* Core ops: it is highly recommended to implement at least these ops:
    g_chip_ident
    log_status
    g_register
    s_register
    This provides basic debugging support.
    The ioctl ops is meant for generic ioctl-like commands. Depending on
    the use-case it might be better to use subdev-specific ops (currently
    not yet implemented) since ops provide proper type-checking.
  */
 /* Subdevice external IO pin configuration */
 #define V4L2_SUBDEV_IO_PIN_DISABLE	(1 << 0) /* ENABLE assumed */
 #define V4L2_SUBDEV_IO_PIN_OUTPUT	(1 << 1)
 #define V4L2_SUBDEV_IO_PIN_INPUT	(1 << 2)
 #define V4L2_SUBDEV_IO_PIN_SET_VALUE	(1 << 3) /* Set output value */
 #define V4L2_SUBDEV_IO_PIN_ACTIVE_LOW	(1 << 4) /* ACTIVE HIGH assumed */
 struct v4l2_subdev_io_pin_config {
 	u32 flags;	/* V4L2_SUBDEV_IO_PIN_* flags for this pin's config */
 	u8 pin;		/* Chip external IO pin to configure */
 	u8 function;	/* Internal signal pad/function to route to IO pin */
 	u8 value;	/* Initial value for pin - e.g. GPIO output value */
 	u8 strength;	/* Pin drive strength */
 };
 /*
    s_io_pin_config: configure one or more chip I/O pins for chips that
 	multiplex different internal signal pads out to IO pins.  This function
 	takes a pointer to an array of 'n' pin configuration entries, one for
 	each pin being configured.  This function could be called at times
 	other than just subdevice initialization.
    init: initialize the sensor registors to some sort of reasonable default
 	values. Do not use for new drivers and should be removed in existing
 	drivers.
    load_fw: load firmware.
    reset: generic reset command. The argument selects which subsystems to
 	reset. Passing 0 will always reset the whole chip. Do not use for new
 	drivers without discussing this first on the linux-media mailinglist.
 	There should be no reason normally to reset a device.
    s_gpio: set GPIO pins. Very simple right now, might need to be extended with
 	a direction argument if needed.
    s_power: puts subdevice in power saving mode (on == 0) or normal operation
 	mode (on == 1).
    interrupt_service_routine: Called by the bridge chip's interrupt service
 	handler, when an interrupt status has be raised due to this subdev,
 	so that this subdev can handle the details.  It may schedule work to be
 	performed later.  It must not sleep.  *Called from an IRQ context*.
  */
 struct v4l2_subdev_core_ops {
 	int (*g_chip_ident)(struct v4l2_subdev *sd, struct v4l2_dbg_chip_ident *chip);
 	int (*log_status)(struct v4l2_subdev *sd);
 	int (*s_io_pin_config)(struct v4l2_subdev *sd, size_t n,
 				      struct v4l2_subdev_io_pin_config *pincfg);
 	int (*init)(struct v4l2_subdev *sd, u32 val);
 	int (*load_fw)(struct v4l2_subdev *sd);
 	int (*reset)(struct v4l2_subdev *sd, u32 val);
 	int (*s_gpio)(struct v4l2_subdev *sd, u32 val);
 	int (*queryctrl)(struct v4l2_subdev *sd, struct v4l2_queryctrl *qc);
 	int (*g_ctrl)(struct v4l2_subdev *sd, struct v4l2_control *ctrl);
 	int (*s_ctrl)(struct v4l2_subdev *sd, struct v4l2_control *ctrl);
 	int (*g_ext_ctrls)(struct v4l2_subdev *sd, struct v4l2_ext_controls *ctrls);
 	int (*s_ext_ctrls)(struct v4l2_subdev *sd, struct v4l2_ext_controls *ctrls);
 	int (*try_ext_ctrls)(struct v4l2_subdev *sd, struct v4l2_ext_controls *ctrls);
 	int (*querymenu)(struct v4l2_subdev *sd, struct v4l2_querymenu *qm);
 	int (*s_std)(struct v4l2_subdev *sd, v4l2_std_id norm);
 	long (*ioctl)(struct v4l2_subdev *sd, unsigned int cmd, void *arg);
 #ifdef CONFIG_VIDEO_ADV_DEBUG
 	int (*g_register)(struct v4l2_subdev *sd, struct v4l2_dbg_register *reg);
 	int (*s_register)(struct v4l2_subdev *sd, struct v4l2_dbg_register *reg);
 #endif
 	int (*s_power)(struct v4l2_subdev *sd, int on);
 	int (*interrupt_service_routine)(struct v4l2_subdev *sd,
 						u32 status, bool *handled);
 	int (*subscribe_event)(struct v4l2_subdev *sd, struct v4l2_fh *fh,
 			       struct v4l2_event_subscription *sub);
 	int (*unsubscribe_event)(struct v4l2_subdev *sd, struct v4l2_fh *fh,
 				 struct v4l2_event_subscription *sub);
 };
 /* s_mode: switch the tuner to a specific tuner mode. Replacement of s_radio.
    s_radio: v4l device was opened in Radio mode, to be replaced by s_mode.
    s_type_addr: sets tuner type and its I2C addr.
    s_config: sets tda9887 specific stuff, like port1, port2 and qss
  */
 struct v4l2_subdev_tuner_ops {
 	int (*s_mode)(struct v4l2_subdev *sd, enum v4l2_tuner_type);
 	int (*s_radio)(struct v4l2_subdev *sd);
 	int (*s_frequency)(struct v4l2_subdev *sd, struct v4l2_frequency *freq);
 	int (*g_frequency)(struct v4l2_subdev *sd, struct v4l2_frequency *freq);
 	int (*g_tuner)(struct v4l2_subdev *sd, struct v4l2_tuner *vt);
 	int (*s_tuner)(struct v4l2_subdev *sd, struct v4l2_tuner *vt);
 	int (*g_modulator)(struct v4l2_subdev *sd, struct v4l2_modulator *vm);
 	int (*s_modulator)(struct v4l2_subdev *sd, struct v4l2_modulator *vm);
 	int (*s_type_addr)(struct v4l2_subdev *sd, struct tuner_setup *type);
 	int (*s_config)(struct v4l2_subdev *sd, const struct v4l2_priv_tun_config *config);
 };
 /* s_clock_freq: set the frequency (in Hz) of the audio clock output.
 	Used to slave an audio processor to the video decoder, ensuring that
 	audio and video remain synchronized. Usual values for the frequency
 	are 48000, 44100 or 32000 Hz. If the frequency is not supported, then
 	-EINVAL is returned.
    s_i2s_clock_freq: sets I2S speed in bps. This is used to provide a standard
 	way to select I2S clock used by driving digital audio streams at some
 	board designs. Usual values for the frequency are 1024000 and 2048000.
 	If the frequency is not supported, then -EINVAL is returned.
    s_routing: used to define the input and/or output pins of an audio chip,
 	and any additional configuration data.
 	Never attempt to use user-level input IDs (e.g. Composite, S-Video,
 	Tuner) at this level. An i2c device shouldn't know about whether an
 	input pin is connected to a Composite connector, become on another
 	board or platform it might be connected to something else entirely.
 	The calling driver is responsible for mapping a user-level input to
 	the right pins on the i2c device.
  */
 struct v4l2_subdev_audio_ops {
 	int (*s_clock_freq)(struct v4l2_subdev *sd, u32 freq);
 	int (*s_i2s_clock_freq)(struct v4l2_subdev *sd, u32 freq);
 	int (*s_routing)(struct v4l2_subdev *sd, u32 input, u32 output, u32 config);
 	int (*s_stream)(struct v4l2_subdev *sd, int enable);
 };
 /*
    s_std_output: set v4l2_std_id for video OUTPUT devices. This is ignored by
 	video input devices.
    s_crystal_freq: sets the frequency of the crystal used to generate the
 	clocks in Hz. An extra flags field allows device specific configuration
 	regarding clock frequency dividers, etc. If not used, then set flags
 	to 0. If the frequency is not supported, then -EINVAL is returned.
    g_input_status: get input status. Same as the status field in the v4l2_input
 	struct.
    s_routing: see s_routing in audio_ops, except this version is for video
 	devices.
    s_dv_preset: set dv (Digital Video) preset in the sub device. Similar to
 	s_std()
    query_dv_preset: query dv preset in the sub device. This is similar to
 	querystd()
    s_dv_timings(): Set custom dv timings in the sub device. This is used
 	when sub device is capable of setting detailed timing information
 	in the hardware to generate/detect the video signal.
    g_dv_timings(): Get custom dv timings in the sub device.
    enum_mbus_fmt: enumerate pixel formats, provided by a video data source
    g_mbus_fmt: get the current pixel format, provided by a video data source
    try_mbus_fmt: try to set a pixel format on a video data source
    s_mbus_fmt: set a pixel format on a video data source
  */
 struct v4l2_subdev_video_ops {
 	int (*s_routing)(struct v4l2_subdev *sd, u32 input, u32 output, u32 config);
 	int (*s_crystal_freq)(struct v4l2_subdev *sd, u32 freq, u32 flags);
 	int (*s_std_output)(struct v4l2_subdev *sd, v4l2_std_id std);
 	int (*querystd)(struct v4l2_subdev *sd, v4l2_std_id *std);
 	int (*g_input_status)(struct v4l2_subdev *sd, u32 *status);
 	int (*s_stream)(struct v4l2_subdev *sd, int enable);
 	int (*cropcap)(struct v4l2_subdev *sd, struct v4l2_cropcap *cc);
 	int (*g_crop)(struct v4l2_subdev *sd, struct v4l2_crop *crop);
 	int (*s_crop)(struct v4l2_subdev *sd, struct v4l2_crop *crop);
 	int (*g_parm)(struct v4l2_subdev *sd, struct v4l2_streamparm *param);
 	int (*s_parm)(struct v4l2_subdev *sd, struct v4l2_streamparm *param);
+	int (*g_frame_interval)(struct v4l2_subdev *sd,
+				struct v4l2_subdev_frame_interval *interval);
+	int (*s_frame_interval)(struct v4l2_subdev *sd,
+				struct v4l2_subdev_frame_interval *interval);
 	int (*enum_framesizes)(struct v4l2_subdev *sd, struct v4l2_frmsizeenum *fsize);
 	int (*enum_frameintervals)(struct v4l2_subdev *sd, struct v4l2_frmivalenum *fival);
 	int (*enum_dv_presets) (struct v4l2_subdev *sd,
 			struct v4l2_dv_enum_preset *preset);
 	int (*s_dv_preset)(struct v4l2_subdev *sd,
 			struct v4l2_dv_preset *preset);
 	int (*query_dv_preset)(struct v4l2_subdev *sd,
 			struct v4l2_dv_preset *preset);
 	int (*s_dv_timings)(struct v4l2_subdev *sd,
 			struct v4l2_dv_timings *timings);
 	int (*g_dv_timings)(struct v4l2_subdev *sd,
 			struct v4l2_dv_timings *timings);
 	int (*enum_mbus_fmt)(struct v4l2_subdev *sd, unsigned int index,
 			     enum v4l2_mbus_pixelcode *code);
 	int (*enum_mbus_fsizes)(struct v4l2_subdev *sd,
 			     struct v4l2_frmsizeenum *fsize);
 	int (*g_mbus_fmt)(struct v4l2_subdev *sd,
 			  struct v4l2_mbus_framefmt *fmt);
 	int (*try_mbus_fmt)(struct v4l2_subdev *sd,
 			    struct v4l2_mbus_framefmt *fmt);
 	int (*s_mbus_fmt)(struct v4l2_subdev *sd,
 			  struct v4l2_mbus_framefmt *fmt);
 };
 /*
    decode_vbi_line: video decoders that support sliced VBI need to implement
 	this ioctl. Field p of the v4l2_sliced_vbi_line struct is set to the
 	start of the VBI data that was generated by the decoder. The driver
 	then parses the sliced VBI data and sets the other fields in the
 	struct accordingly. The pointer p is updated to point to the start of
 	the payload which can be copied verbatim into the data field of the
 	v4l2_sliced_vbi_data struct. If no valid VBI data was found, then the
 	type field is set to 0 on return.
    s_vbi_data: used to generate VBI signals on a video signal.
 	v4l2_sliced_vbi_data is filled with the data packets that should be
 	output. Note that if you set the line field to 0, then that VBI signal
 	is disabled. If no valid VBI data was found, then the type field is
 	set to 0 on return.
    g_vbi_data: used to obtain the sliced VBI packet from a readback register.
 	Not all video decoders support this. If no data is available because
 	the readback register contains invalid or erroneous data -EIO is
 	returned. Note that you must fill in the 'id' member and the 'field'
 	member (to determine whether CC data from the first or second field
 	should be obtained).
    s_raw_fmt: setup the video encoder/decoder for raw VBI.
    g_sliced_fmt: retrieve the current sliced VBI settings.
    s_sliced_fmt: setup the sliced VBI settings.
  */
 struct v4l2_subdev_vbi_ops {
 	int (*decode_vbi_line)(struct v4l2_subdev *sd, struct v4l2_decode_vbi_line *vbi_line);
 	int (*s_vbi_data)(struct v4l2_subdev *sd, const struct v4l2_sliced_vbi_data *vbi_data);
 	int (*g_vbi_data)(struct v4l2_subdev *sd, struct v4l2_sliced_vbi_data *vbi_data);
 	int (*g_sliced_vbi_cap)(struct v4l2_subdev *sd, struct v4l2_sliced_vbi_cap *cap);
 	int (*s_raw_fmt)(struct v4l2_subdev *sd, struct v4l2_vbi_format *fmt);
 	int (*g_sliced_fmt)(struct v4l2_subdev *sd, struct v4l2_sliced_vbi_format *fmt);
 	int (*s_sliced_fmt)(struct v4l2_subdev *sd, struct v4l2_sliced_vbi_format *fmt);
 };
 /**
  * struct v4l2_subdev_sensor_ops - v4l2-subdev sensor operations
  * @g_skip_top_lines: number of lines at the top of the image to be skipped.
  *		      This is needed for some sensors, which always corrupt
  *		      several top lines of the output image, or which send their
  *		      metadata in them.
  */
 struct v4l2_subdev_sensor_ops {
 	int (*g_skip_top_lines)(struct v4l2_subdev *sd, u32 *lines);
 };
 /*
    [rt]x_g_parameters: Get the current operating parameters and state of the
 	the IR receiver or transmitter.
    [rt]x_s_parameters: Set the current operating parameters and state of the
 	the IR receiver or transmitter.  It is recommended to call
 	[rt]x_g_parameters first to fill out the current state, and only change
 	the fields that need to be changed.  Upon return, the actual device
 	operating parameters and state will be returned.  Note that hardware
 	limitations may prevent the actual settings from matching the requested
 	settings - e.g. an actual carrier setting of 35,904 Hz when 36,000 Hz
 	was requested.  An exception is when the shutdown parameter is true.
 	The last used operational parameters will be returned, but the actual
 	state of the hardware be different to minimize power consumption and
 	processing when shutdown is true.
    rx_read: Reads received codes or pulse width data.
 	The semantics are similar to a non-blocking read() call.
    tx_write: Writes codes or pulse width data for transmission.
 	The semantics are similar to a non-blocking write() call.
  */
 enum v4l2_subdev_ir_mode {
 	V4L2_SUBDEV_IR_MODE_PULSE_WIDTH, /* uses struct ir_raw_event records */
 };
 struct v4l2_subdev_ir_parameters {
 	/* Either Rx or Tx */
 	unsigned int bytes_per_data_element; /* of data in read or write call */
 	enum v4l2_subdev_ir_mode mode;
 	bool enable;
 	bool interrupt_enable;
 	bool shutdown; /* true: set hardware to low/no power, false: normal */
 	bool modulation;           /* true: uses carrier, false: baseband */
 	u32 max_pulse_width;       /* ns,      valid only for baseband signal */
 	unsigned int carrier_freq; /* Hz,      valid only for modulated signal*/
 	unsigned int duty_cycle;   /* percent, valid only for modulated signal*/
 	bool invert_level;	   /* invert signal level */
 	/* Tx only */
 	bool invert_carrier_sense; /* Send 0/space as a carrier burst */
 	/* Rx only */
 	u32 noise_filter_min_width;       /* ns, min time of a valid pulse */
 	unsigned int carrier_range_lower; /* Hz, valid only for modulated sig */
 	unsigned int carrier_range_upper; /* Hz, valid only for modulated sig */
 	u32 resolution;                   /* ns */
 };
 struct v4l2_subdev_ir_ops {
 	/* Receiver */
 	int (*rx_read)(struct v4l2_subdev *sd, u8 *buf, size_t count,
 				ssize_t *num);
 	int (*rx_g_parameters)(struct v4l2_subdev *sd,
 				struct v4l2_subdev_ir_parameters *params);
 	int (*rx_s_parameters)(struct v4l2_subdev *sd,
 				struct v4l2_subdev_ir_parameters *params);
 	/* Transmitter */
 	int (*tx_write)(struct v4l2_subdev *sd, u8 *buf, size_t count,
 				ssize_t *num);
 	int (*tx_g_parameters)(struct v4l2_subdev *sd,
 				struct v4l2_subdev_ir_parameters *params);
 	int (*tx_s_parameters)(struct v4l2_subdev *sd,
 				struct v4l2_subdev_ir_parameters *params);
 };
 struct v4l2_subdev_pad_ops {
 	int (*enum_mbus_code)(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
 			      struct v4l2_subdev_mbus_code_enum *code);
 	int (*enum_frame_size)(struct v4l2_subdev *sd,
 			       struct v4l2_subdev_fh *fh,
 			       struct v4l2_subdev_frame_size_enum *fse);
+	int (*enum_frame_interval)(struct v4l2_subdev *sd,
+				   struct v4l2_subdev_fh *fh,
+				   struct v4l2_subdev_frame_interval_enum *fie);
 	int (*get_fmt)(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
 		       struct v4l2_subdev_format *format);
 	int (*set_fmt)(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
 		       struct v4l2_subdev_format *format);
 };
 struct v4l2_subdev_ops {
 	const struct v4l2_subdev_core_ops	*core;
 	const struct v4l2_subdev_tuner_ops	*tuner;
 	const struct v4l2_subdev_audio_ops	*audio;
 	const struct v4l2_subdev_video_ops	*video;
 	const struct v4l2_subdev_vbi_ops	*vbi;
 	const struct v4l2_subdev_ir_ops		*ir;
 	const struct v4l2_subdev_sensor_ops	*sensor;
 	const struct v4l2_subdev_pad_ops	*pad;
 };
 /*
  * Internal ops. Never call this from drivers, only the v4l2 framework can call
  * these ops.
  *
  * registered: called when this subdev is registered. When called the v4l2_dev
  *	field is set to the correct v4l2_device.
  *
  * unregistered: called when this subdev is unregistered. When called the
  *	v4l2_dev field is still set to the correct v4l2_device.
  *
  * open: called when the subdev device node is opened by an application.
  *
  * close: called when the subdev device node is closed.
  */
 struct v4l2_subdev_internal_ops {
 	int (*registered)(struct v4l2_subdev *sd);
 	void (*unregistered)(struct v4l2_subdev *sd);
 	int (*open)(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh);
 	int (*close)(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh);
 };
 #define V4L2_SUBDEV_NAME_SIZE 32
 /* Set this flag if this subdev is a i2c device. */
 #define V4L2_SUBDEV_FL_IS_I2C			(1U << 0)
 /* Set this flag if this subdev is a spi device. */
 #define V4L2_SUBDEV_FL_IS_SPI			(1U << 1)
 /* Set this flag if this subdev needs a device node. */
 #define V4L2_SUBDEV_FL_HAS_DEVNODE		(1U << 2)
 /* Set this flag if this subdev generates events. */
 #define V4L2_SUBDEV_FL_HAS_EVENTS		(1U << 3)
 /* Each instance of a subdev driver should create this struct, either
    stand-alone or embedded in a larger struct.
  */
 struct v4l2_subdev {
 #if defined(CONFIG_MEDIA_CONTROLLER)
 	struct media_entity entity;
 #endif
 	struct list_head list;
 	struct module *owner;
 	u32 flags;
 	struct v4l2_device *v4l2_dev;
 	const struct v4l2_subdev_ops *ops;
 	/* Never call these internal ops from within a driver! */
 	const struct v4l2_subdev_internal_ops *internal_ops;
 	/* The control handler of this subdev. May be NULL. */
 	struct v4l2_ctrl_handler *ctrl_handler;
 	/* name must be unique */
 	char name[V4L2_SUBDEV_NAME_SIZE];
 	/* can be used to group similar subdevs, value is driver-specific */
 	u32 grp_id;
 	/* pointer to private data */
 	void *dev_priv;
 	void *host_priv;
 	/* subdev device node */
 	struct video_device devnode;
 	/* number of events to be allocated on open */
 	unsigned int nevents;
 };
 #define media_entity_to_v4l2_subdev(ent) \
 	container_of(ent, struct v4l2_subdev, entity)
 #define vdev_to_v4l2_subdev(vdev) \
 	container_of(vdev, struct v4l2_subdev, devnode)
 /*
  * Used for storing subdev information per file handle
  */
 struct v4l2_subdev_fh {
 	struct v4l2_fh vfh;
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 	struct v4l2_mbus_framefmt *try_fmt;
 	struct v4l2_rect *try_crop;
 #endif
 };
 #define to_v4l2_subdev_fh(fh)	\
 	container_of(fh, struct v4l2_subdev_fh, vfh)
 #if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 static inline struct v4l2_mbus_framefmt *
 v4l2_subdev_get_try_format(struct v4l2_subdev_fh *fh, unsigned int pad)
 {
 	return &fh->try_fmt[pad];
 }
 static inline struct v4l2_rect *
 v4l2_subdev_get_try_crop(struct v4l2_subdev_fh *fh, unsigned int pad)
 {
 	return &fh->try_crop[pad];
 }
 #endif
 extern const struct v4l2_file_operations v4l2_subdev_fops;
 static inline void v4l2_set_subdevdata(struct v4l2_subdev *sd, void *p)
 {
 	sd->dev_priv = p;
 }
 static inline void *v4l2_get_subdevdata(const struct v4l2_subdev *sd)
 {
 	return sd->dev_priv;
 }
 static inline void v4l2_set_subdev_hostdata(struct v4l2_subdev *sd, void *p)
 {
 	sd->host_priv = p;
 }
 static inline void *v4l2_get_subdev_hostdata(const struct v4l2_subdev *sd)
 {
 	return sd->host_priv;
 }
 void v4l2_subdev_init(struct v4l2_subdev *sd,
 		      const struct v4l2_subdev_ops *ops);
 /* Call an ops of a v4l2_subdev, doing the right checks against
    NULL pointers.
    Example: err = v4l2_subdev_call(sd, core, g_chip_ident, &chip);
  */
 #define v4l2_subdev_call(sd, o, f, args...)				\
 	(!(sd) ? -ENODEV : (((sd)->ops->o && (sd)->ops->o->f) ?	\
 		(sd)->ops->o->f((sd) , ##args) : -ENOIOCTLCMD))
 /* Send a notification to v4l2_device. */
 #define v4l2_subdev_notify(sd, notification, arg)			   \
 	((!(sd) || !(sd)->v4l2_dev || !(sd)->v4l2_dev->notify) ? -ENODEV : \
 	 (sd)->v4l2_dev->notify((sd), (notification), (arg)))
 #endif