1 // SPDX-License-Identifier: GPL-2.0+
3 * DRM driver for the HX8357D LCD controller
5 * Copyright 2018 Broadcom
6 * Copyright 2018 David Lechner <david@lechnology.com>
7 * Copyright 2016 Noralf Trønnes
8 * Copyright (C) 2015 Adafruit Industries
9 * Copyright (C) 2013 Christian Vogelgsang
12 #include <linux/backlight.h>
13 #include <linux/delay.h>
14 #include <linux/gpio/consumer.h>
15 #include <linux/module.h>
16 #include <linux/property.h>
17 #include <linux/spi/spi.h>
19 #include <drm/drm_atomic_helper.h>
20 #include <drm/drm_drv.h>
21 #include <drm/drm_fb_helper.h>
22 #include <drm/drm_gem_cma_helper.h>
23 #include <drm/drm_gem_framebuffer_helper.h>
24 #include <drm/drm_managed.h>
25 #include <drm/drm_mipi_dbi.h>
26 #include <drm/drm_modeset_helper.h>
27 #include <video/mipi_display.h>
29 #define HX8357D_SETOSC 0xb0
30 #define HX8357D_SETPOWER 0xb1
31 #define HX8357D_SETRGB 0xb3
32 #define HX8357D_SETCYC 0xb3
33 #define HX8357D_SETCOM 0xb6
34 #define HX8357D_SETEXTC 0xb9
35 #define HX8357D_SETSTBA 0xc0
36 #define HX8357D_SETPANEL 0xcc
37 #define HX8357D_SETGAMMA 0xe0
39 #define HX8357D_MADCTL_MY 0x80
40 #define HX8357D_MADCTL_MX 0x40
41 #define HX8357D_MADCTL_MV 0x20
42 #define HX8357D_MADCTL_ML 0x10
43 #define HX8357D_MADCTL_RGB 0x00
44 #define HX8357D_MADCTL_BGR 0x08
45 #define HX8357D_MADCTL_MH 0x04
47 static void yx240qv29_enable(struct drm_simple_display_pipe
*pipe
,
48 struct drm_crtc_state
*crtc_state
,
49 struct drm_plane_state
*plane_state
)
51 struct mipi_dbi_dev
*dbidev
= drm_to_mipi_dbi_dev(pipe
->crtc
.dev
);
52 struct mipi_dbi
*dbi
= &dbidev
->dbi
;
56 if (!drm_dev_enter(pipe
->crtc
.dev
, &idx
))
61 ret
= mipi_dbi_poweron_conditional_reset(dbidev
);
68 mipi_dbi_command(dbi
, HX8357D_SETEXTC
, 0xFF, 0x83, 0x57);
71 /* setRGB which also enables SDO */
72 mipi_dbi_command(dbi
, HX8357D_SETRGB
, 0x00, 0x00, 0x06, 0x06);
75 mipi_dbi_command(dbi
, HX8357D_SETCOM
, 0x25);
77 /* Normal mode 70Hz, Idle mode 55 Hz */
78 mipi_dbi_command(dbi
, HX8357D_SETOSC
, 0x68);
80 /* Set Panel - BGR, Gate direction swapped */
81 mipi_dbi_command(dbi
, HX8357D_SETPANEL
, 0x05);
83 mipi_dbi_command(dbi
, HX8357D_SETPOWER
,
84 0x00, /* Not deep standby */
91 mipi_dbi_command(dbi
, HX8357D_SETSTBA
,
92 0x50, /* OPON normal */
99 mipi_dbi_command(dbi
, HX8357D_SETCYC
,
108 mipi_dbi_command(dbi
, HX8357D_SETGAMMA
,
145 mipi_dbi_command(dbi
, MIPI_DCS_SET_PIXEL_FORMAT
,
146 MIPI_DCS_PIXEL_FMT_16BIT
);
149 mipi_dbi_command(dbi
, MIPI_DCS_SET_TEAR_ON
, 0x00);
152 mipi_dbi_command(dbi
, MIPI_DCS_SET_TEAR_SCANLINE
, 0x00, 0x02);
155 mipi_dbi_command(dbi
, MIPI_DCS_EXIT_SLEEP_MODE
);
159 mipi_dbi_command(dbi
, MIPI_DCS_SET_DISPLAY_ON
);
160 usleep_range(5000, 7000);
163 switch (dbidev
->rotation
) {
165 addr_mode
= HX8357D_MADCTL_MX
| HX8357D_MADCTL_MY
;
168 addr_mode
= HX8357D_MADCTL_MV
| HX8357D_MADCTL_MY
;
174 addr_mode
= HX8357D_MADCTL_MV
| HX8357D_MADCTL_MX
;
177 mipi_dbi_command(dbi
, MIPI_DCS_SET_ADDRESS_MODE
, addr_mode
);
178 mipi_dbi_enable_flush(dbidev
, crtc_state
, plane_state
);
183 static const struct drm_simple_display_pipe_funcs hx8357d_pipe_funcs
= {
184 .enable
= yx240qv29_enable
,
185 .disable
= mipi_dbi_pipe_disable
,
186 .update
= mipi_dbi_pipe_update
,
187 .prepare_fb
= drm_gem_fb_simple_display_pipe_prepare_fb
,
190 static const struct drm_display_mode yx350hv15_mode
= {
191 DRM_SIMPLE_MODE(320, 480, 60, 75),
194 DEFINE_DRM_GEM_CMA_FOPS(hx8357d_fops
);
196 static const struct drm_driver hx8357d_driver
= {
197 .driver_features
= DRIVER_GEM
| DRIVER_MODESET
| DRIVER_ATOMIC
,
198 .fops
= &hx8357d_fops
,
199 DRM_GEM_CMA_DRIVER_OPS_VMAP
,
200 .debugfs_init
= mipi_dbi_debugfs_init
,
208 static const struct of_device_id hx8357d_of_match
[] = {
209 { .compatible
= "adafruit,yx350hv15" },
212 MODULE_DEVICE_TABLE(of
, hx8357d_of_match
);
214 static const struct spi_device_id hx8357d_id
[] = {
218 MODULE_DEVICE_TABLE(spi
, hx8357d_id
);
220 static int hx8357d_probe(struct spi_device
*spi
)
222 struct device
*dev
= &spi
->dev
;
223 struct mipi_dbi_dev
*dbidev
;
224 struct drm_device
*drm
;
225 struct gpio_desc
*dc
;
229 dbidev
= devm_drm_dev_alloc(dev
, &hx8357d_driver
,
230 struct mipi_dbi_dev
, drm
);
232 return PTR_ERR(dbidev
);
236 dc
= devm_gpiod_get(dev
, "dc", GPIOD_OUT_LOW
);
238 DRM_DEV_ERROR(dev
, "Failed to get gpio 'dc'\n");
242 dbidev
->backlight
= devm_of_find_backlight(dev
);
243 if (IS_ERR(dbidev
->backlight
))
244 return PTR_ERR(dbidev
->backlight
);
246 device_property_read_u32(dev
, "rotation", &rotation
);
248 ret
= mipi_dbi_spi_init(spi
, &dbidev
->dbi
, dc
);
252 ret
= mipi_dbi_dev_init(dbidev
, &hx8357d_pipe_funcs
, &yx350hv15_mode
, rotation
);
256 drm_mode_config_reset(drm
);
258 ret
= drm_dev_register(drm
, 0);
262 spi_set_drvdata(spi
, drm
);
264 drm_fbdev_generic_setup(drm
, 0);
269 static int hx8357d_remove(struct spi_device
*spi
)
271 struct drm_device
*drm
= spi_get_drvdata(spi
);
274 drm_atomic_helper_shutdown(drm
);
279 static void hx8357d_shutdown(struct spi_device
*spi
)
281 drm_atomic_helper_shutdown(spi_get_drvdata(spi
));
284 static struct spi_driver hx8357d_spi_driver
= {
287 .of_match_table
= hx8357d_of_match
,
289 .id_table
= hx8357d_id
,
290 .probe
= hx8357d_probe
,
291 .remove
= hx8357d_remove
,
292 .shutdown
= hx8357d_shutdown
,
294 module_spi_driver(hx8357d_spi_driver
);
296 MODULE_DESCRIPTION("HX8357D DRM driver");
297 MODULE_AUTHOR("Eric Anholt <eric@anholt.net>");
298 MODULE_LICENSE("GPL");