linux/include/media/cx2341x.h
<<
>>
Prefs
   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#include <media/v4l2-ctrls.h>
  23
  24enum cx2341x_port {
  25        CX2341X_PORT_MEMORY    = 0,
  26        CX2341X_PORT_STREAMING = 1,
  27        CX2341X_PORT_SERIAL    = 2
  28};
  29
  30enum cx2341x_cap {
  31        CX2341X_CAP_HAS_SLICED_VBI = 1 << 0,
  32        CX2341X_CAP_HAS_TS         = 1 << 1,
  33        CX2341X_CAP_HAS_AC3        = 1 << 2,
  34};
  35
  36struct cx2341x_mpeg_params {
  37        /* misc */
  38        u32 capabilities;
  39        enum cx2341x_port port;
  40        u16 width;
  41        u16 height;
  42        u16 is_50hz;
  43
  44        /* stream */
  45        enum v4l2_mpeg_stream_type stream_type;
  46        enum v4l2_mpeg_stream_vbi_fmt stream_vbi_fmt;
  47        u16 stream_insert_nav_packets;
  48
  49        /* audio */
  50        enum v4l2_mpeg_audio_sampling_freq audio_sampling_freq;
  51        enum v4l2_mpeg_audio_encoding audio_encoding;
  52        enum v4l2_mpeg_audio_l2_bitrate audio_l2_bitrate;
  53        enum v4l2_mpeg_audio_ac3_bitrate audio_ac3_bitrate;
  54        enum v4l2_mpeg_audio_mode audio_mode;
  55        enum v4l2_mpeg_audio_mode_extension audio_mode_extension;
  56        enum v4l2_mpeg_audio_emphasis audio_emphasis;
  57        enum v4l2_mpeg_audio_crc audio_crc;
  58        u32 audio_properties;
  59        u16 audio_mute;
  60
  61        /* video */
  62        enum v4l2_mpeg_video_encoding video_encoding;
  63        enum v4l2_mpeg_video_aspect video_aspect;
  64        u16 video_b_frames;
  65        u16 video_gop_size;
  66        u16 video_gop_closure;
  67        enum v4l2_mpeg_video_bitrate_mode video_bitrate_mode;
  68        u32 video_bitrate;
  69        u32 video_bitrate_peak;
  70        u16 video_temporal_decimation;
  71        u16 video_mute;
  72        u32 video_mute_yuv;
  73
  74        /* encoding filters */
  75        enum v4l2_mpeg_cx2341x_video_spatial_filter_mode video_spatial_filter_mode;
  76        u16 video_spatial_filter;
  77        enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type video_luma_spatial_filter_type;
  78        enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type video_chroma_spatial_filter_type;
  79        enum v4l2_mpeg_cx2341x_video_temporal_filter_mode video_temporal_filter_mode;
  80        u16 video_temporal_filter;
  81        enum v4l2_mpeg_cx2341x_video_median_filter_type video_median_filter_type;
  82        u16 video_luma_median_filter_top;
  83        u16 video_luma_median_filter_bottom;
  84        u16 video_chroma_median_filter_top;
  85        u16 video_chroma_median_filter_bottom;
  86};
  87
  88#define CX2341X_MBOX_MAX_DATA 16
  89
  90extern const u32 cx2341x_mpeg_ctrls[];
  91typedef int (*cx2341x_mbox_func)(void *priv, u32 cmd, int in, int out,
  92                u32 data[CX2341X_MBOX_MAX_DATA]);
  93int cx2341x_update(void *priv, cx2341x_mbox_func func,
  94                const struct cx2341x_mpeg_params *old,
  95                const struct cx2341x_mpeg_params *new);
  96int cx2341x_ctrl_query(const struct cx2341x_mpeg_params *params,
  97                struct v4l2_queryctrl *qctrl);
  98const char * const *cx2341x_ctrl_get_menu(const struct cx2341x_mpeg_params *p, u32 id);
  99int cx2341x_ext_ctrls(struct cx2341x_mpeg_params *params, int busy,
 100                struct v4l2_ext_controls *ctrls, unsigned int cmd);
 101void cx2341x_fill_defaults(struct cx2341x_mpeg_params *p);
 102void cx2341x_log_status(const struct cx2341x_mpeg_params *p, const char *prefix);
 103
 104struct cx2341x_handler;
 105
 106struct cx2341x_handler_ops {
 107        /* needed for the video clock freq */
 108        int (*s_audio_sampling_freq)(struct cx2341x_handler *hdl, u32 val);
 109        /* needed for dualwatch */
 110        int (*s_audio_mode)(struct cx2341x_handler *hdl, u32 val);
 111        /* needed for setting up the video resolution */
 112        int (*s_video_encoding)(struct cx2341x_handler *hdl, u32 val);
 113        /* needed for setting up the sliced vbi insertion data structures */
 114        int (*s_stream_vbi_fmt)(struct cx2341x_handler *hdl, u32 val);
 115};
 116
 117struct cx2341x_handler {
 118        u32 capabilities;
 119        enum cx2341x_port port;
 120        u16 width;
 121        u16 height;
 122        u16 is_50hz;
 123        u32 audio_properties;
 124
 125        struct v4l2_ctrl_handler hdl;
 126        void *priv;
 127        cx2341x_mbox_func func;
 128        const struct cx2341x_handler_ops *ops;
 129
 130        struct v4l2_ctrl *stream_vbi_fmt;
 131
 132        struct {
 133                /* audio cluster */
 134                struct v4l2_ctrl *audio_sampling_freq;
 135                struct v4l2_ctrl *audio_encoding;
 136                struct v4l2_ctrl *audio_l2_bitrate;
 137                struct v4l2_ctrl *audio_mode;
 138                struct v4l2_ctrl *audio_mode_extension;
 139                struct v4l2_ctrl *audio_emphasis;
 140                struct v4l2_ctrl *audio_crc;
 141                struct v4l2_ctrl *audio_ac3_bitrate;
 142        };
 143
 144        struct {
 145                /* video gop cluster */
 146                struct v4l2_ctrl *video_b_frames;
 147                struct v4l2_ctrl *video_gop_size;
 148        };
 149
 150        struct {
 151                /* stream type cluster */
 152                struct v4l2_ctrl *stream_type;
 153                struct v4l2_ctrl *video_encoding;
 154                struct v4l2_ctrl *video_bitrate_mode;
 155                struct v4l2_ctrl *video_bitrate;
 156                struct v4l2_ctrl *video_bitrate_peak;
 157        };
 158
 159        struct {
 160                /* video mute cluster */
 161                struct v4l2_ctrl *video_mute;
 162                struct v4l2_ctrl *video_mute_yuv;
 163        };
 164
 165        struct {
 166                /* video filter mode cluster */
 167                struct v4l2_ctrl *video_spatial_filter_mode;
 168                struct v4l2_ctrl *video_temporal_filter_mode;
 169                struct v4l2_ctrl *video_median_filter_type;
 170        };
 171
 172        struct {
 173                /* video filter type cluster */
 174                struct v4l2_ctrl *video_luma_spatial_filter_type;
 175                struct v4l2_ctrl *video_chroma_spatial_filter_type;
 176        };
 177
 178        struct  {
 179                /* video filter cluster */
 180                struct v4l2_ctrl *video_spatial_filter;
 181                struct v4l2_ctrl *video_temporal_filter;
 182        };
 183
 184        struct {
 185                /* video median cluster */
 186                struct v4l2_ctrl *video_luma_median_filter_top;
 187                struct v4l2_ctrl *video_luma_median_filter_bottom;
 188                struct v4l2_ctrl *video_chroma_median_filter_top;
 189                struct v4l2_ctrl *video_chroma_median_filter_bottom;
 190        };
 191};
 192
 193int cx2341x_handler_init(struct cx2341x_handler *cxhdl,
 194                         unsigned nr_of_controls_hint);
 195void cx2341x_handler_set_50hz(struct cx2341x_handler *cxhdl, int is_50hz);
 196int cx2341x_handler_setup(struct cx2341x_handler *cxhdl);
 197void cx2341x_handler_set_busy(struct cx2341x_handler *cxhdl, int busy);
 198
 199/* Firmware names */
 200#define CX2341X_FIRM_ENC_FILENAME "v4l-cx2341x-enc.fw"
 201/* Decoder firmware for the cx23415 only */
 202#define CX2341X_FIRM_DEC_FILENAME "v4l-cx2341x-dec.fw"
 203
 204/* Firmware API commands */
 205
 206/* MPEG decoder API, specific to the cx23415 */
 207#define CX2341X_DEC_PING_FW                     0x00
 208#define CX2341X_DEC_START_PLAYBACK              0x01
 209#define CX2341X_DEC_STOP_PLAYBACK               0x02
 210#define CX2341X_DEC_SET_PLAYBACK_SPEED          0x03
 211#define CX2341X_DEC_STEP_VIDEO                  0x05
 212#define CX2341X_DEC_SET_DMA_BLOCK_SIZE          0x08
 213#define CX2341X_DEC_GET_XFER_INFO               0x09
 214#define CX2341X_DEC_GET_DMA_STATUS              0x0a
 215#define CX2341X_DEC_SCHED_DMA_FROM_HOST         0x0b
 216#define CX2341X_DEC_PAUSE_PLAYBACK              0x0d
 217#define CX2341X_DEC_HALT_FW                     0x0e
 218#define CX2341X_DEC_SET_STANDARD                0x10
 219#define CX2341X_DEC_GET_VERSION                 0x11
 220#define CX2341X_DEC_SET_STREAM_INPUT            0x14
 221#define CX2341X_DEC_GET_TIMING_INFO             0x15
 222#define CX2341X_DEC_SET_AUDIO_MODE              0x16
 223#define CX2341X_DEC_SET_EVENT_NOTIFICATION      0x17
 224#define CX2341X_DEC_SET_DISPLAY_BUFFERS         0x18
 225#define CX2341X_DEC_EXTRACT_VBI                 0x19
 226#define CX2341X_DEC_SET_DECODER_SOURCE          0x1a
 227#define CX2341X_DEC_SET_PREBUFFERING            0x1e
 228
 229/* MPEG encoder API */
 230#define CX2341X_ENC_PING_FW                     0x80
 231#define CX2341X_ENC_START_CAPTURE               0x81
 232#define CX2341X_ENC_STOP_CAPTURE                0x82
 233#define CX2341X_ENC_SET_AUDIO_ID                0x89
 234#define CX2341X_ENC_SET_VIDEO_ID                0x8b
 235#define CX2341X_ENC_SET_PCR_ID                  0x8d
 236#define CX2341X_ENC_SET_FRAME_RATE              0x8f
 237#define CX2341X_ENC_SET_FRAME_SIZE              0x91
 238#define CX2341X_ENC_SET_BIT_RATE                0x95
 239#define CX2341X_ENC_SET_GOP_PROPERTIES          0x97
 240#define CX2341X_ENC_SET_ASPECT_RATIO            0x99
 241#define CX2341X_ENC_SET_DNR_FILTER_MODE         0x9b
 242#define CX2341X_ENC_SET_DNR_FILTER_PROPS        0x9d
 243#define CX2341X_ENC_SET_CORING_LEVELS           0x9f
 244#define CX2341X_ENC_SET_SPATIAL_FILTER_TYPE     0xa1
 245#define CX2341X_ENC_SET_VBI_LINE                0xb7
 246#define CX2341X_ENC_SET_STREAM_TYPE             0xb9
 247#define CX2341X_ENC_SET_OUTPUT_PORT             0xbb
 248#define CX2341X_ENC_SET_AUDIO_PROPERTIES        0xbd
 249#define CX2341X_ENC_HALT_FW                     0xc3
 250#define CX2341X_ENC_GET_VERSION                 0xc4
 251#define CX2341X_ENC_SET_GOP_CLOSURE             0xc5
 252#define CX2341X_ENC_GET_SEQ_END                 0xc6
 253#define CX2341X_ENC_SET_PGM_INDEX_INFO          0xc7
 254#define CX2341X_ENC_SET_VBI_CONFIG              0xc8
 255#define CX2341X_ENC_SET_DMA_BLOCK_SIZE          0xc9
 256#define CX2341X_ENC_GET_PREV_DMA_INFO_MB_10     0xca
 257#define CX2341X_ENC_GET_PREV_DMA_INFO_MB_9      0xcb
 258#define CX2341X_ENC_SCHED_DMA_TO_HOST           0xcc
 259#define CX2341X_ENC_INITIALIZE_INPUT            0xcd
 260#define CX2341X_ENC_SET_FRAME_DROP_RATE         0xd0
 261#define CX2341X_ENC_PAUSE_ENCODER               0xd2
 262#define CX2341X_ENC_REFRESH_INPUT               0xd3
 263#define CX2341X_ENC_SET_COPYRIGHT               0xd4
 264#define CX2341X_ENC_SET_EVENT_NOTIFICATION      0xd5
 265#define CX2341X_ENC_SET_NUM_VSYNC_LINES         0xd6
 266#define CX2341X_ENC_SET_PLACEHOLDER             0xd7
 267#define CX2341X_ENC_MUTE_VIDEO                  0xd9
 268#define CX2341X_ENC_MUTE_AUDIO                  0xda
 269#define CX2341X_ENC_SET_VERT_CROP_LINE          0xdb
 270#define CX2341X_ENC_MISC                        0xdc
 271
 272/* OSD API, specific to the cx23415 */
 273#define CX2341X_OSD_GET_FRAMEBUFFER             0x41
 274#define CX2341X_OSD_GET_PIXEL_FORMAT            0x42
 275#define CX2341X_OSD_SET_PIXEL_FORMAT            0x43
 276#define CX2341X_OSD_GET_STATE                   0x44
 277#define CX2341X_OSD_SET_STATE                   0x45
 278#define CX2341X_OSD_GET_OSD_COORDS              0x46
 279#define CX2341X_OSD_SET_OSD_COORDS              0x47
 280#define CX2341X_OSD_GET_SCREEN_COORDS           0x48
 281#define CX2341X_OSD_SET_SCREEN_COORDS           0x49
 282#define CX2341X_OSD_GET_GLOBAL_ALPHA            0x4a
 283#define CX2341X_OSD_SET_GLOBAL_ALPHA            0x4b
 284#define CX2341X_OSD_SET_BLEND_COORDS            0x4c
 285#define CX2341X_OSD_GET_FLICKER_STATE           0x4f
 286#define CX2341X_OSD_SET_FLICKER_STATE           0x50
 287#define CX2341X_OSD_BLT_COPY                    0x52
 288#define CX2341X_OSD_BLT_FILL                    0x53
 289#define CX2341X_OSD_BLT_TEXT                    0x54
 290#define CX2341X_OSD_SET_FRAMEBUFFER_WINDOW      0x56
 291#define CX2341X_OSD_SET_CHROMA_KEY              0x60
 292#define CX2341X_OSD_GET_ALPHA_CONTENT_INDEX     0x61
 293#define CX2341X_OSD_SET_ALPHA_CONTENT_INDEX     0x62
 294
 295#endif /* CX2341X_H */
 296