xref: /OK3568_Linux_fs/kernel/include/media/davinci/vpbe.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Copyright (C) 2010 Texas Instruments Inc
4*4882a593Smuzhiyun  */
5*4882a593Smuzhiyun #ifndef _VPBE_H
6*4882a593Smuzhiyun #define _VPBE_H
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun #include <linux/videodev2.h>
9*4882a593Smuzhiyun #include <linux/i2c.h>
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #include <media/v4l2-dev.h>
12*4882a593Smuzhiyun #include <media/v4l2-ioctl.h>
13*4882a593Smuzhiyun #include <media/v4l2-device.h>
14*4882a593Smuzhiyun #include <media/davinci/vpbe_osd.h>
15*4882a593Smuzhiyun #include <media/davinci/vpbe_venc.h>
16*4882a593Smuzhiyun #include <media/davinci/vpbe_types.h>
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun /* OSD configuration info */
19*4882a593Smuzhiyun struct osd_config_info {
20*4882a593Smuzhiyun 	char module_name[32];
21*4882a593Smuzhiyun };
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun struct vpbe_output {
24*4882a593Smuzhiyun 	struct v4l2_output output;
25*4882a593Smuzhiyun 	/*
26*4882a593Smuzhiyun 	 * If output capabilities include dv_timings, list supported timings
27*4882a593Smuzhiyun 	 * below
28*4882a593Smuzhiyun 	 */
29*4882a593Smuzhiyun 	char *subdev_name;
30*4882a593Smuzhiyun 	/*
31*4882a593Smuzhiyun 	 * defualt_mode identifies the default timings set at the venc or
32*4882a593Smuzhiyun 	 * external encoder.
33*4882a593Smuzhiyun 	 */
34*4882a593Smuzhiyun 	char *default_mode;
35*4882a593Smuzhiyun 	/*
36*4882a593Smuzhiyun 	 * Fields below are used for supporting multiple modes. For example,
37*4882a593Smuzhiyun 	 * LCD panel might support different modes and they are listed here.
38*4882a593Smuzhiyun 	 * Similarly for supporting external encoders, lcd controller port
39*4882a593Smuzhiyun 	 * requires a set of non-standard timing values to be listed here for
40*4882a593Smuzhiyun 	 * each supported mode since venc is used in non-standard timing mode
41*4882a593Smuzhiyun 	 * for interfacing with external encoder similar to configuring lcd
42*4882a593Smuzhiyun 	 * panel timings
43*4882a593Smuzhiyun 	 */
44*4882a593Smuzhiyun 	unsigned int num_modes;
45*4882a593Smuzhiyun 	struct vpbe_enc_mode_info *modes;
46*4882a593Smuzhiyun 	/*
47*4882a593Smuzhiyun 	 * Bus configuration goes here for external encoders. Some encoders
48*4882a593Smuzhiyun 	 * may require multiple interface types for each of the output. For
49*4882a593Smuzhiyun 	 * example, SD modes would use YCC8 where as HD mode would use YCC16.
50*4882a593Smuzhiyun 	 * Not sure if this is needed on a per mode basis instead of per
51*4882a593Smuzhiyun 	 * output basis. If per mode is needed, we may have to move this to
52*4882a593Smuzhiyun 	 * mode_info structure
53*4882a593Smuzhiyun 	 */
54*4882a593Smuzhiyun 	u32 if_params;
55*4882a593Smuzhiyun };
56*4882a593Smuzhiyun 
57*4882a593Smuzhiyun /* encoder configuration info */
58*4882a593Smuzhiyun struct encoder_config_info {
59*4882a593Smuzhiyun 	char module_name[32];
60*4882a593Smuzhiyun 	/* Is this an i2c device ? */
61*4882a593Smuzhiyun 	unsigned int is_i2c:1;
62*4882a593Smuzhiyun 	/* i2c subdevice board info */
63*4882a593Smuzhiyun 	struct i2c_board_info board_info;
64*4882a593Smuzhiyun };
65*4882a593Smuzhiyun 
66*4882a593Smuzhiyun /*amplifier configuration info */
67*4882a593Smuzhiyun struct amp_config_info {
68*4882a593Smuzhiyun 	char module_name[32];
69*4882a593Smuzhiyun 	/* Is this an i2c device ? */
70*4882a593Smuzhiyun 	unsigned int is_i2c:1;
71*4882a593Smuzhiyun 	/* i2c subdevice board info */
72*4882a593Smuzhiyun 	struct i2c_board_info board_info;
73*4882a593Smuzhiyun };
74*4882a593Smuzhiyun 
75*4882a593Smuzhiyun /* structure for defining vpbe display subsystem components */
76*4882a593Smuzhiyun struct vpbe_config {
77*4882a593Smuzhiyun 	char module_name[32];
78*4882a593Smuzhiyun 	/* i2c bus adapter no */
79*4882a593Smuzhiyun 	int i2c_adapter_id;
80*4882a593Smuzhiyun 	struct osd_config_info osd;
81*4882a593Smuzhiyun 	struct encoder_config_info venc;
82*4882a593Smuzhiyun 	/* external encoder information goes here */
83*4882a593Smuzhiyun 	int num_ext_encoders;
84*4882a593Smuzhiyun 	struct encoder_config_info *ext_encoders;
85*4882a593Smuzhiyun 	/* amplifier information goes here */
86*4882a593Smuzhiyun 	struct amp_config_info *amp;
87*4882a593Smuzhiyun 	unsigned int num_outputs;
88*4882a593Smuzhiyun 	/* Order is venc outputs followed by LCD and then external encoders */
89*4882a593Smuzhiyun 	struct vpbe_output *outputs;
90*4882a593Smuzhiyun };
91*4882a593Smuzhiyun 
92*4882a593Smuzhiyun struct vpbe_device;
93*4882a593Smuzhiyun 
94*4882a593Smuzhiyun struct vpbe_device_ops {
95*4882a593Smuzhiyun 	/* Enumerate the outputs */
96*4882a593Smuzhiyun 	int (*enum_outputs)(struct vpbe_device *vpbe_dev,
97*4882a593Smuzhiyun 			    struct v4l2_output *output);
98*4882a593Smuzhiyun 
99*4882a593Smuzhiyun 	/* Set output to the given index */
100*4882a593Smuzhiyun 	int (*set_output)(struct vpbe_device *vpbe_dev,
101*4882a593Smuzhiyun 			 int index);
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun 	/* Get current output */
104*4882a593Smuzhiyun 	unsigned int (*get_output)(struct vpbe_device *vpbe_dev);
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun 	/* Set DV preset at current output */
107*4882a593Smuzhiyun 	int (*s_dv_timings)(struct vpbe_device *vpbe_dev,
108*4882a593Smuzhiyun 			   struct v4l2_dv_timings *dv_timings);
109*4882a593Smuzhiyun 
110*4882a593Smuzhiyun 	/* Get DV presets supported at the output */
111*4882a593Smuzhiyun 	int (*g_dv_timings)(struct vpbe_device *vpbe_dev,
112*4882a593Smuzhiyun 			   struct v4l2_dv_timings *dv_timings);
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun 	/* Enumerate the DV Presets supported at the output */
115*4882a593Smuzhiyun 	int (*enum_dv_timings)(struct vpbe_device *vpbe_dev,
116*4882a593Smuzhiyun 			       struct v4l2_enum_dv_timings *timings_info);
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun 	/* Set std at the output */
119*4882a593Smuzhiyun 	int (*s_std)(struct vpbe_device *vpbe_dev, v4l2_std_id std_id);
120*4882a593Smuzhiyun 
121*4882a593Smuzhiyun 	/* Get the current std at the output */
122*4882a593Smuzhiyun 	int (*g_std)(struct vpbe_device *vpbe_dev, v4l2_std_id *std_id);
123*4882a593Smuzhiyun 
124*4882a593Smuzhiyun 	/* initialize the device */
125*4882a593Smuzhiyun 	int (*initialize)(struct device *dev, struct vpbe_device *vpbe_dev);
126*4882a593Smuzhiyun 
127*4882a593Smuzhiyun 	/* De-initialize the device */
128*4882a593Smuzhiyun 	void (*deinitialize)(struct device *dev, struct vpbe_device *vpbe_dev);
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun 	/* Get the current mode info */
131*4882a593Smuzhiyun 	int (*get_mode_info)(struct vpbe_device *vpbe_dev,
132*4882a593Smuzhiyun 			     struct vpbe_enc_mode_info*);
133*4882a593Smuzhiyun 
134*4882a593Smuzhiyun 	/*
135*4882a593Smuzhiyun 	 * Set the current mode in the encoder. Alternate way of setting
136*4882a593Smuzhiyun 	 * standard or DV preset or custom timings in the encoder
137*4882a593Smuzhiyun 	 */
138*4882a593Smuzhiyun 	int (*set_mode)(struct vpbe_device *vpbe_dev,
139*4882a593Smuzhiyun 			struct vpbe_enc_mode_info*);
140*4882a593Smuzhiyun 	/* Power management operations */
141*4882a593Smuzhiyun 	int (*suspend)(struct vpbe_device *vpbe_dev);
142*4882a593Smuzhiyun 	int (*resume)(struct vpbe_device *vpbe_dev);
143*4882a593Smuzhiyun };
144*4882a593Smuzhiyun 
145*4882a593Smuzhiyun /* struct for vpbe device */
146*4882a593Smuzhiyun struct vpbe_device {
147*4882a593Smuzhiyun 	/* V4l2 device */
148*4882a593Smuzhiyun 	struct v4l2_device v4l2_dev;
149*4882a593Smuzhiyun 	/* vpbe dispay controller cfg */
150*4882a593Smuzhiyun 	struct vpbe_config *cfg;
151*4882a593Smuzhiyun 	/* parent device */
152*4882a593Smuzhiyun 	struct device *pdev;
153*4882a593Smuzhiyun 	/* external encoder v4l2 sub devices */
154*4882a593Smuzhiyun 	struct v4l2_subdev **encoders;
155*4882a593Smuzhiyun 	/* current encoder index */
156*4882a593Smuzhiyun 	int current_sd_index;
157*4882a593Smuzhiyun 	/* external amplifier v4l2 subdevice */
158*4882a593Smuzhiyun 	struct v4l2_subdev *amp;
159*4882a593Smuzhiyun 	struct mutex lock;
160*4882a593Smuzhiyun 	/* device initialized */
161*4882a593Smuzhiyun 	int initialized;
162*4882a593Smuzhiyun 	/* vpbe dac clock */
163*4882a593Smuzhiyun 	struct clk *dac_clk;
164*4882a593Smuzhiyun 	/* osd_device pointer */
165*4882a593Smuzhiyun 	struct osd_state *osd_device;
166*4882a593Smuzhiyun 	/* venc device pointer */
167*4882a593Smuzhiyun 	struct venc_platform_data *venc_device;
168*4882a593Smuzhiyun 	/*
169*4882a593Smuzhiyun 	 * fields below are accessed by users of vpbe_device. Not the
170*4882a593Smuzhiyun 	 * ones above
171*4882a593Smuzhiyun 	 */
172*4882a593Smuzhiyun 
173*4882a593Smuzhiyun 	/* current output */
174*4882a593Smuzhiyun 	int current_out_index;
175*4882a593Smuzhiyun 	/* lock used by caller to do atomic operation on vpbe device */
176*4882a593Smuzhiyun 	/* current timings set in the controller */
177*4882a593Smuzhiyun 	struct vpbe_enc_mode_info current_timings;
178*4882a593Smuzhiyun 	/* venc sub device */
179*4882a593Smuzhiyun 	struct v4l2_subdev *venc;
180*4882a593Smuzhiyun 	/* device operations below */
181*4882a593Smuzhiyun 	struct vpbe_device_ops ops;
182*4882a593Smuzhiyun };
183*4882a593Smuzhiyun 
184*4882a593Smuzhiyun #endif
185