mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-26 02:39:48 +00:00
![Sachin Kamat](/assets/img/avatar_default.png)
devm_* APIs are device managed and make exit and cleanup code simpler. While at it also remove some unused labels and fix an error path. Signed-off-by: Sachin Kamat <sachin.kamat@linaro.org> Acked-by: Donghwa Lee <dh09.lee@samsung.com> Cc: Inki Dae <inki.dae@samsung.com> Cc: Florian Tobias Schandinat <FlorianSchandinat@gmx.de> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
359 lines
12 KiB
C
359 lines
12 KiB
C
/* include/video/exynos_mipi_dsim.h
|
|
*
|
|
* Platform data header for Samsung SoC MIPI-DSIM.
|
|
*
|
|
* Copyright (c) 2012 Samsung Electronics Co., Ltd
|
|
*
|
|
* InKi Dae <inki.dae@samsung.com>
|
|
* Donghwa Lee <dh09.lee@samsung.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License version 2 as
|
|
* published by the Free Software Foundation.
|
|
*/
|
|
|
|
#ifndef _EXYNOS_MIPI_DSIM_H
|
|
#define _EXYNOS_MIPI_DSIM_H
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/fb.h>
|
|
|
|
#define PANEL_NAME_SIZE (32)
|
|
|
|
/*
|
|
* Enumerate display interface type.
|
|
*
|
|
* DSIM_COMMAND means cpu interface and rgb interface for DSIM_VIDEO.
|
|
*
|
|
* P.S. MIPI DSI Master has two display controller intefaces, RGB Interface
|
|
* for main display and CPU Interface(same as I80 Interface) for main
|
|
* and sub display.
|
|
*/
|
|
enum mipi_dsim_interface_type {
|
|
DSIM_COMMAND,
|
|
DSIM_VIDEO
|
|
};
|
|
|
|
enum mipi_dsim_virtual_ch_no {
|
|
DSIM_VIRTUAL_CH_0,
|
|
DSIM_VIRTUAL_CH_1,
|
|
DSIM_VIRTUAL_CH_2,
|
|
DSIM_VIRTUAL_CH_3
|
|
};
|
|
|
|
enum mipi_dsim_burst_mode_type {
|
|
DSIM_NON_BURST_SYNC_EVENT,
|
|
DSIM_BURST_SYNC_EVENT,
|
|
DSIM_NON_BURST_SYNC_PULSE,
|
|
DSIM_BURST,
|
|
DSIM_NON_VIDEO_MODE
|
|
};
|
|
|
|
enum mipi_dsim_no_of_data_lane {
|
|
DSIM_DATA_LANE_1,
|
|
DSIM_DATA_LANE_2,
|
|
DSIM_DATA_LANE_3,
|
|
DSIM_DATA_LANE_4
|
|
};
|
|
|
|
enum mipi_dsim_byte_clk_src {
|
|
DSIM_PLL_OUT_DIV8,
|
|
DSIM_EXT_CLK_DIV8,
|
|
DSIM_EXT_CLK_BYPASS
|
|
};
|
|
|
|
enum mipi_dsim_pixel_format {
|
|
DSIM_CMD_3BPP,
|
|
DSIM_CMD_8BPP,
|
|
DSIM_CMD_12BPP,
|
|
DSIM_CMD_16BPP,
|
|
DSIM_VID_16BPP_565,
|
|
DSIM_VID_18BPP_666PACKED,
|
|
DSIM_18BPP_666LOOSELYPACKED,
|
|
DSIM_24BPP_888
|
|
};
|
|
|
|
/*
|
|
* struct mipi_dsim_config - interface for configuring mipi-dsi controller.
|
|
*
|
|
* @auto_flush: enable or disable Auto flush of MD FIFO using VSYNC pulse.
|
|
* @eot_disable: enable or disable EoT packet in HS mode.
|
|
* @auto_vertical_cnt: specifies auto vertical count mode.
|
|
* in Video mode, the vertical line transition uses line counter
|
|
* configured by VSA, VBP, and Vertical resolution.
|
|
* If this bit is set to '1', the line counter does not use VSA and VBP
|
|
* registers.(in command mode, this variable is ignored)
|
|
* @hse: set horizontal sync event mode.
|
|
* In VSYNC pulse and Vporch area, MIPI DSI master transfers only HSYNC
|
|
* start packet to MIPI DSI slave at MIPI DSI spec1.1r02.
|
|
* this bit transfers HSYNC end packet in VSYNC pulse and Vporch area
|
|
* (in mommand mode, this variable is ignored)
|
|
* @hfp: specifies HFP disable mode.
|
|
* if this variable is set, DSI master ignores HFP area in VIDEO mode.
|
|
* (in command mode, this variable is ignored)
|
|
* @hbp: specifies HBP disable mode.
|
|
* if this variable is set, DSI master ignores HBP area in VIDEO mode.
|
|
* (in command mode, this variable is ignored)
|
|
* @hsa: specifies HSA disable mode.
|
|
* if this variable is set, DSI master ignores HSA area in VIDEO mode.
|
|
* (in command mode, this variable is ignored)
|
|
* @cma_allow: specifies the number of horizontal lines, where command packet
|
|
* transmission is allowed after Stable VFP period.
|
|
* @e_interface: specifies interface to be used.(CPU or RGB interface)
|
|
* @e_virtual_ch: specifies virtual channel number that main or
|
|
* sub diaplsy uses.
|
|
* @e_pixel_format: specifies pixel stream format for main or sub display.
|
|
* @e_burst_mode: selects Burst mode in Video mode.
|
|
* in Non-burst mode, RGB data area is filled with RGB data and NULL
|
|
* packets, according to input bandwidth of RGB interface.
|
|
* In Burst mode, RGB data area is filled with RGB data only.
|
|
* @e_no_data_lane: specifies data lane count to be used by Master.
|
|
* @e_byte_clk: select byte clock source. (it must be DSIM_PLL_OUT_DIV8)
|
|
* DSIM_EXT_CLK_DIV8 and DSIM_EXT_CLK_BYPASSS are not supported.
|
|
* @pll_stable_time: specifies the PLL Timer for stability of the ganerated
|
|
* clock(System clock cycle base)
|
|
* if the timer value goes to 0x00000000, the clock stable bit of status
|
|
* and interrupt register is set.
|
|
* @esc_clk: specifies escape clock frequency for getting the escape clock
|
|
* prescaler value.
|
|
* @stop_holding_cnt: specifies the interval value between transmitting
|
|
* read packet(or write "set_tear_on" command) and BTA request.
|
|
* after transmitting read packet or write "set_tear_on" command,
|
|
* BTA requests to D-PHY automatically. this counter value specifies
|
|
* the interval between them.
|
|
* @bta_timeout: specifies the timer for BTA.
|
|
* this register specifies time out from BTA request to change
|
|
* the direction with respect to Tx escape clock.
|
|
* @rx_timeout: specifies the timer for LP Rx mode timeout.
|
|
* this register specifies time out on how long RxValid deasserts,
|
|
* after RxLpdt asserts with respect to Tx escape clock.
|
|
* - RxValid specifies Rx data valid indicator.
|
|
* - RxLpdt specifies an indicator that D-PHY is under RxLpdt mode.
|
|
* - RxValid and RxLpdt specifies signal from D-PHY.
|
|
*/
|
|
struct mipi_dsim_config {
|
|
unsigned char auto_flush;
|
|
unsigned char eot_disable;
|
|
|
|
unsigned char auto_vertical_cnt;
|
|
unsigned char hse;
|
|
unsigned char hfp;
|
|
unsigned char hbp;
|
|
unsigned char hsa;
|
|
unsigned char cmd_allow;
|
|
|
|
enum mipi_dsim_interface_type e_interface;
|
|
enum mipi_dsim_virtual_ch_no e_virtual_ch;
|
|
enum mipi_dsim_pixel_format e_pixel_format;
|
|
enum mipi_dsim_burst_mode_type e_burst_mode;
|
|
enum mipi_dsim_no_of_data_lane e_no_data_lane;
|
|
enum mipi_dsim_byte_clk_src e_byte_clk;
|
|
|
|
/*
|
|
* ===========================================
|
|
* | P | M | S | MHz |
|
|
* -------------------------------------------
|
|
* | 3 | 100 | 3 | 100 |
|
|
* | 3 | 100 | 2 | 200 |
|
|
* | 3 | 63 | 1 | 252 |
|
|
* | 4 | 100 | 1 | 300 |
|
|
* | 4 | 110 | 1 | 330 |
|
|
* | 12 | 350 | 1 | 350 |
|
|
* | 3 | 100 | 1 | 400 |
|
|
* | 4 | 150 | 1 | 450 |
|
|
* | 6 | 118 | 1 | 472 |
|
|
* | 3 | 120 | 1 | 480 |
|
|
* | 12 | 250 | 0 | 500 |
|
|
* | 4 | 100 | 0 | 600 |
|
|
* | 3 | 81 | 0 | 648 |
|
|
* | 3 | 88 | 0 | 704 |
|
|
* | 3 | 90 | 0 | 720 |
|
|
* | 3 | 100 | 0 | 800 |
|
|
* | 12 | 425 | 0 | 850 |
|
|
* | 4 | 150 | 0 | 900 |
|
|
* | 12 | 475 | 0 | 950 |
|
|
* | 6 | 250 | 0 | 1000 |
|
|
* -------------------------------------------
|
|
*/
|
|
|
|
/*
|
|
* pms could be calculated as the following.
|
|
* M * 24 / P * 2 ^ S = MHz
|
|
*/
|
|
unsigned char p;
|
|
unsigned short m;
|
|
unsigned char s;
|
|
|
|
unsigned int pll_stable_time;
|
|
unsigned long esc_clk;
|
|
|
|
unsigned short stop_holding_cnt;
|
|
unsigned char bta_timeout;
|
|
unsigned short rx_timeout;
|
|
};
|
|
|
|
/*
|
|
* struct mipi_dsim_device - global interface for mipi-dsi driver.
|
|
*
|
|
* @dev: driver model representation of the device.
|
|
* @id: unique device id.
|
|
* @clock: pointer to MIPI-DSI clock of clock framework.
|
|
* @irq: interrupt number to MIPI-DSI controller.
|
|
* @reg_base: base address to memory mapped SRF of MIPI-DSI controller.
|
|
* (virtual address)
|
|
* @lock: the mutex protecting this data structure.
|
|
* @dsim_info: infomation for configuring mipi-dsi controller.
|
|
* @master_ops: callbacks to mipi-dsi operations.
|
|
* @dsim_lcd_dev: pointer to activated ddi device.
|
|
* (it would be registered by mipi-dsi driver.)
|
|
* @dsim_lcd_drv: pointer to activated_ddi driver.
|
|
* (it would be registered by mipi-dsi driver.)
|
|
* @lcd_info: pointer to mipi_lcd_info structure.
|
|
* @state: specifies status of MIPI-DSI controller.
|
|
* the status could be RESET, INIT, STOP, HSCLKEN and ULPS.
|
|
* @data_lane: specifiec enabled data lane number.
|
|
* this variable would be set by driver according to e_no_data_lane
|
|
* automatically.
|
|
* @e_clk_src: select byte clock source.
|
|
* @pd: pointer to MIPI-DSI driver platform data.
|
|
*/
|
|
struct mipi_dsim_device {
|
|
struct device *dev;
|
|
int id;
|
|
struct clk *clock;
|
|
unsigned int irq;
|
|
void __iomem *reg_base;
|
|
struct mutex lock;
|
|
|
|
struct mipi_dsim_config *dsim_config;
|
|
struct mipi_dsim_master_ops *master_ops;
|
|
struct mipi_dsim_lcd_device *dsim_lcd_dev;
|
|
struct mipi_dsim_lcd_driver *dsim_lcd_drv;
|
|
|
|
unsigned int state;
|
|
unsigned int data_lane;
|
|
unsigned int e_clk_src;
|
|
bool suspended;
|
|
|
|
struct mipi_dsim_platform_data *pd;
|
|
};
|
|
|
|
/*
|
|
* struct mipi_dsim_platform_data - interface to platform data
|
|
* for mipi-dsi driver.
|
|
*
|
|
* @lcd_panel_name: specifies lcd panel name registered to mipi-dsi driver.
|
|
* lcd panel driver searched would be actived.
|
|
* @dsim_config: pointer of structure for configuring mipi-dsi controller.
|
|
* @enabled: indicate whether mipi controller got enabled or not.
|
|
* @lcd_panel_info: pointer for lcd panel specific structure.
|
|
* this structure specifies width, height, timing and polarity and so on.
|
|
* @phy_enable: pointer to a callback controlling D-PHY enable/reset
|
|
*/
|
|
struct mipi_dsim_platform_data {
|
|
char lcd_panel_name[PANEL_NAME_SIZE];
|
|
|
|
struct mipi_dsim_config *dsim_config;
|
|
unsigned int enabled;
|
|
void *lcd_panel_info;
|
|
|
|
int (*phy_enable)(struct platform_device *pdev, bool on);
|
|
};
|
|
|
|
/*
|
|
* struct mipi_dsim_master_ops - callbacks to mipi-dsi operations.
|
|
*
|
|
* @cmd_write: transfer command to lcd panel at LP mode.
|
|
* @cmd_read: read command from rx register.
|
|
* @get_dsim_frame_done: get the status that all screen data have been
|
|
* transferred to mipi-dsi.
|
|
* @clear_dsim_frame_done: clear frame done status.
|
|
* @get_fb_frame_done: get frame done status of display controller.
|
|
* @trigger: trigger display controller.
|
|
* - this one would be used only in case of CPU mode.
|
|
* @set_early_blank_mode: set framebuffer blank mode.
|
|
* - this callback should be called prior to fb_blank() by a client driver
|
|
* only if needing.
|
|
* @set_blank_mode: set framebuffer blank mode.
|
|
* - this callback should be called after fb_blank() by a client driver
|
|
* only if needing.
|
|
*/
|
|
|
|
struct mipi_dsim_master_ops {
|
|
int (*cmd_write)(struct mipi_dsim_device *dsim, unsigned int data_id,
|
|
const unsigned char *data0, unsigned int data1);
|
|
int (*cmd_read)(struct mipi_dsim_device *dsim, unsigned int data_id,
|
|
unsigned int data0, unsigned int req_size, u8 *rx_buf);
|
|
int (*get_dsim_frame_done)(struct mipi_dsim_device *dsim);
|
|
int (*clear_dsim_frame_done)(struct mipi_dsim_device *dsim);
|
|
|
|
int (*get_fb_frame_done)(struct fb_info *info);
|
|
void (*trigger)(struct fb_info *info);
|
|
int (*set_early_blank_mode)(struct mipi_dsim_device *dsim, int power);
|
|
int (*set_blank_mode)(struct mipi_dsim_device *dsim, int power);
|
|
};
|
|
|
|
/*
|
|
* device structure for mipi-dsi based lcd panel.
|
|
*
|
|
* @name: name of the device to use with this device, or an
|
|
* alias for that name.
|
|
* @dev: driver model representation of the device.
|
|
* @id: id of device to be registered.
|
|
* @bus_id: bus id for identifing connected bus
|
|
* and this bus id should be same as id of mipi_dsim_device.
|
|
* @irq: irq number for signaling when framebuffer transfer of
|
|
* lcd panel module is completed.
|
|
* this irq would be used only for MIPI-DSI based CPU mode lcd panel.
|
|
* @master: pointer to mipi-dsi master device object.
|
|
* @platform_data: lcd panel specific platform data.
|
|
*/
|
|
struct mipi_dsim_lcd_device {
|
|
char *name;
|
|
struct device dev;
|
|
int id;
|
|
int bus_id;
|
|
int irq;
|
|
int panel_reverse;
|
|
|
|
struct mipi_dsim_device *master;
|
|
void *platform_data;
|
|
};
|
|
|
|
/*
|
|
* driver structure for mipi-dsi based lcd panel.
|
|
*
|
|
* this structure should be registered by lcd panel driver.
|
|
* mipi-dsi driver seeks lcd panel registered through name field
|
|
* and calls these callback functions in appropriate time.
|
|
*
|
|
* @name: name of the driver to use with this device, or an
|
|
* alias for that name.
|
|
* @id: id of driver to be registered.
|
|
* this id would be used for finding device object registered.
|
|
*/
|
|
struct mipi_dsim_lcd_driver {
|
|
char *name;
|
|
int id;
|
|
|
|
void (*power_on)(struct mipi_dsim_lcd_device *dsim_dev, int enable);
|
|
void (*set_sequence)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
int (*probe)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
int (*remove)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
void (*shutdown)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
int (*suspend)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
int (*resume)(struct mipi_dsim_lcd_device *dsim_dev);
|
|
};
|
|
|
|
/*
|
|
* register mipi_dsim_lcd_device to mipi-dsi master.
|
|
*/
|
|
int exynos_mipi_dsi_register_lcd_device(struct mipi_dsim_lcd_device
|
|
*lcd_dev);
|
|
/**
|
|
* register mipi_dsim_lcd_driver object defined by lcd panel driver
|
|
* to mipi-dsi driver.
|
|
*/
|
|
int exynos_mipi_dsi_register_lcd_driver(struct mipi_dsim_lcd_driver
|
|
*lcd_drv);
|
|
#endif /* _EXYNOS_MIPI_DSIM_H */
|