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);
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)
354 struct tc358764 *ctx = bridge_to_tc358764(bridge);
355 struct drm_device *drm = bridge->dev;
358 ctx->connector.polled = DRM_CONNECTOR_POLL_HPD;
359 ret = drm_connector_init(drm, &ctx->connector,
360 &tc358764_connector_funcs,
361 DRM_MODE_CONNECTOR_LVDS);
363 DRM_ERROR("Failed to initialize connector\n");
367 drm_connector_helper_add(&ctx->connector,
368 &tc358764_connector_helper_funcs);
369 drm_connector_attach_encoder(&ctx->connector, bridge->encoder);
370 drm_panel_attach(ctx->panel, &ctx->connector);
371 ctx->connector.funcs->reset(&ctx->connector);
372 drm_fb_helper_add_one_connector(drm->fb_helper, &ctx->connector);
373 drm_connector_register(&ctx->connector);
378 static void tc358764_detach(struct drm_bridge *bridge)
380 struct tc358764 *ctx = bridge_to_tc358764(bridge);
381 struct drm_device *drm = bridge->dev;
383 drm_connector_unregister(&ctx->connector);
384 drm_fb_helper_remove_one_connector(drm->fb_helper, &ctx->connector);
385 drm_panel_detach(ctx->panel);
387 drm_connector_put(&ctx->connector);
390 static const struct drm_bridge_funcs tc358764_bridge_funcs = {
391 .disable = tc358764_disable,
392 .post_disable = tc358764_post_disable,
393 .enable = tc358764_enable,
394 .pre_enable = tc358764_pre_enable,
395 .attach = tc358764_attach,
396 .detach = tc358764_detach,
399 static int tc358764_parse_dt(struct tc358764 *ctx)
401 struct device *dev = ctx->dev;
404 ctx->gpio_reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_LOW);
405 if (IS_ERR(ctx->gpio_reset)) {
406 dev_err(dev, "no reset GPIO pin provided\n");
407 return PTR_ERR(ctx->gpio_reset);
410 ret = drm_of_find_panel_or_bridge(ctx->dev->of_node, 1, 0, &ctx->panel,
412 if (ret && ret != -EPROBE_DEFER)
413 dev_err(dev, "cannot find panel (%d)\n", ret);
418 static int tc358764_configure_regulators(struct tc358764 *ctx)
422 for (i = 0; i < ARRAY_SIZE(ctx->supplies); ++i)
423 ctx->supplies[i].supply = tc358764_supplies[i];
425 ret = devm_regulator_bulk_get(ctx->dev, ARRAY_SIZE(ctx->supplies),
428 dev_err(ctx->dev, "failed to get regulators: %d\n", ret);
433 static int tc358764_probe(struct mipi_dsi_device *dsi)
435 struct device *dev = &dsi->dev;
436 struct tc358764 *ctx;
439 ctx = devm_kzalloc(dev, sizeof(struct tc358764), GFP_KERNEL);
443 mipi_dsi_set_drvdata(dsi, ctx);
448 dsi->format = MIPI_DSI_FMT_RGB888;
449 dsi->mode_flags = MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST
450 | MIPI_DSI_MODE_VIDEO_AUTO_VERT | MIPI_DSI_MODE_LPM;
452 ret = tc358764_parse_dt(ctx);
456 ret = tc358764_configure_regulators(ctx);
460 ctx->bridge.funcs = &tc358764_bridge_funcs;
461 ctx->bridge.of_node = dev->of_node;
463 drm_bridge_add(&ctx->bridge);
465 ret = mipi_dsi_attach(dsi);
467 drm_bridge_remove(&ctx->bridge);
468 dev_err(dev, "failed to attach dsi\n");
474 static int tc358764_remove(struct mipi_dsi_device *dsi)
476 struct tc358764 *ctx = mipi_dsi_get_drvdata(dsi);
478 mipi_dsi_detach(dsi);
479 drm_bridge_remove(&ctx->bridge);
484 static const struct of_device_id tc358764_of_match[] = {
485 { .compatible = "toshiba,tc358764" },
488 MODULE_DEVICE_TABLE(of, tc358764_of_match);
490 static struct mipi_dsi_driver tc358764_driver = {
491 .probe = tc358764_probe,
492 .remove = tc358764_remove,
495 .owner = THIS_MODULE,
496 .of_match_table = tc358764_of_match,
499 module_mipi_dsi_driver(tc358764_driver);
501 MODULE_AUTHOR("Andrzej Hajda <a.hajda@samsung.com>");
502 MODULE_AUTHOR("Maciej Purski <m.purski@samsung.com>");
503 MODULE_DESCRIPTION("MIPI-DSI based Driver for TC358764 DSI/LVDS Bridge");
504 MODULE_LICENSE("GPL v2");