1 // SPDX-License-Identifier: GPL-2.0-only
3 * Novatek NT35510 panel driver
4 * Copyright (C) 2020 Linus Walleij <linus.walleij@linaro.org>
5 * Based on code by Robert Teather (C) 2012 Samsung
7 * This display driver (and I refer to the physical component NT35510,
8 * not this Linux kernel software driver) can handle:
9 * 480x864, 480x854, 480x800, 480x720 and 480x640 pixel displays.
10 * It has 480x840x24bit SRAM embedded for storing a frame.
11 * When powered on the display is by default in 480x800 mode.
13 * The actual panels using this component have different names, but
14 * the code needed to set up and configure the panel will be similar,
15 * so they should all use the NT35510 driver with appropriate configuration
16 * per-panel, e.g. for physical size.
18 * This driver is for the DSI interface to panels using the NT35510.
20 * The NT35510 can also use an RGB (DPI) interface combined with an
21 * I2C or SPI interface for setting up the NT35510. If this is needed
22 * this panel driver should be refactored to also support that use
25 #include <linux/backlight.h>
26 #include <linux/bitops.h>
27 #include <linux/gpio/consumer.h>
28 #include <linux/module.h>
29 #include <linux/of_device.h>
30 #include <linux/regmap.h>
31 #include <linux/regulator/consumer.h>
33 #include <video/mipi_display.h>
35 #include <drm/drm_mipi_dsi.h>
36 #include <drm/drm_modes.h>
37 #include <drm/drm_panel.h>
39 #define MCS_CMD_MAUCCTR 0xF0 /* Manufacturer command enable */
40 #define MCS_CMD_READ_ID1 0xDA
41 #define MCS_CMD_READ_ID2 0xDB
42 #define MCS_CMD_READ_ID3 0xDC
43 #define MCS_CMD_MTP_READ_SETTING 0xF8 /* Uncertain about name */
44 #define MCS_CMD_MTP_READ_PARAM 0xFF /* Uncertain about name */
47 * These manufacturer commands are available after we enable manufacturer
48 * command set (MCS) for page 0.
50 #define NT35510_P0_DOPCTR 0xB1
51 #define NT35510_P0_SDHDTCTR 0xB6
52 #define NT35510_P0_GSEQCTR 0xB7
53 #define NT35510_P0_SDEQCTR 0xB8
54 #define NT35510_P0_SDVPCTR 0xBA
55 #define NT35510_P0_DPFRCTR1 0xBD
56 #define NT35510_P0_DPFRCTR2 0xBE
57 #define NT35510_P0_DPFRCTR3 0xBF
58 #define NT35510_P0_DPMCTR12 0xCC
60 #define NT35510_P0_DOPCTR_LEN 2
61 #define NT35510_P0_GSEQCTR_LEN 2
62 #define NT35510_P0_SDEQCTR_LEN 4
63 #define NT35510_P0_SDVPCTR_LEN 1
64 #define NT35510_P0_DPFRCTR1_LEN 5
65 #define NT35510_P0_DPFRCTR2_LEN 5
66 #define NT35510_P0_DPFRCTR3_LEN 5
67 #define NT35510_P0_DPMCTR12_LEN 3
69 #define NT35510_DOPCTR_0_RAMKP BIT(7) /* Contents kept in sleep */
70 #define NT35510_DOPCTR_0_DSITE BIT(6) /* Enable TE signal */
71 #define NT35510_DOPCTR_0_DSIG BIT(5) /* Enable generic read/write */
72 #define NT35510_DOPCTR_0_DSIM BIT(4) /* Enable video mode on DSI */
73 #define NT35510_DOPCTR_0_EOTP BIT(3) /* Support EoTP */
74 #define NT35510_DOPCTR_0_N565 BIT(2) /* RGB or BGR pixel format */
75 #define NT35510_DOPCTR_1_TW_PWR_SEL BIT(4) /* TE power selector */
76 #define NT35510_DOPCTR_1_CRGB BIT(3) /* RGB or BGR byte order */
77 #define NT35510_DOPCTR_1_CTB BIT(2) /* Vertical scanning direction */
78 #define NT35510_DOPCTR_1_CRL BIT(1) /* Source driver data shift */
79 #define NT35510_P0_SDVPCTR_PRG BIT(2) /* 0 = normal operation, 1 = VGLO */
80 #define NT35510_P0_SDVPCTR_AVDD 0 /* source driver output = AVDD */
81 #define NT35510_P0_SDVPCTR_OFFCOL 1 /* source driver output = off color */
82 #define NT35510_P0_SDVPCTR_AVSS 2 /* source driver output = AVSS */
83 #define NT35510_P0_SDVPCTR_HI_Z 3 /* source driver output = High impedance */
86 * These manufacturer commands are available after we enable manufacturer
87 * command set (MCS) for page 1.
89 #define NT35510_P1_SETAVDD 0xB0
90 #define NT35510_P1_SETAVEE 0xB1
91 #define NT35510_P1_SETVCL 0xB2
92 #define NT35510_P1_SETVGH 0xB3
93 #define NT35510_P1_SETVRGH 0xB4
94 #define NT35510_P1_SETVGL 0xB5
95 #define NT35510_P1_BT1CTR 0xB6
96 #define NT35510_P1_BT2CTR 0xB7
97 #define NT35510_P1_BT3CTR 0xB8
98 #define NT35510_P1_BT4CTR 0xB9 /* VGH boosting times/freq */
99 #define NT35510_P1_BT5CTR 0xBA
100 #define NT35510_P1_PFMCTR 0xBB
101 #define NT35510_P1_SETVGP 0xBC
102 #define NT35510_P1_SETVGN 0xBD
103 #define NT35510_P1_SETVCMOFF 0xBE
104 #define NT35510_P1_VGHCTR 0xBF /* VGH output ctrl */
105 #define NT35510_P1_SET_GAMMA_RED_POS 0xD1
106 #define NT35510_P1_SET_GAMMA_GREEN_POS 0xD2
107 #define NT35510_P1_SET_GAMMA_BLUE_POS 0xD3
108 #define NT35510_P1_SET_GAMMA_RED_NEG 0xD4
109 #define NT35510_P1_SET_GAMMA_GREEN_NEG 0xD5
110 #define NT35510_P1_SET_GAMMA_BLUE_NEG 0xD6
112 /* AVDD and AVEE setting 3 bytes */
113 #define NT35510_P1_AVDD_LEN 3
114 #define NT35510_P1_AVEE_LEN 3
115 #define NT35510_P1_VGH_LEN 3
116 #define NT35510_P1_VGL_LEN 3
117 #define NT35510_P1_VGP_LEN 3
118 #define NT35510_P1_VGN_LEN 3
119 /* BT1CTR thru BT5CTR setting 3 bytes */
120 #define NT35510_P1_BT1CTR_LEN 3
121 #define NT35510_P1_BT2CTR_LEN 3
122 #define NT35510_P1_BT4CTR_LEN 3
123 #define NT35510_P1_BT5CTR_LEN 3
124 /* 52 gamma parameters times two per color: positive and negative */
125 #define NT35510_P1_GAMMA_LEN 52
128 * struct nt35510_config - the display-specific NT35510 configuration
130 * Some of the settings provide an array of bytes, A, B C which mean:
131 * A = normal / idle off mode
133 * C = partial / idle off mode
135 * Gamma correction arrays are 10bit numbers, two consecutive bytes
136 * makes out one point on the gamma correction curve. The points are
137 * not linearly placed along the X axis, we get points 0, 1, 3, 5
138 * 7, 11, 15, 23, 31, 47, 63, 95, 127, 128, 160, 192, 208, 224, 232,
139 * 240, 244, 248, 250, 252, 254, 255. The voltages tuples form
140 * V0, V1, V3 ... V255, with 0x0000 being the lowest voltage and
141 * 0x03FF being the highest voltage.
143 * Each value must be strictly higher than the previous value forming
144 * a rising curve like this:
154 * +------------------------------------------->
156 * The details about all settings can be found in the NT35510 Application
159 struct nt35510_config
{
161 * @width_mm: physical panel width [mm]
165 * @height_mm: physical panel height [mm]
169 * @mode: the display mode. This is only relevant outside the panel
170 * in video mode: in command mode this is configuring the internal
171 * timing in the display controller.
173 const struct drm_display_mode mode
;
175 * @avdd: setting for AVDD ranging from 0x00 = 6.5V to 0x14 = 4.5V
176 * in 0.1V steps the default is 0x05 which means 6.0V
178 u8 avdd
[NT35510_P1_AVDD_LEN
];
180 * @bt1ctr: setting for boost power control for the AVDD step-up
182 * bits 0..2 in the lower nibble controls PCK, the booster clock
183 * frequency for the step-up circuit:
192 * bits 4..6 in the upper nibble controls BTP, the boosting
193 * amplification for the the step-up circuit:
200 * The defaults are 4 and 4 yielding 0x44
202 u8 bt1ctr
[NT35510_P1_BT1CTR_LEN
];
204 * @avee: setting for AVEE ranging from 0x00 = -6.5V to 0x14 = -4.5V
205 * in 0.1V steps the default is 0x05 which means -6.0V
207 u8 avee
[NT35510_P1_AVEE_LEN
];
209 * @bt2ctr: setting for boost power control for the AVEE step-up
211 * bits 0..2 in the lower nibble controls NCK, the booster clock
212 * frequency, the values are the same as for PCK in @bt1ctr.
213 * bits 4..5 in the upper nibble controls BTN, the boosting
214 * amplification for the the step-up circuit.
220 * The defaults are 4 and 3 yielding 0x34
222 u8 bt2ctr
[NT35510_P1_BT2CTR_LEN
];
224 * @vgh: setting for VGH ranging from 0x00 = 7.0V to 0x0B = 18.0V
225 * in 1V steps, the default is 0x08 which means 15V
227 u8 vgh
[NT35510_P1_VGH_LEN
];
229 * @bt4ctr: setting for boost power control for the VGH step-up
231 * bits 0..2 in the lower nibble controls HCK, the booster clock
232 * frequency, the values are the same as for PCK in @bt1ctr.
233 * bits 4..5 in the upper nibble controls BTH, the boosting
234 * amplification for the the step-up circuit.
237 * 2 = AVDD - AVEE + VDDB
238 * 3 = AVDD x 2 - AVEE
239 * The defaults are 4 and 3 yielding 0x34
241 u8 bt4ctr
[NT35510_P1_BT4CTR_LEN
];
243 * @vgl: setting for VGL ranging from 0x00 = -2V to 0x0f = -15V in
244 * 1V steps, the default is 0x08 which means -10V
246 u8 vgl
[NT35510_P1_VGL_LEN
];
248 * @bt5ctr: setting for boost power control for the VGL step-up
250 * bits 0..2 in the lower nibble controls LCK, the booster clock
251 * frequency, the values are the same as for PCK in @bt1ctr.
252 * bits 4..5 in the upper nibble controls BTL, the boosting
253 * amplification for the the step-up circuit.
256 * 2 = AVEE + VCL - AVDD
257 * 3 = AVEE x 2 - AVDD
258 * The defaults are 3 and 2 yielding 0x32
260 u8 bt5ctr
[NT35510_P1_BT5CTR_LEN
];
262 * @vgp: setting for VGP, the positive gamma divider voltages
263 * VGMP the high voltage and VGSP the low voltage.
264 * The first byte contains bit 8 of VGMP and VGSP in bits 4 and 0
265 * The second byte contains bit 0..7 of VGMP
266 * The third byte contains bit 0..7 of VGSP
267 * VGMP 0x00 = 3.0V .. 0x108 = 6.3V in steps of 12.5mV
268 * VGSP 0x00 = 0V .. 0x111 = 3.7V in steps of 12.5mV
270 u8 vgp
[NT35510_P1_VGP_LEN
];
272 * @vgn: setting for VGN, the negative gamma divider voltages,
273 * same layout of bytes as @vgp.
275 u8 vgn
[NT35510_P1_VGN_LEN
];
277 * @sdeqctr: Source driver control settings, first byte is
278 * 0 for mode 1 and 1 for mode 2. Mode 1 uses two steps and
279 * mode 2 uses three steps meaning EQS3 is not used in mode
280 * 1. Mode 2 is default. The last three parameters are EQS1, EQS2
281 * and EQS3, setting the rise time for each equalizer step:
282 * 0x00 = 0.0 us to 0x0f = 7.5 us in steps of 0.5us. The default
285 u8 sdeqctr
[NT35510_P0_SDEQCTR_LEN
];
287 * @sdvpctr: power/voltage behaviour during vertical porch time
291 * @t1: the number of pixel clocks on one scanline, range
292 * 0x100 (258 ticks) .. 0x3FF (1024 ticks) so the value + 1
297 * @vbp: vertical back porch toward the PANEL note: not toward
298 * the DSI host; these are separate interfaces, in from DSI host
299 * and out to the panel.
303 * @vfp: vertical front porch toward the PANEL.
307 * @psel: pixel clock divisor: 0 = 1, 1 = 2, 2 = 4, 3 = 8.
311 * @dpmctr12: Display timing control 12
312 * Byte 1 bit 4 selects LVGL voltage level: 0 = VGLX, 1 = VGL_REG
313 * Byte 1 bit 1 selects gate signal mode: 0 = non-overlap, 1 = overlap
314 * Byte 1 bit 0 selects output signal control R/L swap, 0 = normal
315 * 1 = swap all O->E, L->R
316 * Byte 2 is CLW delay clock for CK O/E and CKB O/E signals:
317 * 0x00 = 0us .. 0xFF = 12.75us in 0.05us steps
318 * Byte 3 is FTI_H0 delay time for STP O/E signals:
319 * 0x00 = 0us .. 0xFF = 12.75us in 0.05us steps
321 u8 dpmctr12
[NT35510_P0_DPMCTR12_LEN
];
323 * @gamma_corr_pos_r: Red gamma correction parameters, positive
325 u8 gamma_corr_pos_r
[NT35510_P1_GAMMA_LEN
];
327 * @gamma_corr_pos_g: Green gamma correction parameters, positive
329 u8 gamma_corr_pos_g
[NT35510_P1_GAMMA_LEN
];
331 * @gamma_corr_pos_b: Blue gamma correction parameters, positive
333 u8 gamma_corr_pos_b
[NT35510_P1_GAMMA_LEN
];
335 * @gamma_corr_neg_r: Red gamma correction parameters, negative
337 u8 gamma_corr_neg_r
[NT35510_P1_GAMMA_LEN
];
339 * @gamma_corr_neg_g: Green gamma correction parameters, negative
341 u8 gamma_corr_neg_g
[NT35510_P1_GAMMA_LEN
];
343 * @gamma_corr_neg_b: Blue gamma correction parameters, negative
345 u8 gamma_corr_neg_b
[NT35510_P1_GAMMA_LEN
];
349 * struct nt35510 - state container for the NT35510 panel
353 * @dev: the container device
357 * @conf: the specific panel configuration, as the NT35510
358 * can be combined with many physical panels, they can have
359 * different physical dimensions and gamma correction etc,
360 * so this is stored in the config.
362 const struct nt35510_config
*conf
;
364 * @panel: the DRM panel object for the instance
366 struct drm_panel panel
;
368 * @supplies: regulators supplying the panel
370 struct regulator_bulk_data supplies
[2];
372 * @reset_gpio: the reset line
374 struct gpio_desc
*reset_gpio
;
377 /* Manufacturer command has strictly this byte sequence */
378 static const u8 nt35510_mauc_mtp_read_param
[] = { 0xAA, 0x55, 0x25, 0x01 };
379 static const u8 nt35510_mauc_mtp_read_setting
[] = { 0x01, 0x02, 0x00, 0x20,
380 0x33, 0x13, 0x00, 0x40,
381 0x00, 0x00, 0x23, 0x02 };
382 static const u8 nt35510_mauc_select_page_0
[] = { 0x55, 0xAA, 0x52, 0x08, 0x00 };
383 static const u8 nt35510_mauc_select_page_1
[] = { 0x55, 0xAA, 0x52, 0x08, 0x01 };
384 static const u8 nt35510_vgh_on
[] = { 0x01 };
386 static inline struct nt35510
*panel_to_nt35510(struct drm_panel
*panel
)
388 return container_of(panel
, struct nt35510
, panel
);
391 #define NT35510_ROTATE_0_SETTING 0x02
392 #define NT35510_ROTATE_180_SETTING 0x00
394 static int nt35510_send_long(struct nt35510
*nt
, struct mipi_dsi_device
*dsi
,
395 u8 cmd
, u8 cmdlen
, const u8
*seq
)
397 const u8
*seqp
= seq
;
404 ret
= mipi_dsi_dcs_write(dsi
, cmd
, seqp
, chunk
);
406 dev_err(nt
->dev
, "error sending DCS command seq cmd %02x\n", cmd
);
412 while (cmdwritten
< cmdlen
) {
413 chunk
= cmdlen
- cmdwritten
;
416 ret
= mipi_dsi_generic_write(dsi
, seqp
, chunk
);
418 dev_err(nt
->dev
, "error sending generic write seq %02x\n", cmd
);
424 dev_dbg(nt
->dev
, "sent command %02x %02x bytes\n", cmd
, cmdlen
);
428 static int nt35510_read_id(struct nt35510
*nt
)
430 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
434 ret
= mipi_dsi_dcs_read(dsi
, MCS_CMD_READ_ID1
, &id1
, 1);
436 dev_err(nt
->dev
, "could not read MTP ID1\n");
439 ret
= mipi_dsi_dcs_read(dsi
, MCS_CMD_READ_ID2
, &id2
, 1);
441 dev_err(nt
->dev
, "could not read MTP ID2\n");
444 ret
= mipi_dsi_dcs_read(dsi
, MCS_CMD_READ_ID3
, &id3
, 1);
446 dev_err(nt
->dev
, "could not read MTP ID3\n");
451 * Multi-Time Programmable (?) memory contains manufacturer
452 * ID (e.g. Hydis 0x55), driver ID (e.g. NT35510 0xc0) and
455 dev_info(nt
->dev
, "MTP ID manufacturer: %02x version: %02x driver: %02x\n", id1
, id2
, id3
);
461 * nt35510_setup_power() - set up power config in page 1
462 * @nt: the display instance to set up
464 static int nt35510_setup_power(struct nt35510
*nt
)
466 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
469 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETAVDD
,
474 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_BT1CTR
,
475 NT35510_P1_BT1CTR_LEN
,
479 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETAVEE
,
484 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_BT2CTR
,
485 NT35510_P1_BT2CTR_LEN
,
489 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETVGH
,
494 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_BT4CTR
,
495 NT35510_P1_BT4CTR_LEN
,
499 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_VGHCTR
,
500 ARRAY_SIZE(nt35510_vgh_on
),
504 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETVGL
,
509 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_BT5CTR
,
510 NT35510_P1_BT5CTR_LEN
,
514 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETVGP
,
519 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SETVGN
,
525 /* Typically 10 ms */
526 usleep_range(10000, 20000);
532 * nt35510_setup_display() - set up display config in page 0
533 * @nt: the display instance to set up
535 static int nt35510_setup_display(struct nt35510
*nt
)
537 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
538 const struct nt35510_config
*conf
= nt
->conf
;
539 u8 dopctr
[NT35510_P0_DOPCTR_LEN
];
540 u8 gseqctr
[NT35510_P0_GSEQCTR_LEN
];
541 u8 dpfrctr
[NT35510_P0_DPFRCTR1_LEN
];
542 /* FIXME: set up any rotation (assume none for now) */
543 u8 addr_mode
= NT35510_ROTATE_0_SETTING
;
547 /* Enable TE, EoTP and RGB pixel format */
548 dopctr
[0] = NT35510_DOPCTR_0_DSITE
| NT35510_DOPCTR_0_EOTP
|
549 NT35510_DOPCTR_0_N565
;
550 dopctr
[1] = NT35510_DOPCTR_1_CTB
;
551 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_DOPCTR
,
552 NT35510_P0_DOPCTR_LEN
,
557 ret
= mipi_dsi_dcs_write(dsi
, MIPI_DCS_SET_ADDRESS_MODE
, &addr_mode
,
563 * Source data hold time, default 0x05 = 2.5us
564 * 0x00..0x3F = 0 .. 31.5us in steps of 0.5us
568 ret
= mipi_dsi_dcs_write(dsi
, NT35510_P0_SDHDTCTR
, &val
,
573 /* EQ control for gate signals, 0x00 = 0 us */
576 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_GSEQCTR
,
577 NT35510_P0_GSEQCTR_LEN
,
582 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_SDEQCTR
,
583 NT35510_P0_SDEQCTR_LEN
,
588 ret
= mipi_dsi_dcs_write(dsi
, NT35510_P0_SDVPCTR
,
594 * Display timing control for active and idle off mode:
595 * the first byte contains
596 * the two high bits of T1A and second byte the low 8 bits, and
597 * the valid range is 0x100 (257) to 0x3ff (1023) representing
598 * 258..1024 (+1) pixel clock ticks for one scanline. At 20MHz pixel
599 * clock this covers the range of 12.90us .. 51.20us in steps of
600 * 0.05us, the default is 0x184 (388) representing 389 ticks.
601 * The third byte is VBPDA, vertical back porch display active
602 * and the fourth VFPDA, vertical front porch display active,
603 * both given in number of scanlines in the range 0x02..0xff
604 * for 2..255 scanlines. The fifth byte is 2 bits selecting
605 * PSEL for active and idle off mode, how much the 20MHz clock
606 * is divided by 0..3. This needs to be adjusted to get the right
609 dpfrctr
[0] = (conf
->t1
>> 8) & 0xFF;
610 dpfrctr
[1] = conf
->t1
& 0xFF;
611 /* Vertical back porch */
612 dpfrctr
[2] = conf
->vbp
;
613 /* Vertical front porch */
614 dpfrctr
[3] = conf
->vfp
;
615 dpfrctr
[4] = conf
->psel
;
616 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_DPFRCTR1
,
617 NT35510_P0_DPFRCTR1_LEN
,
621 /* For idle and partial idle off mode we decrease front porch by one */
623 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_DPFRCTR2
,
624 NT35510_P0_DPFRCTR2_LEN
,
628 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_DPFRCTR3
,
629 NT35510_P0_DPFRCTR3_LEN
,
634 /* Enable TE on vblank */
635 ret
= mipi_dsi_dcs_set_tear_on(dsi
, MIPI_DSI_DCS_TEAR_MODE_VBLANK
);
639 /* Turn on the pads? */
640 ret
= nt35510_send_long(nt
, dsi
, NT35510_P0_DPMCTR12
,
641 NT35510_P0_DPMCTR12_LEN
,
649 static int nt35510_set_brightness(struct backlight_device
*bl
)
651 struct nt35510
*nt
= bl_get_data(bl
);
652 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
653 u8 brightness
= bl
->props
.brightness
;
656 dev_dbg(nt
->dev
, "set brightness %d\n", brightness
);
657 ret
= mipi_dsi_dcs_write(dsi
, MIPI_DCS_SET_DISPLAY_BRIGHTNESS
,
666 static const struct backlight_ops nt35510_bl_ops
= {
667 .update_status
= nt35510_set_brightness
,
671 * This power-on sequence
673 static int nt35510_power_on(struct nt35510
*nt
)
675 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
678 ret
= regulator_bulk_enable(ARRAY_SIZE(nt
->supplies
), nt
->supplies
);
680 dev_err(nt
->dev
, "unable to enable regulators\n");
684 /* Toggle RESET in accordance with datasheet page 370 */
685 if (nt
->reset_gpio
) {
686 gpiod_set_value(nt
->reset_gpio
, 1);
687 /* Active min 10 us according to datasheet, let's say 20 */
688 usleep_range(20, 1000);
689 gpiod_set_value(nt
->reset_gpio
, 0);
691 * 5 ms during sleep mode, 120 ms during sleep out mode
692 * according to datasheet, let's use 120-140 ms.
694 usleep_range(120000, 140000);
697 ret
= nt35510_send_long(nt
, dsi
, MCS_CMD_MTP_READ_PARAM
,
698 ARRAY_SIZE(nt35510_mauc_mtp_read_param
),
699 nt35510_mauc_mtp_read_param
);
703 ret
= nt35510_send_long(nt
, dsi
, MCS_CMD_MTP_READ_SETTING
,
704 ARRAY_SIZE(nt35510_mauc_mtp_read_setting
),
705 nt35510_mauc_mtp_read_setting
);
709 ret
= nt35510_read_id(nt
);
713 /* Set up stuff in manufacturer control, page 1 */
714 ret
= nt35510_send_long(nt
, dsi
, MCS_CMD_MAUCCTR
,
715 ARRAY_SIZE(nt35510_mauc_select_page_1
),
716 nt35510_mauc_select_page_1
);
720 ret
= nt35510_setup_power(nt
);
724 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_RED_POS
,
725 NT35510_P1_GAMMA_LEN
,
726 nt
->conf
->gamma_corr_pos_r
);
729 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_GREEN_POS
,
730 NT35510_P1_GAMMA_LEN
,
731 nt
->conf
->gamma_corr_pos_g
);
734 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_BLUE_POS
,
735 NT35510_P1_GAMMA_LEN
,
736 nt
->conf
->gamma_corr_pos_b
);
739 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_RED_NEG
,
740 NT35510_P1_GAMMA_LEN
,
741 nt
->conf
->gamma_corr_neg_r
);
744 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_GREEN_NEG
,
745 NT35510_P1_GAMMA_LEN
,
746 nt
->conf
->gamma_corr_neg_g
);
749 ret
= nt35510_send_long(nt
, dsi
, NT35510_P1_SET_GAMMA_BLUE_NEG
,
750 NT35510_P1_GAMMA_LEN
,
751 nt
->conf
->gamma_corr_neg_b
);
755 /* Set up stuff in manufacturer control, page 0 */
756 ret
= nt35510_send_long(nt
, dsi
, MCS_CMD_MAUCCTR
,
757 ARRAY_SIZE(nt35510_mauc_select_page_0
),
758 nt35510_mauc_select_page_0
);
762 ret
= nt35510_setup_display(nt
);
769 static int nt35510_power_off(struct nt35510
*nt
)
773 ret
= regulator_bulk_disable(ARRAY_SIZE(nt
->supplies
), nt
->supplies
);
778 gpiod_set_value(nt
->reset_gpio
, 1);
783 static int nt35510_unprepare(struct drm_panel
*panel
)
785 struct nt35510
*nt
= panel_to_nt35510(panel
);
786 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
789 ret
= mipi_dsi_dcs_set_display_off(dsi
);
791 dev_err(nt
->dev
, "failed to turn display off (%d)\n", ret
);
794 usleep_range(10000, 20000);
796 /* Enter sleep mode */
797 ret
= mipi_dsi_dcs_enter_sleep_mode(dsi
);
799 dev_err(nt
->dev
, "failed to enter sleep mode (%d)\n", ret
);
803 /* Wait 4 frames, how much is that 5ms in the vendor driver */
804 usleep_range(5000, 10000);
806 ret
= nt35510_power_off(nt
);
813 static int nt35510_prepare(struct drm_panel
*panel
)
815 struct nt35510
*nt
= panel_to_nt35510(panel
);
816 struct mipi_dsi_device
*dsi
= to_mipi_dsi_device(nt
->dev
);
819 ret
= nt35510_power_on(nt
);
823 /* Exit sleep mode */
824 ret
= mipi_dsi_dcs_exit_sleep_mode(dsi
);
826 dev_err(nt
->dev
, "failed to exit sleep mode (%d)\n", ret
);
830 usleep_range(120000, 150000);
832 ret
= mipi_dsi_dcs_set_display_on(dsi
);
834 dev_err(nt
->dev
, "failed to turn display on (%d)\n", ret
);
838 usleep_range(10000, 20000);
843 static int nt35510_get_modes(struct drm_panel
*panel
,
844 struct drm_connector
*connector
)
846 struct nt35510
*nt
= panel_to_nt35510(panel
);
847 struct drm_display_mode
*mode
;
848 struct drm_display_info
*info
;
850 info
= &connector
->display_info
;
851 info
->width_mm
= nt
->conf
->width_mm
;
852 info
->height_mm
= nt
->conf
->height_mm
;
853 mode
= drm_mode_duplicate(connector
->dev
, &nt
->conf
->mode
);
855 dev_err(panel
->dev
, "bad mode or failed to add mode\n");
858 drm_mode_set_name(mode
);
859 mode
->type
= DRM_MODE_TYPE_DRIVER
| DRM_MODE_TYPE_PREFERRED
;
861 mode
->width_mm
= nt
->conf
->width_mm
;
862 mode
->height_mm
= nt
->conf
->height_mm
;
863 drm_mode_probed_add(connector
, mode
);
865 return 1; /* Number of modes */
868 static const struct drm_panel_funcs nt35510_drm_funcs
= {
869 .unprepare
= nt35510_unprepare
,
870 .prepare
= nt35510_prepare
,
871 .get_modes
= nt35510_get_modes
,
874 static int nt35510_probe(struct mipi_dsi_device
*dsi
)
876 struct device
*dev
= &dsi
->dev
;
880 nt
= devm_kzalloc(dev
, sizeof(struct nt35510
), GFP_KERNEL
);
883 mipi_dsi_set_drvdata(dsi
, nt
);
887 dsi
->format
= MIPI_DSI_FMT_RGB888
;
889 * Datasheet suggests max HS rate for NT35510 is 250 MHz
890 * (period time 4ns, see figure 7.6.4 page 365) and max LP rate is
891 * 20 MHz (period time 50ns, see figure 7.6.6. page 366).
892 * However these frequencies appear in source code for the Hydis
893 * HVA40WV1 panel and setting up the LP frequency makes the panel
896 * TODO: if other panels prove to be closer to the datasheet,
897 * maybe make this a per-panel config in struct nt35510_config?
899 dsi
->hs_rate
= 349440000;
900 dsi
->lp_rate
= 9600000;
901 dsi
->mode_flags
= MIPI_DSI_CLOCK_NON_CONTINUOUS
|
902 MIPI_DSI_MODE_EOT_PACKET
;
905 * Every new incarnation of this display must have a unique
906 * data entry for the system in this driver.
908 nt
->conf
= of_device_get_match_data(dev
);
910 dev_err(dev
, "missing device configuration\n");
914 nt
->supplies
[0].supply
= "vdd"; /* 2.3-4.8 V */
915 nt
->supplies
[1].supply
= "vddi"; /* 1.65-3.3V */
916 ret
= devm_regulator_bulk_get(dev
, ARRAY_SIZE(nt
->supplies
),
920 ret
= regulator_set_voltage(nt
->supplies
[0].consumer
,
924 ret
= regulator_set_voltage(nt
->supplies
[1].consumer
,
929 nt
->reset_gpio
= devm_gpiod_get_optional(dev
, "reset", GPIOD_ASIS
);
930 if (IS_ERR(nt
->reset_gpio
)) {
931 dev_err(dev
, "error getting RESET GPIO\n");
932 return PTR_ERR(nt
->reset_gpio
);
935 drm_panel_init(&nt
->panel
, dev
, &nt35510_drm_funcs
,
936 DRM_MODE_CONNECTOR_DSI
);
939 * First, try to locate an external backlight (such as on GPIO)
940 * if this fails, assume we will want to use the internal backlight
943 ret
= drm_panel_of_backlight(&nt
->panel
);
945 dev_err(dev
, "error getting external backlight %d\n", ret
);
948 if (!nt
->panel
.backlight
) {
949 struct backlight_device
*bl
;
951 bl
= devm_backlight_device_register(dev
, "nt35510", dev
, nt
,
952 &nt35510_bl_ops
, NULL
);
954 dev_err(dev
, "failed to register backlight device\n");
957 bl
->props
.max_brightness
= 255;
958 bl
->props
.brightness
= 255;
959 bl
->props
.power
= FB_BLANK_POWERDOWN
;
960 nt
->panel
.backlight
= bl
;
963 drm_panel_add(&nt
->panel
);
965 ret
= mipi_dsi_attach(dsi
);
967 drm_panel_remove(&nt
->panel
);
972 static int nt35510_remove(struct mipi_dsi_device
*dsi
)
974 struct nt35510
*nt
= mipi_dsi_get_drvdata(dsi
);
977 mipi_dsi_detach(dsi
);
979 ret
= nt35510_power_off(nt
);
980 drm_panel_remove(&nt
->panel
);
986 * These gamma correction values are 10bit tuples, so only bits 0 and 1 is
987 * ever used in the first byte. They form a positive and negative gamma
988 * correction curve for each color, values must be strictly higher for each
989 * step on the curve. As can be seen these default curves goes from 0x0001
992 #define NT35510_GAMMA_POS_DEFAULT 0x00, 0x01, 0x00, 0x43, 0x00, \
993 0x6B, 0x00, 0x87, 0x00, 0xA3, 0x00, 0xCE, 0x00, 0xF1, 0x01, \
994 0x27, 0x01, 0x53, 0x01, 0x98, 0x01, 0xCE, 0x02, 0x22, 0x02, \
995 0x83, 0x02, 0x78, 0x02, 0x9E, 0x02, 0xDD, 0x03, 0x00, 0x03, \
996 0x2E, 0x03, 0x54, 0x03, 0x7F, 0x03, 0x95, 0x03, 0xB3, 0x03, \
997 0xC2, 0x03, 0xE1, 0x03, 0xF1, 0x03, 0xFE
999 #define NT35510_GAMMA_NEG_DEFAULT 0x00, 0x01, 0x00, 0x43, 0x00, \
1000 0x6B, 0x00, 0x87, 0x00, 0xA3, 0x00, 0xCE, 0x00, 0xF1, 0x01, \
1001 0x27, 0x01, 0x53, 0x01, 0x98, 0x01, 0xCE, 0x02, 0x22, 0x02, \
1002 0x43, 0x02, 0x50, 0x02, 0x9E, 0x02, 0xDD, 0x03, 0x00, 0x03, \
1003 0x2E, 0x03, 0x54, 0x03, 0x7F, 0x03, 0x95, 0x03, 0xB3, 0x03, \
1004 0xC2, 0x03, 0xE1, 0x03, 0xF1, 0x03, 0xFE
1007 * The Hydis HVA40WV1 panel
1009 static const struct nt35510_config nt35510_hydis_hva40wv1
= {
1013 * As the Hydis panel is used in command mode, the porches etc
1014 * are settings programmed internally into the NT35510 controller
1015 * and generated toward the physical display. As the panel is not
1016 * used in video mode, these are not really exposed to the DSI
1019 * Display frame rate control:
1020 * Frame rate = (20 MHz / 1) / (389 * (7 + 50 + 800)) ~= 60 Hz
1023 /* The internal pixel clock of the NT35510 is 20 MHz */
1026 .hsync_start
= 480 + 2, /* HFP = 2 */
1027 .hsync_end
= 480 + 2 + 0, /* HSync = 0 */
1028 .htotal
= 480 + 2 + 0 + 5, /* HFP = 5 */
1030 .vsync_start
= 800 + 2, /* VFP = 2 */
1031 .vsync_end
= 800 + 2 + 0, /* VSync = 0 */
1032 .vtotal
= 800 + 2 + 0 + 5, /* VBP = 5 */
1035 /* 0x09: AVDD = 5.6V */
1036 .avdd
= { 0x09, 0x09, 0x09 },
1037 /* 0x34: PCK = Hsync/2, BTP = 2 x VDDB */
1038 .bt1ctr
= { 0x34, 0x34, 0x34 },
1039 /* 0x09: AVEE = -5.6V */
1040 .avee
= { 0x09, 0x09, 0x09 },
1041 /* 0x24: NCK = Hsync/2, BTN = -2 x VDDB */
1042 .bt2ctr
= { 0x24, 0x24, 0x24 },
1044 .vgh
= { 0x05, 0x05, 0x05 },
1045 /* 0x24: NCKA = Hsync/2, VGH = 2 x AVDD - AVEE */
1046 .bt4ctr
= { 0x24, 0x24, 0x24 },
1048 .vgl
= { 0x0B, 0x0B, 0x0B },
1049 /* 0x24: LCKA = Hsync, VGL = AVDD + VCL - AVDD */
1050 .bt5ctr
= { 0x24, 0x24, 0x24 },
1051 /* VGMP: 0x0A3 = 5.0375V, VGSP = 0V */
1052 .vgp
= { 0x00, 0xA3, 0x00 },
1053 /* VGMP: 0x0A3 = 5.0375V, VGSP = 0V */
1054 .vgn
= { 0x00, 0xA3, 0x00 },
1055 /* SDEQCTR: source driver EQ mode 2, 2.5 us rise time on each step */
1056 .sdeqctr
= { 0x01, 0x05, 0x05, 0x05 },
1057 /* SDVPCTR: Normal operation off color during v porch */
1059 /* T1: number of pixel clocks on one scanline: 0x184 = 389 clocks */
1061 /* VBP: vertical back porch toward the panel */
1063 /* VFP: vertical front porch toward the panel */
1065 /* PSEL: divide pixel clock 20MHz with 1 (no clock downscaling) */
1067 /* DPTMCTR12: 0x03: LVGL = VGLX, overlap mode, swap R->L O->E */
1068 .dpmctr12
= { 0x03, 0x00, 0x00, },
1069 /* Default gamma correction values */
1070 .gamma_corr_pos_r
= { NT35510_GAMMA_POS_DEFAULT
},
1071 .gamma_corr_pos_g
= { NT35510_GAMMA_POS_DEFAULT
},
1072 .gamma_corr_pos_b
= { NT35510_GAMMA_POS_DEFAULT
},
1073 .gamma_corr_neg_r
= { NT35510_GAMMA_NEG_DEFAULT
},
1074 .gamma_corr_neg_g
= { NT35510_GAMMA_NEG_DEFAULT
},
1075 .gamma_corr_neg_b
= { NT35510_GAMMA_NEG_DEFAULT
},
1078 static const struct of_device_id nt35510_of_match
[] = {
1080 .compatible
= "hydis,hva40wv1",
1081 .data
= &nt35510_hydis_hva40wv1
,
1085 MODULE_DEVICE_TABLE(of
, nt35510_of_match
);
1087 static struct mipi_dsi_driver nt35510_driver
= {
1088 .probe
= nt35510_probe
,
1089 .remove
= nt35510_remove
,
1091 .name
= "panel-novatek-nt35510",
1092 .of_match_table
= nt35510_of_match
,
1095 module_mipi_dsi_driver(nt35510_driver
);
1097 MODULE_AUTHOR("Linus Walleij <linus.walleij@linaro.org>");
1098 MODULE_DESCRIPTION("NT35510-based panel driver");
1099 MODULE_LICENSE("GPL v2");