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> 19 #include <linux/of.h> 20 #include <media/v4l2-mediabus.h> 21 #include <video/videomode.h> 22 23 struct ipu_soc; 24 25 enum ipuv3_type { 26 IPUV3EX, 27 IPUV3M, 28 IPUV3H, 29 }; 30 31 #define IPU_PIX_FMT_GBR24 v4l2_fourcc('G', 'B', 'R', '3') 32 33 /* 34 * Bitfield of Display Interface signal polarities. 35 */ 36 struct ipu_di_signal_cfg { 37 unsigned data_pol:1; /* true = inverted */ 38 unsigned clk_pol:1; /* true = rising edge */ 39 unsigned enable_pol:1; 40 41 struct videomode mode; 42 43 u32 bus_format; 44 u32 v_to_h_sync; 45 46 #define IPU_DI_CLKMODE_SYNC (1 << 0) 47 #define IPU_DI_CLKMODE_EXT (1 << 1) 48 unsigned long clkflags; 49 50 u8 hsync_pin; 51 u8 vsync_pin; 52 }; 53 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 63 /* 64 * Enumeration of IPU rotation modes 65 */ 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 70 enum ipu_rotate_mode { 71 IPU_ROTATE_NONE = 0, 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), 80 }; 81 82 /* 90-degree rotations require the IRT unit */ 83 #define ipu_rot_mode_is_irt(m) (((m) & IPU_ROT_BIT_90) != 0) 84 85 enum ipu_color_space { 86 IPUV3_COLORSPACE_RGB, 87 IPUV3_COLORSPACE_YUV, 88 IPUV3_COLORSPACE_UNKNOWN, 89 }; 90 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 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 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 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 126 #define IPUV3_CHANNEL_MEM_VDI_PREV 8 127 #define IPUV3_CHANNEL_MEM_VDI_CUR 9 128 #define IPUV3_CHANNEL_MEM_VDI_NEXT 10 129 #define IPUV3_CHANNEL_MEM_IC_PP 11 130 #define IPUV3_CHANNEL_MEM_IC_PRP_VF 12 131 #define IPUV3_CHANNEL_VDI_MEM_RECENT 13 132 #define IPUV3_CHANNEL_G_MEM_IC_PRP_VF 14 133 #define IPUV3_CHANNEL_G_MEM_IC_PP 15 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 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 142 #define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB 25 143 #define IPUV3_CHANNEL_MEM_VDI_PLANE3_COMB 26 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 148 #define IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA 33 149 #define IPUV3_CHANNEL_DC_MEM_READ 40 150 #define IPUV3_CHANNEL_MEM_DC_ASYNC 41 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 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 161 #define IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA 52 162 #define IPUV3_NUM_CHANNELS 64 163 164 static inline int ipu_channel_alpha_channel(int ch_num) 165 { 166 switch (ch_num) { 167 case IPUV3_CHANNEL_G_MEM_IC_PRP_VF: 168 return IPUV3_CHANNEL_G_MEM_IC_PRP_VF_ALPHA; 169 case IPUV3_CHANNEL_G_MEM_IC_PP: 170 return IPUV3_CHANNEL_G_MEM_IC_PP_ALPHA; 171 case IPUV3_CHANNEL_MEM_FG_SYNC: 172 return IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA; 173 case IPUV3_CHANNEL_MEM_FG_ASYNC: 174 return IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA; 175 case IPUV3_CHANNEL_MEM_BG_SYNC: 176 return IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA; 177 case IPUV3_CHANNEL_MEM_BG_ASYNC: 178 return IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA; 179 case IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB: 180 return IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB_ALPHA; 181 default: 182 return -EINVAL; 183 } 184 } 185 186 int ipu_map_irq(struct ipu_soc *ipu, int irq); 187 int ipu_idmac_channel_irq(struct ipu_soc *ipu, struct ipuv3_channel *channel, 188 enum ipu_channel_irq irq); 189 190 #define IPU_IRQ_DP_SF_START (448 + 2) 191 #define IPU_IRQ_DP_SF_END (448 + 3) 192 #define IPU_IRQ_BG_SF_END IPU_IRQ_DP_SF_END, 193 #define IPU_IRQ_DC_FC_0 (448 + 8) 194 #define IPU_IRQ_DC_FC_1 (448 + 9) 195 #define IPU_IRQ_DC_FC_2 (448 + 10) 196 #define IPU_IRQ_DC_FC_3 (448 + 11) 197 #define IPU_IRQ_DC_FC_4 (448 + 12) 198 #define IPU_IRQ_DC_FC_6 (448 + 13) 199 #define IPU_IRQ_VSYNC_PRE_0 (448 + 14) 200 #define IPU_IRQ_VSYNC_PRE_1 (448 + 15) 201 202 /* 203 * IPU Common functions 204 */ 205 int ipu_get_num(struct ipu_soc *ipu); 206 void ipu_set_csi_src_mux(struct ipu_soc *ipu, int csi_id, bool mipi_csi2); 207 void ipu_set_ic_src_mux(struct ipu_soc *ipu, int csi_id, bool vdi); 208 void ipu_dump(struct ipu_soc *ipu); 209 210 /* 211 * IPU Image DMA Controller (idmac) functions 212 */ 213 struct ipuv3_channel *ipu_idmac_get(struct ipu_soc *ipu, unsigned channel); 214 void ipu_idmac_put(struct ipuv3_channel *); 215 216 int ipu_idmac_enable_channel(struct ipuv3_channel *channel); 217 int ipu_idmac_disable_channel(struct ipuv3_channel *channel); 218 void ipu_idmac_enable_watermark(struct ipuv3_channel *channel, bool enable); 219 int ipu_idmac_lock_enable(struct ipuv3_channel *channel, int num_bursts); 220 int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms); 221 222 void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel, 223 bool doublebuffer); 224 int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel); 225 bool ipu_idmac_buffer_is_ready(struct ipuv3_channel *channel, u32 buf_num); 226 void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num); 227 void ipu_idmac_clear_buffer(struct ipuv3_channel *channel, u32 buf_num); 228 int ipu_fsu_link(struct ipu_soc *ipu, int src_ch, int sink_ch); 229 int ipu_fsu_unlink(struct ipu_soc *ipu, int src_ch, int sink_ch); 230 int ipu_idmac_link(struct ipuv3_channel *src, struct ipuv3_channel *sink); 231 int ipu_idmac_unlink(struct ipuv3_channel *src, struct ipuv3_channel *sink); 232 233 /* 234 * IPU Channel Parameter Memory (cpmem) functions 235 */ 236 struct ipu_rgb { 237 struct fb_bitfield red; 238 struct fb_bitfield green; 239 struct fb_bitfield blue; 240 struct fb_bitfield transp; 241 int bits_per_pixel; 242 }; 243 244 struct ipu_image { 245 struct v4l2_pix_format pix; 246 struct v4l2_rect rect; 247 dma_addr_t phys0; 248 dma_addr_t phys1; 249 /* chroma plane offset overrides */ 250 u32 u_offset; 251 u32 v_offset; 252 }; 253 254 void ipu_cpmem_zero(struct ipuv3_channel *ch); 255 void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres); 256 void ipu_cpmem_skip_odd_chroma_rows(struct ipuv3_channel *ch); 257 void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride); 258 void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch); 259 void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf); 260 void ipu_cpmem_set_uv_offset(struct ipuv3_channel *ch, u32 u_off, u32 v_off); 261 void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride); 262 void ipu_cpmem_set_axi_id(struct ipuv3_channel *ch, u32 id); 263 int ipu_cpmem_get_burstsize(struct ipuv3_channel *ch); 264 void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize); 265 void ipu_cpmem_set_block_mode(struct ipuv3_channel *ch); 266 void ipu_cpmem_set_rotation(struct ipuv3_channel *ch, 267 enum ipu_rotate_mode rot); 268 int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch, 269 const struct ipu_rgb *rgb); 270 int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width); 271 void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format); 272 void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch, 273 unsigned int uv_stride, 274 unsigned int u_offset, 275 unsigned int v_offset); 276 int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc); 277 int ipu_cpmem_set_image(struct ipuv3_channel *ch, struct ipu_image *image); 278 void ipu_cpmem_dump(struct ipuv3_channel *ch); 279 280 /* 281 * IPU Display Controller (dc) functions 282 */ 283 struct ipu_dc; 284 struct ipu_di; 285 struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel); 286 void ipu_dc_put(struct ipu_dc *dc); 287 int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced, 288 u32 pixel_fmt, u32 width); 289 void ipu_dc_enable(struct ipu_soc *ipu); 290 void ipu_dc_enable_channel(struct ipu_dc *dc); 291 void ipu_dc_disable_channel(struct ipu_dc *dc); 292 void ipu_dc_disable(struct ipu_soc *ipu); 293 294 /* 295 * IPU Display Interface (di) functions 296 */ 297 struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp); 298 void ipu_di_put(struct ipu_di *); 299 int ipu_di_disable(struct ipu_di *); 300 int ipu_di_enable(struct ipu_di *); 301 int ipu_di_get_num(struct ipu_di *); 302 int ipu_di_adjust_videomode(struct ipu_di *di, struct videomode *mode); 303 int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig); 304 305 /* 306 * IPU Display Multi FIFO Controller (dmfc) functions 307 */ 308 struct dmfc_channel; 309 int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc); 310 void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc); 311 void ipu_dmfc_config_wait4eot(struct dmfc_channel *dmfc, int width); 312 struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel); 313 void ipu_dmfc_put(struct dmfc_channel *dmfc); 314 315 /* 316 * IPU Display Processor (dp) functions 317 */ 318 #define IPU_DP_FLOW_SYNC_BG 0 319 #define IPU_DP_FLOW_SYNC_FG 1 320 #define IPU_DP_FLOW_ASYNC0_BG 2 321 #define IPU_DP_FLOW_ASYNC0_FG 3 322 #define IPU_DP_FLOW_ASYNC1_BG 4 323 #define IPU_DP_FLOW_ASYNC1_FG 5 324 325 struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow); 326 void ipu_dp_put(struct ipu_dp *); 327 int ipu_dp_enable(struct ipu_soc *ipu); 328 int ipu_dp_enable_channel(struct ipu_dp *dp); 329 void ipu_dp_disable_channel(struct ipu_dp *dp, bool sync); 330 void ipu_dp_disable(struct ipu_soc *ipu); 331 int ipu_dp_setup_channel(struct ipu_dp *dp, 332 enum ipu_color_space in, enum ipu_color_space out); 333 int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos); 334 int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha, 335 bool bg_chan); 336 337 /* 338 * IPU Prefetch Resolve Gasket (prg) functions 339 */ 340 int ipu_prg_max_active_channels(void); 341 bool ipu_prg_present(struct ipu_soc *ipu); 342 bool ipu_prg_format_supported(struct ipu_soc *ipu, uint32_t format, 343 uint64_t modifier); 344 int ipu_prg_enable(struct ipu_soc *ipu); 345 void ipu_prg_disable(struct ipu_soc *ipu); 346 void ipu_prg_channel_disable(struct ipuv3_channel *ipu_chan); 347 int ipu_prg_channel_configure(struct ipuv3_channel *ipu_chan, 348 unsigned int axi_id, unsigned int width, 349 unsigned int height, unsigned int stride, 350 u32 format, uint64_t modifier, unsigned long *eba); 351 bool ipu_prg_channel_configure_pending(struct ipuv3_channel *ipu_chan); 352 353 /* 354 * IPU CMOS Sensor Interface (csi) functions 355 */ 356 struct ipu_csi; 357 int ipu_csi_init_interface(struct ipu_csi *csi, 358 struct v4l2_mbus_config *mbus_cfg, 359 struct v4l2_mbus_framefmt *mbus_fmt); 360 bool ipu_csi_is_interlaced(struct ipu_csi *csi); 361 void ipu_csi_get_window(struct ipu_csi *csi, struct v4l2_rect *w); 362 void ipu_csi_set_window(struct ipu_csi *csi, struct v4l2_rect *w); 363 void ipu_csi_set_downsize(struct ipu_csi *csi, bool horiz, bool vert); 364 void ipu_csi_set_test_generator(struct ipu_csi *csi, bool active, 365 u32 r_value, u32 g_value, u32 b_value, 366 u32 pix_clk); 367 int ipu_csi_set_mipi_datatype(struct ipu_csi *csi, u32 vc, 368 struct v4l2_mbus_framefmt *mbus_fmt); 369 int ipu_csi_set_skip_smfc(struct ipu_csi *csi, u32 skip, 370 u32 max_ratio, u32 id); 371 int ipu_csi_set_dest(struct ipu_csi *csi, enum ipu_csi_dest csi_dest); 372 int ipu_csi_enable(struct ipu_csi *csi); 373 int ipu_csi_disable(struct ipu_csi *csi); 374 struct ipu_csi *ipu_csi_get(struct ipu_soc *ipu, int id); 375 void ipu_csi_put(struct ipu_csi *csi); 376 void ipu_csi_dump(struct ipu_csi *csi); 377 378 /* 379 * IPU Image Converter (ic) functions 380 */ 381 enum ipu_ic_task { 382 IC_TASK_ENCODER, 383 IC_TASK_VIEWFINDER, 384 IC_TASK_POST_PROCESSOR, 385 IC_NUM_TASKS, 386 }; 387 388 struct ipu_ic; 389 int ipu_ic_task_init(struct ipu_ic *ic, 390 int in_width, int in_height, 391 int out_width, int out_height, 392 enum ipu_color_space in_cs, 393 enum ipu_color_space out_cs); 394 int ipu_ic_task_init_rsc(struct ipu_ic *ic, 395 int in_width, int in_height, 396 int out_width, int out_height, 397 enum ipu_color_space in_cs, 398 enum ipu_color_space out_cs, 399 u32 rsc); 400 int ipu_ic_task_graphics_init(struct ipu_ic *ic, 401 enum ipu_color_space in_g_cs, 402 bool galpha_en, u32 galpha, 403 bool colorkey_en, u32 colorkey); 404 void ipu_ic_task_enable(struct ipu_ic *ic); 405 void ipu_ic_task_disable(struct ipu_ic *ic); 406 int ipu_ic_task_idma_init(struct ipu_ic *ic, struct ipuv3_channel *channel, 407 u32 width, u32 height, int burst_size, 408 enum ipu_rotate_mode rot); 409 int ipu_ic_enable(struct ipu_ic *ic); 410 int ipu_ic_disable(struct ipu_ic *ic); 411 struct ipu_ic *ipu_ic_get(struct ipu_soc *ipu, enum ipu_ic_task task); 412 void ipu_ic_put(struct ipu_ic *ic); 413 void ipu_ic_dump(struct ipu_ic *ic); 414 415 /* 416 * IPU Video De-Interlacer (vdi) functions 417 */ 418 struct ipu_vdi; 419 void ipu_vdi_set_field_order(struct ipu_vdi *vdi, v4l2_std_id std, u32 field); 420 void ipu_vdi_set_motion(struct ipu_vdi *vdi, enum ipu_motion_sel motion_sel); 421 void ipu_vdi_setup(struct ipu_vdi *vdi, u32 code, int xres, int yres); 422 void ipu_vdi_unsetup(struct ipu_vdi *vdi); 423 int ipu_vdi_enable(struct ipu_vdi *vdi); 424 int ipu_vdi_disable(struct ipu_vdi *vdi); 425 struct ipu_vdi *ipu_vdi_get(struct ipu_soc *ipu); 426 void ipu_vdi_put(struct ipu_vdi *vdi); 427 428 /* 429 * IPU Sensor Multiple FIFO Controller (SMFC) functions 430 */ 431 struct ipu_smfc *ipu_smfc_get(struct ipu_soc *ipu, unsigned int chno); 432 void ipu_smfc_put(struct ipu_smfc *smfc); 433 int ipu_smfc_enable(struct ipu_smfc *smfc); 434 int ipu_smfc_disable(struct ipu_smfc *smfc); 435 int ipu_smfc_map_channel(struct ipu_smfc *smfc, int csi_id, int mipi_id); 436 int ipu_smfc_set_burstsize(struct ipu_smfc *smfc, int burstsize); 437 int ipu_smfc_set_watermark(struct ipu_smfc *smfc, u32 set_level, u32 clr_level); 438 439 enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc); 440 enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat); 441 enum ipu_color_space ipu_mbus_code_to_colorspace(u32 mbus_code); 442 int ipu_stride_to_bytes(u32 pixel_stride, u32 pixelformat); 443 bool ipu_pixelformat_is_planar(u32 pixelformat); 444 int ipu_degrees_to_rot_mode(enum ipu_rotate_mode *mode, int degrees, 445 bool hflip, bool vflip); 446 int ipu_rot_mode_to_degrees(int *degrees, enum ipu_rotate_mode mode, 447 bool hflip, bool vflip); 448 449 struct ipu_client_platformdata { 450 int csi; 451 int di; 452 int dc; 453 int dp; 454 int dma[2]; 455 struct device_node *of_node; 456 }; 457 458 #endif /* __DRM_IPU_H__ */ 459