1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) 2018 Samsung Electronics Co., Ltd
6 * Andrzej Hajda <a.hajda@samsung.com>
7 * Maciej Purski <m.purski@samsung.com>
10 #include <linux/delay.h>
11 #include <linux/gpio/consumer.h>
12 #include <linux/module.h>
13 #include <linux/of_graph.h>
14 #include <linux/regulator/consumer.h>
16 #include <video/mipi_display.h>
18 #include <drm/drm_atomic_helper.h>
19 #include <drm/drm_bridge.h>
20 #include <drm/drm_crtc.h>
21 #include <drm/drm_fb_helper.h>
22 #include <drm/drm_mipi_dsi.h>
23 #include <drm/drm_of.h>
24 #include <drm/drm_panel.h>
25 #include <drm/drm_print.h>
26 #include <drm/drm_probe_helper.h>
28 #define FLD_MASK(start, end) (((1 << ((start) - (end) + 1)) - 1) << (end))
29 #define FLD_VAL(val, start, end) (((val) << (end)) & FLD_MASK(start, end))
31 /* PPI layer registers */
32 #define PPI_STARTPPI 0x0104 /* START control bit */
33 #define PPI_LPTXTIMECNT 0x0114 /* LPTX timing signal */
34 #define PPI_LANEENABLE 0x0134 /* Enables each lane */
35 #define PPI_TX_RX_TA 0x013C /* BTA timing parameters */
36 #define PPI_D0S_CLRSIPOCOUNT 0x0164 /* Assertion timer for Lane 0 */
37 #define PPI_D1S_CLRSIPOCOUNT 0x0168 /* Assertion timer for Lane 1 */
38 #define PPI_D2S_CLRSIPOCOUNT 0x016C /* Assertion timer for Lane 2 */
39 #define PPI_D3S_CLRSIPOCOUNT 0x0170 /* Assertion timer for Lane 3 */
40 #define PPI_START_FUNCTION 1
42 /* DSI layer registers */
43 #define DSI_STARTDSI 0x0204 /* START control bit of DSI-TX */
44 #define DSI_LANEENABLE 0x0210 /* Enables each lane */
45 #define DSI_RX_START 1
47 /* Video path registers */
48 #define VP_CTRL 0x0450 /* Video Path Control */
49 #define VP_CTRL_MSF(v) FLD_VAL(v, 0, 0) /* Magic square in RGB666 */
50 #define VP_CTRL_VTGEN(v) FLD_VAL(v, 4, 4) /* Use chip clock for timing */
51 #define VP_CTRL_EVTMODE(v) FLD_VAL(v, 5, 5) /* Event mode */
52 #define VP_CTRL_RGB888(v) FLD_VAL(v, 8, 8) /* RGB888 mode */
53 #define VP_CTRL_VSDELAY(v) FLD_VAL(v, 31, 20) /* VSYNC delay */
54 #define VP_CTRL_HSPOL BIT(17) /* Polarity of HSYNC signal */
55 #define VP_CTRL_DEPOL BIT(18) /* Polarity of DE signal */
56 #define VP_CTRL_VSPOL BIT(19) /* Polarity of VSYNC signal */
57 #define VP_HTIM1 0x0454 /* Horizontal Timing Control 1 */
58 #define VP_HTIM1_HBP(v) FLD_VAL(v, 24, 16)
59 #define VP_HTIM1_HSYNC(v) FLD_VAL(v, 8, 0)
60 #define VP_HTIM2 0x0458 /* Horizontal Timing Control 2 */
61 #define VP_HTIM2_HFP(v) FLD_VAL(v, 24, 16)
62 #define VP_HTIM2_HACT(v) FLD_VAL(v, 10, 0)
63 #define VP_VTIM1 0x045C /* Vertical Timing Control 1 */
64 #define VP_VTIM1_VBP(v) FLD_VAL(v, 23, 16)
65 #define VP_VTIM1_VSYNC(v) FLD_VAL(v, 7, 0)
66 #define VP_VTIM2 0x0460 /* Vertical Timing Control 2 */
67 #define VP_VTIM2_VFP(v) FLD_VAL(v, 23, 16)
68 #define VP_VTIM2_VACT(v) FLD_VAL(v, 10, 0)
69 #define VP_VFUEN 0x0464 /* Video Frame Timing Update Enable */
72 #define LV_MX0003 0x0480 /* Mux input bit 0 to 3 */
73 #define LV_MX0407 0x0484 /* Mux input bit 4 to 7 */
74 #define LV_MX0811 0x0488 /* Mux input bit 8 to 11 */
75 #define LV_MX1215 0x048C /* Mux input bit 12 to 15 */
76 #define LV_MX1619 0x0490 /* Mux input bit 16 to 19 */
77 #define LV_MX2023 0x0494 /* Mux input bit 20 to 23 */
78 #define LV_MX2427 0x0498 /* Mux input bit 24 to 27 */
79 #define LV_MX(b0, b1, b2, b3) (FLD_VAL(b0, 4, 0) | FLD_VAL(b1, 12, 8) | \
80 FLD_VAL(b2, 20, 16) | FLD_VAL(b3, 28, 24))
82 /* Input bit numbers used in mux registers */
114 #define LV_CFG 0x049C /* LVDS Configuration */
115 #define LV_PHY0 0x04A0 /* LVDS PHY 0 */
116 #define LV_PHY0_RST(v) FLD_VAL(v, 22, 22) /* PHY reset */
117 #define LV_PHY0_IS(v) FLD_VAL(v, 15, 14)
118 #define LV_PHY0_ND(v) FLD_VAL(v, 4, 0) /* Frequency range select */
119 #define LV_PHY0_PRBS_ON(v) FLD_VAL(v, 20, 16) /* Clock/Data Flag pins */
121 /* System registers */
122 #define SYS_RST 0x0504 /* System Reset */
123 #define SYS_ID 0x0580 /* System ID */
125 #define SYS_RST_I2CS BIT(0) /* Reset I2C-Slave controller */
126 #define SYS_RST_I2CM BIT(1) /* Reset I2C-Master controller */
127 #define SYS_RST_LCD BIT(2) /* Reset LCD controller */
128 #define SYS_RST_BM BIT(3) /* Reset Bus Management controller */
129 #define SYS_RST_DSIRX BIT(4) /* Reset DSI-RX and App controller */
130 #define SYS_RST_REG BIT(5) /* Reset Register module */
134 #define TTA_GET 0x20000
136 /* Lane enable PPI and DSI register bits */
137 #define LANEENABLE_CLEN BIT(0)
138 #define LANEENABLE_L0EN BIT(1)
139 #define LANEENABLE_L1EN BIT(2)
140 #define LANEENABLE_L2EN BIT(3)
141 #define LANEENABLE_L3EN BIT(4)
144 #define LV_CFG_LVEN BIT(0)
145 #define LV_CFG_LVDLINK BIT(1)
146 #define LV_CFG_CLKPOL1 BIT(2)
147 #define LV_CFG_CLKPOL2 BIT(3)
149 static const char * const tc358764_supplies
[] = {
150 "vddc", "vddio", "vddlvds"
155 struct drm_bridge bridge
;
156 struct drm_connector connector
;
157 struct regulator_bulk_data supplies
[ARRAY_SIZE(tc358764_supplies
)];
158 struct gpio_desc
*gpio_reset
;
159 struct drm_panel
*panel
;
163 static int tc358764_clear_error(struct tc358764
*ctx
)
165 int ret
= ctx
->error
;
171 static void tc358764_read(struct tc358764
*ctx
, u16 addr
, u32
*val
)
173 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(ctx
->dev
);
180 ret
= mipi_dsi_generic_read(dsi
, &addr
, sizeof(addr
), val
, sizeof(*val
));
184 dev_dbg(ctx
->dev
, "read: %d, addr: %d\n", addr
, *val
);
187 static void tc358764_write(struct tc358764
*ctx
, u16 addr
, u32 val
)
189 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(ctx
->dev
);
203 ret
= mipi_dsi_generic_write(dsi
, data
, sizeof(data
));
208 static inline struct tc358764
*bridge_to_tc358764(struct drm_bridge
*bridge
)
210 return container_of(bridge
, struct tc358764
, bridge
);
214 struct tc358764
*connector_to_tc358764(struct drm_connector
*connector
)
216 return container_of(connector
, struct tc358764
, connector
);
219 static int tc358764_init(struct tc358764
*ctx
)
223 tc358764_read(ctx
, SYS_ID
, &v
);
225 return tc358764_clear_error(ctx
);
226 dev_info(ctx
->dev
, "ID: %#x\n", v
);
228 /* configure PPI counters */
229 tc358764_write(ctx
, PPI_TX_RX_TA
, TTA_GET
| TTA_SURE
);
230 tc358764_write(ctx
, PPI_LPTXTIMECNT
, LPX_PERIOD
);
231 tc358764_write(ctx
, PPI_D0S_CLRSIPOCOUNT
, 5);
232 tc358764_write(ctx
, PPI_D1S_CLRSIPOCOUNT
, 5);
233 tc358764_write(ctx
, PPI_D2S_CLRSIPOCOUNT
, 5);
234 tc358764_write(ctx
, PPI_D3S_CLRSIPOCOUNT
, 5);
236 /* enable four data lanes and clock lane */
237 tc358764_write(ctx
, PPI_LANEENABLE
, LANEENABLE_L3EN
| LANEENABLE_L2EN
|
238 LANEENABLE_L1EN
| LANEENABLE_L0EN
| LANEENABLE_CLEN
);
239 tc358764_write(ctx
, DSI_LANEENABLE
, LANEENABLE_L3EN
| LANEENABLE_L2EN
|
240 LANEENABLE_L1EN
| LANEENABLE_L0EN
| LANEENABLE_CLEN
);
243 tc358764_write(ctx
, PPI_STARTPPI
, PPI_START_FUNCTION
);
244 tc358764_write(ctx
, DSI_STARTDSI
, DSI_RX_START
);
246 /* configure video path */
247 tc358764_write(ctx
, VP_CTRL
, VP_CTRL_VSDELAY(15) | VP_CTRL_RGB888(1) |
248 VP_CTRL_EVTMODE(1) | VP_CTRL_HSPOL
| VP_CTRL_VSPOL
);
251 tc358764_write(ctx
, LV_PHY0
, LV_PHY0_RST(1) |
252 LV_PHY0_PRBS_ON(4) | LV_PHY0_IS(2) | LV_PHY0_ND(6));
253 tc358764_write(ctx
, LV_PHY0
, LV_PHY0_PRBS_ON(4) | LV_PHY0_IS(2) |
257 tc358764_write(ctx
, SYS_RST
, SYS_RST_LCD
);
260 tc358764_write(ctx
, LV_MX0003
, LV_MX(LVI_R0
, LVI_R1
, LVI_R2
, LVI_R3
));
261 tc358764_write(ctx
, LV_MX0407
, LV_MX(LVI_R4
, LVI_R7
, LVI_R5
, LVI_G0
));
262 tc358764_write(ctx
, LV_MX0811
, LV_MX(LVI_G1
, LVI_G2
, LVI_G6
, LVI_G7
));
263 tc358764_write(ctx
, LV_MX1215
, LV_MX(LVI_G3
, LVI_G4
, LVI_G5
, LVI_B0
));
264 tc358764_write(ctx
, LV_MX1619
, LV_MX(LVI_B6
, LVI_B7
, LVI_B1
, LVI_B2
));
265 tc358764_write(ctx
, LV_MX2023
, LV_MX(LVI_B3
, LVI_B4
, LVI_B5
, LVI_L0
));
266 tc358764_write(ctx
, LV_MX2427
, LV_MX(LVI_HS
, LVI_VS
, LVI_DE
, LVI_R6
));
267 tc358764_write(ctx
, LV_CFG
, LV_CFG_CLKPOL2
| LV_CFG_CLKPOL1
|
270 return tc358764_clear_error(ctx
);
273 static void tc358764_reset(struct tc358764
*ctx
)
275 gpiod_set_value(ctx
->gpio_reset
, 1);
276 usleep_range(1000, 2000);
277 gpiod_set_value(ctx
->gpio_reset
, 0);
278 usleep_range(1000, 2000);
281 static int tc358764_get_modes(struct drm_connector
*connector
)
283 struct tc358764
*ctx
= connector_to_tc358764(connector
);
285 return drm_panel_get_modes(ctx
->panel
, connector
);
289 struct drm_connector_helper_funcs tc358764_connector_helper_funcs
= {
290 .get_modes
= tc358764_get_modes
,
293 static const struct drm_connector_funcs tc358764_connector_funcs
= {
294 .fill_modes
= drm_helper_probe_single_connector_modes
,
295 .destroy
= drm_connector_cleanup
,
296 .reset
= drm_atomic_helper_connector_reset
,
297 .atomic_duplicate_state
= drm_atomic_helper_connector_duplicate_state
,
298 .atomic_destroy_state
= drm_atomic_helper_connector_destroy_state
,
301 static void tc358764_disable(struct drm_bridge
*bridge
)
303 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
304 int ret
= drm_panel_disable(bridge_to_tc358764(bridge
)->panel
);
307 dev_err(ctx
->dev
, "error disabling panel (%d)\n", ret
);
310 static void tc358764_post_disable(struct drm_bridge
*bridge
)
312 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
315 ret
= drm_panel_unprepare(ctx
->panel
);
317 dev_err(ctx
->dev
, "error unpreparing panel (%d)\n", ret
);
319 usleep_range(10000, 15000);
320 ret
= regulator_bulk_disable(ARRAY_SIZE(ctx
->supplies
), ctx
->supplies
);
322 dev_err(ctx
->dev
, "error disabling regulators (%d)\n", ret
);
325 static void tc358764_pre_enable(struct drm_bridge
*bridge
)
327 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
330 ret
= regulator_bulk_enable(ARRAY_SIZE(ctx
->supplies
), ctx
->supplies
);
332 dev_err(ctx
->dev
, "error enabling regulators (%d)\n", ret
);
333 usleep_range(10000, 15000);
335 ret
= tc358764_init(ctx
);
337 dev_err(ctx
->dev
, "error initializing bridge (%d)\n", ret
);
338 ret
= drm_panel_prepare(ctx
->panel
);
340 dev_err(ctx
->dev
, "error preparing panel (%d)\n", ret
);
343 static void tc358764_enable(struct drm_bridge
*bridge
)
345 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
346 int ret
= drm_panel_enable(ctx
->panel
);
349 dev_err(ctx
->dev
, "error enabling panel (%d)\n", ret
);
352 static int tc358764_attach(struct drm_bridge
*bridge
,
353 enum drm_bridge_attach_flags flags
)
355 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
356 struct drm_device
*drm
= bridge
->dev
;
359 if (flags
& DRM_BRIDGE_ATTACH_NO_CONNECTOR
) {
360 DRM_ERROR("Fix bridge driver to make connector optional!");
364 ctx
->connector
.polled
= DRM_CONNECTOR_POLL_HPD
;
365 ret
= drm_connector_init(drm
, &ctx
->connector
,
366 &tc358764_connector_funcs
,
367 DRM_MODE_CONNECTOR_LVDS
);
369 DRM_ERROR("Failed to initialize connector\n");
373 drm_connector_helper_add(&ctx
->connector
,
374 &tc358764_connector_helper_funcs
);
375 drm_connector_attach_encoder(&ctx
->connector
, bridge
->encoder
);
376 ctx
->connector
.funcs
->reset(&ctx
->connector
);
377 drm_connector_register(&ctx
->connector
);
382 static void tc358764_detach(struct drm_bridge
*bridge
)
384 struct tc358764
*ctx
= bridge_to_tc358764(bridge
);
386 drm_connector_unregister(&ctx
->connector
);
388 drm_connector_put(&ctx
->connector
);
391 static const struct drm_bridge_funcs tc358764_bridge_funcs
= {
392 .disable
= tc358764_disable
,
393 .post_disable
= tc358764_post_disable
,
394 .enable
= tc358764_enable
,
395 .pre_enable
= tc358764_pre_enable
,
396 .attach
= tc358764_attach
,
397 .detach
= tc358764_detach
,
400 static int tc358764_parse_dt(struct tc358764
*ctx
)
402 struct device
*dev
= ctx
->dev
;
405 ctx
->gpio_reset
= devm_gpiod_get(dev
, "reset", GPIOD_OUT_LOW
);
406 if (IS_ERR(ctx
->gpio_reset
)) {
407 dev_err(dev
, "no reset GPIO pin provided\n");
408 return PTR_ERR(ctx
->gpio_reset
);
411 ret
= drm_of_find_panel_or_bridge(ctx
->dev
->of_node
, 1, 0, &ctx
->panel
,
413 if (ret
&& ret
!= -EPROBE_DEFER
)
414 dev_err(dev
, "cannot find panel (%d)\n", ret
);
419 static int tc358764_configure_regulators(struct tc358764
*ctx
)
423 for (i
= 0; i
< ARRAY_SIZE(ctx
->supplies
); ++i
)
424 ctx
->supplies
[i
].supply
= tc358764_supplies
[i
];
426 ret
= devm_regulator_bulk_get(ctx
->dev
, ARRAY_SIZE(ctx
->supplies
),
429 dev_err(ctx
->dev
, "failed to get regulators: %d\n", ret
);
434 static int tc358764_probe(struct mipi_dsi_device
*dsi
)
436 struct device
*dev
= &dsi
->dev
;
437 struct tc358764
*ctx
;
440 ctx
= devm_kzalloc(dev
, sizeof(struct tc358764
), GFP_KERNEL
);
444 mipi_dsi_set_drvdata(dsi
, ctx
);
449 dsi
->format
= MIPI_DSI_FMT_RGB888
;
450 dsi
->mode_flags
= MIPI_DSI_MODE_VIDEO
| MIPI_DSI_MODE_VIDEO_BURST
451 | MIPI_DSI_MODE_VIDEO_AUTO_VERT
| MIPI_DSI_MODE_LPM
;
453 ret
= tc358764_parse_dt(ctx
);
457 ret
= tc358764_configure_regulators(ctx
);
461 ctx
->bridge
.funcs
= &tc358764_bridge_funcs
;
462 ctx
->bridge
.of_node
= dev
->of_node
;
464 drm_bridge_add(&ctx
->bridge
);
466 ret
= mipi_dsi_attach(dsi
);
468 drm_bridge_remove(&ctx
->bridge
);
469 dev_err(dev
, "failed to attach dsi\n");
475 static int tc358764_remove(struct mipi_dsi_device
*dsi
)
477 struct tc358764
*ctx
= mipi_dsi_get_drvdata(dsi
);
479 mipi_dsi_detach(dsi
);
480 drm_bridge_remove(&ctx
->bridge
);
485 static const struct of_device_id tc358764_of_match
[] = {
486 { .compatible
= "toshiba,tc358764" },
489 MODULE_DEVICE_TABLE(of
, tc358764_of_match
);
491 static struct mipi_dsi_driver tc358764_driver
= {
492 .probe
= tc358764_probe
,
493 .remove
= tc358764_remove
,
496 .owner
= THIS_MODULE
,
497 .of_match_table
= tc358764_of_match
,
500 module_mipi_dsi_driver(tc358764_driver
);
502 MODULE_AUTHOR("Andrzej Hajda <a.hajda@samsung.com>");
503 MODULE_AUTHOR("Maciej Purski <m.purski@samsung.com>");
504 MODULE_DESCRIPTION("MIPI-DSI based Driver for TC358764 DSI/LVDS Bridge");
505 MODULE_LICENSE("GPL v2");