1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * DRM driver for Sitronix ST7735R panels 4 * 5 * Copyright 2017 David Lechner <david@lechnology.com> 6 * Copyright (C) 2019 Glider bvba 7 */ 8 9 #include <linux/backlight.h> 10 #include <linux/delay.h> 11 #include <linux/dma-buf.h> 12 #include <linux/gpio/consumer.h> 13 #include <linux/module.h> 14 #include <linux/of_device.h> 15 #include <linux/property.h> 16 #include <linux/spi/spi.h> 17 #include <video/mipi_display.h> 18 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 26 #define ST7735R_FRMCTR1 0xb1 27 #define ST7735R_FRMCTR2 0xb2 28 #define ST7735R_FRMCTR3 0xb3 29 #define ST7735R_INVCTR 0xb4 30 #define ST7735R_PWCTR1 0xc0 31 #define ST7735R_PWCTR2 0xc1 32 #define ST7735R_PWCTR3 0xc2 33 #define ST7735R_PWCTR4 0xc3 34 #define ST7735R_PWCTR5 0xc4 35 #define ST7735R_VMCTR1 0xc5 36 #define ST7735R_GAMCTRP1 0xe0 37 #define ST7735R_GAMCTRN1 0xe1 38 39 #define ST7735R_MY BIT(7) 40 #define ST7735R_MX BIT(6) 41 #define ST7735R_MV BIT(5) 42 #define ST7735R_RGB BIT(3) 43 44 struct st7735r_cfg { 45 const struct drm_display_mode mode; 46 unsigned int left_offset; 47 unsigned int top_offset; 48 unsigned int write_only:1; 49 unsigned int rgb:1; /* RGB (vs. BGR) */ 50 }; 51 52 struct st7735r_priv { 53 struct mipi_dbi_dev dbidev; /* Must be first for .release() */ 54 const struct st7735r_cfg *cfg; 55 }; 56 57 static void st7735r_pipe_enable(struct drm_simple_display_pipe *pipe, 58 struct drm_crtc_state *crtc_state, 59 struct drm_plane_state *plane_state) 60 { 61 struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev); 62 struct st7735r_priv *priv = container_of(dbidev, struct st7735r_priv, 63 dbidev); 64 struct mipi_dbi *dbi = &dbidev->dbi; 65 int ret, idx; 66 u8 addr_mode; 67 68 if (!drm_dev_enter(pipe->crtc.dev, &idx)) 69 return; 70 71 DRM_DEBUG_KMS("\n"); 72 73 ret = mipi_dbi_poweron_reset(dbidev); 74 if (ret) 75 goto out_exit; 76 77 msleep(150); 78 79 mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE); 80 msleep(500); 81 82 mipi_dbi_command(dbi, ST7735R_FRMCTR1, 0x01, 0x2c, 0x2d); 83 mipi_dbi_command(dbi, ST7735R_FRMCTR2, 0x01, 0x2c, 0x2d); 84 mipi_dbi_command(dbi, ST7735R_FRMCTR3, 0x01, 0x2c, 0x2d, 0x01, 0x2c, 85 0x2d); 86 mipi_dbi_command(dbi, ST7735R_INVCTR, 0x07); 87 mipi_dbi_command(dbi, ST7735R_PWCTR1, 0xa2, 0x02, 0x84); 88 mipi_dbi_command(dbi, ST7735R_PWCTR2, 0xc5); 89 mipi_dbi_command(dbi, ST7735R_PWCTR3, 0x0a, 0x00); 90 mipi_dbi_command(dbi, ST7735R_PWCTR4, 0x8a, 0x2a); 91 mipi_dbi_command(dbi, ST7735R_PWCTR5, 0x8a, 0xee); 92 mipi_dbi_command(dbi, ST7735R_VMCTR1, 0x0e); 93 mipi_dbi_command(dbi, MIPI_DCS_EXIT_INVERT_MODE); 94 switch (dbidev->rotation) { 95 default: 96 addr_mode = ST7735R_MX | ST7735R_MY; 97 break; 98 case 90: 99 addr_mode = ST7735R_MX | ST7735R_MV; 100 break; 101 case 180: 102 addr_mode = 0; 103 break; 104 case 270: 105 addr_mode = ST7735R_MY | ST7735R_MV; 106 break; 107 } 108 109 if (priv->cfg->rgb) 110 addr_mode |= ST7735R_RGB; 111 112 mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode); 113 mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, 114 MIPI_DCS_PIXEL_FMT_16BIT); 115 mipi_dbi_command(dbi, ST7735R_GAMCTRP1, 0x02, 0x1c, 0x07, 0x12, 0x37, 116 0x32, 0x29, 0x2d, 0x29, 0x25, 0x2b, 0x39, 0x00, 0x01, 117 0x03, 0x10); 118 mipi_dbi_command(dbi, ST7735R_GAMCTRN1, 0x03, 0x1d, 0x07, 0x06, 0x2e, 119 0x2c, 0x29, 0x2d, 0x2e, 0x2e, 0x37, 0x3f, 0x00, 0x00, 120 0x02, 0x10); 121 mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON); 122 123 msleep(100); 124 125 mipi_dbi_command(dbi, MIPI_DCS_ENTER_NORMAL_MODE); 126 127 msleep(20); 128 129 mipi_dbi_enable_flush(dbidev, crtc_state, plane_state); 130 out_exit: 131 drm_dev_exit(idx); 132 } 133 134 static const struct drm_simple_display_pipe_funcs st7735r_pipe_funcs = { 135 .enable = st7735r_pipe_enable, 136 .disable = mipi_dbi_pipe_disable, 137 .update = mipi_dbi_pipe_update, 138 .prepare_fb = drm_gem_fb_simple_display_pipe_prepare_fb, 139 }; 140 141 static const struct st7735r_cfg jd_t18003_t01_cfg = { 142 .mode = { DRM_SIMPLE_MODE(128, 160, 28, 35) }, 143 /* Cannot read from Adafruit 1.8" display via SPI */ 144 .write_only = true, 145 }; 146 147 }; 148 149 DEFINE_DRM_GEM_CMA_FOPS(st7735r_fops); 150 151 static struct drm_driver st7735r_driver = { 152 .driver_features = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC, 153 .fops = &st7735r_fops, 154 .release = mipi_dbi_release, 155 DRM_GEM_CMA_VMAP_DRIVER_OPS, 156 .debugfs_init = mipi_dbi_debugfs_init, 157 .name = "st7735r", 158 .desc = "Sitronix ST7735R", 159 .date = "20171128", 160 .major = 1, 161 .minor = 0, 162 }; 163 164 static const struct of_device_id st7735r_of_match[] = { 165 { .compatible = "jianda,jd-t18003-t01", .data = &jd_t18003_t01_cfg }, 166 { }, 167 }; 168 MODULE_DEVICE_TABLE(of, st7735r_of_match); 169 170 static const struct spi_device_id st7735r_id[] = { 171 { "jd-t18003-t01", (uintptr_t)&jd_t18003_t01_cfg }, 172 { }, 173 }; 174 MODULE_DEVICE_TABLE(spi, st7735r_id); 175 176 static int st7735r_probe(struct spi_device *spi) 177 { 178 struct device *dev = &spi->dev; 179 const struct st7735r_cfg *cfg; 180 struct mipi_dbi_dev *dbidev; 181 struct st7735r_priv *priv; 182 struct drm_device *drm; 183 struct mipi_dbi *dbi; 184 struct gpio_desc *dc; 185 u32 rotation = 0; 186 int ret; 187 188 cfg = of_device_get_match_data(&spi->dev); 189 if (!cfg) 190 cfg = (void *)spi_get_device_id(spi)->driver_data; 191 192 priv = kzalloc(sizeof(*priv), GFP_KERNEL); 193 if (!priv) 194 return -ENOMEM; 195 196 dbidev = &priv->dbidev; 197 priv->cfg = cfg; 198 199 dbi = &dbidev->dbi; 200 drm = &dbidev->drm; 201 ret = devm_drm_dev_init(dev, drm, &st7735r_driver); 202 if (ret) { 203 kfree(dbidev); 204 return ret; 205 } 206 207 drm_mode_config_init(drm); 208 209 dbi->reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_HIGH); 210 if (IS_ERR(dbi->reset)) { 211 DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n"); 212 return PTR_ERR(dbi->reset); 213 } 214 215 dc = devm_gpiod_get(dev, "dc", GPIOD_OUT_LOW); 216 if (IS_ERR(dc)) { 217 DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n"); 218 return PTR_ERR(dc); 219 } 220 221 dbidev->backlight = devm_of_find_backlight(dev); 222 if (IS_ERR(dbidev->backlight)) 223 return PTR_ERR(dbidev->backlight); 224 225 device_property_read_u32(dev, "rotation", &rotation); 226 227 ret = mipi_dbi_spi_init(spi, dbi, dc); 228 if (ret) 229 return ret; 230 231 if (cfg->write_only) 232 dbi->read_commands = NULL; 233 234 dbidev->left_offset = cfg->left_offset; 235 dbidev->top_offset = cfg->top_offset; 236 237 ret = mipi_dbi_dev_init(dbidev, &st7735r_pipe_funcs, &cfg->mode, 238 rotation); 239 if (ret) 240 return ret; 241 242 drm_mode_config_reset(drm); 243 244 ret = drm_dev_register(drm, 0); 245 if (ret) 246 return ret; 247 248 spi_set_drvdata(spi, drm); 249 250 drm_fbdev_generic_setup(drm, 0); 251 252 return 0; 253 } 254 255 static int st7735r_remove(struct spi_device *spi) 256 { 257 struct drm_device *drm = spi_get_drvdata(spi); 258 259 drm_dev_unplug(drm); 260 drm_atomic_helper_shutdown(drm); 261 262 return 0; 263 } 264 265 static void st7735r_shutdown(struct spi_device *spi) 266 { 267 drm_atomic_helper_shutdown(spi_get_drvdata(spi)); 268 } 269 270 static struct spi_driver st7735r_spi_driver = { 271 .driver = { 272 .name = "st7735r", 273 .owner = THIS_MODULE, 274 .of_match_table = st7735r_of_match, 275 }, 276 .id_table = st7735r_id, 277 .probe = st7735r_probe, 278 .remove = st7735r_remove, 279 .shutdown = st7735r_shutdown, 280 }; 281 module_spi_driver(st7735r_spi_driver); 282 283 MODULE_DESCRIPTION("Sitronix ST7735R DRM driver"); 284 MODULE_AUTHOR("David Lechner <david@lechnology.com>"); 285 MODULE_LICENSE("GPL"); 286