3  * MIPI Display Bus Interface (DBI) LCD controller support
44  * This library provides helpers for MIPI Display Bus Interface (DBI)
54  * There are 3 MIPI DBI implementation types:
104 static bool mipi_dbi_command_is_read(struct mipi_dbi *dbi, u8 cmd)  in mipi_dbi_command_is_read()  argument
108 	if (!dbi->read_commands)  in mipi_dbi_command_is_read()
112 		if (!dbi->read_commands[i])  in mipi_dbi_command_is_read()
114 		if (cmd == dbi->read_commands[i])  in mipi_dbi_command_is_read()
123  * @dbi: MIPI DBI structure
132 int mipi_dbi_command_read(struct mipi_dbi *dbi, u8 cmd, u8 *val)  in mipi_dbi_command_read()  argument
134 	if (!dbi->read_commands)  in mipi_dbi_command_read()
137 	if (!mipi_dbi_command_is_read(dbi, cmd))  in mipi_dbi_command_read()
140 	return mipi_dbi_command_buf(dbi, cmd, val, 1);  in mipi_dbi_command_read()
146  * @dbi: MIPI DBI structure
154 int mipi_dbi_command_buf(struct mipi_dbi *dbi, u8 cmd, u8 *data, size_t len)  in mipi_dbi_command_buf()  argument
164 	mutex_lock(&dbi->cmdlock);  in mipi_dbi_command_buf()
165 	ret = dbi->command(dbi, cmdbuf, data, len);  in mipi_dbi_command_buf()
166 	mutex_unlock(&dbi->cmdlock);  in mipi_dbi_command_buf()
175 int mipi_dbi_command_stackbuf(struct mipi_dbi *dbi, u8 cmd, const u8 *data,  in mipi_dbi_command_stackbuf()  argument
185 	ret = mipi_dbi_command_buf(dbi, cmd, buf, len);  in mipi_dbi_command_stackbuf()
255 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_set_window_address()  local
262 	mipi_dbi_command(dbi, MIPI_DCS_SET_COLUMN_ADDRESS, (xs >> 8) & 0xff,  in mipi_dbi_set_window_address()
264 	mipi_dbi_command(dbi, MIPI_DCS_SET_PAGE_ADDRESS, (ys >> 8) & 0xff,  in mipi_dbi_set_window_address()
275 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_fb_dirty()  local
276 	bool swap = dbi->swap_bytes;  in mipi_dbi_fb_dirty()
286 	if (!dbi->dc || !full || swap ||  in mipi_dbi_fb_dirty()
305 	ret = mipi_dbi_command_buf(dbi, MIPI_DCS_WRITE_MEMORY_START, tr, len);  in mipi_dbi_fb_dirty()
312  * mipi_dbi_pipe_mode_valid - MIPI DBI mode-valid helper
316  * This function validates a given display mode against the MIPI DBI's hardware
364  * mipi_dbi_enable_flush - MIPI DBI enable helper
365  * @dbidev: MIPI DBI device structure
406 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_blank()  local
416 	mipi_dbi_command_buf(dbi, MIPI_DCS_WRITE_MEMORY_START,  in mipi_dbi_blank()
423  * mipi_dbi_pipe_disable - MIPI DBI pipe disable helper
449  * mipi_dbi_pipe_begin_fb_access - MIPI DBI pipe begin-access helper
469  * mipi_dbi_pipe_end_fb_access - MIPI DBI pipe end-access helper
485  * mipi_dbi_pipe_reset_plane - MIPI DBI plane-reset helper
489  * for MIPI DBI planes.
498  * mipi_dbi_pipe_duplicate_plane_state - duplicates MIPI DBI plane state
502  * for MIPI DBI planes.
516  * mipi_dbi_pipe_destroy_plane_state - cleans up MIPI DBI plane state
521  * for MIPI DBI planes.
580  * mipi_dbi_dev_init_with_formats - MIPI DBI device initialization with custom formats
581  * @dbidev: MIPI DBI device structure to initialize
615 	if (!dbidev->dbi.command)  in mipi_dbi_dev_init_with_formats()
654 		dbidev->dbi.write_memory_bpw = 8;  in mipi_dbi_dev_init_with_formats()
663  * mipi_dbi_dev_init - MIPI DBI device initialization
664  * @dbidev: MIPI DBI device structure to initialize
695  * @dbi: MIPI DBI structure
699 void mipi_dbi_hw_reset(struct mipi_dbi *dbi)  in mipi_dbi_hw_reset()  argument
701 	if (!dbi->reset)  in mipi_dbi_hw_reset()
704 	gpiod_set_value_cansleep(dbi->reset, 0);  in mipi_dbi_hw_reset()
706 	gpiod_set_value_cansleep(dbi->reset, 1);  in mipi_dbi_hw_reset()
713  * @dbi: MIPI DBI structure
723 bool mipi_dbi_display_is_on(struct mipi_dbi *dbi)  in mipi_dbi_display_is_on()  argument
727 	if (mipi_dbi_command_read(dbi, MIPI_DCS_GET_POWER_MODE, &val))  in mipi_dbi_display_is_on()
746 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_poweron_reset_conditional()  local
767 	if (cond && mipi_dbi_display_is_on(dbi))  in mipi_dbi_poweron_reset_conditional()
770 	mipi_dbi_hw_reset(dbi);  in mipi_dbi_poweron_reset_conditional()
771 	ret = mipi_dbi_command(dbi, MIPI_DCS_SOFT_RESET);  in mipi_dbi_poweron_reset_conditional()
786 	if (dbi->reset)  in mipi_dbi_poweron_reset_conditional()
795  * mipi_dbi_poweron_reset - MIPI DBI poweron and reset
796  * @dbidev: MIPI DBI device structure
811  * mipi_dbi_poweron_conditional_reset - MIPI DBI poweron and conditional reset
812  * @dbidev: MIPI DBI device structure
849  * MIPI DBI Type C Option 1
866 static int mipi_dbi_spi1e_transfer(struct mipi_dbi *dbi, int dc,  in mipi_dbi_spi1e_transfer()  argument
871 	size_t chunk, max_chunk = dbi->tx_buf9_len;  in mipi_dbi_spi1e_transfer()
872 	struct spi_device *spi = dbi->spi;  in mipi_dbi_spi1e_transfer()
874 		.tx_buf = dbi->tx_buf9,  in mipi_dbi_spi1e_transfer()
894 		dst = dbi->tx_buf9;  in mipi_dbi_spi1e_transfer()
914 		dst = dbi->tx_buf9;  in mipi_dbi_spi1e_transfer()
984 static int mipi_dbi_spi1_transfer(struct mipi_dbi *dbi, int dc,  in mipi_dbi_spi1_transfer()  argument
988 	struct spi_device *spi = dbi->spi;  in mipi_dbi_spi1_transfer()
1000 		return mipi_dbi_spi1e_transfer(dbi, dc, buf, len, bpw);  in mipi_dbi_spi1_transfer()
1003 	max_chunk = dbi->tx_buf9_len;  in mipi_dbi_spi1_transfer()
1004 	dst16 = dbi->tx_buf9;  in mipi_dbi_spi1_transfer()
1047 static int mipi_dbi_typec1_command_read(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec1_command_read()  argument
1050 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec1_command_read()
1057 			.tx_buf = dbi->tx_buf9,  in mipi_dbi_typec1_command_read()
1088 	dst16 = dbi->tx_buf9;  in mipi_dbi_typec1_command_read()
1100 static int mipi_dbi_typec1_command(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec1_command()  argument
1106 	if (mipi_dbi_command_is_read(dbi, *cmd))  in mipi_dbi_typec1_command()
1107 		return mipi_dbi_typec1_command_read(dbi, cmd, parameters, num);  in mipi_dbi_typec1_command()
1111 	ret = mipi_dbi_spi1_transfer(dbi, 0, cmd, 1, 8);  in mipi_dbi_typec1_command()
1116 		bpw = dbi->write_memory_bpw;  in mipi_dbi_typec1_command()
1118 	return mipi_dbi_spi1_transfer(dbi, 1, parameters, num, bpw);  in mipi_dbi_typec1_command()
1121 /* MIPI DBI Type C Option 3 */
1123 static int mipi_dbi_typec3_command_read(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec3_command_read()  argument
1126 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec3_command_read()
1165 	gpiod_set_value_cansleep(dbi->dc, 0);  in mipi_dbi_typec3_command_read()
1190 static int mipi_dbi_typec3_command(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec3_command()  argument
1193 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec3_command()
1198 	if (mipi_dbi_command_is_read(dbi, *cmd))  in mipi_dbi_typec3_command()
1199 		return mipi_dbi_typec3_command_read(dbi, cmd, par, num);  in mipi_dbi_typec3_command()
1204 	gpiod_set_value_cansleep(dbi->dc, 0);  in mipi_dbi_typec3_command()
1212 		bpw = dbi->write_memory_bpw;  in mipi_dbi_typec3_command()
1215 	gpiod_set_value_cansleep(dbi->dc, 1);  in mipi_dbi_typec3_command()
1224  * mipi_dbi_spi_init - Initialize MIPI DBI SPI interface
1226  * @dbi: MIPI DBI structure to initialize
1237  * to be taken into account. The MIPI DBI serial interface is big endian and framebuffers are
1257 int mipi_dbi_spi_init(struct spi_device *spi, struct mipi_dbi *dbi,  in mipi_dbi_spi_init()  argument
1281 	dbi->spi = spi;  in mipi_dbi_spi_init()
1282 	dbi->read_commands = mipi_dbi_dcs_read_commands;  in mipi_dbi_spi_init()
1283 	dbi->write_memory_bpw = 16;  in mipi_dbi_spi_init()
1286 		dbi->command = mipi_dbi_typec3_command;  in mipi_dbi_spi_init()
1287 		dbi->dc = dc;  in mipi_dbi_spi_init()
1289 			dbi->write_memory_bpw = 8;  in mipi_dbi_spi_init()
1290 			dbi->swap_bytes = true;  in mipi_dbi_spi_init()
1293 		dbi->command = mipi_dbi_typec1_command;  in mipi_dbi_spi_init()
1294 		dbi->tx_buf9_len = SZ_16K;  in mipi_dbi_spi_init()
1295 		dbi->tx_buf9 = devm_kmalloc(dev, dbi->tx_buf9_len, GFP_KERNEL);  in mipi_dbi_spi_init()
1296 		if (!dbi->tx_buf9)  in mipi_dbi_spi_init()
1300 	mutex_init(&dbi->cmdlock);  in mipi_dbi_spi_init()
1414 	ret = mipi_dbi_command_buf(&dbidev->dbi, cmd, parameters, i);  in mipi_dbi_debugfs_command_write()
1427 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_debugfs_command_show()  local
1436 		if (!mipi_dbi_command_is_read(dbi, cmd))  in mipi_dbi_debugfs_command_show()
1456 		ret = mipi_dbi_command_buf(dbi, cmd, val, len);  in mipi_dbi_debugfs_command_show()
1499 	if (dbidev->dbi.read_commands)  in mipi_dbi_debugfs_init()
1508 MODULE_DESCRIPTION("MIPI Display Bus Interface (DBI) LCD controller support");