// SPDX-License-Identifier: GPL-2.0-or-later /* * lms501kf03 TFT LCD panel driver. * * Copyright (c) 2012 Samsung Electronics Co., Ltd. * Author: Jingoo Han */ #include #include #include #include #include #define COMMAND_ONLY 0x00 #define DATA_ONLY 0x01 struct lms501kf03 { struct device *dev; struct spi_device *spi; unsigned int power; struct lcd_device *ld; struct lcd_platform_data *lcd_pd; }; static const unsigned char seq_password[] = { 0xb9, 0xff, 0x83, 0x69, }; static const unsigned char seq_power[] = { 0xb1, 0x01, 0x00, 0x34, 0x06, 0x00, 0x14, 0x14, 0x20, 0x28, 0x12, 0x12, 0x17, 0x0a, 0x01, 0xe6, 0xe6, 0xe6, 0xe6, 0xe6, }; static const unsigned char seq_display[] = { 0xb2, 0x00, 0x2b, 0x03, 0x03, 0x70, 0x00, 0xff, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03, 0x00, 0x01, }; static const unsigned char seq_rgb_if[] = { 0xb3, 0x09, }; static const unsigned char seq_display_inv[] = { 0xb4, 0x01, 0x08, 0x77, 0x0e, 0x06, }; static const unsigned char seq_vcom[] = { 0xb6, 0x4c, 0x2e, }; static const unsigned char seq_gate[] = { 0xd5, 0x00, 0x05, 0x03, 0x29, 0x01, 0x07, 0x17, 0x68, 0x13, 0x37, 0x20, 0x31, 0x8a, 0x46, 0x9b, 0x57, 0x13, 0x02, 0x75, 0xb9, 0x64, 0xa8, 0x07, 0x0f, 0x04, 0x07, }; static const unsigned char seq_panel[] = { 0xcc, 0x02, }; static const unsigned char seq_col_mod[] = { 0x3a, 0x77, }; static const unsigned char seq_w_gamma[] = { 0xe0, 0x00, 0x04, 0x09, 0x0f, 0x1f, 0x3f, 0x1f, 0x2f, 0x0a, 0x0f, 0x10, 0x16, 0x18, 0x16, 0x17, 0x0d, 0x15, 0x00, 0x04, 0x09, 0x0f, 0x38, 0x3f, 0x20, 0x39, 0x0a, 0x0f, 0x10, 0x16, 0x18, 0x16, 0x17, 0x0d, 0x15, }; static const unsigned char seq_rgb_gamma[] = { 0xc1, 0x01, 0x03, 0x07, 0x0f, 0x1a, 0x22, 0x2c, 0x33, 0x3c, 0x46, 0x4f, 0x58, 0x60, 0x69, 0x71, 0x79, 0x82, 0x89, 0x92, 0x9a, 0xa1, 0xa9, 0xb1, 0xb9, 0xc1, 0xc9, 0xcf, 0xd6, 0xde, 0xe5, 0xec, 0xf3, 0xf9, 0xff, 0xdd, 0x39, 0x07, 0x1c, 0xcb, 0xab, 0x5f, 0x49, 0x80, 0x03, 0x07, 0x0f, 0x19, 0x20, 0x2a, 0x31, 0x39, 0x42, 0x4b, 0x53, 0x5b, 0x63, 0x6b, 0x73, 0x7b, 0x83, 0x8a, 0x92, 0x9b, 0xa2, 0xaa, 0xb2, 0xba, 0xc2, 0xca, 0xd0, 0xd8, 0xe1, 0xe8, 0xf0, 0xf8, 0xff, 0xf7, 0xd8, 0xbe, 0xa7, 0x39, 0x40, 0x85, 0x8c, 0xc0, 0x04, 0x07, 0x0c, 0x17, 0x1c, 0x23, 0x2b, 0x34, 0x3b, 0x43, 0x4c, 0x54, 0x5b, 0x63, 0x6a, 0x73, 0x7a, 0x82, 0x8a, 0x91, 0x98, 0xa1, 0xa8, 0xb0, 0xb7, 0xc1, 0xc9, 0xcf, 0xd9, 0xe3, 0xea, 0xf4, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, }; static const unsigned char seq_sleep_out[] = { 0x11, }; static const unsigned char seq_display_on[] = { 0x29, }; static const unsigned char seq_display_off[] = { 0x10, }; static int lms501kf03_spi_write_byte(struct lms501kf03 *lcd, int addr, int data) { u16 buf[1]; struct spi_message msg; struct spi_transfer xfer = { .len = 2, .tx_buf = buf, }; buf[0] = (addr << 8) | data; spi_message_init(&msg); spi_message_add_tail(&xfer, &msg); return spi_sync(lcd->spi, &msg); } static int lms501kf03_spi_write(struct lms501kf03 *lcd, unsigned char address, unsigned char command) { return lms501kf03_spi_write_byte(lcd, address, command); } static int lms501kf03_panel_send_sequence(struct lms501kf03 *lcd, const unsigned char *wbuf, unsigned int len) { int ret = 0, i = 0; while (i < len) { if (i == 0) ret = lms501kf03_spi_write(lcd, COMMAND_ONLY, wbuf[i]); else ret = lms501kf03_spi_write(lcd, DATA_ONLY, wbuf[i]); if (ret) break; i += 1; } return ret; } static int lms501kf03_ldi_init(struct lms501kf03 *lcd) { int ret, i; static const unsigned char *init_seq[] = { seq_password, seq_power, seq_display, seq_rgb_if, seq_display_inv, seq_vcom, seq_gate, seq_panel, seq_col_mod, seq_w_gamma, seq_rgb_gamma, seq_sleep_out, }; static const unsigned int size_seq[] = { ARRAY_SIZE(seq_password), ARRAY_SIZE(seq_power), ARRAY_SIZE(seq_display), ARRAY_SIZE(seq_rgb_if), ARRAY_SIZE(seq_display_inv), ARRAY_SIZE(seq_vcom), ARRAY_SIZE(seq_gate), ARRAY_SIZE(seq_panel), ARRAY_SIZE(seq_col_mod), ARRAY_SIZE(seq_w_gamma), ARRAY_SIZE(seq_rgb_gamma), ARRAY_SIZE(seq_sleep_out), }; for (i = 0; i < ARRAY_SIZE(init_seq); i++) { ret = lms501kf03_panel_send_sequence(lcd, init_seq[i], size_seq[i]); if (ret) break; } /* * According to the datasheet, 120ms delay time is required. * After sleep out sequence, command is blocked for 120ms. * Thus, LDI should wait for 120ms. */ msleep(120); return ret; } static int lms501kf03_ldi_enable(struct lms501kf03 *lcd) { return lms501kf03_panel_send_sequence(lcd, seq_display_on, ARRAY_SIZE(seq_display_on)); } static int lms501kf03_ldi_disable(struct lms501kf03 *lcd) { return lms501kf03_panel_send_sequence(lcd, seq_display_off, ARRAY_SIZE(seq_display_off)); } static int lms501kf03_power_is_on(int power) { return (power) <= LCD_POWER_REDUCED; } static int lms501kf03_power_on(struct lms501kf03 *lcd) { int ret = 0; struct lcd_platform_data *pd; pd = lcd->lcd_pd; if (!pd->power_on) { dev_err(lcd->dev, "power_on is NULL.\n"); return -EINVAL; } pd->power_on(lcd->ld, 1); msleep(pd->power_on_delay); if (!pd->reset) { dev_err(lcd->dev, "reset is NULL.\n"); return -EINVAL; } pd->reset(lcd->ld); msleep(pd->reset_delay); ret = lms501kf03_ldi_init(lcd); if (ret) { dev_err(lcd->dev, "failed to initialize ldi.\n"); return ret; } ret = lms501kf03_ldi_enable(lcd); if (ret) { dev_err(lcd->dev, "failed to enable ldi.\n"); return ret; } return 0; } static int lms501kf03_power_off(struct lms501kf03 *lcd) { int ret = 0; struct lcd_platform_data *pd; pd = lcd->lcd_pd; ret = lms501kf03_ldi_disable(lcd); if (ret) { dev_err(lcd->dev, "lcd setting failed.\n"); return -EIO; } msleep(pd->power_off_delay); pd->power_on(lcd->ld, 0); return 0; } static int lms501kf03_power(struct lms501kf03 *lcd, int power) { int ret = 0; if (lms501kf03_power_is_on(power) && !lms501kf03_power_is_on(lcd->power)) ret = lms501kf03_power_on(lcd); else if (!lms501kf03_power_is_on(power) && lms501kf03_power_is_on(lcd->power)) ret = lms501kf03_power_off(lcd); if (!ret) lcd->power = power; return ret; } static int lms501kf03_get_power(struct lcd_device *ld) { struct lms501kf03 *lcd = lcd_get_data(ld); return lcd->power; } static int lms501kf03_set_power(struct lcd_device *ld, int power) { struct lms501kf03 *lcd = lcd_get_data(ld); if (power != LCD_POWER_ON && power != LCD_POWER_OFF && power != LCD_POWER_REDUCED) { dev_err(lcd->dev, "power value should be 0, 1 or 4.\n"); return -EINVAL; } return lms501kf03_power(lcd, power); } static const struct lcd_ops lms501kf03_lcd_ops = { .get_power = lms501kf03_get_power, .set_power = lms501kf03_set_power, }; static int lms501kf03_probe(struct spi_device *spi) { struct lms501kf03 *lcd = NULL; struct lcd_device *ld = NULL; int ret = 0; lcd = devm_kzalloc(&spi->dev, sizeof(struct lms501kf03), GFP_KERNEL); if (!lcd) return -ENOMEM; /* lms501kf03 lcd panel uses 3-wire 9-bit SPI Mode. */ spi->bits_per_word = 9; ret = spi_setup(spi); if (ret < 0) { dev_err(&spi->dev, "spi setup failed.\n"); return ret; } lcd->spi = spi; lcd->dev = &spi->dev; lcd->lcd_pd = dev_get_platdata(&spi->dev); if (!lcd->lcd_pd) { dev_err(&spi->dev, "platform data is NULL\n"); return -EINVAL; } ld = devm_lcd_device_register(&spi->dev, "lms501kf03", &spi->dev, lcd, &lms501kf03_lcd_ops); if (IS_ERR(ld)) return PTR_ERR(ld); lcd->ld = ld; if (!lcd->lcd_pd->lcd_enabled) { /* * if lcd panel was off from bootloader then * current lcd status is powerdown and then * it enables lcd panel. */ lcd->power = LCD_POWER_OFF; lms501kf03_power(lcd, LCD_POWER_ON); } else { lcd->power = LCD_POWER_ON; } spi_set_drvdata(spi, lcd); dev_info(&spi->dev, "lms501kf03 panel driver has been probed.\n"); return 0; } static void lms501kf03_remove(struct spi_device *spi) { struct lms501kf03 *lcd = spi_get_drvdata(spi); lms501kf03_power(lcd, LCD_POWER_OFF); } #ifdef CONFIG_PM_SLEEP static int lms501kf03_suspend(struct device *dev) { struct lms501kf03 *lcd = dev_get_drvdata(dev); dev_dbg(dev, "lcd->power = %d\n", lcd->power); /* * when lcd panel is suspend, lcd panel becomes off * regardless of status. */ return lms501kf03_power(lcd, LCD_POWER_OFF); } static int lms501kf03_resume(struct device *dev) { struct lms501kf03 *lcd = dev_get_drvdata(dev); lcd->power = LCD_POWER_OFF; return lms501kf03_power(lcd, LCD_POWER_ON); } #endif static SIMPLE_DEV_PM_OPS(lms501kf03_pm_ops, lms501kf03_suspend, lms501kf03_resume); static void lms501kf03_shutdown(struct spi_device *spi) { struct lms501kf03 *lcd = spi_get_drvdata(spi); lms501kf03_power(lcd, LCD_POWER_OFF); } static struct spi_driver lms501kf03_driver = { .driver = { .name = "lms501kf03", .pm = &lms501kf03_pm_ops, }, .probe = lms501kf03_probe, .remove = lms501kf03_remove, .shutdown = lms501kf03_shutdown, }; module_spi_driver(lms501kf03_driver); MODULE_AUTHOR("Jingoo Han "); MODULE_DESCRIPTION("lms501kf03 LCD Driver"); MODULE_LICENSE("GPL");