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_mipi_dbi.h>
25 #include <drm/drm_modeset_helper.h>
26 #include <video/mipi_display.h>
28 #define HX8357D_SETOSC 0xb0
29 #define HX8357D_SETPOWER 0xb1
30 #define HX8357D_SETRGB 0xb3
31 #define HX8357D_SETCYC 0xb3
32 #define HX8357D_SETCOM 0xb6
33 #define HX8357D_SETEXTC 0xb9
34 #define HX8357D_SETSTBA 0xc0
35 #define HX8357D_SETPANEL 0xcc
36 #define HX8357D_SETGAMMA 0xe0
38 #define HX8357D_MADCTL_MY 0x80
39 #define HX8357D_MADCTL_MX 0x40
40 #define HX8357D_MADCTL_MV 0x20
41 #define HX8357D_MADCTL_ML 0x10
42 #define HX8357D_MADCTL_RGB 0x00
43 #define HX8357D_MADCTL_BGR 0x08
44 #define HX8357D_MADCTL_MH 0x04
46 static void yx240qv29_enable(struct drm_simple_display_pipe
*pipe
,
47 struct drm_crtc_state
*crtc_state
,
48 struct drm_plane_state
*plane_state
)
50 struct mipi_dbi_dev
*dbidev
= drm_to_mipi_dbi_dev(pipe
->crtc
.dev
);
51 struct mipi_dbi
*dbi
= &dbidev
->dbi
;
55 if (!drm_dev_enter(pipe
->crtc
.dev
, &idx
))
60 ret
= mipi_dbi_poweron_conditional_reset(dbidev
);
67 mipi_dbi_command(dbi
, HX8357D_SETEXTC
, 0xFF, 0x83, 0x57);
70 /* setRGB which also enables SDO */
71 mipi_dbi_command(dbi
, HX8357D_SETRGB
, 0x00, 0x00, 0x06, 0x06);
74 mipi_dbi_command(dbi
, HX8357D_SETCOM
, 0x25);
76 /* Normal mode 70Hz, Idle mode 55 Hz */
77 mipi_dbi_command(dbi
, HX8357D_SETOSC
, 0x68);
79 /* Set Panel - BGR, Gate direction swapped */
80 mipi_dbi_command(dbi
, HX8357D_SETPANEL
, 0x05);
82 mipi_dbi_command(dbi
, HX8357D_SETPOWER
,
83 0x00, /* Not deep standby */
90 mipi_dbi_command(dbi
, HX8357D_SETSTBA
,
91 0x50, /* OPON normal */
98 mipi_dbi_command(dbi
, HX8357D_SETCYC
,
107 mipi_dbi_command(dbi
, HX8357D_SETGAMMA
,
144 mipi_dbi_command(dbi
, MIPI_DCS_SET_PIXEL_FORMAT
,
145 MIPI_DCS_PIXEL_FMT_16BIT
);
148 mipi_dbi_command(dbi
, MIPI_DCS_SET_TEAR_ON
, 0x00);
151 mipi_dbi_command(dbi
, MIPI_DCS_SET_TEAR_SCANLINE
, 0x00, 0x02);
154 mipi_dbi_command(dbi
, MIPI_DCS_EXIT_SLEEP_MODE
);
158 mipi_dbi_command(dbi
, MIPI_DCS_SET_DISPLAY_ON
);
159 usleep_range(5000, 7000);
162 switch (dbidev
->rotation
) {
164 addr_mode
= HX8357D_MADCTL_MX
| HX8357D_MADCTL_MY
;
167 addr_mode
= HX8357D_MADCTL_MV
| HX8357D_MADCTL_MY
;
173 addr_mode
= HX8357D_MADCTL_MV
| HX8357D_MADCTL_MX
;
176 mipi_dbi_command(dbi
, MIPI_DCS_SET_ADDRESS_MODE
, addr_mode
);
177 mipi_dbi_enable_flush(dbidev
, crtc_state
, plane_state
);
182 static const struct drm_simple_display_pipe_funcs hx8357d_pipe_funcs
= {
183 .enable
= yx240qv29_enable
,
184 .disable
= mipi_dbi_pipe_disable
,
185 .update
= mipi_dbi_pipe_update
,
186 .prepare_fb
= drm_gem_fb_simple_display_pipe_prepare_fb
,
189 static const struct drm_display_mode yx350hv15_mode
= {
190 DRM_SIMPLE_MODE(320, 480, 60, 75),
193 DEFINE_DRM_GEM_CMA_FOPS(hx8357d_fops
);
195 static struct drm_driver hx8357d_driver
= {
196 .driver_features
= DRIVER_GEM
| DRIVER_MODESET
| DRIVER_ATOMIC
,
197 .fops
= &hx8357d_fops
,
198 .release
= mipi_dbi_release
,
199 DRM_GEM_CMA_VMAP_DRIVER_OPS
,
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
= kzalloc(sizeof(*dbidev
), GFP_KERNEL
);
234 ret
= devm_drm_dev_init(dev
, drm
, &hx8357d_driver
);
240 drm_mode_config_init(drm
);
242 dc
= devm_gpiod_get(dev
, "dc", GPIOD_OUT_LOW
);
244 DRM_DEV_ERROR(dev
, "Failed to get gpio 'dc'\n");
248 dbidev
->backlight
= devm_of_find_backlight(dev
);
249 if (IS_ERR(dbidev
->backlight
))
250 return PTR_ERR(dbidev
->backlight
);
252 device_property_read_u32(dev
, "rotation", &rotation
);
254 ret
= mipi_dbi_spi_init(spi
, &dbidev
->dbi
, dc
);
258 ret
= mipi_dbi_dev_init(dbidev
, &hx8357d_pipe_funcs
, &yx350hv15_mode
, rotation
);
262 drm_mode_config_reset(drm
);
264 ret
= drm_dev_register(drm
, 0);
268 spi_set_drvdata(spi
, drm
);
270 drm_fbdev_generic_setup(drm
, 0);
275 static int hx8357d_remove(struct spi_device
*spi
)
277 struct drm_device
*drm
= spi_get_drvdata(spi
);
280 drm_atomic_helper_shutdown(drm
);
285 static void hx8357d_shutdown(struct spi_device
*spi
)
287 drm_atomic_helper_shutdown(spi_get_drvdata(spi
));
290 static struct spi_driver hx8357d_spi_driver
= {
293 .of_match_table
= hx8357d_of_match
,
295 .id_table
= hx8357d_id
,
296 .probe
= hx8357d_probe
,
297 .remove
= hx8357d_remove
,
298 .shutdown
= hx8357d_shutdown
,
300 module_spi_driver(hx8357d_spi_driver
);
302 MODULE_DESCRIPTION("HX8357D DRM driver");
303 MODULE_AUTHOR("Eric Anholt <eric@anholt.net>");
304 MODULE_LICENSE("GPL");