linux-imx

/*

 * v4l2-mc.h - Media Controller V4L2 types and prototypes

 *

 * Copyright (C) 2016 Mauro Carvalho Chehab <mchehab@kernel.org>

 * Copyright (C) 2006-2010 Nokia Corporation

 * Copyright (c) 2016 Intel Corporation.

 *

 * 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.

 */

​

#ifndef _V4L2_MC_H

#define _V4L2_MC_H

​

#include <media/media-device.h>

#include <media/v4l2-dev.h>

#include <linux/types.h>

​

/* We don't need to include pci.h or usb.h here */

struct pci_dev;

struct usb_device;

​

#ifdef CONFIG_MEDIA_CONTROLLER

/**

 * v4l2_mc_create_media_graph() - create Media Controller links at the graph.

 *

 * @mdev:   pointer to the &media_device struct.

 *

 * Add links between the entities commonly found on PC customer's hardware at

 * the V4L2 side: camera sensors, audio and video PLL-IF decoders, tuners,

 * analog TV decoder and I/O entities (video, VBI and Software Defined Radio).

 *

 * .. note::

 *

 *    Webcams are modelled on a very simple way: the sensor is

 *    connected directly to the I/O entity. All dirty details, like

 *    scaler and crop HW are hidden. While such mapping is enough for v4l2

 *    interface centric PC-consumer's hardware, V4L2 subdev centric camera

 *    hardware should not use this routine, as it will not build the right graph.

 */

int v4l2_mc_create_media_graph(struct media_device *mdev);

​

/**

 * v4l_enable_media_source() -  Hold media source for exclusive use

 *              if free

 *

 * @vdev:   pointer to struct video_device

 *

 * This interface calls enable_source handler to determine if

 * media source is free for use. The enable_source handler is

 * responsible for checking is the media source is free and

 * start a pipeline between the media source and the media

 * entity associated with the video device. This interface

 * should be called from v4l2-core and dvb-core interfaces

 * that change the source configuration.

 *