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