1 // SPDX-License-Identifier: GPL-2.0+
3 * DRM driver for the HX8357D LCD controller
5 * Copyright 2018 Broadcom
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_gem_cma_helper.h>
20 #include <drm/drm_gem_framebuffer_helper.h>
21 #include <drm/drm_modeset_helper.h>
22 #include <drm/tinydrm/mipi-dbi.h>
23 #include <drm/tinydrm/tinydrm-helpers.h>
24 #include <video/mipi_display.h>
26 #define HX8357D_SETOSC 0xb0
27 #define HX8357D_SETPOWER 0xb1
28 #define HX8357D_SETRGB 0xb3
29 #define HX8357D_SETCYC 0xb3
30 #define HX8357D_SETCOM 0xb6
31 #define HX8357D_SETEXTC 0xb9
32 #define HX8357D_SETSTBA 0xc0
33 #define HX8357D_SETPANEL 0xcc
34 #define HX8357D_SETGAMMA 0xe0
36 #define HX8357D_MADCTL_MY 0x80
37 #define HX8357D_MADCTL_MX 0x40
38 #define HX8357D_MADCTL_MV 0x20
39 #define HX8357D_MADCTL_ML 0x10
40 #define HX8357D_MADCTL_RGB 0x00
41 #define HX8357D_MADCTL_BGR 0x08
42 #define HX8357D_MADCTL_MH 0x04
44 static void yx240qv29_enable(struct drm_simple_display_pipe *pipe,
45 struct drm_crtc_state *crtc_state,
46 struct drm_plane_state *plane_state)
48 struct tinydrm_device *tdev = pipe_to_tinydrm(pipe);
49 struct mipi_dbi *mipi = mipi_dbi_from_tinydrm(tdev);
55 ret = mipi_dbi_poweron_conditional_reset(mipi);
62 mipi_dbi_command(mipi, HX8357D_SETEXTC, 0xFF, 0x83, 0x57);
65 /* setRGB which also enables SDO */
66 mipi_dbi_command(mipi, HX8357D_SETRGB, 0x00, 0x00, 0x06, 0x06);
69 mipi_dbi_command(mipi, HX8357D_SETCOM, 0x25);
71 /* Normal mode 70Hz, Idle mode 55 Hz */
72 mipi_dbi_command(mipi, HX8357D_SETOSC, 0x68);
74 /* Set Panel - BGR, Gate direction swapped */
75 mipi_dbi_command(mipi, HX8357D_SETPANEL, 0x05);
77 mipi_dbi_command(mipi, HX8357D_SETPOWER,
78 0x00, /* Not deep standby */
85 mipi_dbi_command(mipi, HX8357D_SETSTBA,
86 0x50, /* OPON normal */
93 mipi_dbi_command(mipi, HX8357D_SETCYC,
102 mipi_dbi_command(mipi, HX8357D_SETGAMMA,
139 mipi_dbi_command(mipi, MIPI_DCS_SET_PIXEL_FORMAT,
140 MIPI_DCS_PIXEL_FMT_16BIT);
143 mipi_dbi_command(mipi, MIPI_DCS_SET_TEAR_ON, 0x00);
146 mipi_dbi_command(mipi, MIPI_DCS_SET_TEAR_SCANLINE, 0x00, 0x02);
149 mipi_dbi_command(mipi, MIPI_DCS_EXIT_SLEEP_MODE);
153 mipi_dbi_command(mipi, MIPI_DCS_SET_DISPLAY_ON);
154 usleep_range(5000, 7000);
157 switch (mipi->rotation) {
159 addr_mode = HX8357D_MADCTL_MX | HX8357D_MADCTL_MY;
162 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MY;
168 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MX;
171 mipi_dbi_command(mipi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
172 mipi_dbi_enable_flush(mipi, crtc_state, plane_state);
175 static const struct drm_simple_display_pipe_funcs hx8357d_pipe_funcs = {
176 .enable = yx240qv29_enable,
177 .disable = mipi_dbi_pipe_disable,
178 .update = tinydrm_display_pipe_update,
179 .prepare_fb = drm_gem_fb_simple_display_pipe_prepare_fb,
182 static const struct drm_display_mode yx350hv15_mode = {
183 TINYDRM_MODE(320, 480, 60, 75),
186 DEFINE_DRM_GEM_CMA_FOPS(hx8357d_fops);
188 static struct drm_driver hx8357d_driver = {
189 .driver_features = DRIVER_GEM | DRIVER_MODESET | DRIVER_PRIME | DRIVER_ATOMIC,
190 .fops = &hx8357d_fops,
191 DRM_GEM_CMA_VMAP_DRIVER_OPS,
192 .debugfs_init = mipi_dbi_debugfs_init,
200 static const struct of_device_id hx8357d_of_match[] = {
201 { .compatible = "adafruit,yx350hv15" },
204 MODULE_DEVICE_TABLE(of, hx8357d_of_match);
206 static const struct spi_device_id hx8357d_id[] = {
210 MODULE_DEVICE_TABLE(spi, hx8357d_id);
212 static int hx8357d_probe(struct spi_device *spi)
214 struct device *dev = &spi->dev;
215 struct mipi_dbi *mipi;
216 struct gpio_desc *dc;
220 mipi = devm_kzalloc(dev, sizeof(*mipi), GFP_KERNEL);
224 dc = devm_gpiod_get(dev, "dc", GPIOD_OUT_LOW);
226 DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");
230 mipi->backlight = devm_of_find_backlight(dev);
231 if (IS_ERR(mipi->backlight))
232 return PTR_ERR(mipi->backlight);
234 device_property_read_u32(dev, "rotation", &rotation);
236 ret = mipi_dbi_spi_init(spi, mipi, dc);
240 ret = mipi_dbi_init(&spi->dev, mipi, &hx8357d_pipe_funcs,
241 &hx8357d_driver, &yx350hv15_mode, rotation);
245 spi_set_drvdata(spi, mipi);
247 return devm_tinydrm_register(&mipi->tinydrm);
250 static void hx8357d_shutdown(struct spi_device *spi)
252 struct mipi_dbi *mipi = spi_get_drvdata(spi);
254 tinydrm_shutdown(&mipi->tinydrm);
257 static struct spi_driver hx8357d_spi_driver = {
260 .of_match_table = hx8357d_of_match,
262 .id_table = hx8357d_id,
263 .probe = hx8357d_probe,
264 .shutdown = hx8357d_shutdown,
266 module_spi_driver(hx8357d_spi_driver);
268 MODULE_DESCRIPTION("HX8357D DRM driver");
270 MODULE_LICENSE("GPL");