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_modeset_helper.h>
25 #include <drm/tinydrm/mipi-dbi.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 *mipi = drm_to_mipi_dbi(pipe->crtc.dev);
51 struct mipi_dbi *dbi = mipi;
55 if (!drm_dev_enter(pipe->crtc.dev, &idx))
60 ret = mipi_dbi_poweron_conditional_reset(mipi);
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 (mipi->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(mipi, 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 drm_device *drm;
224 struct mipi_dbi *mipi;
225 struct gpio_desc *dc;
229 mipi = kzalloc(sizeof(*mipi), 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 mipi->backlight = devm_of_find_backlight(dev);
249 if (IS_ERR(mipi->backlight))
250 return PTR_ERR(mipi->backlight);
252 device_property_read_u32(dev, "rotation", &rotation);
254 ret = mipi_dbi_spi_init(spi, mipi, dc);
258 ret = mipi_dbi_init(mipi, &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");