include/media/v4l2-mc.h

   1 /*
   2  * v4l2-mc.h - Media Controller V4L2 types and prototypes
   3  *
   4  * Copyright (C) 2016 Mauro Carvalho Chehab <mchehab@osg.samsung.com>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  */
  16
  17 /**
  18  * enum tuner_pad_index - tuner pad index for MEDIA_ENT_F_TUNER
  19  *
  20  * @TUNER_PAD_RF_INPUT: Radiofrequency (RF) sink pad, usually linked to a
  21  *                      RF connector entity.
  22  * @TUNER_PAD_OUTPUT:   Tuner video output source pad. Contains the video
  23  *                      chrominance and luminance or the hole bandwidth
  24  *                      of the signal converted to an Intermediate Frequency
  25  *                      (IF) or to baseband (on zero-IF tuners).
  26  * @TUNER_PAD_AUD_OUT:  Tuner audio output source pad. Tuners used to decode
  27  *                      analog TV signals have an extra pad for audio output.
  28  *                      Old tuners use an analog stage with a saw filter for
  29  *                      the audio IF frequency. The output of the pad is, in
  30  *                      this case, the audio IF, with should be decoded either
  31  *                      by the bridge chipset (that's the case of cx2388x
  32  *                      chipsets) or may require an external IF sound
  33  *                      processor, like msp34xx. On modern silicon tuners,
  34  *                      the audio IF decoder is usually incorporated at the
  35  *                      tuner. On such case, the output of this pad is an
  36  *                      audio sampled data.
  37  * @TUNER_NUM_PADS:     Number of pads of the tuner.
  38  */
  39 enum tuner_pad_index {
  40         TUNER_PAD_RF_INPUT,
  41         TUNER_PAD_OUTPUT,
  42         TUNER_PAD_AUD_OUT,
  43         TUNER_NUM_PADS
  44 };
  45
  46 /**
  47  * enum if_vid_dec_index - video IF-PLL pad index for
  48  *                         MEDIA_ENT_F_IF_VID_DECODER
  49  *
  50  * @IF_VID_DEC_PAD_IF_INPUT:    video Intermediate Frequency (IF) sink pad
  51  * @IF_VID_DEC_PAD_OUT:         IF-PLL video output source pad. Contains the
  52  *                              video chrominance and luminance IF signals.
  53  * @IF_VID_DEC_PAD_NUM_PADS:    Number of pads of the video IF-PLL.
  54  */
  55 enum if_vid_dec_pad_index {
  56         IF_VID_DEC_PAD_IF_INPUT,
  57         IF_VID_DEC_PAD_OUT,
  58         IF_VID_DEC_PAD_NUM_PADS
  59 };
  60
  61 /**
  62  * enum if_aud_dec_index - audio/sound IF-PLL pad index for
  63  *                         MEDIA_ENT_F_IF_AUD_DECODER
  64  *
  65  * @IF_AUD_DEC_PAD_IF_INPUT:    audio Intermediate Frequency (IF) sink pad
  66  * @IF_AUD_DEC_PAD_OUT:         IF-PLL audio output source pad. Contains the
  67  *                              audio sampled stream data, usually connected
  68  *                              to the bridge bus via an Inter-IC Sound (I2S)
  69  *                              bus.
  70  * @IF_AUD_DEC_PAD_NUM_PADS:    Number of pads of the audio IF-PLL.
  71  */
  72 enum if_aud_dec_pad_index {
  73         IF_AUD_DEC_PAD_IF_INPUT,
  74         IF_AUD_DEC_PAD_OUT,
  75         IF_AUD_DEC_PAD_NUM_PADS
  76 };
  77
  78 /**
  79  * enum demod_pad_index - analog TV pad index for MEDIA_ENT_F_ATV_DECODER
  80  *
  81  * @DEMOD_PAD_IF_INPUT: IF input sink pad.
  82  * @DEMOD_PAD_VID_OUT:  Video output source pad.
  83  * @DEMOD_PAD_VBI_OUT:  Vertical Blank Interface (VBI) output source pad.
  84  * @DEMOD_NUM_PADS:     Maximum number of output pads.
  85  */
  86 enum demod_pad_index {
  87         DEMOD_PAD_IF_INPUT,
  88         DEMOD_PAD_VID_OUT,
  89         DEMOD_PAD_VBI_OUT,
  90         DEMOD_NUM_PADS
  91 };