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