include/media/cx2341x.h

   1 /*
   2     cx23415/6/8 header containing common defines.
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  17  */
  18
  19 #ifndef CX2341X_H
  20 #define CX2341X_H
  21
  22 enum cx2341x_port {
  23         CX2341X_PORT_MEMORY    = 0,
  24         CX2341X_PORT_STREAMING = 1,
  25         CX2341X_PORT_SERIAL    = 2
  26 };
  27
  28 enum cx2341x_cap {
  29         CX2341X_CAP_HAS_SLICED_VBI = 1 << 0,
  30         CX2341X_CAP_HAS_TS         = 1 << 1,
  31         CX2341X_CAP_HAS_AC3        = 1 << 2,
  32 };
  33
  34 struct cx2341x_mpeg_params {
  35         /* misc */
  36         u32 capabilities;
  37         enum cx2341x_port port;
  38         u16 width;
  39         u16 height;
  40         u16 is_50hz;
  41
  42         /* stream */
  43         enum v4l2_mpeg_stream_type stream_type;
  44         enum v4l2_mpeg_stream_vbi_fmt stream_vbi_fmt;
  45         u16 stream_insert_nav_packets;
  46
  47         /* audio */
  48         enum v4l2_mpeg_audio_sampling_freq audio_sampling_freq;
  49         enum v4l2_mpeg_audio_encoding audio_encoding;
  50         enum v4l2_mpeg_audio_l2_bitrate audio_l2_bitrate;
  51         enum v4l2_mpeg_audio_ac3_bitrate audio_ac3_bitrate;
  52         enum v4l2_mpeg_audio_mode audio_mode;
  53         enum v4l2_mpeg_audio_mode_extension audio_mode_extension;
  54         enum v4l2_mpeg_audio_emphasis audio_emphasis;
  55         enum v4l2_mpeg_audio_crc audio_crc;
  56         u32 audio_properties;
  57         u16 audio_mute;
  58
  59         /* video */
  60         enum v4l2_mpeg_video_encoding video_encoding;
  61         enum v4l2_mpeg_video_aspect video_aspect;
  62         u16 video_b_frames;
  63         u16 video_gop_size;
  64         u16 video_gop_closure;
  65         enum v4l2_mpeg_video_bitrate_mode video_bitrate_mode;
  66         u32 video_bitrate;
  67         u32 video_bitrate_peak;
  68         u16 video_temporal_decimation;
  69         u16 video_mute;
  70         u32 video_mute_yuv;
  71
  72         /* encoding filters */
  73         enum v4l2_mpeg_cx2341x_video_spatial_filter_mode video_spatial_filter_mode;
  74         u16 video_spatial_filter;
  75         enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type video_luma_spatial_filter_type;
  76         enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type video_chroma_spatial_filter_type;
  77         enum v4l2_mpeg_cx2341x_video_temporal_filter_mode video_temporal_filter_mode;
  78         u16 video_temporal_filter;
  79         enum v4l2_mpeg_cx2341x_video_median_filter_type video_median_filter_type;
  80         u16 video_luma_median_filter_top;
  81         u16 video_luma_median_filter_bottom;
  82         u16 video_chroma_median_filter_top;
  83         u16 video_chroma_median_filter_bottom;
  84 };
  85
  86 #define CX2341X_MBOX_MAX_DATA 16
  87
  88 extern const u32 cx2341x_mpeg_ctrls[];
  89 typedef int (*cx2341x_mbox_func)(void *priv, u32 cmd, int in, int out,
  90                 u32 data[CX2341X_MBOX_MAX_DATA]);
  91 int cx2341x_update(void *priv, cx2341x_mbox_func func,
  92                 const struct cx2341x_mpeg_params *old,
  93                 const struct cx2341x_mpeg_params *new);
  94 int cx2341x_ctrl_query(const struct cx2341x_mpeg_params *params,
  95                 struct v4l2_queryctrl *qctrl);
  96 const char **cx2341x_ctrl_get_menu(const struct cx2341x_mpeg_params *p, u32 id);
  97 int cx2341x_ext_ctrls(struct cx2341x_mpeg_params *params, int busy,
  98                 struct v4l2_ext_controls *ctrls, unsigned int cmd);
  99 void cx2341x_fill_defaults(struct cx2341x_mpeg_params *p);
 100 void cx2341x_log_status(const struct cx2341x_mpeg_params *p, const char *prefix);
 101
 102 /* Firmware names */
 103 #define CX2341X_FIRM_ENC_FILENAME "v4l-cx2341x-enc.fw"
 104 /* Decoder firmware for the cx23415 only */
 105 #define CX2341X_FIRM_DEC_FILENAME "v4l-cx2341x-dec.fw"
 106
 107 /* Firmware API commands */
 108
 109 /* MPEG decoder API, specific to the cx23415 */
 110 #define CX2341X_DEC_PING_FW                     0x00
 111 #define CX2341X_DEC_START_PLAYBACK              0x01
 112 #define CX2341X_DEC_STOP_PLAYBACK               0x02
 113 #define CX2341X_DEC_SET_PLAYBACK_SPEED          0x03
 114 #define CX2341X_DEC_STEP_VIDEO                  0x05
 115 #define CX2341X_DEC_SET_DMA_BLOCK_SIZE          0x08
 116 #define CX2341X_DEC_GET_XFER_INFO               0x09
 117 #define CX2341X_DEC_GET_DMA_STATUS              0x0a
 118 #define CX2341X_DEC_SCHED_DMA_FROM_HOST         0x0b
 119 #define CX2341X_DEC_PAUSE_PLAYBACK              0x0d
 120 #define CX2341X_DEC_HALT_FW                     0x0e
 121 #define CX2341X_DEC_SET_STANDARD                0x10
 122 #define CX2341X_DEC_GET_VERSION                 0x11
 123 #define CX2341X_DEC_SET_STREAM_INPUT            0x14
 124 #define CX2341X_DEC_GET_TIMING_INFO             0x15
 125 #define CX2341X_DEC_SET_AUDIO_MODE              0x16
 126 #define CX2341X_DEC_SET_EVENT_NOTIFICATION      0x17
 127 #define CX2341X_DEC_SET_DISPLAY_BUFFERS         0x18
 128 #define CX2341X_DEC_EXTRACT_VBI                 0x19
 129 #define CX2341X_DEC_SET_DECODER_SOURCE          0x1a
 130 #define CX2341X_DEC_SET_PREBUFFERING            0x1e
 131
 132 /* MPEG encoder API */
 133 #define CX2341X_ENC_PING_FW                     0x80
 134 #define CX2341X_ENC_START_CAPTURE               0x81
 135 #define CX2341X_ENC_STOP_CAPTURE                0x82
 136 #define CX2341X_ENC_SET_AUDIO_ID                0x89
 137 #define CX2341X_ENC_SET_VIDEO_ID                0x8b
 138 #define CX2341X_ENC_SET_PCR_ID                  0x8d
 139 #define CX2341X_ENC_SET_FRAME_RATE              0x8f
 140 #define CX2341X_ENC_SET_FRAME_SIZE              0x91
 141 #define CX2341X_ENC_SET_BIT_RATE                0x95
 142 #define CX2341X_ENC_SET_GOP_PROPERTIES          0x97
 143 #define CX2341X_ENC_SET_ASPECT_RATIO            0x99
 144 #define CX2341X_ENC_SET_DNR_FILTER_MODE         0x9b
 145 #define CX2341X_ENC_SET_DNR_FILTER_PROPS        0x9d
 146 #define CX2341X_ENC_SET_CORING_LEVELS           0x9f
 147 #define CX2341X_ENC_SET_SPATIAL_FILTER_TYPE     0xa1
 148 #define CX2341X_ENC_SET_VBI_LINE                0xb7
 149 #define CX2341X_ENC_SET_STREAM_TYPE             0xb9
 150 #define CX2341X_ENC_SET_OUTPUT_PORT             0xbb
 151 #define CX2341X_ENC_SET_AUDIO_PROPERTIES        0xbd
 152 #define CX2341X_ENC_HALT_FW                     0xc3
 153 #define CX2341X_ENC_GET_VERSION                 0xc4
 154 #define CX2341X_ENC_SET_GOP_CLOSURE             0xc5
 155 #define CX2341X_ENC_GET_SEQ_END                 0xc6
 156 #define CX2341X_ENC_SET_PGM_INDEX_INFO          0xc7
 157 #define CX2341X_ENC_SET_VBI_CONFIG              0xc8
 158 #define CX2341X_ENC_SET_DMA_BLOCK_SIZE          0xc9
 159 #define CX2341X_ENC_GET_PREV_DMA_INFO_MB_10     0xca
 160 #define CX2341X_ENC_GET_PREV_DMA_INFO_MB_9      0xcb
 161 #define CX2341X_ENC_SCHED_DMA_TO_HOST           0xcc
 162 #define CX2341X_ENC_INITIALIZE_INPUT            0xcd
 163 #define CX2341X_ENC_SET_FRAME_DROP_RATE         0xd0
 164 #define CX2341X_ENC_PAUSE_ENCODER               0xd2
 165 #define CX2341X_ENC_REFRESH_INPUT               0xd3
 166 #define CX2341X_ENC_SET_COPYRIGHT               0xd4
 167 #define CX2341X_ENC_SET_EVENT_NOTIFICATION      0xd5
 168 #define CX2341X_ENC_SET_NUM_VSYNC_LINES         0xd6
 169 #define CX2341X_ENC_SET_PLACEHOLDER             0xd7
 170 #define CX2341X_ENC_MUTE_VIDEO                  0xd9
 171 #define CX2341X_ENC_MUTE_AUDIO                  0xda
 172 #define CX2341X_ENC_SET_VERT_CROP_LINE          0xdb
 173 #define CX2341X_ENC_MISC                        0xdc
 174
 175 /* OSD API, specific to the cx23415 */
 176 #define CX2341X_OSD_GET_FRAMEBUFFER             0x41
 177 #define CX2341X_OSD_GET_PIXEL_FORMAT            0x42
 178 #define CX2341X_OSD_SET_PIXEL_FORMAT            0x43
 179 #define CX2341X_OSD_GET_STATE                   0x44
 180 #define CX2341X_OSD_SET_STATE                   0x45
 181 #define CX2341X_OSD_GET_OSD_COORDS              0x46
 182 #define CX2341X_OSD_SET_OSD_COORDS              0x47
 183 #define CX2341X_OSD_GET_SCREEN_COORDS           0x48
 184 #define CX2341X_OSD_SET_SCREEN_COORDS           0x49
 185 #define CX2341X_OSD_GET_GLOBAL_ALPHA            0x4a
 186 #define CX2341X_OSD_SET_GLOBAL_ALPHA            0x4b
 187 #define CX2341X_OSD_SET_BLEND_COORDS            0x4c
 188 #define CX2341X_OSD_GET_FLICKER_STATE           0x4f
 189 #define CX2341X_OSD_SET_FLICKER_STATE           0x50
 190 #define CX2341X_OSD_BLT_COPY                    0x52
 191 #define CX2341X_OSD_BLT_FILL                    0x53
 192 #define CX2341X_OSD_BLT_TEXT                    0x54
 193 #define CX2341X_OSD_SET_FRAMEBUFFER_WINDOW      0x56
 194 #define CX2341X_OSD_SET_CHROMA_KEY              0x60
 195 #define CX2341X_OSD_GET_ALPHA_CONTENT_INDEX     0x61
 196 #define CX2341X_OSD_SET_ALPHA_CONTENT_INDEX     0x62
 197
 198 #endif /* CX2341X_H */