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 24 enum cx2341x_port { 25 CX2341X_PORT_MEMORY = 0, 26 CX2341X_PORT_STREAMING = 1, 27 CX2341X_PORT_SERIAL = 2 28 }; 29 30 enum 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 36 struct 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 90 extern const u32 cx2341x_mpeg_ctrls[]; 91 typedef int (*cx2341x_mbox_func)(void *priv, u32 cmd, int in, int out, 92 u32 data[CX2341X_MBOX_MAX_DATA]); 93 int cx2341x_update(void *priv, cx2341x_mbox_func func, 94 const struct cx2341x_mpeg_params *old, 95 const struct cx2341x_mpeg_params *new); 96 int cx2341x_ctrl_query(const struct cx2341x_mpeg_params *params, 97 struct v4l2_queryctrl *qctrl); 98 const char * const *cx2341x_ctrl_get_menu(const struct cx2341x_mpeg_params *p, u32 id); 99 int cx2341x_ext_ctrls(struct cx2341x_mpeg_params *params, int busy, 100 struct v4l2_ext_controls *ctrls, unsigned int cmd); 101 void cx2341x_fill_defaults(struct cx2341x_mpeg_params *p); 102 void cx2341x_log_status(const struct cx2341x_mpeg_params *p, const char *prefix); 103 104 struct cx2341x_handler; 105 106 struct 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 117 struct 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 193 int cx2341x_handler_init(struct cx2341x_handler *cxhdl, 194 unsigned nr_of_controls_hint); 195 void cx2341x_handler_set_50hz(struct cx2341x_handler *cxhdl, int is_50hz); 196 int cx2341x_handler_setup(struct cx2341x_handler *cxhdl); 197 void 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