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/clients/drm_client_setup.h>
20 #include <drm/drm_atomic_helper.h>
21 #include <drm/drm_drv.h>
22 #include <drm/drm_fbdev_dma.h>
23 #include <drm/drm_gem_atomic_helper.h>
24 #include <drm/drm_gem_dma_helper.h>
25 #include <drm/drm_managed.h>
26 #include <drm/drm_mipi_dbi.h>
27 #include <drm/drm_modeset_helper.h>
28 #include <video/mipi_display.h>
30 #define HX8357D_SETOSC 0xb0
31 #define HX8357D_SETPOWER 0xb1
32 #define HX8357D_SETRGB 0xb3
33 #define HX8357D_SETCYC 0xb3
34 #define HX8357D_SETCOM 0xb6
35 #define HX8357D_SETEXTC 0xb9
36 #define HX8357D_SETSTBA 0xc0
37 #define HX8357D_SETPANEL 0xcc
38 #define HX8357D_SETGAMMA 0xe0
40 #define HX8357D_MADCTL_MY 0x80
41 #define HX8357D_MADCTL_MX 0x40
42 #define HX8357D_MADCTL_MV 0x20
43 #define HX8357D_MADCTL_ML 0x10
44 #define HX8357D_MADCTL_RGB 0x00
45 #define HX8357D_MADCTL_BGR 0x08
46 #define HX8357D_MADCTL_MH 0x04
48 static void yx240qv29_enable(struct drm_simple_display_pipe *pipe,
49 struct drm_crtc_state *crtc_state,
50 struct drm_plane_state *plane_state)
52 struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
53 struct mipi_dbi *dbi = &dbidev->dbi;
57 if (!drm_dev_enter(pipe->crtc.dev, &idx))
62 ret = mipi_dbi_poweron_conditional_reset(dbidev);
69 mipi_dbi_command(dbi, HX8357D_SETEXTC, 0xFF, 0x83, 0x57);
72 /* setRGB which also enables SDO */
73 mipi_dbi_command(dbi, HX8357D_SETRGB, 0x00, 0x00, 0x06, 0x06);
76 mipi_dbi_command(dbi, HX8357D_SETCOM, 0x25);
78 /* Normal mode 70Hz, Idle mode 55 Hz */
79 mipi_dbi_command(dbi, HX8357D_SETOSC, 0x68);
81 /* Set Panel - BGR, Gate direction swapped */
82 mipi_dbi_command(dbi, HX8357D_SETPANEL, 0x05);
84 mipi_dbi_command(dbi, HX8357D_SETPOWER,
85 0x00, /* Not deep standby */
92 mipi_dbi_command(dbi, HX8357D_SETSTBA,
93 0x50, /* OPON normal */
100 mipi_dbi_command(dbi, HX8357D_SETCYC,
109 mipi_dbi_command(dbi, HX8357D_SETGAMMA,
146 mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
147 MIPI_DCS_PIXEL_FMT_16BIT);
150 mipi_dbi_command(dbi, MIPI_DCS_SET_TEAR_ON, 0x00);
153 mipi_dbi_command(dbi, MIPI_DCS_SET_TEAR_SCANLINE, 0x00, 0x02);
156 mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
160 mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
161 usleep_range(5000, 7000);
164 switch (dbidev->rotation) {
166 addr_mode = HX8357D_MADCTL_MX | HX8357D_MADCTL_MY;
169 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MY;
175 addr_mode = HX8357D_MADCTL_MV | HX8357D_MADCTL_MX;
178 mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
179 mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
184 static const struct drm_simple_display_pipe_funcs hx8357d_pipe_funcs = {
185 DRM_MIPI_DBI_SIMPLE_DISPLAY_PIPE_FUNCS(yx240qv29_enable),
188 static const struct drm_display_mode yx350hv15_mode = {
189 DRM_SIMPLE_MODE(320, 480, 60, 75),
192 DEFINE_DRM_GEM_DMA_FOPS(hx8357d_fops);
194 static const struct drm_driver hx8357d_driver = {
195 .driver_features = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
196 .fops = &hx8357d_fops,
197 DRM_GEM_DMA_DRIVER_OPS_VMAP,
198 DRM_FBDEV_DMA_DRIVER_OPS,
199 .debugfs_init = mipi_dbi_debugfs_init,
206 static const struct of_device_id hx8357d_of_match[] = {
207 { .compatible = "adafruit,yx350hv15" },
210 MODULE_DEVICE_TABLE(of, hx8357d_of_match);
212 static const struct spi_device_id hx8357d_id[] = {
216 MODULE_DEVICE_TABLE(spi, hx8357d_id);
218 static int hx8357d_probe(struct spi_device *spi)
220 struct device *dev = &spi->dev;
221 struct mipi_dbi_dev *dbidev;
222 struct drm_device *drm;
223 struct gpio_desc *dc;
227 dbidev = devm_drm_dev_alloc(dev, &hx8357d_driver,
228 struct mipi_dbi_dev, drm);
230 return PTR_ERR(dbidev);
234 dc = devm_gpiod_get(dev, "dc", GPIOD_OUT_LOW);
236 return dev_err_probe(dev, PTR_ERR(dc), "Failed to get GPIO 'dc'\n");
238 dbidev->backlight = devm_of_find_backlight(dev);
239 if (IS_ERR(dbidev->backlight))
240 return PTR_ERR(dbidev->backlight);
242 device_property_read_u32(dev, "rotation", &rotation);
244 ret = mipi_dbi_spi_init(spi, &dbidev->dbi, dc);
248 ret = mipi_dbi_dev_init(dbidev, &hx8357d_pipe_funcs, &yx350hv15_mode, rotation);
252 drm_mode_config_reset(drm);
254 ret = drm_dev_register(drm, 0);
258 spi_set_drvdata(spi, drm);
260 drm_client_setup(drm, NULL);
265 static void hx8357d_remove(struct spi_device *spi)
267 struct drm_device *drm = spi_get_drvdata(spi);
270 drm_atomic_helper_shutdown(drm);
273 static void hx8357d_shutdown(struct spi_device *spi)
275 drm_atomic_helper_shutdown(spi_get_drvdata(spi));
278 static struct spi_driver hx8357d_spi_driver = {
281 .of_match_table = hx8357d_of_match,
283 .id_table = hx8357d_id,
284 .probe = hx8357d_probe,
285 .remove = hx8357d_remove,
286 .shutdown = hx8357d_shutdown,
288 module_spi_driver(hx8357d_spi_driver);
290 MODULE_DESCRIPTION("HX8357D DRM driver");
292 MODULE_LICENSE("GPL");