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