1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * DRM driver for Ilitek ILI9225 panels
5 * Copyright 2017 David Lechner <david@lechnology.com>
7 * Some code copied from mipi-dbi.c
8 * Copyright 2016 Noralf Trønnes
11 #include <linux/delay.h>
12 #include <linux/dma-buf.h>
13 #include <linux/gpio/consumer.h>
14 #include <linux/module.h>
15 #include <linux/property.h>
16 #include <linux/spi/spi.h>
17 #include <video/mipi_display.h>
19 #include <drm/drm_atomic_helper.h>
20 #include <drm/drm_damage_helper.h>
21 #include <drm/drm_drv.h>
22 #include <drm/drm_fb_cma_helper.h>
23 #include <drm/drm_fb_helper.h>
24 #include <drm/drm_fourcc.h>
25 #include <drm/drm_gem_cma_helper.h>
26 #include <drm/drm_gem_framebuffer_helper.h>
27 #include <drm/drm_mipi_dbi.h>
28 #include <drm/drm_rect.h>
29 #include <drm/drm_vblank.h>
31 #define ILI9225_DRIVER_READ_CODE 0x00
32 #define ILI9225_DRIVER_OUTPUT_CONTROL 0x01
33 #define ILI9225_LCD_AC_DRIVING_CONTROL 0x02
34 #define ILI9225_ENTRY_MODE 0x03
35 #define ILI9225_DISPLAY_CONTROL_1 0x07
36 #define ILI9225_BLANK_PERIOD_CONTROL_1 0x08
37 #define ILI9225_FRAME_CYCLE_CONTROL 0x0b
38 #define ILI9225_INTERFACE_CONTROL 0x0c
39 #define ILI9225_OSCILLATION_CONTROL 0x0f
40 #define ILI9225_POWER_CONTROL_1 0x10
41 #define ILI9225_POWER_CONTROL_2 0x11
42 #define ILI9225_POWER_CONTROL_3 0x12
43 #define ILI9225_POWER_CONTROL_4 0x13
44 #define ILI9225_POWER_CONTROL_5 0x14
45 #define ILI9225_VCI_RECYCLING 0x15
46 #define ILI9225_RAM_ADDRESS_SET_1 0x20
47 #define ILI9225_RAM_ADDRESS_SET_2 0x21
48 #define ILI9225_WRITE_DATA_TO_GRAM 0x22
49 #define ILI9225_SOFTWARE_RESET 0x28
50 #define ILI9225_GATE_SCAN_CONTROL 0x30
51 #define ILI9225_VERTICAL_SCROLL_1 0x31
52 #define ILI9225_VERTICAL_SCROLL_2 0x32
53 #define ILI9225_VERTICAL_SCROLL_3 0x33
54 #define ILI9225_PARTIAL_DRIVING_POS_1 0x34
55 #define ILI9225_PARTIAL_DRIVING_POS_2 0x35
56 #define ILI9225_HORIZ_WINDOW_ADDR_1 0x36
57 #define ILI9225_HORIZ_WINDOW_ADDR_2 0x37
58 #define ILI9225_VERT_WINDOW_ADDR_1 0x38
59 #define ILI9225_VERT_WINDOW_ADDR_2 0x39
60 #define ILI9225_GAMMA_CONTROL_1 0x50
61 #define ILI9225_GAMMA_CONTROL_2 0x51
62 #define ILI9225_GAMMA_CONTROL_3 0x52
63 #define ILI9225_GAMMA_CONTROL_4 0x53
64 #define ILI9225_GAMMA_CONTROL_5 0x54
65 #define ILI9225_GAMMA_CONTROL_6 0x55
66 #define ILI9225_GAMMA_CONTROL_7 0x56
67 #define ILI9225_GAMMA_CONTROL_8 0x57
68 #define ILI9225_GAMMA_CONTROL_9 0x58
69 #define ILI9225_GAMMA_CONTROL_10 0x59
71 static inline int ili9225_command(struct mipi_dbi
*dbi
, u8 cmd
, u16 data
)
73 u8 par
[2] = { data
>> 8, data
& 0xff };
75 return mipi_dbi_command_buf(dbi
, cmd
, par
, 2);
78 static void ili9225_fb_dirty(struct drm_framebuffer
*fb
, struct drm_rect
*rect
)
80 struct drm_gem_cma_object
*cma_obj
= drm_fb_cma_get_gem_obj(fb
, 0);
81 struct mipi_dbi_dev
*dbidev
= drm_to_mipi_dbi_dev(fb
->dev
);
82 unsigned int height
= rect
->y2
- rect
->y1
;
83 unsigned int width
= rect
->x2
- rect
->x1
;
84 struct mipi_dbi
*dbi
= &dbidev
->dbi
;
85 bool swap
= dbi
->swap_bytes
;
95 if (!drm_dev_enter(fb
->dev
, &idx
))
98 full
= width
== fb
->width
&& height
== fb
->height
;
100 DRM_DEBUG_KMS("Flushing [FB:%d] " DRM_RECT_FMT
"\n", fb
->base
.id
, DRM_RECT_ARG(rect
));
102 if (!dbi
->dc
|| !full
|| swap
||
103 fb
->format
->format
== DRM_FORMAT_XRGB8888
) {
105 ret
= mipi_dbi_buf_copy(dbidev
->tx_buf
, fb
, rect
, swap
);
112 switch (dbidev
->rotation
) {
124 y1
= fb
->width
- rect
->x2
;
125 y2
= fb
->width
- rect
->x1
- 1;
130 x1
= fb
->width
- rect
->x2
;
131 x2
= fb
->width
- rect
->x1
- 1;
132 y1
= fb
->height
- rect
->y2
;
133 y2
= fb
->height
- rect
->y1
- 1;
138 x1
= fb
->height
- rect
->y2
;
139 x2
= fb
->height
- rect
->y1
- 1;
147 ili9225_command(dbi
, ILI9225_HORIZ_WINDOW_ADDR_1
, x2
);
148 ili9225_command(dbi
, ILI9225_HORIZ_WINDOW_ADDR_2
, x1
);
149 ili9225_command(dbi
, ILI9225_VERT_WINDOW_ADDR_1
, y2
);
150 ili9225_command(dbi
, ILI9225_VERT_WINDOW_ADDR_2
, y1
);
152 ili9225_command(dbi
, ILI9225_RAM_ADDRESS_SET_1
, x_start
);
153 ili9225_command(dbi
, ILI9225_RAM_ADDRESS_SET_2
, y_start
);
155 ret
= mipi_dbi_command_buf(dbi
, ILI9225_WRITE_DATA_TO_GRAM
, tr
,
159 dev_err_once(fb
->dev
->dev
, "Failed to update display %d\n", ret
);
164 static void ili9225_pipe_update(struct drm_simple_display_pipe
*pipe
,
165 struct drm_plane_state
*old_state
)
167 struct drm_plane_state
*state
= pipe
->plane
.state
;
168 struct drm_crtc
*crtc
= &pipe
->crtc
;
169 struct drm_rect rect
;
171 if (drm_atomic_helper_damage_merged(old_state
, state
, &rect
))
172 ili9225_fb_dirty(state
->fb
, &rect
);
174 if (crtc
->state
->event
) {
175 spin_lock_irq(&crtc
->dev
->event_lock
);
176 drm_crtc_send_vblank_event(crtc
, crtc
->state
->event
);
177 spin_unlock_irq(&crtc
->dev
->event_lock
);
178 crtc
->state
->event
= NULL
;
182 static void ili9225_pipe_enable(struct drm_simple_display_pipe
*pipe
,
183 struct drm_crtc_state
*crtc_state
,
184 struct drm_plane_state
*plane_state
)
186 struct mipi_dbi_dev
*dbidev
= drm_to_mipi_dbi_dev(pipe
->crtc
.dev
);
187 struct drm_framebuffer
*fb
= plane_state
->fb
;
188 struct device
*dev
= pipe
->crtc
.dev
->dev
;
189 struct mipi_dbi
*dbi
= &dbidev
->dbi
;
190 struct drm_rect rect
= {
199 if (!drm_dev_enter(pipe
->crtc
.dev
, &idx
))
204 mipi_dbi_hw_reset(dbi
);
207 * There don't seem to be two example init sequences that match, so
208 * using the one from the popular Arduino library for this display.
209 * https://github.com/Nkawu/TFT_22_ILI9225/blob/master/src/TFT_22_ILI9225.cpp
212 ret
= ili9225_command(dbi
, ILI9225_POWER_CONTROL_1
, 0x0000);
214 DRM_DEV_ERROR(dev
, "Error sending command %d\n", ret
);
217 ili9225_command(dbi
, ILI9225_POWER_CONTROL_2
, 0x0000);
218 ili9225_command(dbi
, ILI9225_POWER_CONTROL_3
, 0x0000);
219 ili9225_command(dbi
, ILI9225_POWER_CONTROL_4
, 0x0000);
220 ili9225_command(dbi
, ILI9225_POWER_CONTROL_5
, 0x0000);
224 ili9225_command(dbi
, ILI9225_POWER_CONTROL_2
, 0x0018);
225 ili9225_command(dbi
, ILI9225_POWER_CONTROL_3
, 0x6121);
226 ili9225_command(dbi
, ILI9225_POWER_CONTROL_4
, 0x006f);
227 ili9225_command(dbi
, ILI9225_POWER_CONTROL_5
, 0x495f);
228 ili9225_command(dbi
, ILI9225_POWER_CONTROL_1
, 0x0800);
232 ili9225_command(dbi
, ILI9225_POWER_CONTROL_2
, 0x103b);
236 switch (dbidev
->rotation
) {
250 ili9225_command(dbi
, ILI9225_DRIVER_OUTPUT_CONTROL
, 0x011c);
251 ili9225_command(dbi
, ILI9225_LCD_AC_DRIVING_CONTROL
, 0x0100);
252 ili9225_command(dbi
, ILI9225_ENTRY_MODE
, 0x1000 | am_id
);
253 ili9225_command(dbi
, ILI9225_DISPLAY_CONTROL_1
, 0x0000);
254 ili9225_command(dbi
, ILI9225_BLANK_PERIOD_CONTROL_1
, 0x0808);
255 ili9225_command(dbi
, ILI9225_FRAME_CYCLE_CONTROL
, 0x1100);
256 ili9225_command(dbi
, ILI9225_INTERFACE_CONTROL
, 0x0000);
257 ili9225_command(dbi
, ILI9225_OSCILLATION_CONTROL
, 0x0d01);
258 ili9225_command(dbi
, ILI9225_VCI_RECYCLING
, 0x0020);
259 ili9225_command(dbi
, ILI9225_RAM_ADDRESS_SET_1
, 0x0000);
260 ili9225_command(dbi
, ILI9225_RAM_ADDRESS_SET_2
, 0x0000);
262 ili9225_command(dbi
, ILI9225_GATE_SCAN_CONTROL
, 0x0000);
263 ili9225_command(dbi
, ILI9225_VERTICAL_SCROLL_1
, 0x00db);
264 ili9225_command(dbi
, ILI9225_VERTICAL_SCROLL_2
, 0x0000);
265 ili9225_command(dbi
, ILI9225_VERTICAL_SCROLL_3
, 0x0000);
266 ili9225_command(dbi
, ILI9225_PARTIAL_DRIVING_POS_1
, 0x00db);
267 ili9225_command(dbi
, ILI9225_PARTIAL_DRIVING_POS_2
, 0x0000);
269 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_1
, 0x0000);
270 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_2
, 0x0808);
271 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_3
, 0x080a);
272 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_4
, 0x000a);
273 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_5
, 0x0a08);
274 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_6
, 0x0808);
275 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_7
, 0x0000);
276 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_8
, 0x0a00);
277 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_9
, 0x0710);
278 ili9225_command(dbi
, ILI9225_GAMMA_CONTROL_10
, 0x0710);
280 ili9225_command(dbi
, ILI9225_DISPLAY_CONTROL_1
, 0x0012);
284 ili9225_command(dbi
, ILI9225_DISPLAY_CONTROL_1
, 0x1017);
286 dbidev
->enabled
= true;
287 ili9225_fb_dirty(fb
, &rect
);
292 static void ili9225_pipe_disable(struct drm_simple_display_pipe
*pipe
)
294 struct mipi_dbi_dev
*dbidev
= drm_to_mipi_dbi_dev(pipe
->crtc
.dev
);
295 struct mipi_dbi
*dbi
= &dbidev
->dbi
;
300 * This callback is not protected by drm_dev_enter/exit since we want to
301 * turn off the display on regular driver unload. It's highly unlikely
302 * that the underlying SPI controller is gone should this be called after
306 if (!dbidev
->enabled
)
309 ili9225_command(dbi
, ILI9225_DISPLAY_CONTROL_1
, 0x0000);
311 ili9225_command(dbi
, ILI9225_POWER_CONTROL_2
, 0x0007);
313 ili9225_command(dbi
, ILI9225_POWER_CONTROL_1
, 0x0a02);
315 dbidev
->enabled
= false;
318 static int ili9225_dbi_command(struct mipi_dbi
*dbi
, u8
*cmd
, u8
*par
,
321 struct spi_device
*spi
= dbi
->spi
;
322 unsigned int bpw
= 8;
326 gpiod_set_value_cansleep(dbi
->dc
, 0);
327 speed_hz
= mipi_dbi_spi_cmd_max_speed(spi
, 1);
328 ret
= mipi_dbi_spi_transfer(spi
, speed_hz
, 8, cmd
, 1);
332 if (*cmd
== ILI9225_WRITE_DATA_TO_GRAM
&& !dbi
->swap_bytes
)
335 gpiod_set_value_cansleep(dbi
->dc
, 1);
336 speed_hz
= mipi_dbi_spi_cmd_max_speed(spi
, num
);
338 return mipi_dbi_spi_transfer(spi
, speed_hz
, bpw
, par
, num
);
341 static const struct drm_simple_display_pipe_funcs ili9225_pipe_funcs
= {
342 .enable
= ili9225_pipe_enable
,
343 .disable
= ili9225_pipe_disable
,
344 .update
= ili9225_pipe_update
,
345 .prepare_fb
= drm_gem_fb_simple_display_pipe_prepare_fb
,
348 static const struct drm_display_mode ili9225_mode
= {
349 DRM_SIMPLE_MODE(176, 220, 35, 44),
352 DEFINE_DRM_GEM_CMA_FOPS(ili9225_fops
);
354 static struct drm_driver ili9225_driver
= {
355 .driver_features
= DRIVER_GEM
| DRIVER_MODESET
| DRIVER_ATOMIC
,
356 .fops
= &ili9225_fops
,
357 .release
= mipi_dbi_release
,
358 DRM_GEM_CMA_VMAP_DRIVER_OPS
,
360 .desc
= "Ilitek ILI9225",
366 static const struct of_device_id ili9225_of_match
[] = {
367 { .compatible
= "vot,v220hf01a-t" },
370 MODULE_DEVICE_TABLE(of
, ili9225_of_match
);
372 static const struct spi_device_id ili9225_id
[] = {
373 { "v220hf01a-t", 0 },
376 MODULE_DEVICE_TABLE(spi
, ili9225_id
);
378 static int ili9225_probe(struct spi_device
*spi
)
380 struct device
*dev
= &spi
->dev
;
381 struct mipi_dbi_dev
*dbidev
;
382 struct drm_device
*drm
;
383 struct mipi_dbi
*dbi
;
384 struct gpio_desc
*rs
;
388 dbidev
= kzalloc(sizeof(*dbidev
), GFP_KERNEL
);
394 ret
= devm_drm_dev_init(dev
, drm
, &ili9225_driver
);
400 drm_mode_config_init(drm
);
402 dbi
->reset
= devm_gpiod_get(dev
, "reset", GPIOD_OUT_HIGH
);
403 if (IS_ERR(dbi
->reset
)) {
404 DRM_DEV_ERROR(dev
, "Failed to get gpio 'reset'\n");
405 return PTR_ERR(dbi
->reset
);
408 rs
= devm_gpiod_get(dev
, "rs", GPIOD_OUT_LOW
);
410 DRM_DEV_ERROR(dev
, "Failed to get gpio 'rs'\n");
414 device_property_read_u32(dev
, "rotation", &rotation
);
416 ret
= mipi_dbi_spi_init(spi
, dbi
, rs
);
420 /* override the command function set in mipi_dbi_spi_init() */
421 dbi
->command
= ili9225_dbi_command
;
423 ret
= mipi_dbi_dev_init(dbidev
, &ili9225_pipe_funcs
, &ili9225_mode
, rotation
);
427 drm_mode_config_reset(drm
);
429 ret
= drm_dev_register(drm
, 0);
433 spi_set_drvdata(spi
, drm
);
435 drm_fbdev_generic_setup(drm
, 0);
440 static int ili9225_remove(struct spi_device
*spi
)
442 struct drm_device
*drm
= spi_get_drvdata(spi
);
445 drm_atomic_helper_shutdown(drm
);
450 static void ili9225_shutdown(struct spi_device
*spi
)
452 drm_atomic_helper_shutdown(spi_get_drvdata(spi
));
455 static struct spi_driver ili9225_spi_driver
= {
458 .owner
= THIS_MODULE
,
459 .of_match_table
= ili9225_of_match
,
461 .id_table
= ili9225_id
,
462 .probe
= ili9225_probe
,
463 .remove
= ili9225_remove
,
464 .shutdown
= ili9225_shutdown
,
466 module_spi_driver(ili9225_spi_driver
);
468 MODULE_DESCRIPTION("Ilitek ILI9225 DRM driver");
469 MODULE_AUTHOR("David Lechner <david@lechnology.com>");
470 MODULE_LICENSE("GPL");