Eric Lee / smarc-fsl-linux-kernel

Commit 97548ed4c4661502cdfd1aabd5d3876fa4f5cc2e

Authored by Laurent Pinchart 15 years ago

Committed by Mauro Carvalho Chehab 14 years ago

Exists in master and in 39 other branches

[media] media: Links setup

Create the following ioctl and implement it at the media device level to
setup links.

- MEDIA_IOC_SETUP_LINK: Modify the properties of a given link

The only property that can currently be modified is the ENABLED link
flag to enable/disable a link. Links marked with the IMMUTABLE link flag
can not be enabled or disabled.

Enabling or disabling a link has effects on entities' use count. Those
changes are automatically propagated through the graph.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Stanimir Varbanov <svarbanov@mm-sol.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 9 changed files with 356 additions and 0 deletions Inline Diff

Documentation/DocBook/media-entities.tmpl
Documentation/DocBook/v4l/media-controller.xml
Documentation/DocBook/v4l/media-ioc-setup-link.xml
Documentation/media-framework.txt
drivers/media/media-device.c
drivers/media/media-entity.c
include/linux/media.h
include/media/media-device.h
include/media/media-entity.h

Documentation/DocBook/media-entities.tmpl

Diff comments View file @ 97548ed

 <!-- 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-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-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-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-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-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 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-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-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/media-controller.xml

Diff comments View file @ 97548ed

 <partinfo>
   <authorgroup>
     <author>
       <firstname>Laurent</firstname>
       <surname>Pinchart</surname>
       <affiliation><address><email>laurent.pinchart@ideasonboard.com</email></address></affiliation>
       <contrib>Initial version.</contrib>
     </author>
   </authorgroup>
   <copyright>
     <year>2010</year>
     <holder>Laurent Pinchart</holder>
   </copyright>
   <revhistory>
     <!-- Put document revisions here, newest first. -->
     <revision>
       <revnumber>1.0.0</revnumber>
       <date>2010-11-10</date>
       <authorinitials>lp</authorinitials>
       <revremark>Initial revision</revremark>
     </revision>
   </revhistory>
 </partinfo>
 <title>Media Controller API</title>
 <chapter id="media_controller">
   <title>Media Controller</title>
   <section id="media-controller-intro">
     <title>Introduction</title>
     <para>Media devices increasingly handle multiple related functions. Many USB
     cameras include microphones, video capture hardware can also output video,
     or SoC camera interfaces also perform memory-to-memory operations similar to
     video codecs.</para>
     <para>Independent functions, even when implemented in the same hardware, can
     be modelled as separate devices. A USB camera with a microphone will be
     presented to userspace applications as V4L2 and ALSA capture devices. The
     devices' relationships (when using a webcam, end-users shouldn't have to
     manually select the associated USB microphone), while not made available
     directly to applications by the drivers, can usually be retrieved from
     sysfs.</para>
     <para>With more and more advanced SoC devices being introduced, the current
     approach will not scale. Device topologies are getting increasingly complex
     and can't always be represented by a tree structure. Hardware blocks are
     shared between different functions, creating dependencies between seemingly
     unrelated devices.</para>
     <para>Kernel abstraction APIs such as V4L2 and ALSA provide means for
     applications to access hardware parameters. As newer hardware expose an
     increasingly high number of those parameters, drivers need to guess what
     applications really require based on limited information, thereby
     implementing policies that belong to userspace.</para>
     <para>The media controller API aims at solving those problems.</para>
   </section>
   <section id="media-controller-model">
     <title>Media device model</title>
     <para>Discovering a device internal topology, and configuring it at runtime,
     is one of the goals of the media controller API. To achieve this, hardware
     devices are modelled as an oriented graph of building blocks called entities
     connected through pads.</para>
     <para>An entity is a basic media hardware or software building block. It can
     correspond to a large variety of logical blocks such as physical hardware
     devices (CMOS sensor for instance), logical hardware devices (a building
     block in a System-on-Chip image processing pipeline), DMA channels or
     physical connectors.</para>
     <para>A pad is a connection endpoint through which an entity can interact
     with other entities. Data (not restricted to video) produced by an entity
     flows from the entity's output to one or more entity inputs. Pads should not
     be confused with physical pins at chip boundaries.</para>
     <para>A link is a point-to-point oriented connection between two pads,
     either on the same entity or on different entities. Data flows from a source
     pad to a sink pad.</para>
   </section>
 </chapter>
 <appendix id="media-user-func">
   <title>Function Reference</title>
   <!-- Keep this alphabetically sorted. -->
   &sub-media-open;
   &sub-media-close;
   &sub-media-ioctl;
   <!-- All ioctls go here. -->
   &sub-media-ioc-device-info;
   &sub-media-ioc-enum-entities;
   &sub-media-ioc-enum-links;
+  &sub-media-ioc-setup-link;
 </appendix>

Documentation/DocBook/v4l/media-ioc-setup-link.xml

Diff comments View file @ 97548ed

File was created	1	<refentry id="media-ioc-setup-link">
	2	<refmeta>
	3	<refentrytitle>ioctl MEDIA_IOC_SETUP_LINK</refentrytitle>
	4	&manvol;
	5	</refmeta>
	6
	7	<refnamediv>
	8	<refname>MEDIA_IOC_SETUP_LINK</refname>
	9	<refpurpose>Modify the properties of a link</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 media_link_desc *<parameter>argp</parameter></paramdef>
	19	</funcprototype>
	20	</funcsynopsis>
	21	</refsynopsisdiv>
	22
	23	<refsect1>
	24	<title>Arguments</title>
	25
	26	<variablelist>
	27	<varlistentry>
	28	<term><parameter>fd</parameter></term>
	29	<listitem>
	30	<para>File descriptor returned by
	31	<link linkend='media-func-open'><function>open()</function></link>.</para>
	32	</listitem>
	33	</varlistentry>
	34	<varlistentry>
	35	<term><parameter>request</parameter></term>
	36	<listitem>
	37	<para>MEDIA_IOC_ENUM_LINKS</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	<para>To change link properties applications fill a &media-link-desc; with
	53	link identification information (source and sink pad) and the new requested
	54	link flags. They then call the MEDIA_IOC_SETUP_LINK ioctl with a pointer to
	55	that structure.</para>
	56	<para>The only configurable property is the <constant>ENABLED</constant>
	57	link flag to enable/disable a link. Links marked with the
	58	<constant>IMMUTABLE</constant> link flag can not be enabled or disabled.
	59	</para>
	60	<para>Link configuration has no side effect on other links. If an enabled
	61	link at the sink pad prevents the link from being enabled, the driver
	62	returns with an &EBUSY;.</para>
	63	<para>If the specified link can't be found the driver returns with an
	64	&EINVAL;.</para>
	65	</refsect1>
	66
	67	<refsect1>
	68	&return-value;
	69
	70	<variablelist>
	71	<varlistentry>
	72	<term><errorcode>EBUSY</errorcode></term>
	73	<listitem>
	74	<para>The link properties can't be changed because the link is
	75	currently busy. This can be caused, for instance, by an active media
	76	stream (audio or video) on the link. The ioctl shouldn't be retried if
	77	no other action is performed before to fix the problem.</para>
	78	</listitem>
	79	</varlistentry>
	80	<varlistentry>
	81	<term><errorcode>EINVAL</errorcode></term>
	82	<listitem>
	83	<para>The &media-link-desc; references a non-existing link, or the
	84	link is immutable and an attempt to modify its configuration was made.
	85	</para>
	86	</listitem>
	87	</varlistentry>
	88	</variablelist>
	89	</refsect1>
	90	</refentry>
	91

Documentation/media-framework.txt

Diff comments View file @ 97548ed

 Linux kernel media framework
 ============================
 This document describes the Linux kernel media framework, its data structures,
 functions and their usage.
 Introduction
 ------------
 The media controller API is documented in DocBook format in
 Documentation/DocBook/v4l/media-controller.xml. This document will focus on
 the kernel-side implementation of the media framework.
 Abstract media device model
 ---------------------------
 Discovering a device internal topology, and configuring it at runtime, is one
 of the goals of the media framework. To achieve this, hardware devices are
 modeled as an oriented graph of building blocks called entities connected
 through pads.
 An entity is a basic media hardware building block. It can correspond to
 a large variety of logical blocks such as physical hardware devices
 (CMOS sensor for instance), logical hardware devices (a building block
 in a System-on-Chip image processing pipeline), DMA channels or physical
 connectors.
 A pad is a connection endpoint through which an entity can interact with
 other entities. Data (not restricted to video) produced by an entity
 flows from the entity's output to one or more entity inputs. Pads should
 not be confused with physical pins at chip boundaries.
 A link is a point-to-point oriented connection between two pads, either
 on the same entity or on different entities. Data flows from a source
 pad to a sink pad.
 Media device
 ------------
 A media device is represented by a struct media_device instance, defined in
 include/media/media-device.h. Allocation of the structure is handled by the
 media device driver, usually by embedding the media_device instance in a
 larger driver-specific structure.
 Drivers register media device instances by calling
 	media_device_register(struct media_device *mdev);
 The caller is responsible for initializing the media_device structure before
 registration. The following fields must be set:
  - dev must point to the parent device (usually a pci_dev, usb_interface or
    platform_device instance).
  - model must be filled with the device model name as a NUL-terminated UTF-8
    string. The device/model revision must not be stored in this field.
 The following fields are optional:
  - serial is a unique serial number stored as a NUL-terminated ASCII string.
    The field is big enough to store a GUID in text form. If the hardware
    doesn't provide a unique serial number this field must be left empty.
  - bus_info represents the location of the device in the system as a
    NUL-terminated ASCII string. For PCI/PCIe devices bus_info must be set to
    "PCI:" (or "PCIe:") followed by the value of pci_name(). For USB devices,
    the usb_make_path() function must be used. This field is used by
    applications to distinguish between otherwise identical devices that don't
    provide a serial number.
  - hw_revision is the hardware device revision in a driver-specific format.
    When possible the revision should be formatted with the KERNEL_VERSION
    macro.
  - driver_version is formatted with the KERNEL_VERSION macro. The version
    minor must be incremented when new features are added to the userspace API
    without breaking binary compatibility. The version major must be
    incremented when binary compatibility is broken.
 Upon successful registration a character device named media[0-9]+ is created.
 The device major and minor numbers are dynamic. The model name is exported as
 a sysfs attribute.
 Drivers unregister media device instances by calling
 	media_device_unregister(struct media_device *mdev);
 Unregistering a media device that hasn't been registered is *NOT* safe.
 Entities, pads and links
 ------------------------
 - Entities
 Entities are represented by a struct media_entity instance, defined in
 include/media/media-entity.h. The structure is usually embedded into a
 higher-level structure, such as a v4l2_subdev or video_device instance,
 although drivers can allocate entities directly.
 Drivers initialize entities by calling
 	media_entity_init(struct media_entity *entity, u16 num_pads,
 			  struct media_pad *pads, u16 extra_links);
 The media_entity name, type, flags, revision and group_id fields can be
 initialized before or after calling media_entity_init. Entities embedded in
 higher-level standard structures can have some of those fields set by the
 higher-level framework.
 As the number of pads is known in advance, the pads array is not allocated
 dynamically but is managed by the entity driver. Most drivers will embed the
 pads array in a driver-specific structure, avoiding dynamic allocation.
 Drivers must set the direction of every pad in the pads array before calling
 media_entity_init. The function will initialize the other pads fields.
 Unlike the number of pads, the total number of links isn't always known in
 advance by the entity driver. As an initial estimate, media_entity_init
 pre-allocates a number of links equal to the number of pads plus an optional
 number of extra links. The links array will be reallocated if it grows beyond
 the initial estimate.
 Drivers register entities with a media device by calling
 	media_device_register_entity(struct media_device *mdev,
 				     struct media_entity *entity);
 Entities are identified by a unique positive integer ID. Drivers can provide an
 ID by filling the media_entity id field prior to registration, or request the
 media controller framework to assign an ID automatically. Drivers that provide
 IDs manually must ensure that all IDs are unique. IDs are not guaranteed to be
 contiguous even when they are all assigned automatically by the framework.
 Drivers unregister entities by calling
 	media_device_unregister_entity(struct media_entity *entity);
 Unregistering an entity will not change the IDs of the other entities, and the
 ID will never be reused for a newly registered entity.
 When a media device is unregistered, all its entities are unregistered
 automatically. No manual entities unregistration is then required.
 Drivers free resources associated with an entity by calling
 	media_entity_cleanup(struct media_entity *entity);
 This function must be called during the cleanup phase after unregistering the
 entity. Note that the media_entity instance itself must be freed explicitly by
 the driver if required.
 Entities have flags that describe the entity capabilities and state.
 	MEDIA_ENT_FL_DEFAULT indicates the default entity for a given type.
 	This can be used to report the default audio and video devices or the
 	default camera sensor.
 Logical entity groups can be defined by setting the group ID of all member
 entities to the same non-zero value. An entity group serves no purpose in the
 kernel, but is reported to userspace during entities enumeration. The group_id
 field belongs to the media device driver and must not by touched by entity
 drivers.
 Media device drivers should define groups if several entities are logically
 bound together. Example usages include reporting
 	- ALSA, VBI and video nodes that carry the same media stream
 	- lens and flash controllers associated with a sensor
 - Pads
 Pads are represented by a struct media_pad instance, defined in
 include/media/media-entity.h. Each entity stores its pads in a pads array
 managed by the entity driver. Drivers usually embed the array in a
 driver-specific structure.
 Pads are identified by their entity and their 0-based index in the pads array.
 Both information are stored in the media_pad structure, making the media_pad
 pointer the canonical way to store and pass link references.
 Pads have flags that describe the pad capabilities and state.
 	MEDIA_PAD_FL_SINK indicates that the pad supports sinking data.
 	MEDIA_PAD_FL_SOURCE indicates that the pad supports sourcing data.
 One and only one of MEDIA_PAD_FL_SINK and MEDIA_PAD_FL_SOURCE must be set for
 each pad.
 - Links
 Links are represented by a struct media_link instance, defined in
 include/media/media-entity.h. Each entity stores all links originating at or
 targetting any of its pads in a links array. A given link is thus stored
 twice, once in the source entity and once in the target entity. The array is
 pre-allocated and grows dynamically as needed.
 Drivers create links by calling
 	media_entity_create_link(struct media_entity *source, u16 source_pad,
 				 struct media_entity *sink,   u16 sink_pad,
 				 u32 flags);
 An entry in the link array of each entity is allocated and stores pointers
 to source and sink pads.
 Links have flags that describe the link capabilities and state.
 	MEDIA_LNK_FL_ENABLED indicates that the link is enabled and can be used
 	to transfer media data. When two or more links target a sink pad, only
 	one of them can be enabled at a time.
 	MEDIA_LNK_FL_IMMUTABLE indicates that the link enabled state can't be
 	modified at runtime. If MEDIA_LNK_FL_IMMUTABLE is set, then
 	MEDIA_LNK_FL_ENABLED must also be set since an immutable link is always
 	enabled.
 Graph traversal
 ---------------
 The media framework provides APIs to iterate over entities in a graph.
 To iterate over all entities belonging to a media device, drivers can use the
 media_device_for_each_entity macro, defined in include/media/media-device.h.
 	struct media_entity *entity;
 	media_device_for_each_entity(entity, mdev) {
 		/* entity will point to each entity in turn */
 		...
 	}
 Drivers might also need to iterate over all entities in a graph that can be
 reached only through enabled links starting at a given entity. The media
 framework provides a depth-first graph traversal API for that purpose.
 Note that graphs with cycles (whether directed or undirected) are *NOT*
 supported by the graph traversal API. To prevent infinite loops, the graph
 traversal code limits the maximum depth to MEDIA_ENTITY_ENUM_MAX_DEPTH,
 currently defined as 16.
 Drivers initiate a graph traversal by calling
 	media_entity_graph_walk_start(struct media_entity_graph *graph,
 				      struct media_entity *entity);
 The graph structure, provided by the caller, is initialized to start graph
 traversal at the given entity.
 Drivers can then retrieve the next entity by calling
 	media_entity_graph_walk_next(struct media_entity_graph *graph);
 When the graph traversal is complete the function will return NULL.
 Graph traversal can be interrupted at any moment. No cleanup function call is
 required and the graph structure can be freed normally.
+Helper functions can be used to find a link between two given pads, or a pad
+connected to another pad through an enabled link
+	media_entity_find_link(struct media_pad *source,
+			       struct media_pad *sink);
+	media_entity_remote_source(struct media_pad *pad);
+Refer to the kerneldoc documentation for more information.
 Use count and power handling
 ----------------------------
 Due to the wide differences between drivers regarding power management needs,
 the media controller does not implement power management. However, the
 media_entity structure includes a use_count field that media drivers can use to
 track the number of users of every entity for power management needs.
 The use_count field is owned by media drivers and must not be touched by entity
 drivers. Access to the field must be protected by the media device graph_mutex
 lock.
+Links setup
+-----------
+Link properties can be modified at runtime by calling
+	media_entity_setup_link(struct media_link *link, u32 flags);
+The flags argument contains the requested new link flags.
+The only configurable property is the ENABLED link flag to enable/disable a
+link. Links marked with the IMMUTABLE link flag can not be enabled or disabled.
+When a link is enabled or disabled, the media framework calls the
+link_setup operation for the two entities at the source and sink of the link,
+in that order. If the second link_setup call fails, another link_setup call is
+made on the first entity to restore the original link flags.
+Media device drivers can be notified of link setup operations by setting the
+media_device::link_notify pointer to a callback function. If provided, the
+notification callback will be called before enabling and after disabling
+links.
+Entity drivers must implement the link_setup operation if any of their links
+is non-immutable. The operation must either configure the hardware or store
+the configuration information to be applied later.
+Link configuration must not have any side effect on other links. If an enabled
+link at a sink pad prevents another link at the same pad from being disabled,
+the link_setup operation must return -EBUSY and can't implicitly disable the
+first enabled link.

drivers/media/media-device.c

Diff comments View file @ 97548ed

 /*
  * Media device
  *
  * 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
  */
 #include <linux/types.h>
 #include <linux/ioctl.h>
 #include <linux/media.h>
 #include <media/media-device.h>
 #include <media/media-devnode.h>
 #include <media/media-entity.h>
 /* -----------------------------------------------------------------------------
  * Userspace API
  */
 static int media_device_open(struct file *filp)
 {
 	return 0;
 }
 static int media_device_close(struct file *filp)
 {
 	return 0;
 }
 static int media_device_get_info(struct media_device *dev,
 				 struct media_device_info __user *__info)
 {
 	struct media_device_info info;
 	memset(&info, 0, sizeof(info));
 	strlcpy(info.driver, dev->dev->driver->name, sizeof(info.driver));
 	strlcpy(info.model, dev->model, sizeof(info.model));
 	strlcpy(info.serial, dev->serial, sizeof(info.serial));
 	strlcpy(info.bus_info, dev->bus_info, sizeof(info.bus_info));
 	info.media_version = MEDIA_API_VERSION;
 	info.hw_revision = dev->hw_revision;
 	info.driver_version = dev->driver_version;
 	return copy_to_user(__info, &info, sizeof(*__info));
 }
 static struct media_entity *find_entity(struct media_device *mdev, u32 id)
 {
 	struct media_entity *entity;
 	int next = id & MEDIA_ENT_ID_FLAG_NEXT;
 	id &= ~MEDIA_ENT_ID_FLAG_NEXT;
 	spin_lock(&mdev->lock);
 	media_device_for_each_entity(entity, mdev) {
 		if ((entity->id == id && !next) ||
 		    (entity->id > id && next)) {
 			spin_unlock(&mdev->lock);
 			return entity;
 		}
 	}
 	spin_unlock(&mdev->lock);
 	return NULL;
 }
 static long media_device_enum_entities(struct media_device *mdev,
 				       struct media_entity_desc __user *uent)
 {
 	struct media_entity *ent;
 	struct media_entity_desc u_ent;
 	if (copy_from_user(&u_ent.id, &uent->id, sizeof(u_ent.id)))
 		return -EFAULT;
 	ent = find_entity(mdev, u_ent.id);
 	if (ent == NULL)
 		return -EINVAL;
 	u_ent.id = ent->id;
 	u_ent.name[0] = '\0';
 	if (ent->name)
 		strlcpy(u_ent.name, ent->name, sizeof(u_ent.name));
 	u_ent.type = ent->type;
 	u_ent.revision = ent->revision;
 	u_ent.flags = ent->flags;
 	u_ent.group_id = ent->group_id;
 	u_ent.pads = ent->num_pads;
 	u_ent.links = ent->num_links - ent->num_backlinks;
 	u_ent.v4l.major = ent->v4l.major;
 	u_ent.v4l.minor = ent->v4l.minor;
 	if (copy_to_user(uent, &u_ent, sizeof(u_ent)))
 		return -EFAULT;
 	return 0;
 }
 static void media_device_kpad_to_upad(const struct media_pad *kpad,
 				      struct media_pad_desc *upad)
 {
 	upad->entity = kpad->entity->id;
 	upad->index = kpad->index;
 	upad->flags = kpad->flags;
 }
 static long media_device_enum_links(struct media_device *mdev,
 				    struct media_links_enum __user *ulinks)
 {
 	struct media_entity *entity;
 	struct media_links_enum links;
 	if (copy_from_user(&links, ulinks, sizeof(links)))
 		return -EFAULT;
 	entity = find_entity(mdev, links.entity);
 	if (entity == NULL)
 		return -EINVAL;
 	if (links.pads) {
 		unsigned int p;
 		for (p = 0; p < entity->num_pads; p++) {
 			struct media_pad_desc pad;
 			media_device_kpad_to_upad(&entity->pads[p], &pad);
 			if (copy_to_user(&links.pads[p], &pad, sizeof(pad)))
 				return -EFAULT;
 		}
 	}
 	if (links.links) {
 		struct media_link_desc __user *ulink;
 		unsigned int l;
 		for (l = 0, ulink = links.links; l < entity->num_links; l++) {
 			struct media_link_desc link;
 			/* Ignore backlinks. */
 			if (entity->links[l].source->entity != entity)
 				continue;
 			media_device_kpad_to_upad(entity->links[l].source,
 						  &link.source);
 			media_device_kpad_to_upad(entity->links[l].sink,
 						  &link.sink);
 			link.flags = entity->links[l].flags;
 			if (copy_to_user(ulink, &link, sizeof(*ulink)))
 				return -EFAULT;
 			ulink++;
 		}
 	}
 	if (copy_to_user(ulinks, &links, sizeof(*ulinks)))
 		return -EFAULT;
 	return 0;
 }
+static long media_device_setup_link(struct media_device *mdev,
+				    struct media_link_desc __user *_ulink)
+{
+	struct media_link *link = NULL;
+	struct media_link_desc ulink;
+	struct media_entity *source;
+	struct media_entity *sink;
+	int ret;
+	if (copy_from_user(&ulink, _ulink, sizeof(ulink)))
+		return -EFAULT;
+	/* Find the source and sink entities and link.
+	 */
+	source = find_entity(mdev, ulink.source.entity);
+	sink = find_entity(mdev, ulink.sink.entity);
+	if (source == NULL || sink == NULL)
+		return -EINVAL;
+	if (ulink.source.index >= source->num_pads ||
+	    ulink.sink.index >= sink->num_pads)
+		return -EINVAL;
+	link = media_entity_find_link(&source->pads[ulink.source.index],
+				      &sink->pads[ulink.sink.index]);
+	if (link == NULL)
+		return -EINVAL;
+	/* Setup the link on both entities. */
+	ret = __media_entity_setup_link(link, ulink.flags);
+	if (copy_to_user(_ulink, &ulink, sizeof(ulink)))
+		return -EFAULT;
+	return ret;
+}
 static long media_device_ioctl(struct file *filp, unsigned int cmd,
 			       unsigned long arg)
 {
 	struct media_devnode *devnode = media_devnode_data(filp);
 	struct media_device *dev = to_media_device(devnode);
 	long ret;
 	switch (cmd) {
 	case MEDIA_IOC_DEVICE_INFO:
 		ret = media_device_get_info(dev,
 				(struct media_device_info __user *)arg);
 		break;
 	case MEDIA_IOC_ENUM_ENTITIES:
 		ret = media_device_enum_entities(dev,
 				(struct media_entity_desc __user *)arg);
 		break;
 	case MEDIA_IOC_ENUM_LINKS:
 		mutex_lock(&dev->graph_mutex);
 		ret = media_device_enum_links(dev,
 				(struct media_links_enum __user *)arg);
+		mutex_unlock(&dev->graph_mutex);
+		break;
+	case MEDIA_IOC_SETUP_LINK:
+		mutex_lock(&dev->graph_mutex);
+		ret = media_device_setup_link(dev,
+				(struct media_link_desc __user *)arg);
 		mutex_unlock(&dev->graph_mutex);
 		break;
 	default:
 		ret = -ENOIOCTLCMD;
 	}
 	return ret;
 }
 static const struct media_file_operations media_device_fops = {
 	.owner = THIS_MODULE,
 	.open = media_device_open,
 	.ioctl = media_device_ioctl,
 	.release = media_device_close,
 };
 /* -----------------------------------------------------------------------------
  * sysfs
  */
 static ssize_t show_model(struct device *cd,
 			  struct device_attribute *attr, char *buf)
 {
 	struct media_device *mdev = to_media_device(to_media_devnode(cd));
 	return sprintf(buf, "%.*s\n", (int)sizeof(mdev->model), mdev->model);
 }
 static DEVICE_ATTR(model, S_IRUGO, show_model, NULL);
 /* -----------------------------------------------------------------------------
  * Registration/unregistration
  */
 static void media_device_release(struct media_devnode *mdev)
 {
 }
 /**
  * media_device_register - register a media device
  * @mdev:	The media device
  *
  * The caller is responsible for initializing the media device before
  * registration. The following fields must be set:
  *
  * - dev must point to the parent device
  * - model must be filled with the device model name
  */
 int __must_check media_device_register(struct media_device *mdev)
 {
 	int ret;
 	if (WARN_ON(mdev->dev == NULL || mdev->model[0] == 0))
 		return -EINVAL;
 	mdev->entity_id = 1;
 	INIT_LIST_HEAD(&mdev->entities);
 	spin_lock_init(&mdev->lock);
 	mutex_init(&mdev->graph_mutex);
 	/* Register the device node. */
 	mdev->devnode.fops = &media_device_fops;
 	mdev->devnode.parent = mdev->dev;
 	mdev->devnode.release = media_device_release;
 	ret = media_devnode_register(&mdev->devnode);
 	if (ret < 0)
 		return ret;
 	ret = device_create_file(&mdev->devnode.dev, &dev_attr_model);
 	if (ret < 0) {
 		media_devnode_unregister(&mdev->devnode);
 		return ret;
 	}
 	return 0;
 }
 EXPORT_SYMBOL_GPL(media_device_register);
 /**
  * media_device_unregister - unregister a media device
  * @mdev:	The media device
  *
  */
 void media_device_unregister(struct media_device *mdev)
 {
 	struct media_entity *entity;
 	struct media_entity *next;
 	list_for_each_entry_safe(entity, next, &mdev->entities, list)
 		media_device_unregister_entity(entity);
 	device_remove_file(&mdev->devnode.dev, &dev_attr_model);
 	media_devnode_unregister(&mdev->devnode);
 }
 EXPORT_SYMBOL_GPL(media_device_unregister);
 /**
  * media_device_register_entity - Register an entity with a media device
  * @mdev:	The media device
  * @entity:	The entity
  */
 int __must_check media_device_register_entity(struct media_device *mdev,
 					      struct media_entity *entity)
 {
 	/* Warn if we apparently re-register an entity */
 	WARN_ON(entity->parent != NULL);
 	entity->parent = mdev;
 	spin_lock(&mdev->lock);
 	if (entity->id == 0)
 		entity->id = mdev->entity_id++;
 	else
 		mdev->entity_id = max(entity->id + 1, mdev->entity_id);
 	list_add_tail(&entity->list, &mdev->entities);
 	spin_unlock(&mdev->lock);
 	return 0;
 }
 EXPORT_SYMBOL_GPL(media_device_register_entity);
 /**
  * media_device_unregister_entity - Unregister an entity
  * @entity:	The entity
  *
  * If the entity has never been registered this function will return
  * immediately.
  */
 void media_device_unregister_entity(struct media_entity *entity)
 {
 	struct media_device *mdev = entity->parent;
 	if (mdev == NULL)
 		return;
 	spin_lock(&mdev->lock);
 	list_del(&entity->list);
 	spin_unlock(&mdev->lock);
 	entity->parent = NULL;
 }
 EXPORT_SYMBOL_GPL(media_device_unregister_entity);

drivers/media/media-entity.c

Diff comments View file @ 97548ed

 /*
  * Media entity
  *
  * 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
  */
 #include <linux/module.h>
 #include <linux/slab.h>
 #include <media/media-entity.h>
 #include <media/media-device.h>
 /**
  * media_entity_init - Initialize a media entity
  *
  * @num_pads: Total number of sink and source pads.
  * @extra_links: Initial estimate of the number of extra links.
  * @pads: Array of 'num_pads' pads.
  *
  * The total number of pads is an intrinsic property of entities known by the
  * entity driver, while the total number of links depends on hardware design
  * and is an extrinsic property unknown to the entity driver. However, in most
  * use cases the entity driver can guess the number of links which can safely
  * be assumed to be equal to or larger than the number of pads.
  *
  * For those reasons the links array can be preallocated based on the entity
  * driver guess and will be reallocated later if extra links need to be
  * created.
  *
  * This function allocates a links array with enough space to hold at least
  * 'num_pads' + 'extra_links' elements. The media_entity::max_links field will
  * be set to the number of allocated elements.
  *
  * The pads array is managed by the entity driver and passed to
  * media_entity_init() where its pointer will be stored in the entity structure.
  */
 int
 media_entity_init(struct media_entity *entity, u16 num_pads,
 		  struct media_pad *pads, u16 extra_links)
 {
 	struct media_link *links;
 	unsigned int max_links = num_pads + extra_links;
 	unsigned int i;
 	links = kzalloc(max_links * sizeof(links[0]), GFP_KERNEL);
 	if (links == NULL)
 		return -ENOMEM;
 	entity->group_id = 0;
 	entity->max_links = max_links;
 	entity->num_links = 0;
 	entity->num_backlinks = 0;
 	entity->num_pads = num_pads;
 	entity->pads = pads;
 	entity->links = links;
 	for (i = 0; i < num_pads; i++) {
 		pads[i].entity = entity;
 		pads[i].index = i;
 	}
 	return 0;
 }
 EXPORT_SYMBOL_GPL(media_entity_init);
 void
 media_entity_cleanup(struct media_entity *entity)
 {
 	kfree(entity->links);
 }
 EXPORT_SYMBOL_GPL(media_entity_cleanup);
 /* -----------------------------------------------------------------------------
  * Graph traversal
  */
 static struct media_entity *
 media_entity_other(struct media_entity *entity, struct media_link *link)
 {
 	if (link->source->entity == entity)
 		return link->sink->entity;
 	else
 		return link->source->entity;
 }
 /* push an entity to traversal stack */
 static void stack_push(struct media_entity_graph *graph,
 		       struct media_entity *entity)
 {
 	if (graph->top == MEDIA_ENTITY_ENUM_MAX_DEPTH - 1) {
 		WARN_ON(1);
 		return;
 	}
 	graph->top++;
 	graph->stack[graph->top].link = 0;
 	graph->stack[graph->top].entity = entity;
 }
 static struct media_entity *stack_pop(struct media_entity_graph *graph)
 {
 	struct media_entity *entity;
 	entity = graph->stack[graph->top].entity;
 	graph->top--;
 	return entity;
 }
 #define stack_peek(en)	((en)->stack[(en)->top - 1].entity)
 #define link_top(en)	((en)->stack[(en)->top].link)
 #define stack_top(en)	((en)->stack[(en)->top].entity)
 /**
  * media_entity_graph_walk_start - Start walking the media graph at a given entity
  * @graph: Media graph structure that will be used to walk the graph
  * @entity: Starting entity
  *
  * This function initializes the graph traversal structure to walk the entities
  * graph starting at the given entity. The traversal structure must not be
  * modified by the caller during graph traversal. When done the structure can
  * safely be freed.
  */
 void media_entity_graph_walk_start(struct media_entity_graph *graph,
 				   struct media_entity *entity)
 {
 	graph->top = 0;
 	graph->stack[graph->top].entity = NULL;
 	stack_push(graph, entity);
 }
 EXPORT_SYMBOL_GPL(media_entity_graph_walk_start);
 /**
  * media_entity_graph_walk_next - Get the next entity in the graph
  * @graph: Media graph structure
  *
  * Perform a depth-first traversal of the given media entities graph.
  *
  * The graph structure must have been previously initialized with a call to
  * media_entity_graph_walk_start().
  *
  * Return the next entity in the graph or NULL if the whole graph have been
  * traversed.
  */
 struct media_entity *
 media_entity_graph_walk_next(struct media_entity_graph *graph)
 {
 	if (stack_top(graph) == NULL)
 		return NULL;
 	/*
 	 * Depth first search. Push entity to stack and continue from
 	 * top of the stack until no more entities on the level can be
 	 * found.
 	 */
 	while (link_top(graph) < stack_top(graph)->num_links) {
 		struct media_entity *entity = stack_top(graph);
 		struct media_link *link = &entity->links[link_top(graph)];
 		struct media_entity *next;
 		/* The link is not enabled so we do not follow. */
 		if (!(link->flags & MEDIA_LNK_FL_ENABLED)) {
 			link_top(graph)++;
 			continue;
 		}
 		/* Get the entity in the other end of the link . */
 		next = media_entity_other(entity, link);
 		/* Was it the entity we came here from? */
 		if (next == stack_peek(graph)) {
 			link_top(graph)++;
 			continue;
 		}
 		/* Push the new entity to stack and start over. */
 		link_top(graph)++;
 		stack_push(graph, next);
 	}
 	return stack_pop(graph);
 }
 EXPORT_SYMBOL_GPL(media_entity_graph_walk_next);
 /* -----------------------------------------------------------------------------
  * Module use count
  */
 /*
  * media_entity_get - Get a reference to the parent module
  * @entity: The entity
  *
  * Get a reference to the parent media device module.
  *
  * The function will return immediately if @entity is NULL.
  *
  * Return a pointer to the entity on success or NULL on failure.
  */
 struct media_entity *media_entity_get(struct media_entity *entity)
 {
 	if (entity == NULL)
 		return NULL;
 	if (entity->parent->dev &&
 	    !try_module_get(entity->parent->dev->driver->owner))
 		return NULL;
 	return entity;
 }
 EXPORT_SYMBOL_GPL(media_entity_get);
 /*
  * media_entity_put - Release the reference to the parent module
  * @entity: The entity
  *
  * Release the reference count acquired by media_entity_get().
  *
  * The function will return immediately if @entity is NULL.
  */
 void media_entity_put(struct media_entity *entity)
 {
 	if (entity == NULL)
 		return;
 	if (entity->parent->dev)
 		module_put(entity->parent->dev->driver->owner);
 }
 EXPORT_SYMBOL_GPL(media_entity_put);
 /* -----------------------------------------------------------------------------
  * Links management
  */
 static struct media_link *media_entity_add_link(struct media_entity *entity)
 {
 	if (entity->num_links >= entity->max_links) {
 		struct media_link *links = entity->links;
 		unsigned int max_links = entity->max_links + 2;
 		unsigned int i;
 		links = krealloc(links, max_links * sizeof(*links), GFP_KERNEL);
 		if (links == NULL)
 			return NULL;
 		for (i = 0; i < entity->num_links; i++)
 			links[i].reverse->reverse = &links[i];
 		entity->max_links = max_links;
 		entity->links = links;
 	}
 	return &entity->links[entity->num_links++];
 }
 int
 media_entity_create_link(struct media_entity *source, u16 source_pad,
 			 struct media_entity *sink, u16 sink_pad, u32 flags)
 {
 	struct media_link *link;
 	struct media_link *backlink;
 	BUG_ON(source == NULL || sink == NULL);
 	BUG_ON(source_pad >= source->num_pads);
 	BUG_ON(sink_pad >= sink->num_pads);
 	link = media_entity_add_link(source);
 	if (link == NULL)
 		return -ENOMEM;
 	link->source = &source->pads[source_pad];
 	link->sink = &sink->pads[sink_pad];
 	link->flags = flags;
 	/* Create the backlink. Backlinks are used to help graph traversal and
 	 * are not reported to userspace.
 	 */
 	backlink = media_entity_add_link(sink);
 	if (backlink == NULL) {
 		source->num_links--;
 		return -ENOMEM;
 	}
 	backlink->source = &source->pads[source_pad];
 	backlink->sink = &sink->pads[sink_pad];
 	backlink->flags = flags;
 	link->reverse = backlink;
 	backlink->reverse = link;
 	sink->num_backlinks++;
 	return 0;
 }
 EXPORT_SYMBOL_GPL(media_entity_create_link);
+static int __media_entity_setup_link_notify(struct media_link *link, u32 flags)
+{
+	const u32 mask = MEDIA_LNK_FL_ENABLED;
+	int ret;
+	/* Notify both entities. */
+	ret = media_entity_call(link->source->entity, link_setup,
+				link->source, link->sink, flags);
+	if (ret < 0 && ret != -ENOIOCTLCMD)
+		return ret;
+	ret = media_entity_call(link->sink->entity, link_setup,
+				link->sink, link->source, flags);
+	if (ret < 0 && ret != -ENOIOCTLCMD) {
+		media_entity_call(link->source->entity, link_setup,
+				  link->source, link->sink, link->flags);
+		return ret;
+	}
+	link->flags = (link->flags & ~mask) | (flags & mask);
+	link->reverse->flags = link->flags;
+	return 0;
+}
+/**
+ * __media_entity_setup_link - Configure a media link
+ * @link: The link being configured
+ * @flags: Link configuration flags
+ *
+ * The bulk of link setup is handled by the two entities connected through the
+ * link. This function notifies both entities of the link configuration change.
+ *
+ * If the link is immutable or if the current and new configuration are
+ * identical, return immediately.
+ *
+ * The user is expected to hold link->source->parent->mutex. If not,
+ * media_entity_setup_link() should be used instead.
+ */
+int __media_entity_setup_link(struct media_link *link, u32 flags)
+{
+	struct media_device *mdev;
+	struct media_entity *source, *sink;
+	int ret = -EBUSY;
+	if (link == NULL)
+		return -EINVAL;
+	if (link->flags & MEDIA_LNK_FL_IMMUTABLE)
+		return link->flags == flags ? 0 : -EINVAL;
+	if (link->flags == flags)
+		return 0;
+	source = link->source->entity;
+	sink = link->sink->entity;
+	mdev = source->parent;
+	if ((flags & MEDIA_LNK_FL_ENABLED) && mdev->link_notify) {
+		ret = mdev->link_notify(link->source, link->sink,
+					MEDIA_LNK_FL_ENABLED);
+		if (ret < 0)
+			return ret;
+	}
+	ret = __media_entity_setup_link_notify(link, flags);
+	if (ret < 0)
+		goto err;
+	if (!(flags & MEDIA_LNK_FL_ENABLED) && mdev->link_notify)
+		mdev->link_notify(link->source, link->sink, 0);
+	return 0;
+err:
+	if ((flags & MEDIA_LNK_FL_ENABLED) && mdev->link_notify)
+		mdev->link_notify(link->source, link->sink, 0);
+	return ret;
+}
+int media_entity_setup_link(struct media_link *link, u32 flags)
+{
+	int ret;
+	mutex_lock(&link->source->entity->parent->graph_mutex);
+	ret = __media_entity_setup_link(link, flags);
+	mutex_unlock(&link->source->entity->parent->graph_mutex);
+	return ret;
+}
+EXPORT_SYMBOL_GPL(media_entity_setup_link);
+/**
+ * media_entity_find_link - Find a link between two pads
+ * @source: Source pad
+ * @sink: Sink pad
+ *
+ * Return a pointer to the link between the two entities. If no such link
+ * exists, return NULL.
+ */
+struct media_link *
+media_entity_find_link(struct media_pad *source, struct media_pad *sink)
+{
+	struct media_link *link;
+	unsigned int i;
+	for (i = 0; i < source->entity->num_links; ++i) {
+		link = &source->entity->links[i];
+		if (link->source->entity == source->entity &&
+		    link->source->index == source->index &&
+		    link->sink->entity == sink->entity &&
+		    link->sink->index == sink->index)
+			return link;
+	}
+	return NULL;
+}
+EXPORT_SYMBOL_GPL(media_entity_find_link);
+/**
+ * media_entity_remote_source - Find the source pad at the remote end of a link
+ * @pad: Sink pad at the local end of the link
+ *
+ * Search for a remote source pad connected to the given sink pad by iterating
+ * over all links originating or terminating at that pad until an enabled link
+ * is found.
+ *
+ * Return a pointer to the pad at the remote end of the first found enabled
+ * link, or NULL if no enabled link has been found.
+ */
+struct media_pad *media_entity_remote_source(struct media_pad *pad)
+{
+	unsigned int i;
+	for (i = 0; i < pad->entity->num_links; i++) {
+		struct media_link *link = &pad->entity->links[i];
+		if (!(link->flags & MEDIA_LNK_FL_ENABLED))
+			continue;
+		if (link->source == pad)
+			return link->sink;
+		if (link->sink == pad)
+			return link->source;
+	}
+	return NULL;
+}
+EXPORT_SYMBOL_GPL(media_entity_remote_source);

include/linux/media.h

Diff comments View file @ 97548ed

 /*
  * Multimedia device 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_MEDIA_H
 #define __LINUX_MEDIA_H
 #include <linux/ioctl.h>
 #include <linux/types.h>
 #include <linux/version.h>
 #define MEDIA_API_VERSION	KERNEL_VERSION(0, 1, 0)
 struct media_device_info {
 	char driver[16];
 	char model[32];
 	char serial[40];
 	char bus_info[32];
 	__u32 media_version;
 	__u32 hw_revision;
 	__u32 driver_version;
 	__u32 reserved[31];
 };
 #define MEDIA_ENT_ID_FLAG_NEXT		(1 << 31)
 #define MEDIA_ENT_TYPE_SHIFT		16
 #define MEDIA_ENT_TYPE_MASK		0x00ff0000
 #define MEDIA_ENT_SUBTYPE_MASK		0x0000ffff
 #define MEDIA_ENT_T_DEVNODE		(1 << MEDIA_ENT_TYPE_SHIFT)
 #define MEDIA_ENT_T_DEVNODE_V4L		(MEDIA_ENT_T_DEVNODE + 1)
 #define MEDIA_ENT_T_DEVNODE_FB		(MEDIA_ENT_T_DEVNODE + 2)
 #define MEDIA_ENT_T_DEVNODE_ALSA	(MEDIA_ENT_T_DEVNODE + 3)
 #define MEDIA_ENT_T_DEVNODE_DVB		(MEDIA_ENT_T_DEVNODE + 4)
 #define MEDIA_ENT_T_V4L2_SUBDEV		(2 << MEDIA_ENT_TYPE_SHIFT)
 #define MEDIA_ENT_T_V4L2_SUBDEV_SENSOR	(MEDIA_ENT_T_V4L2_SUBDEV + 1)
 #define MEDIA_ENT_T_V4L2_SUBDEV_FLASH	(MEDIA_ENT_T_V4L2_SUBDEV + 2)
 #define MEDIA_ENT_T_V4L2_SUBDEV_LENS	(MEDIA_ENT_T_V4L2_SUBDEV + 3)
 #define MEDIA_ENT_FL_DEFAULT		(1 << 0)
 struct media_entity_desc {
 	__u32 id;
 	char name[32];
 	__u32 type;
 	__u32 revision;
 	__u32 flags;
 	__u32 group_id;
 	__u16 pads;
 	__u16 links;
 	__u32 reserved[4];
 	union {
 		/* Node specifications */
 		struct {
 			__u32 major;
 			__u32 minor;
 		} v4l;
 		struct {
 			__u32 major;
 			__u32 minor;
 		} fb;
 		struct {
 			__u32 card;
 			__u32 device;
 			__u32 subdevice;
 		} alsa;
 		int dvb;
 		/* Sub-device specifications */
 		/* Nothing needed yet */
 		__u8 raw[184];
 	};
 };
 #define MEDIA_PAD_FL_SINK		(1 << 0)
 #define MEDIA_PAD_FL_SOURCE		(1 << 1)
 struct media_pad_desc {
 	__u32 entity;		/* entity ID */
 	__u16 index;		/* pad index */
 	__u32 flags;		/* pad flags */
 	__u32 reserved[2];
 };
 #define MEDIA_LNK_FL_ENABLED		(1 << 0)
 #define MEDIA_LNK_FL_IMMUTABLE		(1 << 1)
 struct media_link_desc {
 	struct media_pad_desc source;
 	struct media_pad_desc sink;
 	__u32 flags;
 	__u32 reserved[2];
 };
 struct media_links_enum {
 	__u32 entity;
 	/* Should have enough room for pads elements */
 	struct media_pad_desc __user *pads;
 	/* Should have enough room for links elements */
 	struct media_link_desc __user *links;
 	__u32 reserved[4];
 };
 #define MEDIA_IOC_DEVICE_INFO		_IOWR('M', 1, struct media_device_info)
 #define MEDIA_IOC_ENUM_ENTITIES		_IOWR('M', 2, struct media_entity_desc)
 #define MEDIA_IOC_ENUM_LINKS		_IOWR('M', 3, struct media_links_enum)
+#define MEDIA_IOC_SETUP_LINK		_IOWR('M', 4, struct media_link_desc)
 #endif /* __LINUX_MEDIA_H */

include/media/media-device.h

Diff comments View file @ 97548ed

 /*
  * Media device
  *
  * 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 _MEDIA_DEVICE_H
 #define _MEDIA_DEVICE_H
 #include <linux/device.h>
 #include <linux/list.h>
 #include <linux/mutex.h>
 #include <linux/spinlock.h>
 #include <media/media-devnode.h>
 #include <media/media-entity.h>
 /**
  * struct media_device - Media device
  * @dev:	Parent device
  * @devnode:	Media device node
  * @model:	Device model name
  * @serial:	Device serial number (optional)
  * @bus_info:	Unique and stable device location identifier
  * @hw_revision: Hardware device revision
  * @driver_version: Device driver version
  * @entity_id:	ID of the next entity to be registered
  * @entities:	List of registered entities
  * @lock:	Entities list lock
  * @graph_mutex: Entities graph operation lock
  *
  * This structure represents an abstract high-level media device. It allows easy
  * access to entities and provides basic media device-level support. The
  * structure can be allocated directly or embedded in a larger structure.
  *
  * The parent @dev is a physical device. It must be set before registering the
  * media device.
  *
  * @model is a descriptive model name exported through sysfs. It doesn't have to
  * be unique.
  */
 struct media_device {
 	/* dev->driver_data points to this struct. */
 	struct device *dev;
 	struct media_devnode devnode;
 	char model[32];
 	char serial[40];
 	char bus_info[32];
 	u32 hw_revision;
 	u32 driver_version;
 	u32 entity_id;
 	struct list_head entities;
 	/* Protects the entities list */
 	spinlock_t lock;
 	/* Serializes graph operations. */
 	struct mutex graph_mutex;
+	int (*link_notify)(struct media_pad *source,
+			   struct media_pad *sink, u32 flags);
 };
 /* media_devnode to media_device */
 #define to_media_device(node) container_of(node, struct media_device, devnode)
 int __must_check media_device_register(struct media_device *mdev);
 void media_device_unregister(struct media_device *mdev);
 int __must_check media_device_register_entity(struct media_device *mdev,
 					      struct media_entity *entity);
 void media_device_unregister_entity(struct media_entity *entity);
 /* Iterate over all entities. */
 #define media_device_for_each_entity(entity, mdev)			\
 	list_for_each_entry(entity, &(mdev)->entities, list)
 #endif

include/media/media-entity.h

Diff comments View file @ 97548ed

 /*
  * Media entity
  *
  * 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 _MEDIA_ENTITY_H
 #define _MEDIA_ENTITY_H
 #include <linux/list.h>
 #include <linux/media.h>
 struct media_link {
 	struct media_pad *source;	/* Source pad */
 	struct media_pad *sink;		/* Sink pad  */
 	struct media_link *reverse;	/* Link in the reverse direction */
 	unsigned long flags;		/* Link flags (MEDIA_LNK_FL_*) */
 };
 struct media_pad {
 	struct media_entity *entity;	/* Entity this pad belongs to */
 	u16 index;			/* Pad index in the entity pads array */
 	unsigned long flags;		/* Pad flags (MEDIA_PAD_FL_*) */
 };
+struct media_entity_operations {
+	int (*link_setup)(struct media_entity *entity,
+			  const struct media_pad *local,
+			  const struct media_pad *remote, u32 flags);
+};
 struct media_entity {
 	struct list_head list;
 	struct media_device *parent;	/* Media device this entity belongs to*/
 	u32 id;				/* Entity ID, unique in the parent media
 					 * device context */
 	const char *name;		/* Entity name */
 	u32 type;			/* Entity type (MEDIA_ENT_T_*) */
 	u32 revision;			/* Entity revision, driver specific */
 	unsigned long flags;		/* Entity flags (MEDIA_ENT_FL_*) */
 	u32 group_id;			/* Entity group ID */
 	u16 num_pads;			/* Number of sink and source pads */
 	u16 num_links;			/* Number of existing links, both
 					 * enabled and disabled */
 	u16 num_backlinks;		/* Number of backlinks */
 	u16 max_links;			/* Maximum number of links */
 	struct media_pad *pads;		/* Pads array (num_pads elements) */
 	struct media_link *links;	/* Links array (max_links elements)*/
+	const struct media_entity_operations *ops;	/* Entity operations */
 	/* Reference counts must never be negative, but are signed integers on
 	 * purpose: a simple WARN_ON(<0) check can be used to detect reference
 	 * count bugs that would make them negative.
 	 */
 	int use_count;			/* Use count for the entity. */
 	union {
 		/* Node specifications */
 		struct {
 			u32 major;
 			u32 minor;
 		} v4l;
 		struct {
 			u32 major;
 			u32 minor;
 		} fb;
 		struct {
 			u32 card;
 			u32 device;
 			u32 subdevice;
 		} alsa;
 		int dvb;
 		/* Sub-device specifications */
 		/* Nothing needed yet */
 	};
 };
 static inline u32 media_entity_type(struct media_entity *entity)
 {
 	return entity->type & MEDIA_ENT_TYPE_MASK;
 }
 static inline u32 media_entity_subtype(struct media_entity *entity)
 {
 	return entity->type & MEDIA_ENT_SUBTYPE_MASK;
 }
 #define MEDIA_ENTITY_ENUM_MAX_DEPTH	16
 struct media_entity_graph {
 	struct {
 		struct media_entity *entity;
 		int link;
 	} stack[MEDIA_ENTITY_ENUM_MAX_DEPTH];
 	int top;
 };
 int media_entity_init(struct media_entity *entity, u16 num_pads,
 		struct media_pad *pads, u16 extra_links);
 void media_entity_cleanup(struct media_entity *entity);
 int media_entity_create_link(struct media_entity *source, u16 source_pad,
 		struct media_entity *sink, u16 sink_pad, u32 flags);
+int __media_entity_setup_link(struct media_link *link, u32 flags);
+int media_entity_setup_link(struct media_link *link, u32 flags);
+struct media_link *media_entity_find_link(struct media_pad *source,
+		struct media_pad *sink);
+struct media_pad *media_entity_remote_source(struct media_pad *pad);
 struct media_entity *media_entity_get(struct media_entity *entity);
 void media_entity_put(struct media_entity *entity);
 void media_entity_graph_walk_start(struct media_entity_graph *graph,
 		struct media_entity *entity);
 struct media_entity *
 media_entity_graph_walk_next(struct media_entity_graph *graph);
+#define media_entity_call(entity, operation, args...)			\
+	(((entity)->ops && (entity)->ops->operation) ?			\
+	 (entity)->ops->operation((entity) , ##args) : -ENOIOCTLCMD)
 #endif