xref: /openbmc/linux/drivers/gpu/drm/tiny/ili9225.c (revision 0889d07f)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * DRM driver for Ilitek ILI9225 panels
4  *
5  * Copyright 2017 David Lechner <david@lechnology.com>
6  *
7  * Some code copied from mipi-dbi.c
8  * Copyright 2016 Noralf Trønnes
9  */
10 
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>
18 
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>
30 
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
70 
71 static inline int ili9225_command(struct mipi_dbi *dbi, u8 cmd, u16 data)
72 {
73 	u8 par[2] = { data >> 8, data & 0xff };
74 
75 	return mipi_dbi_command_buf(dbi, cmd, par, 2);
76 }
77 
78 static void ili9225_fb_dirty(struct drm_framebuffer *fb, struct drm_rect *rect)
79 {
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;
86 	u16 x_start, y_start;
87 	u16 x1, x2, y1, y2;
88 	int idx, ret = 0;
89 	bool full;
90 	void *tr;
91 
92 	if (!dbidev->enabled)
93 		return;
94 
95 	if (!drm_dev_enter(fb->dev, &idx))
96 		return;
97 
98 	full = width == fb->width && height == fb->height;
99 
100 	DRM_DEBUG_KMS("Flushing [FB:%d] " DRM_RECT_FMT "\n", fb->base.id, DRM_RECT_ARG(rect));
101 
102 	if (!dbi->dc || !full || swap ||
103 	    fb->format->format == DRM_FORMAT_XRGB8888) {
104 		tr = dbidev->tx_buf;
105 		ret = mipi_dbi_buf_copy(dbidev->tx_buf, fb, rect, swap);
106 		if (ret)
107 			goto err_msg;
108 	} else {
109 		tr = cma_obj->vaddr;
110 	}
111 
112 	switch (dbidev->rotation) {
113 	default:
114 		x1 = rect->x1;
115 		x2 = rect->x2 - 1;
116 		y1 = rect->y1;
117 		y2 = rect->y2 - 1;
118 		x_start = x1;
119 		y_start = y1;
120 		break;
121 	case 90:
122 		x1 = rect->y1;
123 		x2 = rect->y2 - 1;
124 		y1 = fb->width - rect->x2;
125 		y2 = fb->width - rect->x1 - 1;
126 		x_start = x1;
127 		y_start = y2;
128 		break;
129 	case 180:
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;
134 		x_start = x2;
135 		y_start = y2;
136 		break;
137 	case 270:
138 		x1 = fb->height - rect->y2;
139 		x2 = fb->height - rect->y1 - 1;
140 		y1 = rect->x1;
141 		y2 = rect->x2 - 1;
142 		x_start = x2;
143 		y_start = y1;
144 		break;
145 	}
146 
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);
151 
152 	ili9225_command(dbi, ILI9225_RAM_ADDRESS_SET_1, x_start);
153 	ili9225_command(dbi, ILI9225_RAM_ADDRESS_SET_2, y_start);
154 
155 	ret = mipi_dbi_command_buf(dbi, ILI9225_WRITE_DATA_TO_GRAM, tr,
156 				   width * height * 2);
157 err_msg:
158 	if (ret)
159 		dev_err_once(fb->dev->dev, "Failed to update display %d\n", ret);
160 
161 	drm_dev_exit(idx);
162 }
163 
164 static void ili9225_pipe_update(struct drm_simple_display_pipe *pipe,
165 				struct drm_plane_state *old_state)
166 {
167 	struct drm_plane_state *state = pipe->plane.state;
168 	struct drm_crtc *crtc = &pipe->crtc;
169 	struct drm_rect rect;
170 
171 	if (drm_atomic_helper_damage_merged(old_state, state, &rect))
172 		ili9225_fb_dirty(state->fb, &rect);
173 
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;
179 	}
180 }
181 
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)
185 {
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 = {
191 		.x1 = 0,
192 		.x2 = fb->width,
193 		.y1 = 0,
194 		.y2 = fb->height,
195 	};
196 	int ret, idx;
197 	u8 am_id;
198 
199 	if (!drm_dev_enter(pipe->crtc.dev, &idx))
200 		return;
201 
202 	DRM_DEBUG_KMS("\n");
203 
204 	mipi_dbi_hw_reset(dbi);
205 
206 	/*
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
210 	 */
211 
212 	ret = ili9225_command(dbi, ILI9225_POWER_CONTROL_1, 0x0000);
213 	if (ret) {
214 		DRM_DEV_ERROR(dev, "Error sending command %d\n", ret);
215 		goto out_exit;
216 	}
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);
221 
222 	msleep(40);
223 
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);
229 
230 	msleep(10);
231 
232 	ili9225_command(dbi, ILI9225_POWER_CONTROL_2, 0x103b);
233 
234 	msleep(50);
235 
236 	switch (dbidev->rotation) {
237 	default:
238 		am_id = 0x30;
239 		break;
240 	case 90:
241 		am_id = 0x18;
242 		break;
243 	case 180:
244 		am_id = 0x00;
245 		break;
246 	case 270:
247 		am_id = 0x28;
248 		break;
249 	}
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);
261 
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);
268 
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);
279 
280 	ili9225_command(dbi, ILI9225_DISPLAY_CONTROL_1, 0x0012);
281 
282 	msleep(50);
283 
284 	ili9225_command(dbi, ILI9225_DISPLAY_CONTROL_1, 0x1017);
285 
286 	dbidev->enabled = true;
287 	ili9225_fb_dirty(fb, &rect);
288 out_exit:
289 	drm_dev_exit(idx);
290 }
291 
292 static void ili9225_pipe_disable(struct drm_simple_display_pipe *pipe)
293 {
294 	struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
295 	struct mipi_dbi *dbi = &dbidev->dbi;
296 
297 	DRM_DEBUG_KMS("\n");
298 
299 	/*
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
303 	 * unplug.
304 	 */
305 
306 	if (!dbidev->enabled)
307 		return;
308 
309 	ili9225_command(dbi, ILI9225_DISPLAY_CONTROL_1, 0x0000);
310 	msleep(50);
311 	ili9225_command(dbi, ILI9225_POWER_CONTROL_2, 0x0007);
312 	msleep(50);
313 	ili9225_command(dbi, ILI9225_POWER_CONTROL_1, 0x0a02);
314 
315 	dbidev->enabled = false;
316 }
317 
318 static int ili9225_dbi_command(struct mipi_dbi *dbi, u8 *cmd, u8 *par,
319 			       size_t num)
320 {
321 	struct spi_device *spi = dbi->spi;
322 	unsigned int bpw = 8;
323 	u32 speed_hz;
324 	int ret;
325 
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);
329 	if (ret || !num)
330 		return ret;
331 
332 	if (*cmd == ILI9225_WRITE_DATA_TO_GRAM && !dbi->swap_bytes)
333 		bpw = 16;
334 
335 	gpiod_set_value_cansleep(dbi->dc, 1);
336 	speed_hz = mipi_dbi_spi_cmd_max_speed(spi, num);
337 
338 	return mipi_dbi_spi_transfer(spi, speed_hz, bpw, par, num);
339 }
340 
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,
346 };
347 
348 static const struct drm_display_mode ili9225_mode = {
349 	DRM_SIMPLE_MODE(176, 220, 35, 44),
350 };
351 
352 DEFINE_DRM_GEM_CMA_FOPS(ili9225_fops);
353 
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,
359 	.name			= "ili9225",
360 	.desc			= "Ilitek ILI9225",
361 	.date			= "20171106",
362 	.major			= 1,
363 	.minor			= 0,
364 };
365 
366 static const struct of_device_id ili9225_of_match[] = {
367 	{ .compatible = "vot,v220hf01a-t" },
368 	{},
369 };
370 MODULE_DEVICE_TABLE(of, ili9225_of_match);
371 
372 static const struct spi_device_id ili9225_id[] = {
373 	{ "v220hf01a-t", 0 },
374 	{ },
375 };
376 MODULE_DEVICE_TABLE(spi, ili9225_id);
377 
378 static int ili9225_probe(struct spi_device *spi)
379 {
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;
385 	u32 rotation = 0;
386 	int ret;
387 
388 	dbidev = kzalloc(sizeof(*dbidev), GFP_KERNEL);
389 	if (!dbidev)
390 		return -ENOMEM;
391 
392 	dbi = &dbidev->dbi;
393 	drm = &dbidev->drm;
394 	ret = devm_drm_dev_init(dev, drm, &ili9225_driver);
395 	if (ret) {
396 		kfree(dbidev);
397 		return ret;
398 	}
399 
400 	drm_mode_config_init(drm);
401 
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);
406 	}
407 
408 	rs = devm_gpiod_get(dev, "rs", GPIOD_OUT_LOW);
409 	if (IS_ERR(rs)) {
410 		DRM_DEV_ERROR(dev, "Failed to get gpio 'rs'\n");
411 		return PTR_ERR(rs);
412 	}
413 
414 	device_property_read_u32(dev, "rotation", &rotation);
415 
416 	ret = mipi_dbi_spi_init(spi, dbi, rs);
417 	if (ret)
418 		return ret;
419 
420 	/* override the command function set in  mipi_dbi_spi_init() */
421 	dbi->command = ili9225_dbi_command;
422 
423 	ret = mipi_dbi_dev_init(dbidev, &ili9225_pipe_funcs, &ili9225_mode, rotation);
424 	if (ret)
425 		return ret;
426 
427 	drm_mode_config_reset(drm);
428 
429 	ret = drm_dev_register(drm, 0);
430 	if (ret)
431 		return ret;
432 
433 	spi_set_drvdata(spi, drm);
434 
435 	drm_fbdev_generic_setup(drm, 0);
436 
437 	return 0;
438 }
439 
440 static int ili9225_remove(struct spi_device *spi)
441 {
442 	struct drm_device *drm = spi_get_drvdata(spi);
443 
444 	drm_dev_unplug(drm);
445 	drm_atomic_helper_shutdown(drm);
446 
447 	return 0;
448 }
449 
450 static void ili9225_shutdown(struct spi_device *spi)
451 {
452 	drm_atomic_helper_shutdown(spi_get_drvdata(spi));
453 }
454 
455 static struct spi_driver ili9225_spi_driver = {
456 	.driver = {
457 		.name = "ili9225",
458 		.owner = THIS_MODULE,
459 		.of_match_table = ili9225_of_match,
460 	},
461 	.id_table = ili9225_id,
462 	.probe = ili9225_probe,
463 	.remove = ili9225_remove,
464 	.shutdown = ili9225_shutdown,
465 };
466 module_spi_driver(ili9225_spi_driver);
467 
468 MODULE_DESCRIPTION("Ilitek ILI9225 DRM driver");
469 MODULE_AUTHOR("David Lechner <david@lechnology.com>");
470 MODULE_LICENSE("GPL");
471