1 // SPDX-License-Identifier: GPL-2.0-only
3 * ld9040 AMOLED LCD drm_panel driver.
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd
6 * Derived from drivers/video/backlight/ld9040.c
8 * Andrzej Hajda <a.hajda@samsung.com>
12 #include <drm/drm_panel.h>
14 #include <linux/gpio/consumer.h>
15 #include <linux/regulator/consumer.h>
16 #include <linux/spi/spi.h>
18 #include <video/mipi_display.h>
19 #include <video/of_videomode.h>
20 #include <video/videomode.h>
22 /* Manufacturer Command Set */
23 #define MCS_MANPWR 0xb0
24 #define MCS_ELVSS_ON 0xb1
25 #define MCS_USER_SETTING 0xf0
26 #define MCS_DISPCTL 0xf2
27 #define MCS_POWER_CTRL 0xf4
28 #define MCS_GTCON 0xf7
29 #define MCS_PANEL_CONDITION 0xf8
30 #define MCS_GAMMA_SET1 0xf9
31 #define MCS_GAMMA_CTRL 0xfb
33 /* array of gamma tables for gamma value 2.2 */
34 static u8 const ld9040_gammas[25][22] = {
35 { 0xf9, 0x00, 0x13, 0xb2, 0xba, 0xd2, 0x00, 0x30, 0x00, 0xaf, 0xc0,
36 0xb8, 0xcd, 0x00, 0x3d, 0x00, 0xa8, 0xb8, 0xb7, 0xcd, 0x00, 0x44 },
37 { 0xf9, 0x00, 0x13, 0xb9, 0xb9, 0xd0, 0x00, 0x3c, 0x00, 0xaf, 0xbf,
38 0xb6, 0xcb, 0x00, 0x4b, 0x00, 0xa8, 0xb9, 0xb5, 0xcc, 0x00, 0x52 },
39 { 0xf9, 0x00, 0x13, 0xba, 0xb9, 0xcd, 0x00, 0x41, 0x00, 0xb0, 0xbe,
40 0xb5, 0xc9, 0x00, 0x51, 0x00, 0xa9, 0xb9, 0xb5, 0xca, 0x00, 0x57 },
41 { 0xf9, 0x00, 0x13, 0xb9, 0xb8, 0xcd, 0x00, 0x46, 0x00, 0xb1, 0xbc,
42 0xb5, 0xc8, 0x00, 0x56, 0x00, 0xaa, 0xb8, 0xb4, 0xc9, 0x00, 0x5d },
43 { 0xf9, 0x00, 0x13, 0xba, 0xb8, 0xcb, 0x00, 0x4b, 0x00, 0xb3, 0xbc,
44 0xb4, 0xc7, 0x00, 0x5c, 0x00, 0xac, 0xb8, 0xb4, 0xc8, 0x00, 0x62 },
45 { 0xf9, 0x00, 0x13, 0xbb, 0xb7, 0xca, 0x00, 0x4f, 0x00, 0xb4, 0xbb,
46 0xb3, 0xc7, 0x00, 0x60, 0x00, 0xad, 0xb8, 0xb4, 0xc7, 0x00, 0x67 },
47 { 0xf9, 0x00, 0x47, 0xba, 0xb6, 0xca, 0x00, 0x53, 0x00, 0xb5, 0xbb,
48 0xb3, 0xc6, 0x00, 0x65, 0x00, 0xae, 0xb8, 0xb3, 0xc7, 0x00, 0x6c },
49 { 0xf9, 0x00, 0x71, 0xbb, 0xb5, 0xc8, 0x00, 0x57, 0x00, 0xb5, 0xbb,
50 0xb0, 0xc5, 0x00, 0x6a, 0x00, 0xae, 0xb9, 0xb1, 0xc6, 0x00, 0x70 },
51 { 0xf9, 0x00, 0x7b, 0xbb, 0xb4, 0xc8, 0x00, 0x5b, 0x00, 0xb5, 0xba,
52 0xb1, 0xc4, 0x00, 0x6e, 0x00, 0xae, 0xb9, 0xb0, 0xc5, 0x00, 0x75 },
53 { 0xf9, 0x00, 0x82, 0xba, 0xb4, 0xc7, 0x00, 0x5f, 0x00, 0xb5, 0xba,
54 0xb0, 0xc3, 0x00, 0x72, 0x00, 0xae, 0xb8, 0xb0, 0xc3, 0x00, 0x7a },
55 { 0xf9, 0x00, 0x89, 0xba, 0xb3, 0xc8, 0x00, 0x62, 0x00, 0xb6, 0xba,
56 0xaf, 0xc3, 0x00, 0x76, 0x00, 0xaf, 0xb7, 0xae, 0xc4, 0x00, 0x7e },
57 { 0xf9, 0x00, 0x8b, 0xb9, 0xb3, 0xc7, 0x00, 0x65, 0x00, 0xb7, 0xb8,
58 0xaf, 0xc3, 0x00, 0x7a, 0x00, 0x80, 0xb6, 0xae, 0xc4, 0x00, 0x81 },
59 { 0xf9, 0x00, 0x93, 0xba, 0xb3, 0xc5, 0x00, 0x69, 0x00, 0xb8, 0xb9,
60 0xae, 0xc1, 0x00, 0x7f, 0x00, 0xb0, 0xb6, 0xae, 0xc3, 0x00, 0x85 },
61 { 0xf9, 0x00, 0x97, 0xba, 0xb2, 0xc5, 0x00, 0x6c, 0x00, 0xb8, 0xb8,
62 0xae, 0xc1, 0x00, 0x82, 0x00, 0xb0, 0xb6, 0xae, 0xc2, 0x00, 0x89 },
63 { 0xf9, 0x00, 0x9a, 0xba, 0xb1, 0xc4, 0x00, 0x6f, 0x00, 0xb8, 0xb8,
64 0xad, 0xc0, 0x00, 0x86, 0x00, 0xb0, 0xb7, 0xad, 0xc0, 0x00, 0x8d },
65 { 0xf9, 0x00, 0x9c, 0xb9, 0xb0, 0xc4, 0x00, 0x72, 0x00, 0xb8, 0xb8,
66 0xac, 0xbf, 0x00, 0x8a, 0x00, 0xb0, 0xb6, 0xac, 0xc0, 0x00, 0x91 },
67 { 0xf9, 0x00, 0x9e, 0xba, 0xb0, 0xc2, 0x00, 0x75, 0x00, 0xb9, 0xb8,
68 0xab, 0xbe, 0x00, 0x8e, 0x00, 0xb0, 0xb6, 0xac, 0xbf, 0x00, 0x94 },
69 { 0xf9, 0x00, 0xa0, 0xb9, 0xaf, 0xc3, 0x00, 0x77, 0x00, 0xb9, 0xb7,
70 0xab, 0xbe, 0x00, 0x90, 0x00, 0xb0, 0xb6, 0xab, 0xbf, 0x00, 0x97 },
71 { 0xf9, 0x00, 0xa2, 0xb9, 0xaf, 0xc2, 0x00, 0x7a, 0x00, 0xb9, 0xb7,
72 0xaa, 0xbd, 0x00, 0x94, 0x00, 0xb0, 0xb5, 0xab, 0xbf, 0x00, 0x9a },
73 { 0xf9, 0x00, 0xa4, 0xb9, 0xaf, 0xc1, 0x00, 0x7d, 0x00, 0xb9, 0xb6,
74 0xaa, 0xbb, 0x00, 0x97, 0x00, 0xb1, 0xb5, 0xaa, 0xbf, 0x00, 0x9d },
75 { 0xf9, 0x00, 0xa4, 0xb8, 0xb0, 0xbf, 0x00, 0x80, 0x00, 0xb8, 0xb6,
76 0xaa, 0xbc, 0x00, 0x9a, 0x00, 0xb0, 0xb5, 0xab, 0xbd, 0x00, 0xa0 },
77 { 0xf9, 0x00, 0xa8, 0xb8, 0xae, 0xbe, 0x00, 0x84, 0x00, 0xb9, 0xb7,
78 0xa8, 0xbc, 0x00, 0x9d, 0x00, 0xb2, 0xb5, 0xaa, 0xbc, 0x00, 0xa4 },
79 { 0xf9, 0x00, 0xa9, 0xb6, 0xad, 0xbf, 0x00, 0x86, 0x00, 0xb8, 0xb5,
80 0xa8, 0xbc, 0x00, 0xa0, 0x00, 0xb3, 0xb3, 0xa9, 0xbc, 0x00, 0xa7 },
81 { 0xf9, 0x00, 0xa9, 0xb7, 0xae, 0xbd, 0x00, 0x89, 0x00, 0xb7, 0xb6,
82 0xa8, 0xba, 0x00, 0xa4, 0x00, 0xb1, 0xb4, 0xaa, 0xbb, 0x00, 0xaa },
83 { 0xf9, 0x00, 0xa7, 0xb4, 0xae, 0xbf, 0x00, 0x91, 0x00, 0xb2, 0xb4,
84 0xaa, 0xbb, 0x00, 0xac, 0x00, 0xb3, 0xb1, 0xaa, 0xbc, 0x00, 0xb3 },
89 struct drm_panel panel;
91 struct regulator_bulk_data supplies[2];
92 struct gpio_desc *reset_gpio;
101 /* This field is tested by functions directly accessing bus before
102 * transfer, transfer is skipped if it is set. In case of transfer
103 * failure or unexpected response the field is set to error value.
104 * Such construct allows to eliminate many checks in higher level
110 static inline struct ld9040 *panel_to_ld9040(struct drm_panel *panel)
112 return container_of(panel, struct ld9040, panel);
115 static int ld9040_clear_error(struct ld9040 *ctx)
117 int ret = ctx->error;
123 static int ld9040_spi_write_word(struct ld9040 *ctx, u16 data)
125 struct spi_device *spi = to_spi_device(ctx->dev);
126 struct spi_transfer xfer = {
130 struct spi_message msg;
132 spi_message_init(&msg);
133 spi_message_add_tail(&xfer, &msg);
135 return spi_sync(spi, &msg);
138 static void ld9040_dcs_write(struct ld9040 *ctx, const u8 *data, size_t len)
142 if (ctx->error < 0 || len == 0)
145 dev_dbg(ctx->dev, "writing dcs seq: %*ph\n", (int)len, data);
146 ret = ld9040_spi_write_word(ctx, *data);
148 while (!ret && --len) {
150 ret = ld9040_spi_write_word(ctx, *data | 0x100);
154 dev_err(ctx->dev, "error %d writing dcs seq: %*ph\n", ret,
159 usleep_range(300, 310);
162 #define ld9040_dcs_write_seq_static(ctx, seq...) \
164 static const u8 d[] = { seq };\
165 ld9040_dcs_write(ctx, d, ARRAY_SIZE(d));\
168 static void ld9040_brightness_set(struct ld9040 *ctx)
170 ld9040_dcs_write(ctx, ld9040_gammas[ctx->brightness],
171 ARRAY_SIZE(ld9040_gammas[ctx->brightness]));
173 ld9040_dcs_write_seq_static(ctx, MCS_GAMMA_CTRL, 0x02, 0x5a);
176 static void ld9040_init(struct ld9040 *ctx)
178 ld9040_dcs_write_seq_static(ctx, MCS_USER_SETTING, 0x5a, 0x5a);
179 ld9040_dcs_write_seq_static(ctx, MCS_PANEL_CONDITION,
180 0x05, 0x65, 0x96, 0x71, 0x7d, 0x19, 0x3b, 0x0d,
181 0x19, 0x7e, 0x0d, 0xe2, 0x00, 0x00, 0x7e, 0x7d,
182 0x07, 0x07, 0x20, 0x20, 0x20, 0x02, 0x02);
183 ld9040_dcs_write_seq_static(ctx, MCS_DISPCTL,
184 0x02, 0x08, 0x08, 0x10, 0x10);
185 ld9040_dcs_write_seq_static(ctx, MCS_MANPWR, 0x04);
186 ld9040_dcs_write_seq_static(ctx, MCS_POWER_CTRL,
187 0x0a, 0x87, 0x25, 0x6a, 0x44, 0x02, 0x88);
188 ld9040_dcs_write_seq_static(ctx, MCS_ELVSS_ON, 0x0d, 0x00, 0x16);
189 ld9040_dcs_write_seq_static(ctx, MCS_GTCON, 0x09, 0x00, 0x00);
190 ld9040_brightness_set(ctx);
191 ld9040_dcs_write_seq_static(ctx, MIPI_DCS_EXIT_SLEEP_MODE);
192 ld9040_dcs_write_seq_static(ctx, MIPI_DCS_SET_DISPLAY_ON);
195 static int ld9040_power_on(struct ld9040 *ctx)
199 ret = regulator_bulk_enable(ARRAY_SIZE(ctx->supplies), ctx->supplies);
203 msleep(ctx->power_on_delay);
204 gpiod_set_value(ctx->reset_gpio, 0);
205 msleep(ctx->reset_delay);
206 gpiod_set_value(ctx->reset_gpio, 1);
207 msleep(ctx->reset_delay);
212 static int ld9040_power_off(struct ld9040 *ctx)
214 return regulator_bulk_disable(ARRAY_SIZE(ctx->supplies), ctx->supplies);
217 static int ld9040_disable(struct drm_panel *panel)
222 static int ld9040_unprepare(struct drm_panel *panel)
224 struct ld9040 *ctx = panel_to_ld9040(panel);
227 ld9040_dcs_write_seq_static(ctx, MIPI_DCS_SET_DISPLAY_OFF);
228 ld9040_dcs_write_seq_static(ctx, MIPI_DCS_ENTER_SLEEP_MODE);
231 ld9040_clear_error(ctx);
233 return ld9040_power_off(ctx);
236 static int ld9040_prepare(struct drm_panel *panel)
238 struct ld9040 *ctx = panel_to_ld9040(panel);
241 ret = ld9040_power_on(ctx);
247 ret = ld9040_clear_error(ctx);
250 ld9040_unprepare(panel);
255 static int ld9040_enable(struct drm_panel *panel)
260 static int ld9040_get_modes(struct drm_panel *panel)
262 struct drm_connector *connector = panel->connector;
263 struct ld9040 *ctx = panel_to_ld9040(panel);
264 struct drm_display_mode *mode;
266 mode = drm_mode_create(connector->dev);
268 DRM_ERROR("failed to create a new display mode\n");
272 drm_display_mode_from_videomode(&ctx->vm, mode);
273 mode->width_mm = ctx->width_mm;
274 mode->height_mm = ctx->height_mm;
275 connector->display_info.width_mm = mode->width_mm;
276 connector->display_info.height_mm = mode->height_mm;
278 mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED;
279 drm_mode_probed_add(connector, mode);
284 static const struct drm_panel_funcs ld9040_drm_funcs = {
285 .disable = ld9040_disable,
286 .unprepare = ld9040_unprepare,
287 .prepare = ld9040_prepare,
288 .enable = ld9040_enable,
289 .get_modes = ld9040_get_modes,
292 static int ld9040_parse_dt(struct ld9040 *ctx)
294 struct device *dev = ctx->dev;
295 struct device_node *np = dev->of_node;
298 ret = of_get_videomode(np, &ctx->vm, 0);
302 of_property_read_u32(np, "power-on-delay", &ctx->power_on_delay);
303 of_property_read_u32(np, "reset-delay", &ctx->reset_delay);
304 of_property_read_u32(np, "panel-width-mm", &ctx->width_mm);
305 of_property_read_u32(np, "panel-height-mm", &ctx->height_mm);
310 static int ld9040_probe(struct spi_device *spi)
312 struct device *dev = &spi->dev;
316 ctx = devm_kzalloc(dev, sizeof(struct ld9040), GFP_KERNEL);
320 spi_set_drvdata(spi, ctx);
323 ctx->brightness = ARRAY_SIZE(ld9040_gammas) - 1;
325 ret = ld9040_parse_dt(ctx);
329 ctx->supplies[0].supply = "vdd3";
330 ctx->supplies[1].supply = "vci";
331 ret = devm_regulator_bulk_get(dev, ARRAY_SIZE(ctx->supplies),
336 ctx->reset_gpio = devm_gpiod_get(dev, "reset", GPIOD_OUT_HIGH);
337 if (IS_ERR(ctx->reset_gpio)) {
338 dev_err(dev, "cannot get reset-gpios %ld\n",
339 PTR_ERR(ctx->reset_gpio));
340 return PTR_ERR(ctx->reset_gpio);
343 spi->bits_per_word = 9;
344 ret = spi_setup(spi);
346 dev_err(dev, "spi setup failed.\n");
350 drm_panel_init(&ctx->panel);
351 ctx->panel.dev = dev;
352 ctx->panel.funcs = &ld9040_drm_funcs;
354 return drm_panel_add(&ctx->panel);
357 static int ld9040_remove(struct spi_device *spi)
359 struct ld9040 *ctx = spi_get_drvdata(spi);
361 ld9040_power_off(ctx);
362 drm_panel_remove(&ctx->panel);
367 static const struct of_device_id ld9040_of_match[] = {
368 { .compatible = "samsung,ld9040" },
371 MODULE_DEVICE_TABLE(of, ld9040_of_match);
373 static struct spi_driver ld9040_driver = {
374 .probe = ld9040_probe,
375 .remove = ld9040_remove,
377 .name = "panel-samsung-ld9040",
378 .of_match_table = ld9040_of_match,
381 module_spi_driver(ld9040_driver);
383 MODULE_AUTHOR("Andrzej Hajda <a.hajda@samsung.com>");
384 MODULE_DESCRIPTION("ld9040 LCD Driver");
385 MODULE_LICENSE("GPL v2");