1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Mantix MLAF057WE51 5.7" MIPI-DSI panel driver
4  *
5  * Copyright (C) Purism SPC 2020
6  */
7 
8 #include <linux/backlight.h>
9 #include <linux/delay.h>
10 #include <linux/gpio/consumer.h>
11 #include <linux/media-bus-format.h>
12 #include <linux/module.h>
13 #include <linux/of_device.h>
14 #include <linux/regulator/consumer.h>
15 
16 #include <video/mipi_display.h>
17 
18 #include <drm/drm_mipi_dsi.h>
19 #include <drm/drm_modes.h>
20 #include <drm/drm_panel.h>
21 
22 #define DRV_NAME "panel-mantix-mlaf057we51"
23 
24 /* Manufacturer specific Commands send via DSI */
25 #define MANTIX_CMD_OTP_STOP_RELOAD_MIPI 0x41
26 #define MANTIX_CMD_INT_CANCEL           0x4C
27 #define MANTIX_CMD_SPI_FINISH           0x90
28 
29 struct mantix {
30 	struct device *dev;
31 	struct drm_panel panel;
32 
33 	struct gpio_desc *reset_gpio;
34 	struct gpio_desc *tp_rstn_gpio;
35 
36 	struct regulator *avdd;
37 	struct regulator *avee;
38 	struct regulator *vddi;
39 
40 	const struct drm_display_mode *default_mode;
41 };
42 
43 static inline struct mantix *panel_to_mantix(struct drm_panel *panel)
44 {
45 	return container_of(panel, struct mantix, panel);
46 }
47 
48 #define dsi_generic_write_seq(dsi, seq...) do {				\
49 		static const u8 d[] = { seq };				\
50 		int ret;						\
51 		ret = mipi_dsi_generic_write(dsi, d, ARRAY_SIZE(d));	\
52 		if (ret < 0)						\
53 			return ret;					\
54 	} while (0)
55 
56 static int mantix_init_sequence(struct mantix *ctx)
57 {
58 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(ctx->dev);
59 	struct device *dev = ctx->dev;
60 
61 	/*
62 	 * Init sequence was supplied by the panel vendor.
63 	 */
64 	dsi_generic_write_seq(dsi, MANTIX_CMD_OTP_STOP_RELOAD_MIPI, 0x5A);
65 
66 	dsi_generic_write_seq(dsi, MANTIX_CMD_INT_CANCEL, 0x03);
67 	dsi_generic_write_seq(dsi, MANTIX_CMD_OTP_STOP_RELOAD_MIPI, 0x5A, 0x03);
68 	dsi_generic_write_seq(dsi, 0x80, 0xA9, 0x00);
69 
70 	dsi_generic_write_seq(dsi, MANTIX_CMD_OTP_STOP_RELOAD_MIPI, 0x5A, 0x09);
71 	dsi_generic_write_seq(dsi, 0x80, 0x64, 0x00, 0x64, 0x00, 0x00);
72 	msleep(20);
73 
74 	dsi_generic_write_seq(dsi, MANTIX_CMD_SPI_FINISH, 0xA5);
75 	dsi_generic_write_seq(dsi, MANTIX_CMD_OTP_STOP_RELOAD_MIPI, 0x00, 0x2F);
76 	msleep(20);
77 
78 	dev_dbg(dev, "Panel init sequence done\n");
79 	return 0;
80 }
81 
82 static int mantix_enable(struct drm_panel *panel)
83 {
84 	struct mantix *ctx = panel_to_mantix(panel);
85 	struct device *dev = ctx->dev;
86 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
87 	int ret;
88 
89 	ret = mantix_init_sequence(ctx);
90 	if (ret < 0) {
91 		dev_err(ctx->dev, "Panel init sequence failed: %d\n", ret);
92 		return ret;
93 	}
94 
95 	ret = mipi_dsi_dcs_exit_sleep_mode(dsi);
96 	if (ret < 0) {
97 		dev_err(dev, "Failed to exit sleep mode\n");
98 		return ret;
99 	}
100 	msleep(20);
101 
102 	ret = mipi_dsi_dcs_set_display_on(dsi);
103 	if (ret)
104 		return ret;
105 	usleep_range(10000, 12000);
106 
107 	ret = mipi_dsi_turn_on_peripheral(dsi);
108 	if (ret < 0) {
109 		dev_err(dev, "Failed to turn on peripheral\n");
110 		return ret;
111 	}
112 
113 	return 0;
114 }
115 
116 static int mantix_disable(struct drm_panel *panel)
117 {
118 	struct mantix *ctx = panel_to_mantix(panel);
119 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(ctx->dev);
120 	int ret;
121 
122 	ret = mipi_dsi_dcs_set_display_off(dsi);
123 	if (ret < 0)
124 		dev_err(ctx->dev, "Failed to turn off the display: %d\n", ret);
125 
126 	ret = mipi_dsi_dcs_enter_sleep_mode(dsi);
127 	if (ret < 0)
128 		dev_err(ctx->dev, "Failed to enter sleep mode: %d\n", ret);
129 
130 
131 	return 0;
132 }
133 
134 static int mantix_unprepare(struct drm_panel *panel)
135 {
136 	struct mantix *ctx = panel_to_mantix(panel);
137 
138 	gpiod_set_value_cansleep(ctx->tp_rstn_gpio, 1);
139 	usleep_range(5000, 6000);
140 	gpiod_set_value_cansleep(ctx->reset_gpio, 1);
141 
142 	regulator_disable(ctx->avee);
143 	regulator_disable(ctx->avdd);
144 	/* T11 */
145 	usleep_range(5000, 6000);
146 	regulator_disable(ctx->vddi);
147 	/* T14 */
148 	msleep(50);
149 
150 	return 0;
151 }
152 
153 static int mantix_prepare(struct drm_panel *panel)
154 {
155 	struct mantix *ctx = panel_to_mantix(panel);
156 	int ret;
157 
158 	/* Focaltech FT8006P, section 7.3.1 and 7.3.4 */
159 	dev_dbg(ctx->dev, "Resetting the panel\n");
160 	ret = regulator_enable(ctx->vddi);
161 	if (ret < 0) {
162 		dev_err(ctx->dev, "Failed to enable vddi supply: %d\n", ret);
163 		return ret;
164 	}
165 
166 	/* T1 + T2 */
167 	usleep_range(8000, 10000);
168 
169 	ret = regulator_enable(ctx->avdd);
170 	if (ret < 0) {
171 		dev_err(ctx->dev, "Failed to enable avdd supply: %d\n", ret);
172 		return ret;
173 	}
174 
175 	/* T2d */
176 	usleep_range(3500, 4000);
177 	ret = regulator_enable(ctx->avee);
178 	if (ret < 0) {
179 		dev_err(ctx->dev, "Failed to enable avee supply: %d\n", ret);
180 		return ret;
181 	}
182 
183 	/* T3 + T4 + time for voltage to become stable: */
184 	usleep_range(6000, 7000);
185 	gpiod_set_value_cansleep(ctx->reset_gpio, 0);
186 	gpiod_set_value_cansleep(ctx->tp_rstn_gpio, 0);
187 
188 	/* T6 */
189 	msleep(50);
190 
191 	return 0;
192 }
193 
194 static const struct drm_display_mode default_mode_mantix = {
195 	.hdisplay    = 720,
196 	.hsync_start = 720 + 45,
197 	.hsync_end   = 720 + 45 + 14,
198 	.htotal	     = 720 + 45 + 14 + 25,
199 	.vdisplay    = 1440,
200 	.vsync_start = 1440 + 130,
201 	.vsync_end   = 1440 + 130 + 8,
202 	.vtotal	     = 1440 + 130 + 8 + 106,
203 	.clock	     = 85298,
204 	.flags	     = DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC,
205 	.width_mm    = 65,
206 	.height_mm   = 130,
207 };
208 
209 static const struct drm_display_mode default_mode_ys = {
210 	.hdisplay    = 720,
211 	.hsync_start = 720 + 45,
212 	.hsync_end   = 720 + 45 + 14,
213 	.htotal	     = 720 + 45 + 14 + 25,
214 	.vdisplay    = 1440,
215 	.vsync_start = 1440 + 175,
216 	.vsync_end   = 1440 + 175 + 8,
217 	.vtotal	     = 1440 + 175 + 8 + 50,
218 	.clock	     = 85298,
219 	.flags	     = DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC,
220 	.width_mm    = 65,
221 	.height_mm   = 130,
222 };
223 
224 static const u32 mantix_bus_formats[] = {
225 	MEDIA_BUS_FMT_RGB888_1X24,
226 };
227 
228 static int mantix_get_modes(struct drm_panel *panel,
229 			    struct drm_connector *connector)
230 {
231 	struct mantix *ctx = panel_to_mantix(panel);
232 	struct drm_display_mode *mode;
233 
234 	mode = drm_mode_duplicate(connector->dev, ctx->default_mode);
235 	if (!mode) {
236 		dev_err(ctx->dev, "Failed to add mode %ux%u@%u\n",
237 			ctx->default_mode->hdisplay, ctx->default_mode->vdisplay,
238 			drm_mode_vrefresh(ctx->default_mode));
239 		return -ENOMEM;
240 	}
241 
242 	drm_mode_set_name(mode);
243 
244 	mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED;
245 	connector->display_info.width_mm = mode->width_mm;
246 	connector->display_info.height_mm = mode->height_mm;
247 	drm_mode_probed_add(connector, mode);
248 
249 	drm_display_info_set_bus_formats(&connector->display_info,
250 					 mantix_bus_formats,
251 					 ARRAY_SIZE(mantix_bus_formats));
252 
253 	return 1;
254 }
255 
256 static const struct drm_panel_funcs mantix_drm_funcs = {
257 	.disable   = mantix_disable,
258 	.unprepare = mantix_unprepare,
259 	.prepare   = mantix_prepare,
260 	.enable	   = mantix_enable,
261 	.get_modes = mantix_get_modes,
262 };
263 
264 static int mantix_probe(struct mipi_dsi_device *dsi)
265 {
266 	struct device *dev = &dsi->dev;
267 	struct mantix *ctx;
268 	int ret;
269 
270 	ctx = devm_kzalloc(dev, sizeof(*ctx), GFP_KERNEL);
271 	if (!ctx)
272 		return -ENOMEM;
273 	ctx->default_mode = of_device_get_match_data(dev);
274 
275 	ctx->reset_gpio = devm_gpiod_get(dev, "reset", GPIOD_OUT_HIGH);
276 	if (IS_ERR(ctx->reset_gpio)) {
277 		dev_err(dev, "cannot get reset gpio\n");
278 		return PTR_ERR(ctx->reset_gpio);
279 	}
280 
281 	ctx->tp_rstn_gpio = devm_gpiod_get(dev, "mantix,tp-rstn", GPIOD_OUT_HIGH);
282 	if (IS_ERR(ctx->tp_rstn_gpio)) {
283 		dev_err(dev, "cannot get tp-rstn gpio\n");
284 		return PTR_ERR(ctx->tp_rstn_gpio);
285 	}
286 
287 	mipi_dsi_set_drvdata(dsi, ctx);
288 	ctx->dev = dev;
289 
290 	dsi->lanes = 4;
291 	dsi->format = MIPI_DSI_FMT_RGB888;
292 	dsi->mode_flags = MIPI_DSI_MODE_VIDEO |
293 		MIPI_DSI_MODE_VIDEO_BURST | MIPI_DSI_MODE_VIDEO_SYNC_PULSE;
294 
295 	ctx->avdd = devm_regulator_get(dev, "avdd");
296 	if (IS_ERR(ctx->avdd))
297 		return dev_err_probe(dev, PTR_ERR(ctx->avdd), "Failed to request avdd regulator\n");
298 
299 	ctx->avee = devm_regulator_get(dev, "avee");
300 	if (IS_ERR(ctx->avee))
301 		return dev_err_probe(dev, PTR_ERR(ctx->avee), "Failed to request avee regulator\n");
302 
303 	ctx->vddi = devm_regulator_get(dev, "vddi");
304 	if (IS_ERR(ctx->vddi))
305 		return dev_err_probe(dev, PTR_ERR(ctx->vddi), "Failed to request vddi regulator\n");
306 
307 	drm_panel_init(&ctx->panel, dev, &mantix_drm_funcs,
308 		       DRM_MODE_CONNECTOR_DSI);
309 
310 	ret = drm_panel_of_backlight(&ctx->panel);
311 	if (ret)
312 		return ret;
313 
314 	drm_panel_add(&ctx->panel);
315 
316 	ret = mipi_dsi_attach(dsi);
317 	if (ret < 0) {
318 		dev_err(dev, "mipi_dsi_attach failed (%d). Is host ready?\n", ret);
319 		drm_panel_remove(&ctx->panel);
320 		return ret;
321 	}
322 
323 	dev_info(dev, "%ux%u@%u %ubpp dsi %udl - ready\n",
324 		 ctx->default_mode->hdisplay, ctx->default_mode->vdisplay,
325 		 drm_mode_vrefresh(ctx->default_mode),
326 		 mipi_dsi_pixel_format_to_bpp(dsi->format), dsi->lanes);
327 
328 	return 0;
329 }
330 
331 static void mantix_shutdown(struct mipi_dsi_device *dsi)
332 {
333 	struct mantix *ctx = mipi_dsi_get_drvdata(dsi);
334 
335 	drm_panel_unprepare(&ctx->panel);
336 	drm_panel_disable(&ctx->panel);
337 }
338 
339 static void mantix_remove(struct mipi_dsi_device *dsi)
340 {
341 	struct mantix *ctx = mipi_dsi_get_drvdata(dsi);
342 
343 	mantix_shutdown(dsi);
344 
345 	mipi_dsi_detach(dsi);
346 	drm_panel_remove(&ctx->panel);
347 }
348 
349 static const struct of_device_id mantix_of_match[] = {
350 	{ .compatible = "mantix,mlaf057we51-x", .data = &default_mode_mantix },
351 	{ .compatible = "ys,ys57pss36bh5gq", .data = &default_mode_ys },
352 	{ /* sentinel */ }
353 };
354 MODULE_DEVICE_TABLE(of, mantix_of_match);
355 
356 static struct mipi_dsi_driver mantix_driver = {
357 	.probe	= mantix_probe,
358 	.remove = mantix_remove,
359 	.shutdown = mantix_shutdown,
360 	.driver = {
361 		.name = DRV_NAME,
362 		.of_match_table = mantix_of_match,
363 	},
364 };
365 module_mipi_dsi_driver(mantix_driver);
366 
367 MODULE_AUTHOR("Guido Günther <agx@sigxcpu.org>");
368 MODULE_DESCRIPTION("DRM driver for Mantix MLAF057WE51-X MIPI DSI panel");
369 MODULE_LICENSE("GPL v2");
370