[mirror_ubuntu-bionic-kernel.git] / include / video / imx-ipu-v3.h

/*
 * Copyright 2005-2009 Freescale Semiconductor, Inc.
 *
 * The code contained herein is licensed under the GNU Lesser General
 * Public License.  You may obtain a copy of the GNU Lesser General
 * Public License Version 2.1 or later at the following locations:
 *
 * http://www.opensource.org/licenses/lgpl-license.html
 * http://www.gnu.org/copyleft/lgpl.html
 */

#ifndef __DRM_IPU_H__
#define __DRM_IPU_H__

#include <linux/types.h>
#include <linux/videodev2.h>
#include <linux/bitmap.h>
#include <linux/fb.h>
#include <linux/of.h>
#include <media/v4l2-mediabus.h>
#include <video/videomode.h>

struct ipu_soc;

enum ipuv3_type {
	IPUV3EX,
	IPUV3M,
	IPUV3H,
};

#define IPU_PIX_FMT_GBR24	v4l2_fourcc('G', 'B', 'R', '3')

/*
 * Bitfield of Display Interface signal polarities.
 */
struct ipu_di_signal_cfg {
	unsigned data_pol:1;	/* true = inverted */
	unsigned clk_pol:1;	/* true = rising edge */
	unsigned enable_pol:1;

	struct videomode mode;

	u32 bus_format;
	u32 v_to_h_sync;

#define IPU_DI_CLKMODE_SYNC	(1 << 0)
#define IPU_DI_CLKMODE_EXT	(1 << 1)
	unsigned long clkflags;

	u8 hsync_pin;
	u8 vsync_pin;
};

/*
 * Enumeration of CSI destinations
 */
enum ipu_csi_dest {
	IPU_CSI_DEST_IDMAC, /* to memory via SMFC */
	IPU_CSI_DEST_IC,	/* to Image Converter */
	IPU_CSI_DEST_VDIC,  /* to VDIC */
};

/*
 * Enumeration of IPU rotation modes
 */
#define IPU_ROT_BIT_VFLIP (1 << 0)
#define IPU_ROT_BIT_HFLIP (1 << 1)
#define IPU_ROT_BIT_90    (1 << 2)

enum ipu_rotate_mode {
	IPU_ROTATE_NONE = 0,
	IPU_ROTATE_VERT_FLIP = IPU_ROT_BIT_VFLIP,
	IPU_ROTATE_HORIZ_FLIP = IPU_ROT_BIT_HFLIP,
	IPU_ROTATE_180 = (IPU_ROT_BIT_VFLIP | IPU_ROT_BIT_HFLIP),
	IPU_ROTATE_90_RIGHT = IPU_ROT_BIT_90,
	IPU_ROTATE_90_RIGHT_VFLIP = (IPU_ROT_BIT_90 | IPU_ROT_BIT_VFLIP),
	IPU_ROTATE_90_RIGHT_HFLIP = (IPU_ROT_BIT_90 | IPU_ROT_BIT_HFLIP),
	IPU_ROTATE_90_LEFT = (IPU_ROT_BIT_90 |
			      IPU_ROT_BIT_VFLIP | IPU_ROT_BIT_HFLIP),
};

/* 90-degree rotations require the IRT unit */
#define ipu_rot_mode_is_irt(m) (((m) & IPU_ROT_BIT_90) != 0)

enum ipu_color_space {
	IPUV3_COLORSPACE_RGB,
	IPUV3_COLORSPACE_YUV,
	IPUV3_COLORSPACE_UNKNOWN,
};

/*
 * Enumeration of VDI MOTION select
 */
enum ipu_motion_sel {
	MOTION_NONE = 0,
	LOW_MOTION,
	MED_MOTION,
	HIGH_MOTION,
};

struct ipuv3_channel;

enum ipu_channel_irq {
	IPU_IRQ_EOF = 0,
	IPU_IRQ_NFACK = 64,
	IPU_IRQ_NFB4EOF = 128,
	IPU_IRQ_EOS = 192,
};

/*
 * Enumeration of IDMAC channels
 */
#define IPUV3_CHANNEL_CSI0			 0
#define IPUV3_CHANNEL_CSI1			 1
#define IPUV3_CHANNEL_CSI2			 2
#define IPUV3_CHANNEL_CSI3			 3
#define IPUV3_CHANNEL_VDI_MEM_IC_VF		 5
/*
 * NOTE: channels 6,7 are unused in the IPU and are not IDMAC channels,
 * but the direct CSI->VDI linking is handled the same way as IDMAC
 * channel linking in the FSU via the IPU_FS_PROC_FLOW registers, so
 * these channel names are used to support the direct CSI->VDI link.
 */
#define IPUV3_CHANNEL_CSI_DIRECT		 6
#define IPUV3_CHANNEL_CSI_VDI_PREV		 7
#define IPUV3_CHANNEL_MEM_VDI_PREV		 8
#define IPUV3_CHANNEL_MEM_VDI_CUR		 9
#define IPUV3_CHANNEL_MEM_VDI_NEXT		10
#define IPUV3_CHANNEL_MEM_IC_PP			11
#define IPUV3_CHANNEL_MEM_IC_PRP_VF		12
#define IPUV3_CHANNEL_VDI_MEM_RECENT		13
#define IPUV3_CHANNEL_G_MEM_IC_PRP_VF		14
#define IPUV3_CHANNEL_G_MEM_IC_PP		15
#define IPUV3_CHANNEL_G_MEM_IC_PRP_VF_ALPHA	17
#define IPUV3_CHANNEL_G_MEM_IC_PP_ALPHA		18
#define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB_ALPHA	19
#define IPUV3_CHANNEL_IC_PRP_ENC_MEM		20
#define IPUV3_CHANNEL_IC_PRP_VF_MEM		21
#define IPUV3_CHANNEL_IC_PP_MEM			22
#define IPUV3_CHANNEL_MEM_BG_SYNC		23
#define IPUV3_CHANNEL_MEM_BG_ASYNC		24
#define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB	25
#define IPUV3_CHANNEL_MEM_VDI_PLANE3_COMB	26
#define IPUV3_CHANNEL_MEM_FG_SYNC		27
#define IPUV3_CHANNEL_MEM_DC_SYNC		28
#define IPUV3_CHANNEL_MEM_FG_ASYNC		29
#define IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA		31
#define IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA	33
#define IPUV3_CHANNEL_DC_MEM_READ		40
#define IPUV3_CHANNEL_MEM_DC_ASYNC		41
#define IPUV3_CHANNEL_MEM_DC_COMMAND		42
#define IPUV3_CHANNEL_MEM_DC_COMMAND2		43
#define IPUV3_CHANNEL_MEM_DC_OUTPUT_MASK	44
#define IPUV3_CHANNEL_MEM_ROT_ENC		45
#define IPUV3_CHANNEL_MEM_ROT_VF		46
#define IPUV3_CHANNEL_MEM_ROT_PP		47
#define IPUV3_CHANNEL_ROT_ENC_MEM		48
#define IPUV3_CHANNEL_ROT_VF_MEM		49
#define IPUV3_CHANNEL_ROT_PP_MEM		50
#define IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA		51
#define IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA	52
#define IPUV3_NUM_CHANNELS			64

int ipu_map_irq(struct ipu_soc *ipu, int irq);
int ipu_idmac_channel_irq(struct ipu_soc *ipu, struct ipuv3_channel *channel,
		enum ipu_channel_irq irq);

#define IPU_IRQ_DP_SF_START		(448 + 2)
#define IPU_IRQ_DP_SF_END		(448 + 3)
#define IPU_IRQ_BG_SF_END		IPU_IRQ_DP_SF_END,
#define IPU_IRQ_DC_FC_0			(448 + 8)
#define IPU_IRQ_DC_FC_1			(448 + 9)
#define IPU_IRQ_DC_FC_2			(448 + 10)
#define IPU_IRQ_DC_FC_3			(448 + 11)
#define IPU_IRQ_DC_FC_4			(448 + 12)
#define IPU_IRQ_DC_FC_6			(448 + 13)
#define IPU_IRQ_VSYNC_PRE_0		(448 + 14)
#define IPU_IRQ_VSYNC_PRE_1		(448 + 15)

/*
 * IPU Common functions
 */
int ipu_get_num(struct ipu_soc *ipu);
void ipu_set_csi_src_mux(struct ipu_soc *ipu, int csi_id, bool mipi_csi2);
void ipu_set_ic_src_mux(struct ipu_soc *ipu, int csi_id, bool vdi);
void ipu_dump(struct ipu_soc *ipu);

/*
 * IPU Image DMA Controller (idmac) functions
 */
struct ipuv3_channel *ipu_idmac_get(struct ipu_soc *ipu, unsigned channel);
void ipu_idmac_put(struct ipuv3_channel *);

int ipu_idmac_enable_channel(struct ipuv3_channel *channel);
int ipu_idmac_disable_channel(struct ipuv3_channel *channel);
void ipu_idmac_enable_watermark(struct ipuv3_channel *channel, bool enable);
int ipu_idmac_lock_enable(struct ipuv3_channel *channel, int num_bursts);
int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms);

void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel,
		bool doublebuffer);
int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel);
bool ipu_idmac_buffer_is_ready(struct ipuv3_channel *channel, u32 buf_num);
void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num);
void ipu_idmac_clear_buffer(struct ipuv3_channel *channel, u32 buf_num);
int ipu_fsu_link(struct ipu_soc *ipu, int src_ch, int sink_ch);
int ipu_fsu_unlink(struct ipu_soc *ipu, int src_ch, int sink_ch);
int ipu_idmac_link(struct ipuv3_channel *src, struct ipuv3_channel *sink);
int ipu_idmac_unlink(struct ipuv3_channel *src, struct ipuv3_channel *sink);

/*
 * IPU Channel Parameter Memory (cpmem) functions
 */
struct ipu_rgb {
	struct fb_bitfield      red;
	struct fb_bitfield      green;
	struct fb_bitfield      blue;
	struct fb_bitfield      transp;
	int                     bits_per_pixel;
};

struct ipu_image {
	struct v4l2_pix_format pix;
	struct v4l2_rect rect;
	dma_addr_t phys0;
	dma_addr_t phys1;
};

void ipu_cpmem_zero(struct ipuv3_channel *ch);
void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres);
void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride);
void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch);
void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf);
void ipu_cpmem_set_uv_offset(struct ipuv3_channel *ch, u32 u_off, u32 v_off);
void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride);
void ipu_cpmem_set_axi_id(struct ipuv3_channel *ch, u32 id);
int ipu_cpmem_get_burstsize(struct ipuv3_channel *ch);
void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize);
void ipu_cpmem_set_block_mode(struct ipuv3_channel *ch);
void ipu_cpmem_set_rotation(struct ipuv3_channel *ch,
			    enum ipu_rotate_mode rot);
int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch,
			     const struct ipu_rgb *rgb);
int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width);
void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format);
void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch,
				   unsigned int uv_stride,
				   unsigned int u_offset,
				   unsigned int v_offset);
int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc);
int ipu_cpmem_set_image(struct ipuv3_channel *ch, struct ipu_image *image);
void ipu_cpmem_dump(struct ipuv3_channel *ch);

/*
 * IPU Display Controller (dc) functions
 */
struct ipu_dc;
struct ipu_di;
struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel);
void ipu_dc_put(struct ipu_dc *dc);
int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced,
		u32 pixel_fmt, u32 width);
void ipu_dc_enable(struct ipu_soc *ipu);
void ipu_dc_enable_channel(struct ipu_dc *dc);
void ipu_dc_disable_channel(struct ipu_dc *dc);
void ipu_dc_disable(struct ipu_soc *ipu);

/*
 * IPU Display Interface (di) functions
 */
struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp);
void ipu_di_put(struct ipu_di *);
int ipu_di_disable(struct ipu_di *);
int ipu_di_enable(struct ipu_di *);
int ipu_di_get_num(struct ipu_di *);
int ipu_di_adjust_videomode(struct ipu_di *di, struct videomode *mode);
int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig);

/*
 * IPU Display Multi FIFO Controller (dmfc) functions
 */
struct dmfc_channel;
int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
void ipu_dmfc_config_wait4eot(struct dmfc_channel *dmfc, int width);
struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel);
void ipu_dmfc_put(struct dmfc_channel *dmfc);

/*
 * IPU Display Processor (dp) functions
 */
#define IPU_DP_FLOW_SYNC_BG	0
#define IPU_DP_FLOW_SYNC_FG	1
#define IPU_DP_FLOW_ASYNC0_BG	2
#define IPU_DP_FLOW_ASYNC0_FG	3
#define IPU_DP_FLOW_ASYNC1_BG	4
#define IPU_DP_FLOW_ASYNC1_FG	5

struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow);
void ipu_dp_put(struct ipu_dp *);
int ipu_dp_enable(struct ipu_soc *ipu);
int ipu_dp_enable_channel(struct ipu_dp *dp);
void ipu_dp_disable_channel(struct ipu_dp *dp, bool sync);
void ipu_dp_disable(struct ipu_soc *ipu);
int ipu_dp_setup_channel(struct ipu_dp *dp,
		enum ipu_color_space in, enum ipu_color_space out);
int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
		bool bg_chan);

/*
 * IPU CMOS Sensor Interface (csi) functions
 */
struct ipu_csi;
int ipu_csi_init_interface(struct ipu_csi *csi,
			   struct v4l2_mbus_config *mbus_cfg,
			   struct v4l2_mbus_framefmt *mbus_fmt);
bool ipu_csi_is_interlaced(struct ipu_csi *csi);
void ipu_csi_get_window(struct ipu_csi *csi, struct v4l2_rect *w);
void ipu_csi_set_window(struct ipu_csi *csi, struct v4l2_rect *w);
void ipu_csi_set_downsize(struct ipu_csi *csi, bool horiz, bool vert);
void ipu_csi_set_test_generator(struct ipu_csi *csi, bool active,
				u32 r_value, u32 g_value, u32 b_value,
				u32 pix_clk);
int ipu_csi_set_mipi_datatype(struct ipu_csi *csi, u32 vc,
			      struct v4l2_mbus_framefmt *mbus_fmt);
int ipu_csi_set_skip_smfc(struct ipu_csi *csi, u32 skip,
			  u32 max_ratio, u32 id);
int ipu_csi_set_dest(struct ipu_csi *csi, enum ipu_csi_dest csi_dest);
int ipu_csi_enable(struct ipu_csi *csi);
int ipu_csi_disable(struct ipu_csi *csi);
struct ipu_csi *ipu_csi_get(struct ipu_soc *ipu, int id);
void ipu_csi_put(struct ipu_csi *csi);
void ipu_csi_dump(struct ipu_csi *csi);

/*
 * IPU Image Converter (ic) functions
 */
enum ipu_ic_task {
	IC_TASK_ENCODER,
	IC_TASK_VIEWFINDER,
	IC_TASK_POST_PROCESSOR,
	IC_NUM_TASKS,
};

struct ipu_ic;
int ipu_ic_task_init(struct ipu_ic *ic,
		     int in_width, int in_height,
		     int out_width, int out_height,
		     enum ipu_color_space in_cs,
		     enum ipu_color_space out_cs);
int ipu_ic_task_graphics_init(struct ipu_ic *ic,
			      enum ipu_color_space in_g_cs,
			      bool galpha_en, u32 galpha,
			      bool colorkey_en, u32 colorkey);
void ipu_ic_task_enable(struct ipu_ic *ic);
void ipu_ic_task_disable(struct ipu_ic *ic);
int ipu_ic_task_idma_init(struct ipu_ic *ic, struct ipuv3_channel *channel,
			  u32 width, u32 height, int burst_size,
			  enum ipu_rotate_mode rot);
int ipu_ic_enable(struct ipu_ic *ic);
int ipu_ic_disable(struct ipu_ic *ic);
struct ipu_ic *ipu_ic_get(struct ipu_soc *ipu, enum ipu_ic_task task);
void ipu_ic_put(struct ipu_ic *ic);
void ipu_ic_dump(struct ipu_ic *ic);

/*
 * IPU Video De-Interlacer (vdi) functions
 */
struct ipu_vdi;
void ipu_vdi_set_field_order(struct ipu_vdi *vdi, v4l2_std_id std, u32 field);
void ipu_vdi_set_motion(struct ipu_vdi *vdi, enum ipu_motion_sel motion_sel);
void ipu_vdi_setup(struct ipu_vdi *vdi, u32 code, int xres, int yres);
void ipu_vdi_unsetup(struct ipu_vdi *vdi);
int ipu_vdi_enable(struct ipu_vdi *vdi);
int ipu_vdi_disable(struct ipu_vdi *vdi);
struct ipu_vdi *ipu_vdi_get(struct ipu_soc *ipu);
void ipu_vdi_put(struct ipu_vdi *vdi);

/*
 * IPU Sensor Multiple FIFO Controller (SMFC) functions
 */
struct ipu_smfc *ipu_smfc_get(struct ipu_soc *ipu, unsigned int chno);
void ipu_smfc_put(struct ipu_smfc *smfc);
int ipu_smfc_enable(struct ipu_smfc *smfc);
int ipu_smfc_disable(struct ipu_smfc *smfc);
int ipu_smfc_map_channel(struct ipu_smfc *smfc, int csi_id, int mipi_id);
int ipu_smfc_set_burstsize(struct ipu_smfc *smfc, int burstsize);
int ipu_smfc_set_watermark(struct ipu_smfc *smfc, u32 set_level, u32 clr_level);

enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
enum ipu_color_space ipu_mbus_code_to_colorspace(u32 mbus_code);
int ipu_stride_to_bytes(u32 pixel_stride, u32 pixelformat);
bool ipu_pixelformat_is_planar(u32 pixelformat);
int ipu_degrees_to_rot_mode(enum ipu_rotate_mode *mode, int degrees,
			    bool hflip, bool vflip);
int ipu_rot_mode_to_degrees(int *degrees, enum ipu_rotate_mode mode,
			    bool hflip, bool vflip);

struct ipu_client_platformdata {
	int csi;
	int di;
	int dc;
	int dp;
	int dma[2];
	struct device_node *of_node;
};

#endif /* __DRM_IPU_H__ */
Commit	Line	Data
aecfbdb1 SH	1	/*
	2	* Copyright 2005-2009 Freescale Semiconductor, Inc.
	3	*
	4	* The code contained herein is licensed under the GNU Lesser General
	5	* Public License. You may obtain a copy of the GNU Lesser General
	6	* Public License Version 2.1 or later at the following locations:
	7	*
	8	* http://www.opensource.org/licenses/lgpl-license.html
	9	* http://www.gnu.org/copyleft/lgpl.html
	10	*/
	11
	12	#ifndef __DRM_IPU_H__
	13	#define __DRM_IPU_H__
	14
	15	#include <linux/types.h>
	16	#include <linux/videodev2.h>
	17	#include <linux/bitmap.h>
	18	#include <linux/fb.h>
310944d1	19	#include <linux/of.h>
2ffd48f2	20	#include <media/v4l2-mediabus.h>
6541d710	21	#include <video/videomode.h>
aecfbdb1 SH	22
	23	struct ipu_soc;
	24
	25	enum ipuv3_type {
	26	IPUV3EX,
	27	IPUV3M,
	28	IPUV3H,
	29	};
	30
7f4392aa PZ	31	#define IPU_PIX_FMT_GBR24 v4l2_fourcc('G', 'B', 'R', '3')
7f4392aa PZ	32
aecfbdb1 SH	33	/*
	34	* Bitfield of Display Interface signal polarities.
	35	*/
	36	struct ipu_di_signal_cfg {
aecfbdb1 SH	37	unsigned data_pol:1; /* true = inverted */
	38	unsigned clk_pol:1; /* true = rising edge */
	39	unsigned enable_pol:1;
aecfbdb1	40
b6835a71 SL	41	struct videomode mode;
b6835a71 SL	42
2872c807	43	u32 bus_format;
aecfbdb1	44	u32 v_to_h_sync;
b6835a71	45
aecfbdb1 SH	46	#define IPU_DI_CLKMODE_SYNC (1 << 0)
	47	#define IPU_DI_CLKMODE_EXT (1 << 1)
	48	unsigned long clkflags;
2ea42608 PZ	49
	50	u8 hsync_pin;
	51	u8 vsync_pin;
aecfbdb1 SH	52	};
aecfbdb1 SH	53
2ffd48f2 SL	54	/*
	55	* Enumeration of CSI destinations
	56	*/
	57	enum ipu_csi_dest {
	58	IPU_CSI_DEST_IDMAC, /* to memory via SMFC */
	59	IPU_CSI_DEST_IC, /* to Image Converter */
	60	IPU_CSI_DEST_VDIC, /* to VDIC */
	61	};
	62
1aa8ea0d SL	63	/*
	64	* Enumeration of IPU rotation modes
	65	*/
8b9c3d50 SL	66	#define IPU_ROT_BIT_VFLIP (1 << 0)
	67	#define IPU_ROT_BIT_HFLIP (1 << 1)
	68	#define IPU_ROT_BIT_90 (1 << 2)
	69
1aa8ea0d SL	70	enum ipu_rotate_mode {
1aa8ea0d SL	71	IPU_ROTATE_NONE = 0,
8b9c3d50 SL	72	IPU_ROTATE_VERT_FLIP = IPU_ROT_BIT_VFLIP,
	73	IPU_ROTATE_HORIZ_FLIP = IPU_ROT_BIT_HFLIP,
	74	IPU_ROTATE_180 = (IPU_ROT_BIT_VFLIP \| IPU_ROT_BIT_HFLIP),
	75	IPU_ROTATE_90_RIGHT = IPU_ROT_BIT_90,
	76	IPU_ROTATE_90_RIGHT_VFLIP = (IPU_ROT_BIT_90 \| IPU_ROT_BIT_VFLIP),
	77	IPU_ROTATE_90_RIGHT_HFLIP = (IPU_ROT_BIT_90 \| IPU_ROT_BIT_HFLIP),
	78	IPU_ROTATE_90_LEFT = (IPU_ROT_BIT_90 \|
	79	IPU_ROT_BIT_VFLIP \| IPU_ROT_BIT_HFLIP),
1aa8ea0d SL	80	};
1aa8ea0d SL	81
8b9c3d50 SL	82	/* 90-degree rotations require the IRT unit */
	83	#define ipu_rot_mode_is_irt(m) (((m) & IPU_ROT_BIT_90) != 0)
	84
aecfbdb1 SH	85	enum ipu_color_space {
	86	IPUV3_COLORSPACE_RGB,
	87	IPUV3_COLORSPACE_YUV,
	88	IPUV3_COLORSPACE_UNKNOWN,
	89	};
	90
2d2ead45 SL	91	/*
	92	* Enumeration of VDI MOTION select
	93	*/
	94	enum ipu_motion_sel {
	95	MOTION_NONE = 0,
	96	LOW_MOTION,
	97	MED_MOTION,
	98	HIGH_MOTION,
	99	};
	100
aecfbdb1 SH	101	struct ipuv3_channel;
	102
	103	enum ipu_channel_irq {
	104	IPU_IRQ_EOF = 0,
	105	IPU_IRQ_NFACK = 64,
	106	IPU_IRQ_NFB4EOF = 128,
	107	IPU_IRQ_EOS = 192,
	108	};
	109
a4cd8f22 SL	110	/*
	111	* Enumeration of IDMAC channels
	112	*/
	113	#define IPUV3_CHANNEL_CSI0 0
	114	#define IPUV3_CHANNEL_CSI1 1
	115	#define IPUV3_CHANNEL_CSI2 2
	116	#define IPUV3_CHANNEL_CSI3 3
	117	#define IPUV3_CHANNEL_VDI_MEM_IC_VF 5
ac4708fa SL	118	/*
	119	* NOTE: channels 6,7 are unused in the IPU and are not IDMAC channels,
	120	* but the direct CSI->VDI linking is handled the same way as IDMAC
	121	* channel linking in the FSU via the IPU_FS_PROC_FLOW registers, so
	122	* these channel names are used to support the direct CSI->VDI link.
	123	*/
	124	#define IPUV3_CHANNEL_CSI_DIRECT 6
	125	#define IPUV3_CHANNEL_CSI_VDI_PREV 7
97afc25c SL	126	#define IPUV3_CHANNEL_MEM_VDI_PREV 8
	127	#define IPUV3_CHANNEL_MEM_VDI_CUR 9
	128	#define IPUV3_CHANNEL_MEM_VDI_NEXT 10
a4cd8f22 SL	129	#define IPUV3_CHANNEL_MEM_IC_PP 11
a4cd8f22 SL	130	#define IPUV3_CHANNEL_MEM_IC_PRP_VF 12
bc0a3387	131	#define IPUV3_CHANNEL_VDI_MEM_RECENT 13
a4cd8f22 SL	132	#define IPUV3_CHANNEL_G_MEM_IC_PRP_VF 14
a4cd8f22 SL	133	#define IPUV3_CHANNEL_G_MEM_IC_PP 15
bc0a3387 PZ	134	#define IPUV3_CHANNEL_G_MEM_IC_PRP_VF_ALPHA 17
	135	#define IPUV3_CHANNEL_G_MEM_IC_PP_ALPHA 18
	136	#define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB_ALPHA 19
a4cd8f22 SL	137	#define IPUV3_CHANNEL_IC_PRP_ENC_MEM 20
	138	#define IPUV3_CHANNEL_IC_PRP_VF_MEM 21
	139	#define IPUV3_CHANNEL_IC_PP_MEM 22
	140	#define IPUV3_CHANNEL_MEM_BG_SYNC 23
	141	#define IPUV3_CHANNEL_MEM_BG_ASYNC 24
bc0a3387 PZ	142	#define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB 25
bc0a3387 PZ	143	#define IPUV3_CHANNEL_MEM_VDI_PLANE3_COMB 26
a4cd8f22 SL	144	#define IPUV3_CHANNEL_MEM_FG_SYNC 27
	145	#define IPUV3_CHANNEL_MEM_DC_SYNC 28
	146	#define IPUV3_CHANNEL_MEM_FG_ASYNC 29
	147	#define IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA 31
bc0a3387 PZ	148	#define IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA 33
bc0a3387 PZ	149	#define IPUV3_CHANNEL_DC_MEM_READ 40
a4cd8f22	150	#define IPUV3_CHANNEL_MEM_DC_ASYNC 41
bc0a3387 PZ	151	#define IPUV3_CHANNEL_MEM_DC_COMMAND 42
	152	#define IPUV3_CHANNEL_MEM_DC_COMMAND2 43
	153	#define IPUV3_CHANNEL_MEM_DC_OUTPUT_MASK 44
a4cd8f22 SL	154	#define IPUV3_CHANNEL_MEM_ROT_ENC 45
	155	#define IPUV3_CHANNEL_MEM_ROT_VF 46
	156	#define IPUV3_CHANNEL_MEM_ROT_PP 47
	157	#define IPUV3_CHANNEL_ROT_ENC_MEM 48
	158	#define IPUV3_CHANNEL_ROT_VF_MEM 49
	159	#define IPUV3_CHANNEL_ROT_PP_MEM 50
	160	#define IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA 51
bc0a3387	161	#define IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA 52
ac4708fa	162	#define IPUV3_NUM_CHANNELS 64
a4cd8f22	163
861a50c1	164	int ipu_map_irq(struct ipu_soc *ipu, int irq);
aecfbdb1 SH	165	int ipu_idmac_channel_irq(struct ipu_soc ipu, struct ipuv3_channel channel,
	166	enum ipu_channel_irq irq);
	167
	168	#define IPU_IRQ_DP_SF_START (448 + 2)
	169	#define IPU_IRQ_DP_SF_END (448 + 3)
	170	#define IPU_IRQ_BG_SF_END IPU_IRQ_DP_SF_END,
	171	#define IPU_IRQ_DC_FC_0 (448 + 8)
	172	#define IPU_IRQ_DC_FC_1 (448 + 9)
	173	#define IPU_IRQ_DC_FC_2 (448 + 10)
	174	#define IPU_IRQ_DC_FC_3 (448 + 11)
	175	#define IPU_IRQ_DC_FC_4 (448 + 12)
	176	#define IPU_IRQ_DC_FC_6 (448 + 13)
	177	#define IPU_IRQ_VSYNC_PRE_0 (448 + 14)
	178	#define IPU_IRQ_VSYNC_PRE_1 (448 + 15)
	179
ba07975f SL	180	/*
	181	* IPU Common functions
	182	*/
572a7615	183	int ipu_get_num(struct ipu_soc *ipu);
ba07975f SL	184	void ipu_set_csi_src_mux(struct ipu_soc *ipu, int csi_id, bool mipi_csi2);
ba07975f SL	185	void ipu_set_ic_src_mux(struct ipu_soc *ipu, int csi_id, bool vdi);
3feb049f	186	void ipu_dump(struct ipu_soc *ipu);
ba07975f	187
aecfbdb1 SH	188	/*
	189	* IPU Image DMA Controller (idmac) functions
	190	*/
	191	struct ipuv3_channel ipu_idmac_get(struct ipu_soc ipu, unsigned channel);
	192	void ipu_idmac_put(struct ipuv3_channel *);
	193
	194	int ipu_idmac_enable_channel(struct ipuv3_channel *channel);
	195	int ipu_idmac_disable_channel(struct ipuv3_channel *channel);
2bcf577e	196	void ipu_idmac_enable_watermark(struct ipuv3_channel *channel, bool enable);
4fd1a07a	197	int ipu_idmac_lock_enable(struct ipuv3_channel *channel, int num_bursts);
fb822a39	198	int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms);
aecfbdb1 SH	199
	200	void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel,
	201	bool doublebuffer);
e9046097	202	int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel);
aa52f578	203	bool ipu_idmac_buffer_is_ready(struct ipuv3_channel *channel, u32 buf_num);
aecfbdb1	204	void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num);
bce6f087	205	void ipu_idmac_clear_buffer(struct ipuv3_channel *channel, u32 buf_num);
ac4708fa SL	206	int ipu_fsu_link(struct ipu_soc *ipu, int src_ch, int sink_ch);
	207	int ipu_fsu_unlink(struct ipu_soc *ipu, int src_ch, int sink_ch);
	208	int ipu_idmac_link(struct ipuv3_channel src, struct ipuv3_channel sink);
	209	int ipu_idmac_unlink(struct ipuv3_channel src, struct ipuv3_channel sink);
aecfbdb1	210
7d2691da SL	211	/*
	212	* IPU Channel Parameter Memory (cpmem) functions
	213	*/
	214	struct ipu_rgb {
	215	struct fb_bitfield red;
	216	struct fb_bitfield green;
	217	struct fb_bitfield blue;
	218	struct fb_bitfield transp;
	219	int bits_per_pixel;
	220	};
	221
	222	struct ipu_image {
	223	struct v4l2_pix_format pix;
	224	struct v4l2_rect rect;
2094b603 SL	225	dma_addr_t phys0;
2094b603 SL	226	dma_addr_t phys1;
7d2691da SL	227	};
	228
	229	void ipu_cpmem_zero(struct ipuv3_channel *ch);
	230	void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres);
	231	void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride);
	232	void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch);
	233	void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf);
e5e8690f	234	void ipu_cpmem_set_uv_offset(struct ipuv3_channel *ch, u32 u_off, u32 v_off);
7d2691da	235	void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride);
555f0e66	236	void ipu_cpmem_set_axi_id(struct ipuv3_channel *ch, u32 id);
03085911	237	int ipu_cpmem_get_burstsize(struct ipuv3_channel *ch);
7d2691da	238	void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize);
9b9da0be	239	void ipu_cpmem_set_block_mode(struct ipuv3_channel *ch);
c42d37ca SL	240	void ipu_cpmem_set_rotation(struct ipuv3_channel *ch,
c42d37ca SL	241	enum ipu_rotate_mode rot);
7d2691da SL	242	int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch,
	243	const struct ipu_rgb *rgb);
	244	int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width);
	245	void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format);
	246	void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch,
90195c36 PZ	247	unsigned int uv_stride,
	248	unsigned int u_offset,
	249	unsigned int v_offset);
7d2691da SL	250	int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc);
7d2691da SL	251	int ipu_cpmem_set_image(struct ipuv3_channel ch, struct ipu_image image);
60c04456	252	void ipu_cpmem_dump(struct ipuv3_channel *ch);
7d2691da	253
aecfbdb1 SH	254	/*
	255	* IPU Display Controller (dc) functions
	256	*/
	257	struct ipu_dc;
	258	struct ipu_di;
	259	struct ipu_dc ipu_dc_get(struct ipu_soc ipu, int channel);
	260	void ipu_dc_put(struct ipu_dc *dc);
	261	int ipu_dc_init_sync(struct ipu_dc dc, struct ipu_di di, bool interlaced,
	262	u32 pixel_fmt, u32 width);
1e6d486b	263	void ipu_dc_enable(struct ipu_soc *ipu);
aecfbdb1 SH	264	void ipu_dc_enable_channel(struct ipu_dc *dc);
aecfbdb1 SH	265	void ipu_dc_disable_channel(struct ipu_dc *dc);
1e6d486b	266	void ipu_dc_disable(struct ipu_soc *ipu);
aecfbdb1 SH	267
	268	/*
	269	* IPU Display Interface (di) functions
	270	*/
	271	struct ipu_di ipu_di_get(struct ipu_soc ipu, int disp);
	272	void ipu_di_put(struct ipu_di *);
	273	int ipu_di_disable(struct ipu_di *);
	274	int ipu_di_enable(struct ipu_di *);
	275	int ipu_di_get_num(struct ipu_di *);
6541d710	276	int ipu_di_adjust_videomode(struct ipu_di di, struct videomode mode);
aecfbdb1 SH	277	int ipu_di_init_sync_panel(struct ipu_di , struct ipu_di_signal_cfg sig);
	278
	279	/*
	280	* IPU Display Multi FIFO Controller (dmfc) functions
	281	*/
	282	struct dmfc_channel;
	283	int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
	284	void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
27630c20	285	void ipu_dmfc_config_wait4eot(struct dmfc_channel *dmfc, int width);
aecfbdb1 SH	286	struct dmfc_channel ipu_dmfc_get(struct ipu_soc ipu, int ipuv3_channel);
	287	void ipu_dmfc_put(struct dmfc_channel *dmfc);
	288
	289	/*
	290	* IPU Display Processor (dp) functions
	291	*/
	292	#define IPU_DP_FLOW_SYNC_BG 0
	293	#define IPU_DP_FLOW_SYNC_FG 1
	294	#define IPU_DP_FLOW_ASYNC0_BG 2
	295	#define IPU_DP_FLOW_ASYNC0_FG 3
	296	#define IPU_DP_FLOW_ASYNC1_BG 4
	297	#define IPU_DP_FLOW_ASYNC1_FG 5
	298
	299	struct ipu_dp ipu_dp_get(struct ipu_soc ipu, unsigned int flow);
	300	void ipu_dp_put(struct ipu_dp *);
285bbb01	301	int ipu_dp_enable(struct ipu_soc *ipu);
aecfbdb1	302	int ipu_dp_enable_channel(struct ipu_dp *dp);
f9bb7acb	303	void ipu_dp_disable_channel(struct ipu_dp *dp, bool sync);
285bbb01	304	void ipu_dp_disable(struct ipu_soc *ipu);
aecfbdb1 SH	305	int ipu_dp_setup_channel(struct ipu_dp *dp,
	306	enum ipu_color_space in, enum ipu_color_space out);
	307	int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
	308	int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
	309	bool bg_chan);
	310
3f5a8a94 PZ	311	/*
	312	* IPU CMOS Sensor Interface (csi) functions
	313	*/
2ffd48f2 SL	314	struct ipu_csi;
	315	int ipu_csi_init_interface(struct ipu_csi *csi,
	316	struct v4l2_mbus_config *mbus_cfg,
	317	struct v4l2_mbus_framefmt *mbus_fmt);
	318	bool ipu_csi_is_interlaced(struct ipu_csi *csi);
	319	void ipu_csi_get_window(struct ipu_csi csi, struct v4l2_rect w);
	320	void ipu_csi_set_window(struct ipu_csi csi, struct v4l2_rect w);
867341b9	321	void ipu_csi_set_downsize(struct ipu_csi *csi, bool horiz, bool vert);
2ffd48f2 SL	322	void ipu_csi_set_test_generator(struct ipu_csi *csi, bool active,
	323	u32 r_value, u32 g_value, u32 b_value,
	324	u32 pix_clk);
	325	int ipu_csi_set_mipi_datatype(struct ipu_csi *csi, u32 vc,
	326	struct v4l2_mbus_framefmt *mbus_fmt);
	327	int ipu_csi_set_skip_smfc(struct ipu_csi *csi, u32 skip,
	328	u32 max_ratio, u32 id);
	329	int ipu_csi_set_dest(struct ipu_csi *csi, enum ipu_csi_dest csi_dest);
	330	int ipu_csi_enable(struct ipu_csi *csi);
	331	int ipu_csi_disable(struct ipu_csi *csi);
	332	struct ipu_csi ipu_csi_get(struct ipu_soc ipu, int id);
	333	void ipu_csi_put(struct ipu_csi *csi);
	334	void ipu_csi_dump(struct ipu_csi *csi);
3f5a8a94	335
1aa8ea0d SL	336	/*
	337	* IPU Image Converter (ic) functions
	338	*/
	339	enum ipu_ic_task {
	340	IC_TASK_ENCODER,
	341	IC_TASK_VIEWFINDER,
	342	IC_TASK_POST_PROCESSOR,
	343	IC_NUM_TASKS,
	344	};
	345
	346	struct ipu_ic;
	347	int ipu_ic_task_init(struct ipu_ic *ic,
	348	int in_width, int in_height,
	349	int out_width, int out_height,
	350	enum ipu_color_space in_cs,
	351	enum ipu_color_space out_cs);
	352	int ipu_ic_task_graphics_init(struct ipu_ic *ic,
	353	enum ipu_color_space in_g_cs,
	354	bool galpha_en, u32 galpha,
	355	bool colorkey_en, u32 colorkey);
	356	void ipu_ic_task_enable(struct ipu_ic *ic);
	357	void ipu_ic_task_disable(struct ipu_ic *ic);
	358	int ipu_ic_task_idma_init(struct ipu_ic ic, struct ipuv3_channel channel,
	359	u32 width, u32 height, int burst_size,
	360	enum ipu_rotate_mode rot);
	361	int ipu_ic_enable(struct ipu_ic *ic);
	362	int ipu_ic_disable(struct ipu_ic *ic);
	363	struct ipu_ic ipu_ic_get(struct ipu_soc ipu, enum ipu_ic_task task);
	364	void ipu_ic_put(struct ipu_ic *ic);
	365	void ipu_ic_dump(struct ipu_ic *ic);
	366
2d2ead45 SL	367	/*
	368	* IPU Video De-Interlacer (vdi) functions
	369	*/
	370	struct ipu_vdi;
	371	void ipu_vdi_set_field_order(struct ipu_vdi *vdi, v4l2_std_id std, u32 field);
	372	void ipu_vdi_set_motion(struct ipu_vdi *vdi, enum ipu_motion_sel motion_sel);
	373	void ipu_vdi_setup(struct ipu_vdi *vdi, u32 code, int xres, int yres);
	374	void ipu_vdi_unsetup(struct ipu_vdi *vdi);
	375	int ipu_vdi_enable(struct ipu_vdi *vdi);
	376	int ipu_vdi_disable(struct ipu_vdi *vdi);
	377	struct ipu_vdi ipu_vdi_get(struct ipu_soc ipu);
	378	void ipu_vdi_put(struct ipu_vdi *vdi);
	379
35de925f PZ	380	/*
	381	* IPU Sensor Multiple FIFO Controller (SMFC) functions
	382	*/
7fafa8f0 SL	383	struct ipu_smfc ipu_smfc_get(struct ipu_soc ipu, unsigned int chno);
	384	void ipu_smfc_put(struct ipu_smfc *smfc);
	385	int ipu_smfc_enable(struct ipu_smfc *smfc);
	386	int ipu_smfc_disable(struct ipu_smfc *smfc);
	387	int ipu_smfc_map_channel(struct ipu_smfc *smfc, int csi_id, int mipi_id);
	388	int ipu_smfc_set_burstsize(struct ipu_smfc *smfc, int burstsize);
a2be35e3	389	int ipu_smfc_set_watermark(struct ipu_smfc *smfc, u32 set_level, u32 clr_level);
35de925f	390
7cb17797	391	enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
aecfbdb1	392	enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
ae0e9708	393	enum ipu_color_space ipu_mbus_code_to_colorspace(u32 mbus_code);
6930afdc	394	int ipu_stride_to_bytes(u32 pixel_stride, u32 pixelformat);
4cea940d	395	bool ipu_pixelformat_is_planar(u32 pixelformat);
f835f386 SL	396	int ipu_degrees_to_rot_mode(enum ipu_rotate_mode *mode, int degrees,
	397	bool hflip, bool vflip);
	398	int ipu_rot_mode_to_degrees(int *degrees, enum ipu_rotate_mode mode,
	399	bool hflip, bool vflip);
aecfbdb1	400
aecfbdb1	401	struct ipu_client_platformdata {
d6ca8ca7	402	int csi;
aecfbdb1 SH	403	int di;
	404	int dc;
	405	int dp;
aecfbdb1	406	int dma[2];
310944d1	407	struct device_node *of_node;
aecfbdb1 SH	408	};
	409
	410	#endif /* __DRM_IPU_H__ */