1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * cx18 header containing common defines.
4 *
5 * Copyright (C) 2007 Hans Verkuil <hverkuil@xs4all.nl>
6 */
7
8#ifndef CX23418_H
9#define CX23418_H
10
11#include <media/drv-intf/cx2341x.h>
12
13#define MGR_CMD_MASK 0x40000000
14/* The MSB of the command code indicates that this is the completion of a
15 command */
16#define MGR_CMD_MASK_ACK (MGR_CMD_MASK | 0x80000000)
17
18/* Description: This command creates a new instance of a certain task
19 IN[0] - Task ID. This is one of the XPU_CMD_MASK_YYY where XPU is
20 the processor on which the task YYY will be created
21 OUT[0] - Task handle. This handle is passed along with commands to
22 dispatch to the right instance of the task
23 ReturnCode - One of the ERR_SYS_... */
24#define CX18_CREATE_TASK (MGR_CMD_MASK | 0x0001)
25
26/* Description: This command destroys an instance of a task
27 IN[0] - Task handle. Hanlde of the task to destroy
28 ReturnCode - One of the ERR_SYS_... */
29#define CX18_DESTROY_TASK (MGR_CMD_MASK | 0x0002)
30
31/* All commands for CPU have the following mask set */
32#define CPU_CMD_MASK 0x20000000
33#define CPU_CMD_MASK_DEBUG (CPU_CMD_MASK | 0x00000000)
34#define CPU_CMD_MASK_ACK (CPU_CMD_MASK | 0x80000000)
35#define CPU_CMD_MASK_CAPTURE (CPU_CMD_MASK | 0x00020000)
36#define CPU_CMD_MASK_TS (CPU_CMD_MASK | 0x00040000)
37
38#define EPU_CMD_MASK 0x02000000
39#define EPU_CMD_MASK_DEBUG (EPU_CMD_MASK | 0x000000)
40#define EPU_CMD_MASK_DE (EPU_CMD_MASK | 0x040000)
41
42#define APU_CMD_MASK 0x10000000
43#define APU_CMD_MASK_ACK (APU_CMD_MASK | 0x80000000)
44
45#define CX18_APU_ENCODING_METHOD_MPEG (0 << 28)
46#define CX18_APU_ENCODING_METHOD_AC3 (1 << 28)
47
48/* Description: Command APU to start audio
49 IN[0] - audio parameters (same as CX18_CPU_SET_AUDIO_PARAMETERS?)
50 IN[1] - caller buffer address, or 0
51 ReturnCode - ??? */
52#define CX18_APU_START (APU_CMD_MASK | 0x01)
53
54/* Description: Command APU to stop audio
55 IN[0] - encoding method to stop
56 ReturnCode - ??? */
57#define CX18_APU_STOP (APU_CMD_MASK | 0x02)
58
59/* Description: Command APU to reset the AI
60 ReturnCode - ??? */
61#define CX18_APU_RESETAI (APU_CMD_MASK | 0x05)
62
63/* Description: This command indicates that a Memory Descriptor List has been
64 filled with the requested channel type
65 IN[0] - Task handle. Handle of the task
66 IN[1] - Offset of the MDL_ACK from the beginning of the local DDR.
67 IN[2] - Number of CNXT_MDL_ACK structures in the array pointed to by IN[1]
68 ReturnCode - One of the ERR_DE_... */
69#define CX18_EPU_DMA_DONE (EPU_CMD_MASK_DE | 0x0001)
70
71/* Something interesting happened
72 IN[0] - A value to log
73 IN[1] - An offset of a string in the MiniMe memory;
74 0/zero/NULL means "I have nothing to say" */
75#define CX18_EPU_DEBUG (EPU_CMD_MASK_DEBUG | 0x0003)
76
77/* Reads memory/registers (32-bit)
78 IN[0] - Address
79 OUT[1] - Value */
80#define CX18_CPU_DEBUG_PEEK32 (CPU_CMD_MASK_DEBUG | 0x0003)
81
82/* Description: This command starts streaming with the set channel type
83 IN[0] - Task handle. Handle of the task to start
84 ReturnCode - One of the ERR_CAPTURE_... */
85#define CX18_CPU_CAPTURE_START (CPU_CMD_MASK_CAPTURE | 0x0002)
86
87/* Description: This command stops streaming with the set channel type
88 IN[0] - Task handle. Handle of the task to stop
89 IN[1] - 0 = stop at end of GOP, 1 = stop at end of frame (MPEG only)
90 ReturnCode - One of the ERR_CAPTURE_... */
91#define CX18_CPU_CAPTURE_STOP (CPU_CMD_MASK_CAPTURE | 0x0003)
92
93/* Description: This command pauses streaming with the set channel type
94 IN[0] - Task handle. Handle of the task to pause
95 ReturnCode - One of the ERR_CAPTURE_... */
96#define CX18_CPU_CAPTURE_PAUSE (CPU_CMD_MASK_CAPTURE | 0x0007)
97
98/* Description: This command resumes streaming with the set channel type
99 IN[0] - Task handle. Handle of the task to resume
100 ReturnCode - One of the ERR_CAPTURE_... */
101#define CX18_CPU_CAPTURE_RESUME (CPU_CMD_MASK_CAPTURE | 0x0008)
102
103#define CAPTURE_CHANNEL_TYPE_NONE 0
104#define CAPTURE_CHANNEL_TYPE_MPEG 1
105#define CAPTURE_CHANNEL_TYPE_INDEX 2
106#define CAPTURE_CHANNEL_TYPE_YUV 3
107#define CAPTURE_CHANNEL_TYPE_PCM 4
108#define CAPTURE_CHANNEL_TYPE_VBI 5
109#define CAPTURE_CHANNEL_TYPE_SLICED_VBI 6
110#define CAPTURE_CHANNEL_TYPE_TS 7
111#define CAPTURE_CHANNEL_TYPE_MAX 15
112
113/* Description: This command sets the channel type. This can only be done
114 when stopped.
115 IN[0] - Task handle. Handle of the task to start
116 IN[1] - Channel Type. See Below.
117 ReturnCode - One of the ERR_CAPTURE_... */
118#define CX18_CPU_SET_CHANNEL_TYPE (CPU_CMD_MASK_CAPTURE + 1)
119
120/* Description: Set stream output type
121 IN[0] - task handle. Handle of the task to start
122 IN[1] - type
123 ReturnCode - One of the ERR_CAPTURE_... */
124#define CX18_CPU_SET_STREAM_OUTPUT_TYPE (CPU_CMD_MASK_CAPTURE | 0x0012)
125
126/* Description: Set video input resolution and frame rate
127 IN[0] - task handle
128 IN[1] - reserved
129 IN[2] - reserved
130 IN[3] - reserved
131 IN[4] - reserved
132 IN[5] - frame rate, 0 - 29.97f/s, 1 - 25f/s
133 ReturnCode - One of the ERR_CAPTURE_... */
134#define CX18_CPU_SET_VIDEO_IN (CPU_CMD_MASK_CAPTURE | 0x0004)
135
136/* Description: Set video frame rate
137 IN[0] - task handle. Handle of the task to start
138 IN[1] - video bit rate mode
139 IN[2] - video average rate
140 IN[3] - video peak rate
141 IN[4] - system mux rate
142 ReturnCode - One of the ERR_CAPTURE_... */
143#define CX18_CPU_SET_VIDEO_RATE (CPU_CMD_MASK_CAPTURE | 0x0005)
144
145/* Description: Set video output resolution
146 IN[0] - task handle
147 IN[1] - horizontal size
148 IN[2] - vertical size
149 ReturnCode - One of the ERR_CAPTURE_... */
150#define CX18_CPU_SET_VIDEO_RESOLUTION (CPU_CMD_MASK_CAPTURE | 0x0006)
151
152/* Description: This command set filter parameters
153 IN[0] - Task handle. Handle of the task
154 IN[1] - type, 0 - temporal, 1 - spatial, 2 - median
155 IN[2] - mode, temporal/spatial: 0 - disable, 1 - static, 2 - dynamic
156 median: 0 = disable, 1 = horizontal, 2 = vertical,
157 3 = horizontal/vertical, 4 = diagonal
158 IN[3] - strength, temporal 0 - 31, spatial 0 - 15
159 ReturnCode - One of the ERR_CAPTURE_... */
160#define CX18_CPU_SET_FILTER_PARAM (CPU_CMD_MASK_CAPTURE | 0x0009)
161
162/* Description: This command set spatial filter type
163 IN[0] - Task handle.
164 IN[1] - luma type: 0 = disable, 1 = 1D horizontal only, 2 = 1D vertical only,
165 3 = 2D H/V separable, 4 = 2D symmetric non-separable
166 IN[2] - chroma type: 0 - disable, 1 = 1D horizontal
167 ReturnCode - One of the ERR_CAPTURE_... */
168#define CX18_CPU_SET_SPATIAL_FILTER_TYPE (CPU_CMD_MASK_CAPTURE | 0x000C)
169
170/* Description: This command set coring levels for median filter
171 IN[0] - Task handle.
172 IN[1] - luma_high
173 IN[2] - luma_low
174 IN[3] - chroma_high
175 IN[4] - chroma_low
176 ReturnCode - One of the ERR_CAPTURE_... */
177#define CX18_CPU_SET_MEDIAN_CORING (CPU_CMD_MASK_CAPTURE | 0x000E)
178
179/* Description: This command set the picture type mask for index file
180 IN[0] - Task handle (ignored by firmware)
181 IN[1] - 0 = disable index file output
182 1 = output I picture
183 2 = P picture
184 4 = B picture
185 other = illegal */
186#define CX18_CPU_SET_INDEXTABLE (CPU_CMD_MASK_CAPTURE | 0x0010)
187
188/* Description: Set audio parameters
189 IN[0] - task handle. Handle of the task to start
190 IN[1] - audio parameter
191 ReturnCode - One of the ERR_CAPTURE_... */
192#define CX18_CPU_SET_AUDIO_PARAMETERS (CPU_CMD_MASK_CAPTURE | 0x0011)
193
194/* Description: Set video mute
195 IN[0] - task handle. Handle of the task to start
196 IN[1] - bit31-24: muteYvalue
197 bit23-16: muteUvalue
198 bit15-8: muteVvalue
199 bit0: 1:mute, 0: unmute
200 ReturnCode - One of the ERR_CAPTURE_... */
201#define CX18_CPU_SET_VIDEO_MUTE (CPU_CMD_MASK_CAPTURE | 0x0013)
202
203/* Description: Set audio mute
204 IN[0] - task handle. Handle of the task to start
205 IN[1] - mute/unmute
206 ReturnCode - One of the ERR_CAPTURE_... */
207#define CX18_CPU_SET_AUDIO_MUTE (CPU_CMD_MASK_CAPTURE | 0x0014)
208
209/* Description: Set stream output type
210 IN[0] - task handle. Handle of the task to start
211 IN[1] - subType
212 SET_INITIAL_SCR 1
213 SET_QUALITY_MODE 2
214 SET_VIM_PROTECT_MODE 3
215 SET_PTS_CORRECTION 4
216 SET_USB_FLUSH_MODE 5
217 SET_MERAQPAR_ENABLE 6
218 SET_NAV_PACK_INSERTION 7
219 SET_SCENE_CHANGE_ENABLE 8
220 IN[2] - parameter 1
221 IN[3] - parameter 2
222 ReturnCode - One of the ERR_CAPTURE_... */
223#define CX18_CPU_SET_MISC_PARAMETERS (CPU_CMD_MASK_CAPTURE | 0x0015)
224
225/* Description: Set raw VBI parameters
226 IN[0] - Task handle
227 IN[1] - No. of input lines per field:
228 bit[15:0]: field 1,
229 bit[31:16]: field 2
230 IN[2] - No. of input bytes per line
231 IN[3] - No. of output frames per transfer
232 IN[4] - start code
233 IN[5] - stop code
234 ReturnCode */
235#define CX18_CPU_SET_RAW_VBI_PARAM (CPU_CMD_MASK_CAPTURE | 0x0016)
236
237/* Description: Set capture line No.
238 IN[0] - task handle. Handle of the task to start
239 IN[1] - height1
240 IN[2] - height2
241 ReturnCode - One of the ERR_CAPTURE_... */
242#define CX18_CPU_SET_CAPTURE_LINE_NO (CPU_CMD_MASK_CAPTURE | 0x0017)
243
244/* Description: Set copyright
245 IN[0] - task handle. Handle of the task to start
246 IN[1] - copyright
247 ReturnCode - One of the ERR_CAPTURE_... */
248#define CX18_CPU_SET_COPYRIGHT (CPU_CMD_MASK_CAPTURE | 0x0018)
249
250/* Description: Set audio PID
251 IN[0] - task handle. Handle of the task to start
252 IN[1] - PID
253 ReturnCode - One of the ERR_CAPTURE_... */
254#define CX18_CPU_SET_AUDIO_PID (CPU_CMD_MASK_CAPTURE | 0x0019)
255
256/* Description: Set video PID
257 IN[0] - task handle. Handle of the task to start
258 IN[1] - PID
259 ReturnCode - One of the ERR_CAPTURE_... */
260#define CX18_CPU_SET_VIDEO_PID (CPU_CMD_MASK_CAPTURE | 0x001A)
261
262/* Description: Set Vertical Crop Line
263 IN[0] - task handle. Handle of the task to start
264 IN[1] - Line
265 ReturnCode - One of the ERR_CAPTURE_... */
266#define CX18_CPU_SET_VER_CROP_LINE (CPU_CMD_MASK_CAPTURE | 0x001B)
267
268/* Description: Set COP structure
269 IN[0] - task handle. Handle of the task to start
270 IN[1] - M
271 IN[2] - N
272 ReturnCode - One of the ERR_CAPTURE_... */
273#define CX18_CPU_SET_GOP_STRUCTURE (CPU_CMD_MASK_CAPTURE | 0x001C)
274
275/* Description: Set Scene Change Detection
276 IN[0] - task handle. Handle of the task to start
277 IN[1] - scene change
278 ReturnCode - One of the ERR_CAPTURE_... */
279#define CX18_CPU_SET_SCENE_CHANGE_DETECTION (CPU_CMD_MASK_CAPTURE | 0x001D)
280
281/* Description: Set Aspect Ratio
282 IN[0] - task handle. Handle of the task to start
283 IN[1] - AspectRatio
284 ReturnCode - One of the ERR_CAPTURE_... */
285#define CX18_CPU_SET_ASPECT_RATIO (CPU_CMD_MASK_CAPTURE | 0x001E)
286
287/* Description: Set Skip Input Frame
288 IN[0] - task handle. Handle of the task to start
289 IN[1] - skip input frames
290 ReturnCode - One of the ERR_CAPTURE_... */
291#define CX18_CPU_SET_SKIP_INPUT_FRAME (CPU_CMD_MASK_CAPTURE | 0x001F)
292
293/* Description: Set sliced VBI parameters -
294 Note This API will only apply to MPEG and Sliced VBI Channels
295 IN[0] - Task handle
296 IN[1] - output type, 0 - CC, 1 - Moji, 2 - Teletext
297 IN[2] - start / stop line
298 bit[15:0] start line number
299 bit[31:16] stop line number
300 IN[3] - number of output frames per interrupt
301 IN[4] - VBI insertion mode
302 bit 0: output user data, 1 - enable
303 bit 1: output private stream, 1 - enable
304 bit 2: mux option, 0 - in GOP, 1 - in picture
305 bit[7:0] private stream ID
306 IN[5] - insertion period while mux option is in picture
307 ReturnCode - VBI data offset */
308#define CX18_CPU_SET_SLICED_VBI_PARAM (CPU_CMD_MASK_CAPTURE | 0x0020)
309
310/* Description: Set the user data place holder
311 IN[0] - type of data (0 for user)
312 IN[1] - Stuffing period
313 IN[2] - ID data size in word (less than 10)
314 IN[3] - Pointer to ID buffer */
315#define CX18_CPU_SET_USERDATA_PLACE_HOLDER (CPU_CMD_MASK_CAPTURE | 0x0021)
316
317
318/* Description:
319 In[0] Task Handle
320 return parameter:
321 Out[0] Reserved
322 Out[1] Video PTS bit[32:2] of last output video frame.
323 Out[2] Video PTS bit[ 1:0] of last output video frame.
324 Out[3] Hardware Video PTS counter bit[31:0],
325 these bits get incremented on every 90kHz clock tick.
326 Out[4] Hardware Video PTS counter bit32,
327 these bits get incremented on every 90kHz clock tick.
328 ReturnCode */
329#define CX18_CPU_GET_ENC_PTS (CPU_CMD_MASK_CAPTURE | 0x0022)
330
331/* Description: Set VFC parameters
332 IN[0] - task handle
333 IN[1] - VFC enable flag, 1 - enable, 0 - disable
334*/
335#define CX18_CPU_SET_VFC_PARAM (CPU_CMD_MASK_CAPTURE | 0x0023)
336
337/* Below is the list of commands related to the data exchange */
338#define CPU_CMD_MASK_DE (CPU_CMD_MASK | 0x040000)
339
340/* Description: This command provides the physical base address of the local
341 DDR as viewed by EPU
342 IN[0] - Physical offset where EPU has the local DDR mapped
343 ReturnCode - One of the ERR_DE_... */
344#define CPU_CMD_DE_SetBase (CPU_CMD_MASK_DE | 0x0001)
345
346/* Description: This command provides the offsets in the device memory where
347 the 2 cx18_mdl_ack blocks reside
348 IN[0] - Task handle. Handle of the task to start
349 IN[1] - Offset of the first cx18_mdl_ack from the beginning of the
350 local DDR.
351 IN[2] - Offset of the second cx18_mdl_ack from the beginning of the
352 local DDR.
353 ReturnCode - One of the ERR_DE_... */
354#define CX18_CPU_DE_SET_MDL_ACK (CPU_CMD_MASK_DE | 0x0002)
355
356/* Description: This command provides the offset to a Memory Descriptor List
357 IN[0] - Task handle. Handle of the task to start
358 IN[1] - Offset of the MDL from the beginning of the local DDR.
359 IN[2] - Number of cx18_mdl_ent structures in the array pointed to by IN[1]
360 IN[3] - Buffer ID
361 IN[4] - Total buffer length
362 ReturnCode - One of the ERR_DE_... */
363#define CX18_CPU_DE_SET_MDL (CPU_CMD_MASK_DE | 0x0005)
364
365/* Description: This command requests return of all current Memory
366 Descriptor Lists to the driver
367 IN[0] - Task handle. Handle of the task to start
368 ReturnCode - One of the ERR_DE_... */
369#define CX18_CPU_DE_RELEASE_MDL (CPU_CMD_MASK_DE | 0x0006)
370
371/* Description: This command signals the cpu that the dat buffer has been
372 consumed and ready for re-use.
373 IN[0] - Task handle. Handle of the task
374 IN[1] - Offset of the data block from the beginning of the local DDR.
375 IN[2] - Number of bytes in the data block
376 ReturnCode - One of the ERR_DE_... */
377/* #define CX18_CPU_DE_RELEASE_BUFFER (CPU_CMD_MASK_DE | 0x0007) */
378
379/* No Error / Success */
380#define CNXT_OK 0x000000
381
382/* Received unknown command */
383#define CXERR_UNK_CMD 0x000001
384
385/* First parameter in the command is invalid */
386#define CXERR_INVALID_PARAM1 0x000002
387
388/* Second parameter in the command is invalid */
389#define CXERR_INVALID_PARAM2 0x000003
390
391/* Device interface is not open/found */
392#define CXERR_DEV_NOT_FOUND 0x000004
393
394/* Requested function is not implemented/available */
395#define CXERR_NOTSUPPORTED 0x000005
396
397/* Invalid pointer is provided */
398#define CXERR_BADPTR 0x000006
399
400/* Unable to allocate memory */
401#define CXERR_NOMEM 0x000007
402
403/* Object/Link not found */
404#define CXERR_LINK 0x000008
405
406/* Device busy, command cannot be executed */
407#define CXERR_BUSY 0x000009
408
409/* File/device/handle is not open. */
410#define CXERR_NOT_OPEN 0x00000A
411
412/* Value is out of range */
413#define CXERR_OUTOFRANGE 0x00000B
414
415/* Buffer overflow */
416#define CXERR_OVERFLOW 0x00000C
417
418/* Version mismatch */
419#define CXERR_BADVER 0x00000D
420
421/* Operation timed out */
422#define CXERR_TIMEOUT 0x00000E
423
424/* Operation aborted */
425#define CXERR_ABORT 0x00000F
426
427/* Specified I2C device not found for read/write */
428#define CXERR_I2CDEV_NOTFOUND 0x000010
429
430/* Error in I2C data xfer (but I2C device is present) */
431#define CXERR_I2CDEV_XFERERR 0x000011
432
433/* Channel changing component not ready */
434#define CXERR_CHANNELNOTREADY 0x000012
435
436/* PPU (Presensation/Decoder) mail box is corrupted */
437#define CXERR_PPU_MB_CORRUPT 0x000013
438
439/* CPU (Capture/Encoder) mail box is corrupted */
440#define CXERR_CPU_MB_CORRUPT 0x000014
441
442/* APU (Audio) mail box is corrupted */
443#define CXERR_APU_MB_CORRUPT 0x000015
444
445/* Unable to open file for reading */
446#define CXERR_FILE_OPEN_READ 0x000016
447
448/* Unable to open file for writing */
449#define CXERR_FILE_OPEN_WRITE 0x000017
450
451/* Unable to find the I2C section specified */
452#define CXERR_I2C_BADSECTION 0x000018
453
454/* Error in I2C data xfer (but I2C device is present) */
455#define CXERR_I2CDEV_DATALOW 0x000019
456
457/* Error in I2C data xfer (but I2C device is present) */
458#define CXERR_I2CDEV_CLOCKLOW 0x00001A
459
460/* No Interrupt received from HW (for I2C access) */
461#define CXERR_NO_HW_I2C_INTR 0x00001B
462
463/* RPU is not ready to accept commands! */
464#define CXERR_RPU_NOT_READY 0x00001C
465
466/* RPU is not ready to accept commands! */
467#define CXERR_RPU_NO_ACK 0x00001D
468
469/* The are no buffers ready. Try again soon! */
470#define CXERR_NODATA_AGAIN 0x00001E
471
472/* The stream is stopping. Function not allowed now! */
473#define CXERR_STOPPING_STATUS 0x00001F
474
475/* Trying to access hardware when the power is turned OFF */
476#define CXERR_DEVPOWER_OFF 0x000020
477
478#endif /* CX23418_H */
479

source code of linux/drivers/media/pci/cx18/cx23418.h