kernel/drivers/video/backlight/ili922x.c

   1 /*
   2  * (C) Copyright 2008
   3  * Stefano Babic, DENX Software Engineering, sbabic@denx.de.
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License as
   7  * published by the Free Software Foundation; either version 2 of
   8  * the License, or (at your option) any later version.
   9  *
  10  * This driver implements a lcd device for the ILITEK 922x display
  11  * controller. The interface to the display is SPI and the display's
  12  * memory is cyclically updated over the RGB interface.
  13  */
  14
  15 #include <linux/fb.h>
  16 #include <linux/delay.h>
  17 #include <linux/errno.h>
  18 #include <linux/init.h>
  19 #include <linux/kernel.h>
  20 #include <linux/lcd.h>
  21 #include <linux/module.h>
  22 #include <linux/of.h>
  23 #include <linux/slab.h>
  24 #include <linux/spi/spi.h>
  25 #include <linux/string.h>
  26
  27 /* Register offset, see manual section 8.2 */
  28 #define REG_START_OSCILLATION                   0x00
  29 #define REG_DRIVER_CODE_READ                    0x00
  30 #define REG_DRIVER_OUTPUT_CONTROL               0x01
  31 #define REG_LCD_AC_DRIVEING_CONTROL             0x02
  32 #define REG_ENTRY_MODE                          0x03
  33 #define REG_COMPARE_1                           0x04
  34 #define REG_COMPARE_2                           0x05
  35 #define REG_DISPLAY_CONTROL_1                   0x07
  36 #define REG_DISPLAY_CONTROL_2                   0x08
  37 #define REG_DISPLAY_CONTROL_3                   0x09
  38 #define REG_FRAME_CYCLE_CONTROL                 0x0B
  39 #define REG_EXT_INTF_CONTROL                    0x0C
  40 #define REG_POWER_CONTROL_1                     0x10
  41 #define REG_POWER_CONTROL_2                     0x11
  42 #define REG_POWER_CONTROL_3                     0x12
  43 #define REG_POWER_CONTROL_4                     0x13
  44 #define REG_RAM_ADDRESS_SET                     0x21
  45 #define REG_WRITE_DATA_TO_GRAM                  0x22
  46 #define REG_RAM_WRITE_MASK1                     0x23
  47 #define REG_RAM_WRITE_MASK2                     0x24
  48 #define REG_GAMMA_CONTROL_1                     0x30
  49 #define REG_GAMMA_CONTROL_2                     0x31
  50 #define REG_GAMMA_CONTROL_3                     0x32
  51 #define REG_GAMMA_CONTROL_4                     0x33
  52 #define REG_GAMMA_CONTROL_5                     0x34
  53 #define REG_GAMMA_CONTROL_6                     0x35
  54 #define REG_GAMMA_CONTROL_7                     0x36
  55 #define REG_GAMMA_CONTROL_8                     0x37
  56 #define REG_GAMMA_CONTROL_9                     0x38
  57 #define REG_GAMMA_CONTROL_10                    0x39
  58 #define REG_GATE_SCAN_CONTROL                   0x40
  59 #define REG_VERT_SCROLL_CONTROL                 0x41
  60 #define REG_FIRST_SCREEN_DRIVE_POS              0x42
  61 #define REG_SECOND_SCREEN_DRIVE_POS             0x43
  62 #define REG_RAM_ADDR_POS_H                      0x44
  63 #define REG_RAM_ADDR_POS_V                      0x45
  64 #define REG_OSCILLATOR_CONTROL                  0x4F
  65 #define REG_GPIO                                0x60
  66 #define REG_OTP_VCM_PROGRAMMING                 0x61
  67 #define REG_OTP_VCM_STATUS_ENABLE               0x62
  68 #define REG_OTP_PROGRAMMING_ID_KEY              0x65
  69
  70 /*
  71  * maximum frequency for register access
  72  * (not for the GRAM access)
  73  */
  74 #define ILITEK_MAX_FREQ_REG     4000000
  75
  76 /*
  77  * Device ID as found in the datasheet (supports 9221 and 9222)
  78  */
  79 #define ILITEK_DEVICE_ID        0x9220
  80 #define ILITEK_DEVICE_ID_MASK   0xFFF0
  81
  82 /* Last two bits in the START BYTE */
  83 #define START_RS_INDEX          0
  84 #define START_RS_REG            1
  85 #define START_RW_WRITE          0
  86 #define START_RW_READ           1
  87
  88 /**
  89  * START_BYTE(id, rs, rw)
  90  *
  91  * Set the start byte according to the required operation.
  92  * The start byte is defined as:
  93  *   ----------------------------------
  94  *  | 0 | 1 | 1 | 1 | 0 | ID | RS | RW |
  95  *   ----------------------------------
  96  * @id: display's id as set by the manufacturer
  97  * @rs: operation type bit, one of:
  98  *        - START_RS_INDEX      set the index register
  99  *        - START_RS_REG        write/read registers/GRAM
 100  * @rw: read/write operation
 101  *       - START_RW_WRITE       write
 102  *       - START_RW_READ        read
 103  */
 104 #define START_BYTE(id, rs, rw)  \
 105         (0x70 | (((id) & 0x01) << 2) | (((rs) & 0x01) << 1) | ((rw) & 0x01))
 106
 107 /**
 108  * CHECK_FREQ_REG(spi_device s, spi_transfer x) - Check the frequency
 109  *      for the SPI transfer. According to the datasheet, the controller
 110  *      accept higher frequency for the GRAM transfer, but it requires
 111  *      lower frequency when the registers are read/written.
 112  *      The macro sets the frequency in the spi_transfer structure if
 113  *      the frequency exceeds the maximum value.
 114  */
 115 #define CHECK_FREQ_REG(s, x)    \
 116         do {                    \
 117                 if (s->max_speed_hz > ILITEK_MAX_FREQ_REG)      \
 118                         ((struct spi_transfer *)x)->speed_hz =  \
 119                                         ILITEK_MAX_FREQ_REG;    \
 120         } while (0)
 121
 122 #define CMD_BUFSIZE             16
 123
 124 #define POWER_IS_ON(pwr)        ((pwr) <= FB_BLANK_NORMAL)
 125
 126 #define set_tx_byte(b)          (tx_invert ? ~(b) : b)
 127
 128 /**
 129  * ili922x_id - id as set by manufacturer
 130  */
 131 static int ili922x_id = 1;
 132 module_param(ili922x_id, int, 0);
 133
 134 static int tx_invert;
 135 module_param(tx_invert, int, 0);
 136
 137 /**
 138  * driver's private structure
 139  */
 140 struct ili922x {
 141         struct spi_device *spi;
 142         struct lcd_device *ld;
 143         int power;
 144 };
 145
 146 /**
 147  * ili922x_read_status - read status register from display
 148  * @spi: spi device
 149  * @rs:  output value
 150  */
 151 static int ili922x_read_status(struct spi_device *spi, u16 *rs)
 152 {
 153         struct spi_message msg;
 154         struct spi_transfer xfer;
 155         unsigned char tbuf[CMD_BUFSIZE];
 156         unsigned char rbuf[CMD_BUFSIZE];
 157         int ret, i;
 158
 159         memset(&xfer, 0, sizeof(struct spi_transfer));
 160         spi_message_init(&msg);
 161         xfer.tx_buf = tbuf;
 162         xfer.rx_buf = rbuf;
 163         xfer.cs_change = 1;
 164         CHECK_FREQ_REG(spi, &xfer);
 165
 166         tbuf[0] = set_tx_byte(START_BYTE(ili922x_id, START_RS_INDEX,
 167                                          START_RW_READ));
 168         /*
 169          * we need 4-byte xfer here due to invalid dummy byte
 170          * received after start byte
 171          */
 172         for (i = 1; i < 4; i++)
 173                 tbuf[i] = set_tx_byte(0);       /* dummy */
 174
 175         xfer.bits_per_word = 8;
 176         xfer.len = 4;
 177         spi_message_add_tail(&xfer, &msg);
 178         ret = spi_sync(spi, &msg);
 179         if (ret < 0) {
 180                 dev_dbg(&spi->dev, "Error sending SPI message 0x%x", ret);
 181                 return ret;
 182         }
 183
 184         *rs = (rbuf[2] << 8) + rbuf[3];
 185         return 0;
 186 }
 187
 188 /**
 189  * ili922x_read - read register from display
 190  * @spi: spi device
 191  * @reg: offset of the register to be read
 192  * @rx:  output value
 193  */
 194 static int ili922x_read(struct spi_device *spi, u8 reg, u16 *rx)
 195 {
 196         struct spi_message msg;
 197         struct spi_transfer xfer_regindex, xfer_regvalue;
 198         unsigned char tbuf[CMD_BUFSIZE];
 199         unsigned char rbuf[CMD_BUFSIZE];
 200         int ret, len = 0, send_bytes;
 201
 202         memset(&xfer_regindex, 0, sizeof(struct spi_transfer));
 203         memset(&xfer_regvalue, 0, sizeof(struct spi_transfer));
 204         spi_message_init(&msg);
 205         xfer_regindex.tx_buf = tbuf;
 206         xfer_regindex.rx_buf = rbuf;
 207         xfer_regindex.cs_change = 1;
 208         CHECK_FREQ_REG(spi, &xfer_regindex);
 209
 210         tbuf[0] = set_tx_byte(START_BYTE(ili922x_id, START_RS_INDEX,
 211                                          START_RW_WRITE));
 212         tbuf[1] = set_tx_byte(0);
 213         tbuf[2] = set_tx_byte(reg);
 214         xfer_regindex.bits_per_word = 8;
 215         len = xfer_regindex.len = 3;
 216         spi_message_add_tail(&xfer_regindex, &msg);
 217
 218         send_bytes = len;
 219
 220         tbuf[len++] = set_tx_byte(START_BYTE(ili922x_id, START_RS_REG,
 221                                              START_RW_READ));
 222         tbuf[len++] = set_tx_byte(0);
 223         tbuf[len] = set_tx_byte(0);
 224
 225         xfer_regvalue.cs_change = 1;
 226         xfer_regvalue.len = 3;
 227         xfer_regvalue.tx_buf = &tbuf[send_bytes];
 228         xfer_regvalue.rx_buf = &rbuf[send_bytes];
 229         CHECK_FREQ_REG(spi, &xfer_regvalue);
 230
 231         spi_message_add_tail(&xfer_regvalue, &msg);
 232         ret = spi_sync(spi, &msg);
 233         if (ret < 0) {
 234                 dev_dbg(&spi->dev, "Error sending SPI message 0x%x", ret);
 235                 return ret;
 236         }
 237
 238         *rx = (rbuf[1 + send_bytes] << 8) + rbuf[2 + send_bytes];
 239         return 0;
 240 }
 241
 242 /**
 243  * ili922x_write - write a controller register
 244  * @spi: struct spi_device *
 245  * @reg: offset of the register to be written
 246  * @value: value to be written
 247  */
 248 static int ili922x_write(struct spi_device *spi, u8 reg, u16 value)
 249 {
 250         struct spi_message msg;
 251         struct spi_transfer xfer_regindex, xfer_regvalue;
 252         unsigned char tbuf[CMD_BUFSIZE];
 253         unsigned char rbuf[CMD_BUFSIZE];
 254         int ret, len = 0;
 255
 256         memset(&xfer_regindex, 0, sizeof(struct spi_transfer));
 257         memset(&xfer_regvalue, 0, sizeof(struct spi_transfer));
 258
 259         spi_message_init(&msg);
 260         xfer_regindex.tx_buf = tbuf;
 261         xfer_regindex.rx_buf = rbuf;
 262         xfer_regindex.cs_change = 1;
 263         CHECK_FREQ_REG(spi, &xfer_regindex);
 264
 265         tbuf[0] = set_tx_byte(START_BYTE(ili922x_id, START_RS_INDEX,
 266                                          START_RW_WRITE));
 267         tbuf[1] = set_tx_byte(0);
 268         tbuf[2] = set_tx_byte(reg);
 269         xfer_regindex.bits_per_word = 8;
 270         xfer_regindex.len = 3;
 271         spi_message_add_tail(&xfer_regindex, &msg);
 272
 273         ret = spi_sync(spi, &msg);
 274
 275         spi_message_init(&msg);
 276         len = 0;
 277         tbuf[0] = set_tx_byte(START_BYTE(ili922x_id, START_RS_REG,
 278                                          START_RW_WRITE));
 279         tbuf[1] = set_tx_byte((value & 0xFF00) >> 8);
 280         tbuf[2] = set_tx_byte(value & 0x00FF);
 281
 282         xfer_regvalue.cs_change = 1;
 283         xfer_regvalue.len = 3;
 284         xfer_regvalue.tx_buf = tbuf;
 285         xfer_regvalue.rx_buf = rbuf;
 286         CHECK_FREQ_REG(spi, &xfer_regvalue);
 287
 288         spi_message_add_tail(&xfer_regvalue, &msg);
 289
 290         ret = spi_sync(spi, &msg);
 291         if (ret < 0) {
 292                 dev_err(&spi->dev, "Error sending SPI message 0x%x", ret);
 293                 return ret;
 294         }
 295         return 0;
 296 }
 297
 298 #ifdef DEBUG
 299 /**
 300  * ili922x_reg_dump - dump all registers
 301  */
 302 static void ili922x_reg_dump(struct spi_device *spi)
 303 {
 304         u8 reg;
 305         u16 rx;
 306
 307         dev_dbg(&spi->dev, "ILI922x configuration registers:\n");
 308         for (reg = REG_START_OSCILLATION;
 309              reg <= REG_OTP_PROGRAMMING_ID_KEY; reg++) {
 310                 ili922x_read(spi, reg, &rx);
 311                 dev_dbg(&spi->dev, "reg @ 0x%02X: 0x%04X\n", reg, rx);
 312         }
 313 }
 314 #else
 315 static inline void ili922x_reg_dump(struct spi_device *spi) {}
 316 #endif
 317
 318 /**
 319  * set_write_to_gram_reg - initialize the display to write the GRAM
 320  * @spi: spi device
 321  */
 322 static void set_write_to_gram_reg(struct spi_device *spi)
 323 {
 324         struct spi_message msg;
 325         struct spi_transfer xfer;
 326         unsigned char tbuf[CMD_BUFSIZE];
 327
 328         memset(&xfer, 0, sizeof(struct spi_transfer));
 329
 330         spi_message_init(&msg);
 331         xfer.tx_buf = tbuf;
 332         xfer.rx_buf = NULL;
 333         xfer.cs_change = 1;
 334
 335         tbuf[0] = START_BYTE(ili922x_id, START_RS_INDEX, START_RW_WRITE);
 336         tbuf[1] = 0;
 337         tbuf[2] = REG_WRITE_DATA_TO_GRAM;
 338
 339         xfer.bits_per_word = 8;
 340         xfer.len = 3;
 341         spi_message_add_tail(&xfer, &msg);
 342         spi_sync(spi, &msg);
 343 }
 344
 345 /**
 346  * ili922x_poweron - turn the display on
 347  * @spi: spi device
 348  *
 349  * The sequence to turn on the display is taken from
 350  * the datasheet and/or the example code provided by the
 351  * manufacturer.
 352  */
 353 static int ili922x_poweron(struct spi_device *spi)
 354 {
 355         int ret;
 356
 357         /* Power on */
 358         ret = ili922x_write(spi, REG_POWER_CONTROL_1, 0x0000);
 359         usleep_range(10000, 10500);
 360         ret += ili922x_write(spi, REG_POWER_CONTROL_2, 0x0000);
 361         ret += ili922x_write(spi, REG_POWER_CONTROL_3, 0x0000);
 362         msleep(40);
 363         ret += ili922x_write(spi, REG_POWER_CONTROL_4, 0x0000);
 364         msleep(40);
 365         /* register 0x56 is not documented in the datasheet */
 366         ret += ili922x_write(spi, 0x56, 0x080F);
 367         ret += ili922x_write(spi, REG_POWER_CONTROL_1, 0x4240);
 368         usleep_range(10000, 10500);
 369         ret += ili922x_write(spi, REG_POWER_CONTROL_2, 0x0000);
 370         ret += ili922x_write(spi, REG_POWER_CONTROL_3, 0x0014);
 371         msleep(40);
 372         ret += ili922x_write(spi, REG_POWER_CONTROL_4, 0x1319);
 373         msleep(40);
 374
 375         return ret;
 376 }
 377
 378 /**
 379  * ili922x_poweroff - turn the display off
 380  * @spi: spi device
 381  */
 382 static int ili922x_poweroff(struct spi_device *spi)
 383 {
 384         int ret;
 385
 386         /* Power off */
 387         ret = ili922x_write(spi, REG_POWER_CONTROL_1, 0x0000);
 388         usleep_range(10000, 10500);
 389         ret += ili922x_write(spi, REG_POWER_CONTROL_2, 0x0000);
 390         ret += ili922x_write(spi, REG_POWER_CONTROL_3, 0x0000);
 391         msleep(40);
 392         ret += ili922x_write(spi, REG_POWER_CONTROL_4, 0x0000);
 393         msleep(40);
 394
 395         return ret;
 396 }
 397
 398 /**
 399  * ili922x_display_init - initialize the display by setting
 400  *                        the configuration registers
 401  * @spi: spi device
 402  */
 403 static void ili922x_display_init(struct spi_device *spi)
 404 {
 405         ili922x_write(spi, REG_START_OSCILLATION, 1);
 406         usleep_range(10000, 10500);
 407         ili922x_write(spi, REG_DRIVER_OUTPUT_CONTROL, 0x691B);
 408         ili922x_write(spi, REG_LCD_AC_DRIVEING_CONTROL, 0x0700);
 409         ili922x_write(spi, REG_ENTRY_MODE, 0x1030);
 410         ili922x_write(spi, REG_COMPARE_1, 0x0000);
 411         ili922x_write(spi, REG_COMPARE_2, 0x0000);
 412         ili922x_write(spi, REG_DISPLAY_CONTROL_1, 0x0037);
 413         ili922x_write(spi, REG_DISPLAY_CONTROL_2, 0x0202);
 414         ili922x_write(spi, REG_DISPLAY_CONTROL_3, 0x0000);
 415         ili922x_write(spi, REG_FRAME_CYCLE_CONTROL, 0x0000);
 416
 417         /* Set RGB interface */
 418         ili922x_write(spi, REG_EXT_INTF_CONTROL, 0x0110);
 419
 420         ili922x_poweron(spi);
 421
 422         ili922x_write(spi, REG_GAMMA_CONTROL_1, 0x0302);
 423         ili922x_write(spi, REG_GAMMA_CONTROL_2, 0x0407);
 424         ili922x_write(spi, REG_GAMMA_CONTROL_3, 0x0304);
 425         ili922x_write(spi, REG_GAMMA_CONTROL_4, 0x0203);
 426         ili922x_write(spi, REG_GAMMA_CONTROL_5, 0x0706);
 427         ili922x_write(spi, REG_GAMMA_CONTROL_6, 0x0407);
 428         ili922x_write(spi, REG_GAMMA_CONTROL_7, 0x0706);
 429         ili922x_write(spi, REG_GAMMA_CONTROL_8, 0x0000);
 430         ili922x_write(spi, REG_GAMMA_CONTROL_9, 0x0C06);
 431         ili922x_write(spi, REG_GAMMA_CONTROL_10, 0x0F00);
 432         ili922x_write(spi, REG_RAM_ADDRESS_SET, 0x0000);
 433         ili922x_write(spi, REG_GATE_SCAN_CONTROL, 0x0000);
 434         ili922x_write(spi, REG_VERT_SCROLL_CONTROL, 0x0000);
 435         ili922x_write(spi, REG_FIRST_SCREEN_DRIVE_POS, 0xDB00);
 436         ili922x_write(spi, REG_SECOND_SCREEN_DRIVE_POS, 0xDB00);
 437         ili922x_write(spi, REG_RAM_ADDR_POS_H, 0xAF00);
 438         ili922x_write(spi, REG_RAM_ADDR_POS_V, 0xDB00);
 439         ili922x_reg_dump(spi);
 440         set_write_to_gram_reg(spi);
 441 }
 442
 443 static int ili922x_lcd_power(struct ili922x *lcd, int power)
 444 {
 445         int ret = 0;
 446
 447         if (POWER_IS_ON(power) && !POWER_IS_ON(lcd->power))
 448                 ret = ili922x_poweron(lcd->spi);
 449         else if (!POWER_IS_ON(power) && POWER_IS_ON(lcd->power))
 450                 ret = ili922x_poweroff(lcd->spi);
 451
 452         if (!ret)
 453                 lcd->power = power;
 454
 455         return ret;
 456 }
 457
 458 static int ili922x_set_power(struct lcd_device *ld, int power)
 459 {
 460         struct ili922x *ili = lcd_get_data(ld);
 461
 462         return ili922x_lcd_power(ili, power);
 463 }
 464
 465 static int ili922x_get_power(struct lcd_device *ld)
 466 {
 467         struct ili922x *ili = lcd_get_data(ld);
 468
 469         return ili->power;
 470 }
 471
 472 static struct lcd_ops ili922x_ops = {
 473         .get_power = ili922x_get_power,
 474         .set_power = ili922x_set_power,
 475 };
 476
 477 static int ili922x_probe(struct spi_device *spi)
 478 {
 479         struct ili922x *ili;
 480         struct lcd_device *lcd;
 481         int ret;
 482         u16 reg = 0;
 483
 484         ili = devm_kzalloc(&spi->dev, sizeof(*ili), GFP_KERNEL);
 485         if (!ili)
 486                 return -ENOMEM;
 487
 488         ili->spi = spi;
 489         spi_set_drvdata(spi, ili);
 490
 491         /* check if the device is connected */
 492         ret = ili922x_read(spi, REG_DRIVER_CODE_READ, &reg);
 493         if (ret || ((reg & ILITEK_DEVICE_ID_MASK) != ILITEK_DEVICE_ID)) {
 494                 dev_err(&spi->dev,
 495                         "no LCD found: Chip ID 0x%x, ret %d\n",
 496                         reg, ret);
 497                 return -ENODEV;
 498         }
 499
 500         dev_info(&spi->dev, "ILI%x found, SPI freq %d, mode %d\n",
 501                  reg, spi->max_speed_hz, spi->mode);
 502
 503         ret = ili922x_read_status(spi, &reg);
 504         if (ret) {
 505                 dev_err(&spi->dev, "reading RS failed...\n");
 506                 return ret;
 507         }
 508
 509         dev_dbg(&spi->dev, "status: 0x%x\n", reg);
 510
 511         ili922x_display_init(spi);
 512
 513         ili->power = FB_BLANK_POWERDOWN;
 514
 515         lcd = devm_lcd_device_register(&spi->dev, "ili922xlcd", &spi->dev, ili,
 516                                         &ili922x_ops);
 517         if (IS_ERR(lcd)) {
 518                 dev_err(&spi->dev, "cannot register LCD\n");
 519                 return PTR_ERR(lcd);
 520         }
 521
 522         ili->ld = lcd;
 523         spi_set_drvdata(spi, ili);
 524
 525         ili922x_lcd_power(ili, FB_BLANK_UNBLANK);
 526
 527         return 0;
 528 }
 529
 530 static int ili922x_remove(struct spi_device *spi)
 531 {
 532         ili922x_poweroff(spi);
 533         return 0;
 534 }
 535
 536 static struct spi_driver ili922x_driver = {
 537         .driver = {
 538                 .name = "ili922x",
 539                 .owner = THIS_MODULE,
 540         },
 541         .probe = ili922x_probe,
 542         .remove = ili922x_remove,
 543 };
 544
 545 module_spi_driver(ili922x_driver);
 546
 547 MODULE_AUTHOR("Stefano Babic <sbabic@denx.de>");
 548 MODULE_DESCRIPTION("ILI9221/9222 LCD driver");
 549 MODULE_LICENSE("GPL");
 550 MODULE_PARM_DESC(ili922x_id, "set controller identifier (default=1)");
 551 MODULE_PARM_DESC(tx_invert, "invert bytes before sending");