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_drv.h>
20 #include <drm/drm_gem_cma_helper.h>
21 #include <drm/drm_gem_framebuffer_helper.h>
22 #include <drm/drm_modeset_helper.h>
23 #include <drm/tinydrm/mipi-dbi.h>
24 #include <drm/tinydrm/tinydrm-helpers.h>
25 #include <video/mipi_display.h>
27 #define HX8357D_SETOSC 0xb0
28 #define HX8357D_SETPOWER 0xb1
29 #define HX8357D_SETRGB 0xb3
30 #define HX8357D_SETCYC 0xb3
31 #define HX8357D_SETCOM 0xb6
32 #define HX8357D_SETEXTC 0xb9
33 #define HX8357D_SETSTBA 0xc0
34 #define HX8357D_SETPANEL 0xcc
35 #define HX8357D_SETGAMMA 0xe0
37 #define HX8357D_MADCTL_MY 0x80
38 #define HX8357D_MADCTL_MX 0x40
39 #define HX8357D_MADCTL_MV 0x20
40 #define HX8357D_MADCTL_ML 0x10
41 #define HX8357D_MADCTL_RGB 0x00
42 #define HX8357D_MADCTL_BGR 0x08
43 #define HX8357D_MADCTL_MH 0x04
45 static void yx240qv29_enable(struct drm_simple_display_pipe *pipe,
46 struct drm_crtc_state *crtc_state,
47 struct drm_plane_state *plane_state)
49 struct tinydrm_device *tdev = pipe_to_tinydrm(pipe);
50 struct mipi_dbi *mipi = mipi_dbi_from_tinydrm(tdev);
56 ret = mipi_dbi_poweron_conditional_reset(mipi);
63 mipi_dbi_command(mipi, HX8357D_SETEXTC, 0xFF, 0x83, 0x57);
66 /* setRGB which also enables SDO */
67 mipi_dbi_command(mipi, HX8357D_SETRGB, 0x00, 0x00, 0x06, 0x06);
70 mipi_dbi_command(mipi, HX8357D_SETCOM, 0x25);
72 /* Normal mode 70Hz, Idle mode 55 Hz */
73 mipi_dbi_command(mipi, HX8357D_SETOSC, 0x68);
75 /* Set Panel - BGR, Gate direction swapped */
76 mipi_dbi_command(mipi, HX8357D_SETPANEL, 0x05);
78 mipi_dbi_command(mipi, HX8357D_SETPOWER,
79 0x00, /* Not deep standby */
86 mipi_dbi_command(mipi, HX8357D_SETSTBA,
87 0x50, /* OPON normal */
94 mipi_dbi_command(mipi, HX8357D_SETCYC,
103 mipi_dbi_command(mipi, HX8357D_SETGAMMA,
140 mipi_dbi_command(mipi, MIPI_DCS_SET_PIXEL_FORMAT,
141 MIPI_DCS_PIXEL_FMT_16BIT);
144 mipi_dbi_command(mipi, MIPI_DCS_SET_TEAR_ON, 0x00);
147 mipi_dbi_command(mipi, MIPI_DCS_SET_TEAR_SCANLINE, 0x00, 0x02);
150 mipi_dbi_command(mipi, MIPI_DCS_EXIT_SLEEP_MODE);
154 mipi_dbi_command(mipi, MIPI_DCS_SET_DISPLAY_ON);
155 usleep_range(5000, 7000);
158 switch (mipi->rotation) {
160 addr_mode = HX8357D_MADCTL_MX | HX8357D_MADCTL_MY;
163 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MY;
169 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MX;
172 mipi_dbi_command(mipi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
173 mipi_dbi_enable_flush(mipi, crtc_state, plane_state);
176 static const struct drm_simple_display_pipe_funcs hx8357d_pipe_funcs = {
177 .enable = yx240qv29_enable,
178 .disable = mipi_dbi_pipe_disable,
179 .update = mipi_dbi_pipe_update,
180 .prepare_fb = drm_gem_fb_simple_display_pipe_prepare_fb,
183 static const struct drm_display_mode yx350hv15_mode = {
184 TINYDRM_MODE(320, 480, 60, 75),
187 DEFINE_DRM_GEM_CMA_FOPS(hx8357d_fops);
189 static struct drm_driver hx8357d_driver = {
190 .driver_features = DRIVER_GEM | DRIVER_MODESET | DRIVER_PRIME | DRIVER_ATOMIC,
191 .fops = &hx8357d_fops,
192 DRM_GEM_CMA_VMAP_DRIVER_OPS,
193 .debugfs_init = mipi_dbi_debugfs_init,
201 static const struct of_device_id hx8357d_of_match[] = {
202 { .compatible = "adafruit,yx350hv15" },
205 MODULE_DEVICE_TABLE(of, hx8357d_of_match);
207 static const struct spi_device_id hx8357d_id[] = {
211 MODULE_DEVICE_TABLE(spi, hx8357d_id);
213 static int hx8357d_probe(struct spi_device *spi)
215 struct device *dev = &spi->dev;
216 struct mipi_dbi *mipi;
217 struct gpio_desc *dc;
221 mipi = devm_kzalloc(dev, sizeof(*mipi), GFP_KERNEL);
225 dc = devm_gpiod_get(dev, "dc", GPIOD_OUT_LOW);
227 DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");
231 mipi->backlight = devm_of_find_backlight(dev);
232 if (IS_ERR(mipi->backlight))
233 return PTR_ERR(mipi->backlight);
235 device_property_read_u32(dev, "rotation", &rotation);
237 ret = mipi_dbi_spi_init(spi, mipi, dc);
241 ret = mipi_dbi_init(&spi->dev, mipi, &hx8357d_pipe_funcs,
242 &hx8357d_driver, &yx350hv15_mode, rotation);
246 spi_set_drvdata(spi, mipi);
248 return devm_tinydrm_register(&mipi->tinydrm);
251 static void hx8357d_shutdown(struct spi_device *spi)
253 struct mipi_dbi *mipi = spi_get_drvdata(spi);
255 tinydrm_shutdown(&mipi->tinydrm);
258 static struct spi_driver hx8357d_spi_driver = {
261 .of_match_table = hx8357d_of_match,
263 .id_table = hx8357d_id,
264 .probe = hx8357d_probe,
265 .shutdown = hx8357d_shutdown,
267 module_spi_driver(hx8357d_spi_driver);
269 MODULE_DESCRIPTION("HX8357D DRM driver");
271 MODULE_LICENSE("GPL");