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()
241 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_set_window_address()  local
248 	mipi_dbi_command(dbi, MIPI_DCS_SET_COLUMN_ADDRESS, (xs >> 8) & 0xff,  in mipi_dbi_set_window_address()
250 	mipi_dbi_command(dbi, MIPI_DCS_SET_PAGE_ADDRESS, (ys >> 8) & 0xff,  in mipi_dbi_set_window_address()
260 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_fb_dirty()  local
261 	bool swap = dbi->swap_bytes;  in mipi_dbi_fb_dirty()
270 	if (!dbi->dc || !full || swap ||  in mipi_dbi_fb_dirty()
283 	ret = mipi_dbi_command_buf(dbi, MIPI_DCS_WRITE_MEMORY_START, tr,  in mipi_dbi_fb_dirty()
291  * mipi_dbi_pipe_mode_valid - MIPI DBI mode-valid helper
295  * This function validates a given display mode against the MIPI DBI's hardware
342  * mipi_dbi_enable_flush - MIPI DBI enable helper
343  * @dbidev: MIPI DBI device structure
383 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_blank()  local
393 	mipi_dbi_command_buf(dbi, MIPI_DCS_WRITE_MEMORY_START,  in mipi_dbi_blank()
400  * mipi_dbi_pipe_disable - MIPI DBI pipe disable helper
426  * mipi_dbi_pipe_begin_fb_access - MIPI DBI pipe begin-access helper
446  * mipi_dbi_pipe_end_fb_access - MIPI DBI pipe end-access helper
462  * mipi_dbi_pipe_reset_plane - MIPI DBI plane-reset helper
466  * for MIPI DBI planes.
475  * mipi_dbi_pipe_duplicate_plane_state - duplicates MIPI DBI plane state
479  * for MIPI DBI planes.
493  * mipi_dbi_pipe_destroy_plane_state - cleans up MIPI DBI plane state
498  * for MIPI DBI planes.
557  * mipi_dbi_dev_init_with_formats - MIPI DBI device initialization with custom formats
558  * @dbidev: MIPI DBI device structure to initialize
592 	if (!dbidev->dbi.command)  in mipi_dbi_dev_init_with_formats()
637  * mipi_dbi_dev_init - MIPI DBI device initialization
638  * @dbidev: MIPI DBI device structure to initialize
669  * @dbi: MIPI DBI structure
673 void mipi_dbi_hw_reset(struct mipi_dbi *dbi)  in mipi_dbi_hw_reset()  argument
675 	if (!dbi->reset)  in mipi_dbi_hw_reset()
678 	gpiod_set_value_cansleep(dbi->reset, 0);  in mipi_dbi_hw_reset()
680 	gpiod_set_value_cansleep(dbi->reset, 1);  in mipi_dbi_hw_reset()
687  * @dbi: MIPI DBI structure
697 bool mipi_dbi_display_is_on(struct mipi_dbi *dbi)  in mipi_dbi_display_is_on()  argument
701 	if (mipi_dbi_command_read(dbi, MIPI_DCS_GET_POWER_MODE, &val))  in mipi_dbi_display_is_on()
720 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_poweron_reset_conditional()  local
741 	if (cond && mipi_dbi_display_is_on(dbi))  in mipi_dbi_poweron_reset_conditional()
744 	mipi_dbi_hw_reset(dbi);  in mipi_dbi_poweron_reset_conditional()
745 	ret = mipi_dbi_command(dbi, MIPI_DCS_SOFT_RESET);  in mipi_dbi_poweron_reset_conditional()
760 	if (dbi->reset)  in mipi_dbi_poweron_reset_conditional()
769  * mipi_dbi_poweron_reset - MIPI DBI poweron and reset
770  * @dbidev: MIPI DBI device structure
785  * mipi_dbi_poweron_conditional_reset - MIPI DBI poweron and conditional reset
786  * @dbidev: MIPI DBI device structure
832  * MIPI DBI Type C Option 1
849 static int mipi_dbi_spi1e_transfer(struct mipi_dbi *dbi, int dc,  in mipi_dbi_spi1e_transfer()  argument
854 	size_t chunk, max_chunk = dbi->tx_buf9_len;  in mipi_dbi_spi1e_transfer()
855 	struct spi_device *spi = dbi->spi;  in mipi_dbi_spi1e_transfer()
857 		.tx_buf = dbi->tx_buf9,  in mipi_dbi_spi1e_transfer()
877 		dst = dbi->tx_buf9;  in mipi_dbi_spi1e_transfer()
897 		dst = dbi->tx_buf9;  in mipi_dbi_spi1e_transfer()
967 static int mipi_dbi_spi1_transfer(struct mipi_dbi *dbi, int dc,  in mipi_dbi_spi1_transfer()  argument
971 	struct spi_device *spi = dbi->spi;  in mipi_dbi_spi1_transfer()
983 		return mipi_dbi_spi1e_transfer(dbi, dc, buf, len, bpw);  in mipi_dbi_spi1_transfer()
986 	max_chunk = dbi->tx_buf9_len;  in mipi_dbi_spi1_transfer()
987 	dst16 = dbi->tx_buf9;  in mipi_dbi_spi1_transfer()
1030 static int mipi_dbi_typec1_command_read(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec1_command_read()  argument
1033 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec1_command_read()
1040 			.tx_buf = dbi->tx_buf9,  in mipi_dbi_typec1_command_read()
1071 	dst16 = dbi->tx_buf9;  in mipi_dbi_typec1_command_read()
1083 static int mipi_dbi_typec1_command(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec1_command()  argument
1089 	if (mipi_dbi_command_is_read(dbi, *cmd))  in mipi_dbi_typec1_command()
1090 		return mipi_dbi_typec1_command_read(dbi, cmd, parameters, num);  in mipi_dbi_typec1_command()
1094 	ret = mipi_dbi_spi1_transfer(dbi, 0, cmd, 1, 8);  in mipi_dbi_typec1_command()
1098 	return mipi_dbi_spi1_transfer(dbi, 1, parameters, num, bpw);  in mipi_dbi_typec1_command()
1101 /* MIPI DBI Type C Option 3 */
1103 static int mipi_dbi_typec3_command_read(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec3_command_read()  argument
1106 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec3_command_read()
1145 	gpiod_set_value_cansleep(dbi->dc, 0);  in mipi_dbi_typec3_command_read()
1170 static int mipi_dbi_typec3_command(struct mipi_dbi *dbi, u8 *cmd,  in mipi_dbi_typec3_command()  argument
1173 	struct spi_device *spi = dbi->spi;  in mipi_dbi_typec3_command()
1178 	if (mipi_dbi_command_is_read(dbi, *cmd))  in mipi_dbi_typec3_command()
1179 		return mipi_dbi_typec3_command_read(dbi, cmd, par, num);  in mipi_dbi_typec3_command()
1184 	gpiod_set_value_cansleep(dbi->dc, 0);  in mipi_dbi_typec3_command()
1191 	if (*cmd == MIPI_DCS_WRITE_MEMORY_START && !dbi->swap_bytes)  in mipi_dbi_typec3_command()
1195 	gpiod_set_value_cansleep(dbi->dc, 1);  in mipi_dbi_typec3_command()
1204  * mipi_dbi_spi_init - Initialize MIPI DBI SPI interface
1206  * @dbi: MIPI DBI structure to initialize
1225 int mipi_dbi_spi_init(struct spi_device *spi, struct mipi_dbi *dbi,  in mipi_dbi_spi_init()  argument
1249 	dbi->spi = spi;  in mipi_dbi_spi_init()
1250 	dbi->read_commands = mipi_dbi_dcs_read_commands;  in mipi_dbi_spi_init()
1253 		dbi->command = mipi_dbi_typec3_command;  in mipi_dbi_spi_init()
1254 		dbi->dc = dc;  in mipi_dbi_spi_init()
1256 			dbi->swap_bytes = true;  in mipi_dbi_spi_init()
1258 		dbi->command = mipi_dbi_typec1_command;  in mipi_dbi_spi_init()
1259 		dbi->tx_buf9_len = SZ_16K;  in mipi_dbi_spi_init()
1260 		dbi->tx_buf9 = devm_kmalloc(dev, dbi->tx_buf9_len, GFP_KERNEL);  in mipi_dbi_spi_init()
1261 		if (!dbi->tx_buf9)  in mipi_dbi_spi_init()
1265 	mutex_init(&dbi->cmdlock);  in mipi_dbi_spi_init()
1379 	ret = mipi_dbi_command_buf(&dbidev->dbi, cmd, parameters, i);  in mipi_dbi_debugfs_command_write()
1392 	struct mipi_dbi *dbi = &dbidev->dbi;  in mipi_dbi_debugfs_command_show()  local
1401 		if (!mipi_dbi_command_is_read(dbi, cmd))  in mipi_dbi_debugfs_command_show()
1421 		ret = mipi_dbi_command_buf(dbi, cmd, val, len);  in mipi_dbi_debugfs_command_show()
1464 	if (dbidev->dbi.read_commands)  in mipi_dbi_debugfs_init()