1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Samsung S6D7AA0 MIPI-DSI TFT LCD controller drm_panel driver. 4 * 5 * Copyright (C) 2022 Artur Weber <aweber.kernel@gmail.com> 6 */ 7 8 #include <linux/backlight.h> 9 #include <linux/delay.h> 10 #include <linux/gpio/consumer.h> 11 #include <linux/module.h> 12 #include <linux/regulator/consumer.h> 13 #include <linux/of.h> 14 15 #include <video/mipi_display.h> 16 #include <drm/drm_mipi_dsi.h> 17 #include <drm/drm_modes.h> 18 #include <drm/drm_panel.h> 19 20 /* Manufacturer command set */ 21 #define MCS_BL_CTL 0xc3 22 #define MCS_OTP_RELOAD 0xd0 23 #define MCS_PASSWD1 0xf0 24 #define MCS_PASSWD2 0xf1 25 #define MCS_PASSWD3 0xfc 26 27 struct s6d7aa0 { 28 struct drm_panel panel; 29 struct mipi_dsi_device *dsi; 30 struct gpio_desc *reset_gpio; 31 struct regulator_bulk_data supplies[2]; 32 const struct s6d7aa0_panel_desc *desc; 33 }; 34 35 struct s6d7aa0_panel_desc { 36 unsigned int panel_type; 37 int (*init_func)(struct s6d7aa0 *ctx); 38 int (*off_func)(struct s6d7aa0 *ctx); 39 const struct drm_display_mode *drm_mode; 40 unsigned long mode_flags; 41 u32 bus_flags; 42 bool has_backlight; 43 bool use_passwd3; 44 }; 45 46 enum s6d7aa0_panels { 47 S6D7AA0_PANEL_LSL080AL02, 48 S6D7AA0_PANEL_LSL080AL03, 49 S6D7AA0_PANEL_LTL101AT01, 50 }; 51 52 static inline struct s6d7aa0 *panel_to_s6d7aa0(struct drm_panel *panel) 53 { 54 return container_of(panel, struct s6d7aa0, panel); 55 } 56 57 static void s6d7aa0_reset(struct s6d7aa0 *ctx) 58 { 59 gpiod_set_value_cansleep(ctx->reset_gpio, 1); 60 msleep(50); 61 gpiod_set_value_cansleep(ctx->reset_gpio, 0); 62 msleep(50); 63 } 64 65 static int s6d7aa0_lock(struct s6d7aa0 *ctx, bool lock) 66 { 67 struct mipi_dsi_device *dsi = ctx->dsi; 68 69 if (lock) { 70 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD1, 0xa5, 0xa5); 71 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD2, 0xa5, 0xa5); 72 if (ctx->desc->use_passwd3) 73 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD3, 0x5a, 0x5a); 74 } else { 75 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD1, 0x5a, 0x5a); 76 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD2, 0x5a, 0x5a); 77 if (ctx->desc->use_passwd3) 78 mipi_dsi_dcs_write_seq(dsi, MCS_PASSWD3, 0xa5, 0xa5); 79 } 80 81 return 0; 82 } 83 84 static int s6d7aa0_on(struct s6d7aa0 *ctx) 85 { 86 struct mipi_dsi_device *dsi = ctx->dsi; 87 struct device *dev = &dsi->dev; 88 int ret; 89 90 ret = ctx->desc->init_func(ctx); 91 if (ret < 0) { 92 dev_err(dev, "Failed to initialize panel: %d\n", ret); 93 gpiod_set_value_cansleep(ctx->reset_gpio, 1); 94 return ret; 95 } 96 97 ret = mipi_dsi_dcs_set_display_on(dsi); 98 if (ret < 0) { 99 dev_err(dev, "Failed to set display on: %d\n", ret); 100 return ret; 101 } 102 103 return 0; 104 } 105 106 static int s6d7aa0_off(struct s6d7aa0 *ctx) 107 { 108 struct mipi_dsi_device *dsi = ctx->dsi; 109 struct device *dev = &dsi->dev; 110 int ret; 111 112 ret = ctx->desc->off_func(ctx); 113 if (ret < 0) { 114 dev_err(dev, "Panel-specific off function failed: %d\n", ret); 115 return ret; 116 } 117 118 ret = mipi_dsi_dcs_set_display_off(dsi); 119 if (ret < 0) { 120 dev_err(dev, "Failed to set display off: %d\n", ret); 121 return ret; 122 } 123 msleep(64); 124 125 ret = mipi_dsi_dcs_enter_sleep_mode(dsi); 126 if (ret < 0) { 127 dev_err(dev, "Failed to enter sleep mode: %d\n", ret); 128 return ret; 129 } 130 msleep(120); 131 132 return 0; 133 } 134 135 static int s6d7aa0_prepare(struct drm_panel *panel) 136 { 137 struct s6d7aa0 *ctx = panel_to_s6d7aa0(panel); 138 struct device *dev = &ctx->dsi->dev; 139 int ret; 140 141 ret = regulator_bulk_enable(ARRAY_SIZE(ctx->supplies), ctx->supplies); 142 if (ret < 0) { 143 dev_err(dev, "Failed to enable regulators: %d\n", ret); 144 return ret; 145 } 146 147 s6d7aa0_reset(ctx); 148 149 ret = s6d7aa0_on(ctx); 150 if (ret < 0) { 151 dev_err(dev, "Failed to initialize panel: %d\n", ret); 152 gpiod_set_value_cansleep(ctx->reset_gpio, 1); 153 return ret; 154 } 155 156 return 0; 157 } 158 159 static int s6d7aa0_disable(struct drm_panel *panel) 160 { 161 struct s6d7aa0 *ctx = panel_to_s6d7aa0(panel); 162 struct device *dev = &ctx->dsi->dev; 163 int ret; 164 165 ret = s6d7aa0_off(ctx); 166 if (ret < 0) 167 dev_err(dev, "Failed to un-initialize panel: %d\n", ret); 168 169 return 0; 170 } 171 172 static int s6d7aa0_unprepare(struct drm_panel *panel) 173 { 174 struct s6d7aa0 *ctx = panel_to_s6d7aa0(panel); 175 176 gpiod_set_value_cansleep(ctx->reset_gpio, 1); 177 regulator_bulk_disable(ARRAY_SIZE(ctx->supplies), ctx->supplies); 178 179 return 0; 180 } 181 182 /* Backlight control code */ 183 184 static int s6d7aa0_bl_update_status(struct backlight_device *bl) 185 { 186 struct mipi_dsi_device *dsi = bl_get_data(bl); 187 u16 brightness = backlight_get_brightness(bl); 188 int ret; 189 190 ret = mipi_dsi_dcs_set_display_brightness(dsi, brightness); 191 if (ret < 0) 192 return ret; 193 194 return 0; 195 } 196 197 static int s6d7aa0_bl_get_brightness(struct backlight_device *bl) 198 { 199 struct mipi_dsi_device *dsi = bl_get_data(bl); 200 u16 brightness; 201 int ret; 202 203 ret = mipi_dsi_dcs_get_display_brightness(dsi, &brightness); 204 if (ret < 0) 205 return ret; 206 207 return brightness & 0xff; 208 } 209 210 static const struct backlight_ops s6d7aa0_bl_ops = { 211 .update_status = s6d7aa0_bl_update_status, 212 .get_brightness = s6d7aa0_bl_get_brightness, 213 }; 214 215 static struct backlight_device * 216 s6d7aa0_create_backlight(struct mipi_dsi_device *dsi) 217 { 218 struct device *dev = &dsi->dev; 219 const struct backlight_properties props = { 220 .type = BACKLIGHT_RAW, 221 .brightness = 255, 222 .max_brightness = 255, 223 }; 224 225 return devm_backlight_device_register(dev, dev_name(dev), dev, dsi, 226 &s6d7aa0_bl_ops, &props); 227 } 228 229 /* Initialization code and structures for LSL080AL02 panel */ 230 231 static int s6d7aa0_lsl080al02_init(struct s6d7aa0 *ctx) 232 { 233 struct mipi_dsi_device *dsi = ctx->dsi; 234 struct device *dev = &dsi->dev; 235 int ret; 236 237 usleep_range(20000, 25000); 238 239 ret = s6d7aa0_lock(ctx, false); 240 if (ret < 0) { 241 dev_err(dev, "Failed to unlock registers: %d\n", ret); 242 return ret; 243 } 244 245 mipi_dsi_dcs_write_seq(dsi, MCS_OTP_RELOAD, 0x00, 0x10); 246 usleep_range(1000, 1500); 247 248 /* SEQ_B6_PARAM_8_R01 */ 249 mipi_dsi_dcs_write_seq(dsi, 0xb6, 0x10); 250 251 /* BL_CTL_ON */ 252 mipi_dsi_dcs_write_seq(dsi, MCS_BL_CTL, 0x40, 0x00, 0x28); 253 254 usleep_range(5000, 6000); 255 256 mipi_dsi_dcs_write_seq(dsi, MIPI_DCS_SET_ADDRESS_MODE, 0x04); 257 258 ret = mipi_dsi_dcs_exit_sleep_mode(dsi); 259 if (ret < 0) { 260 dev_err(dev, "Failed to exit sleep mode: %d\n", ret); 261 return ret; 262 } 263 264 msleep(120); 265 mipi_dsi_dcs_write_seq(dsi, MIPI_DCS_SET_ADDRESS_MODE, 0x00); 266 267 ret = s6d7aa0_lock(ctx, true); 268 if (ret < 0) { 269 dev_err(dev, "Failed to lock registers: %d\n", ret); 270 return ret; 271 } 272 273 ret = mipi_dsi_dcs_set_display_on(dsi); 274 if (ret < 0) { 275 dev_err(dev, "Failed to set display on: %d\n", ret); 276 return ret; 277 } 278 279 return 0; 280 } 281 282 static int s6d7aa0_lsl080al02_off(struct s6d7aa0 *ctx) 283 { 284 struct mipi_dsi_device *dsi = ctx->dsi; 285 286 /* BL_CTL_OFF */ 287 mipi_dsi_dcs_write_seq(dsi, MCS_BL_CTL, 0x40, 0x00, 0x20); 288 289 return 0; 290 } 291 292 static const struct drm_display_mode s6d7aa0_lsl080al02_mode = { 293 .clock = (800 + 16 + 4 + 140) * (1280 + 8 + 4 + 4) * 60 / 1000, 294 .hdisplay = 800, 295 .hsync_start = 800 + 16, 296 .hsync_end = 800 + 16 + 4, 297 .htotal = 800 + 16 + 4 + 140, 298 .vdisplay = 1280, 299 .vsync_start = 1280 + 8, 300 .vsync_end = 1280 + 8 + 4, 301 .vtotal = 1280 + 8 + 4 + 4, 302 .width_mm = 108, 303 .height_mm = 173, 304 }; 305 306 static const struct s6d7aa0_panel_desc s6d7aa0_lsl080al02_desc = { 307 .panel_type = S6D7AA0_PANEL_LSL080AL02, 308 .init_func = s6d7aa0_lsl080al02_init, 309 .off_func = s6d7aa0_lsl080al02_off, 310 .drm_mode = &s6d7aa0_lsl080al02_mode, 311 .mode_flags = MIPI_DSI_MODE_VSYNC_FLUSH | MIPI_DSI_MODE_VIDEO_NO_HFP, 312 .bus_flags = 0, 313 314 .has_backlight = false, 315 .use_passwd3 = false, 316 }; 317 318 /* Initialization code and structures for LSL080AL03 panel */ 319 320 static int s6d7aa0_lsl080al03_init(struct s6d7aa0 *ctx) 321 { 322 struct mipi_dsi_device *dsi = ctx->dsi; 323 struct device *dev = &dsi->dev; 324 int ret; 325 326 usleep_range(20000, 25000); 327 328 ret = s6d7aa0_lock(ctx, false); 329 if (ret < 0) { 330 dev_err(dev, "Failed to unlock registers: %d\n", ret); 331 return ret; 332 } 333 334 if (ctx->desc->panel_type == S6D7AA0_PANEL_LSL080AL03) { 335 mipi_dsi_dcs_write_seq(dsi, MCS_BL_CTL, 0xc7, 0x00, 0x29); 336 mipi_dsi_dcs_write_seq(dsi, 0xbc, 0x01, 0x4e, 0xa0); 337 mipi_dsi_dcs_write_seq(dsi, 0xfd, 0x16, 0x10, 0x11, 0x23, 338 0x09); 339 mipi_dsi_dcs_write_seq(dsi, 0xfe, 0x00, 0x02, 0x03, 0x21, 340 0x80, 0x78); 341 } else if (ctx->desc->panel_type == S6D7AA0_PANEL_LTL101AT01) { 342 mipi_dsi_dcs_write_seq(dsi, MCS_BL_CTL, 0x40, 0x00, 0x08); 343 mipi_dsi_dcs_write_seq(dsi, 0xbc, 0x01, 0x4e, 0x0b); 344 mipi_dsi_dcs_write_seq(dsi, 0xfd, 0x16, 0x10, 0x11, 0x23, 345 0x09); 346 mipi_dsi_dcs_write_seq(dsi, 0xfe, 0x00, 0x02, 0x03, 0x21, 347 0x80, 0x68); 348 } 349 350 mipi_dsi_dcs_write_seq(dsi, 0xb3, 0x51); 351 mipi_dsi_dcs_write_seq(dsi, MIPI_DCS_WRITE_CONTROL_DISPLAY, 0x24); 352 mipi_dsi_dcs_write_seq(dsi, 0xf2, 0x02, 0x08, 0x08); 353 354 usleep_range(10000, 11000); 355 356 mipi_dsi_dcs_write_seq(dsi, 0xc0, 0x80, 0x80, 0x30); 357 mipi_dsi_dcs_write_seq(dsi, 0xcd, 358 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 359 0x2e, 0x2e, 0x2e, 0x2e, 0x2e); 360 mipi_dsi_dcs_write_seq(dsi, 0xce, 361 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 362 0x00, 0x00, 0x00, 0x00, 0x00); 363 mipi_dsi_dcs_write_seq(dsi, 0xc1, 0x03); 364 365 ret = mipi_dsi_dcs_exit_sleep_mode(dsi); 366 if (ret < 0) { 367 dev_err(dev, "Failed to exit sleep mode: %d\n", ret); 368 return ret; 369 } 370 371 ret = s6d7aa0_lock(ctx, true); 372 if (ret < 0) { 373 dev_err(dev, "Failed to lock registers: %d\n", ret); 374 return ret; 375 } 376 377 ret = mipi_dsi_dcs_set_display_on(dsi); 378 if (ret < 0) { 379 dev_err(dev, "Failed to set display on: %d\n", ret); 380 return ret; 381 } 382 383 return 0; 384 } 385 386 static int s6d7aa0_lsl080al03_off(struct s6d7aa0 *ctx) 387 { 388 struct mipi_dsi_device *dsi = ctx->dsi; 389 390 mipi_dsi_dcs_write_seq(dsi, 0x22, 0x00); 391 392 return 0; 393 } 394 395 static const struct drm_display_mode s6d7aa0_lsl080al03_mode = { 396 .clock = (768 + 18 + 16 + 126) * (1024 + 8 + 2 + 6) * 60 / 1000, 397 .hdisplay = 768, 398 .hsync_start = 768 + 18, 399 .hsync_end = 768 + 18 + 16, 400 .htotal = 768 + 18 + 16 + 126, 401 .vdisplay = 1024, 402 .vsync_start = 1024 + 8, 403 .vsync_end = 1024 + 8 + 2, 404 .vtotal = 1024 + 8 + 2 + 6, 405 .width_mm = 122, 406 .height_mm = 163, 407 }; 408 409 static const struct s6d7aa0_panel_desc s6d7aa0_lsl080al03_desc = { 410 .panel_type = S6D7AA0_PANEL_LSL080AL03, 411 .init_func = s6d7aa0_lsl080al03_init, 412 .off_func = s6d7aa0_lsl080al03_off, 413 .drm_mode = &s6d7aa0_lsl080al03_mode, 414 .mode_flags = MIPI_DSI_MODE_NO_EOT_PACKET, 415 .bus_flags = 0, 416 417 .has_backlight = true, 418 .use_passwd3 = true, 419 }; 420 421 /* Initialization structures for LTL101AT01 panel */ 422 423 static const struct drm_display_mode s6d7aa0_ltl101at01_mode = { 424 .clock = (768 + 96 + 16 + 184) * (1024 + 8 + 2 + 6) * 60 / 1000, 425 .hdisplay = 768, 426 .hsync_start = 768 + 96, 427 .hsync_end = 768 + 96 + 16, 428 .htotal = 768 + 96 + 16 + 184, 429 .vdisplay = 1024, 430 .vsync_start = 1024 + 8, 431 .vsync_end = 1024 + 8 + 2, 432 .vtotal = 1024 + 8 + 2 + 6, 433 .width_mm = 148, 434 .height_mm = 197, 435 }; 436 437 static const struct s6d7aa0_panel_desc s6d7aa0_ltl101at01_desc = { 438 .panel_type = S6D7AA0_PANEL_LTL101AT01, 439 .init_func = s6d7aa0_lsl080al03_init, /* Similar init to LSL080AL03 */ 440 .off_func = s6d7aa0_lsl080al03_off, 441 .drm_mode = &s6d7aa0_ltl101at01_mode, 442 .mode_flags = MIPI_DSI_MODE_NO_EOT_PACKET, 443 .bus_flags = 0, 444 445 .has_backlight = true, 446 .use_passwd3 = true, 447 }; 448 449 static int s6d7aa0_get_modes(struct drm_panel *panel, 450 struct drm_connector *connector) 451 { 452 struct drm_display_mode *mode; 453 struct s6d7aa0 *ctx; 454 455 ctx = container_of(panel, struct s6d7aa0, panel); 456 if (!ctx) 457 return -EINVAL; 458 459 mode = drm_mode_duplicate(connector->dev, ctx->desc->drm_mode); 460 if (!mode) 461 return -ENOMEM; 462 463 drm_mode_set_name(mode); 464 465 mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED; 466 connector->display_info.width_mm = mode->width_mm; 467 connector->display_info.height_mm = mode->height_mm; 468 connector->display_info.bus_flags = ctx->desc->bus_flags; 469 drm_mode_probed_add(connector, mode); 470 471 return 1; 472 } 473 474 static const struct drm_panel_funcs s6d7aa0_panel_funcs = { 475 .disable = s6d7aa0_disable, 476 .prepare = s6d7aa0_prepare, 477 .unprepare = s6d7aa0_unprepare, 478 .get_modes = s6d7aa0_get_modes, 479 }; 480 481 static int s6d7aa0_probe(struct mipi_dsi_device *dsi) 482 { 483 struct device *dev = &dsi->dev; 484 struct s6d7aa0 *ctx; 485 int ret; 486 487 ctx = devm_kzalloc(dev, sizeof(*ctx), GFP_KERNEL); 488 if (!ctx) 489 return -ENOMEM; 490 491 ctx->desc = of_device_get_match_data(dev); 492 if (!ctx->desc) 493 return -ENODEV; 494 495 ctx->supplies[0].supply = "power"; 496 ctx->supplies[1].supply = "vmipi"; 497 ret = devm_regulator_bulk_get(dev, ARRAY_SIZE(ctx->supplies), 498 ctx->supplies); 499 if (ret < 0) 500 return dev_err_probe(dev, ret, "Failed to get regulators\n"); 501 502 ctx->reset_gpio = devm_gpiod_get(dev, "reset", GPIOD_OUT_HIGH); 503 if (IS_ERR(ctx->reset_gpio)) 504 return dev_err_probe(dev, PTR_ERR(ctx->reset_gpio), 505 "Failed to get reset-gpios\n"); 506 507 ctx->dsi = dsi; 508 mipi_dsi_set_drvdata(dsi, ctx); 509 510 dsi->lanes = 4; 511 dsi->format = MIPI_DSI_FMT_RGB888; 512 dsi->mode_flags = MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST 513 | ctx->desc->mode_flags; 514 515 drm_panel_init(&ctx->panel, dev, &s6d7aa0_panel_funcs, 516 DRM_MODE_CONNECTOR_DSI); 517 ctx->panel.prepare_prev_first = true; 518 519 ret = drm_panel_of_backlight(&ctx->panel); 520 if (ret) 521 return dev_err_probe(dev, ret, "Failed to get backlight\n"); 522 523 /* Use DSI-based backlight as fallback if available */ 524 if (ctx->desc->has_backlight && !ctx->panel.backlight) { 525 ctx->panel.backlight = s6d7aa0_create_backlight(dsi); 526 if (IS_ERR(ctx->panel.backlight)) 527 return dev_err_probe(dev, PTR_ERR(ctx->panel.backlight), 528 "Failed to create backlight\n"); 529 } 530 531 drm_panel_add(&ctx->panel); 532 533 ret = mipi_dsi_attach(dsi); 534 if (ret < 0) { 535 dev_err(dev, "Failed to attach to DSI host: %d\n", ret); 536 drm_panel_remove(&ctx->panel); 537 return ret; 538 } 539 540 return 0; 541 } 542 543 static void s6d7aa0_remove(struct mipi_dsi_device *dsi) 544 { 545 struct s6d7aa0 *ctx = mipi_dsi_get_drvdata(dsi); 546 int ret; 547 548 ret = mipi_dsi_detach(dsi); 549 if (ret < 0) 550 dev_err(&dsi->dev, "Failed to detach from DSI host: %d\n", ret); 551 552 drm_panel_remove(&ctx->panel); 553 } 554 555 static const struct of_device_id s6d7aa0_of_match[] = { 556 { 557 .compatible = "samsung,lsl080al02", 558 .data = &s6d7aa0_lsl080al02_desc 559 }, 560 { 561 .compatible = "samsung,lsl080al03", 562 .data = &s6d7aa0_lsl080al03_desc 563 }, 564 { 565 .compatible = "samsung,ltl101at01", 566 .data = &s6d7aa0_ltl101at01_desc 567 }, 568 { /* sentinel */ } 569 }; 570 MODULE_DEVICE_TABLE(of, s6d7aa0_of_match); 571 572 static struct mipi_dsi_driver s6d7aa0_driver = { 573 .probe = s6d7aa0_probe, 574 .remove = s6d7aa0_remove, 575 .driver = { 576 .name = "panel-samsung-s6d7aa0", 577 .of_match_table = s6d7aa0_of_match, 578 }, 579 }; 580 module_mipi_dsi_driver(s6d7aa0_driver); 581 582 MODULE_AUTHOR("Artur Weber <aweber.kernel@gmail.com>"); 583 MODULE_DESCRIPTION("Samsung S6D7AA0 MIPI-DSI LCD controller driver"); 584 MODULE_LICENSE("GPL"); 585