2  * MIPI DSI Bus
41  * DOC: dsi helpers
43  * These functions contain some common logic and helpers to deal with MIPI DSI
46  * Helpers are provided for a number of standard MIPI DSI command as well as a
52 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_device_match()  local
58 	/* compare DSI device and driver names */  in mipi_dsi_device_match()
59 	if (!strcmp(dsi->name, drv->name))  in mipi_dsi_device_match()
67 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_uevent()  local
75 		       dsi->name);  in mipi_dsi_uevent()
92 	.name = "mipi-dsi",
99  * of_find_mipi_dsi_device_by_node() - find the MIPI DSI device matching a
103  * Return: A pointer to the MIPI DSI device corresponding to @np or NULL if no
118 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_dev_release()  local
121 	kfree(dsi);  in mipi_dsi_dev_release()
130 	struct mipi_dsi_device *dsi;  in mipi_dsi_device_alloc()  local
132 	dsi = kzalloc(sizeof(*dsi), GFP_KERNEL);  in mipi_dsi_device_alloc()
133 	if (!dsi)  in mipi_dsi_device_alloc()
136 	dsi->host = host;  in mipi_dsi_device_alloc()
137 	dsi->dev.bus = &mipi_dsi_bus_type;  in mipi_dsi_device_alloc()
138 	dsi->dev.parent = host->dev;  in mipi_dsi_device_alloc()
139 	dsi->dev.type = &mipi_dsi_device_type;  in mipi_dsi_device_alloc()
141 	device_initialize(&dsi->dev);  in mipi_dsi_device_alloc()
143 	return dsi;  in mipi_dsi_device_alloc()
146 static int mipi_dsi_device_add(struct mipi_dsi_device *dsi)  in mipi_dsi_device_add()  argument
148 	struct mipi_dsi_host *host = dsi->host;  in mipi_dsi_device_add()
150 	dev_set_name(&dsi->dev, "%s.%d", dev_name(host->dev),  dsi->channel);  in mipi_dsi_device_add()
152 	return device_add(&dsi->dev);  in mipi_dsi_device_add()
189  * mipi_dsi_device_register_full - create a MIPI DSI device
190  * @host: DSI host to which this device is connected
191  * @info: pointer to template containing DSI device information
193  * Create a MIPI DSI device by using the device information provided by
197  * A pointer to the newly created MIPI DSI device, or, a pointer encoded
204 	struct mipi_dsi_device *dsi;  in mipi_dsi_device_register_full()  local
217 	dsi = mipi_dsi_device_alloc(host);  in mipi_dsi_device_register_full()
218 	if (IS_ERR(dsi)) {  in mipi_dsi_device_register_full()
219 		drm_err(host, "failed to allocate DSI device %ld\n",  in mipi_dsi_device_register_full()
220 			PTR_ERR(dsi));  in mipi_dsi_device_register_full()
221 		return dsi;  in mipi_dsi_device_register_full()
224 	dsi->dev.of_node = info->node;  in mipi_dsi_device_register_full()
225 	dsi->channel = info->channel;  in mipi_dsi_device_register_full()
226 	strlcpy(dsi->name, info->type, sizeof(dsi->name));  in mipi_dsi_device_register_full()
228 	ret = mipi_dsi_device_add(dsi);  in mipi_dsi_device_register_full()
230 		drm_err(host, "failed to add DSI device %d\n", ret);  in mipi_dsi_device_register_full()
231 		kfree(dsi);  in mipi_dsi_device_register_full()
235 	return dsi;  in mipi_dsi_device_register_full()
240  * mipi_dsi_device_unregister - unregister MIPI DSI device
241  * @dsi: DSI peripheral device
243 void mipi_dsi_device_unregister(struct mipi_dsi_device *dsi)  in mipi_dsi_device_unregister()  argument
245 	device_unregister(&dsi->dev);  in mipi_dsi_device_unregister()
253  * of_find_mipi_dsi_host_by_node() - find the MIPI DSI host matching a
258  * A pointer to the MIPI DSI host corresponding to @node or NULL if no
301 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_remove_device_fn()  local
303 	mipi_dsi_detach(dsi);  in mipi_dsi_remove_device_fn()
304 	mipi_dsi_device_unregister(dsi);  in mipi_dsi_remove_device_fn()
320  * mipi_dsi_attach - attach a DSI device to its DSI host
321  * @dsi: DSI peripheral
323 int mipi_dsi_attach(struct mipi_dsi_device *dsi)  in mipi_dsi_attach()  argument
325 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_attach()
330 	return ops->attach(dsi->host, dsi);  in mipi_dsi_attach()
335  * mipi_dsi_detach - detach a DSI device from its DSI host
336  * @dsi: DSI peripheral
338 int mipi_dsi_detach(struct mipi_dsi_device *dsi)  in mipi_dsi_detach()  argument
340 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_detach()
345 	return ops->detach(dsi->host, dsi);  in mipi_dsi_detach()
349 static ssize_t mipi_dsi_device_transfer(struct mipi_dsi_device *dsi,  in mipi_dsi_device_transfer()  argument
352 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_device_transfer()
357 	if (dsi->mode_flags & MIPI_DSI_MODE_LPM)  in mipi_dsi_device_transfer()
361 	return ops->transfer(dsi->host, msg);  in mipi_dsi_device_transfer()
366  * @type: MIPI DSI data type of the packet
404  * @type: MIPI DSI data type of the packet
437  *     DSI protocol
438  * @packet: pointer to a DSI packet structure
490  * @dsi: DSI peripheral device
494 int mipi_dsi_shutdown_peripheral(struct mipi_dsi_device *dsi)  in mipi_dsi_shutdown_peripheral()  argument
497 		.channel = dsi->channel,  in mipi_dsi_shutdown_peripheral()
502 	int ret = mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_shutdown_peripheral()
510  * @dsi: DSI peripheral device
514 int mipi_dsi_turn_on_peripheral(struct mipi_dsi_device *dsi)  in mipi_dsi_turn_on_peripheral()  argument
517 		.channel = dsi->channel,  in mipi_dsi_turn_on_peripheral()
522 	int ret = mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_turn_on_peripheral()
532  * @dsi: DSI peripheral device
537 int mipi_dsi_set_maximum_return_packet_size(struct mipi_dsi_device *dsi,  in mipi_dsi_set_maximum_return_packet_size()  argument
542 		.channel = dsi->channel,  in mipi_dsi_set_maximum_return_packet_size()
547 	int ret = mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_set_maximum_return_packet_size()
555  * @dsi: DSI peripheral device
563 ssize_t mipi_dsi_compression_mode(struct mipi_dsi_device *dsi, bool enable)  in mipi_dsi_compression_mode()  argument
568 		.channel = dsi->channel,  in mipi_dsi_compression_mode()
573 	int ret = mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_compression_mode()
581  * @dsi: DSI peripheral device
588 ssize_t mipi_dsi_picture_parameter_set(struct mipi_dsi_device *dsi,  in mipi_dsi_picture_parameter_set()  argument
592 		.channel = dsi->channel,  in mipi_dsi_picture_parameter_set()
597 	int ret = mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_picture_parameter_set()
605  * @dsi: DSI peripheral device
615 ssize_t mipi_dsi_generic_write(struct mipi_dsi_device *dsi, const void *payload,  in mipi_dsi_generic_write()  argument
619 		.channel = dsi->channel,  in mipi_dsi_generic_write()
642 	return mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_generic_write()
648  * @dsi: DSI peripheral device
660 ssize_t mipi_dsi_generic_read(struct mipi_dsi_device *dsi, const void *params,  in mipi_dsi_generic_read()  argument
664 		.channel = dsi->channel,  in mipi_dsi_generic_read()
688 	return mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_generic_read()
694  * @dsi: DSI peripheral device
704 ssize_t mipi_dsi_dcs_write_buffer(struct mipi_dsi_device *dsi,  in mipi_dsi_dcs_write_buffer()  argument
708 		.channel = dsi->channel,  in mipi_dsi_dcs_write_buffer()
730 	return mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_dcs_write_buffer()
736  * @dsi: DSI peripheral device
747 ssize_t mipi_dsi_dcs_write(struct mipi_dsi_device *dsi, u8 cmd,  in mipi_dsi_dcs_write()  argument
769 	err = mipi_dsi_dcs_write_buffer(dsi, tx, size);  in mipi_dsi_dcs_write()
780  * @dsi: DSI peripheral device
787 ssize_t mipi_dsi_dcs_read(struct mipi_dsi_device *dsi, u8 cmd, void *data,  in mipi_dsi_dcs_read()  argument
791 		.channel = dsi->channel,  in mipi_dsi_dcs_read()
799 	return mipi_dsi_device_transfer(dsi, &msg);  in mipi_dsi_dcs_read()
805  * @dsi: DSI peripheral device
809 int mipi_dsi_dcs_nop(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_nop()  argument
813 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_NOP, NULL, 0);  in mipi_dsi_dcs_nop()
823  * @dsi: DSI peripheral device
827 int mipi_dsi_dcs_soft_reset(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_soft_reset()  argument
831 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SOFT_RESET, NULL, 0);  in mipi_dsi_dcs_soft_reset()
842  * @dsi: DSI peripheral device
847 int mipi_dsi_dcs_get_power_mode(struct mipi_dsi_device *dsi, u8 *mode)  in mipi_dsi_dcs_get_power_mode()  argument
851 	err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_POWER_MODE, mode,  in mipi_dsi_dcs_get_power_mode()
867  * @dsi: DSI peripheral device
872 int mipi_dsi_dcs_get_pixel_format(struct mipi_dsi_device *dsi, u8 *format)  in mipi_dsi_dcs_get_pixel_format()  argument
876 	err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_PIXEL_FORMAT, format,  in mipi_dsi_dcs_get_pixel_format()
892  * @dsi: DSI peripheral device
896 int mipi_dsi_dcs_enter_sleep_mode(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_enter_sleep_mode()  argument
900 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_ENTER_SLEEP_MODE, NULL, 0);  in mipi_dsi_dcs_enter_sleep_mode()
911  * @dsi: DSI peripheral device
915 int mipi_dsi_dcs_exit_sleep_mode(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_exit_sleep_mode()  argument
919 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_EXIT_SLEEP_MODE, NULL, 0);  in mipi_dsi_dcs_exit_sleep_mode()
930  * @dsi: DSI peripheral device
934 int mipi_dsi_dcs_set_display_off(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_set_display_off()  argument
938 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_OFF, NULL, 0);  in mipi_dsi_dcs_set_display_off()
949  * @dsi: DSI peripheral device
953 int mipi_dsi_dcs_set_display_on(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_set_display_on()  argument
957 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_ON, NULL, 0);  in mipi_dsi_dcs_set_display_on()
968  * @dsi: DSI peripheral device
974 int mipi_dsi_dcs_set_column_address(struct mipi_dsi_device *dsi, u16 start,  in mipi_dsi_dcs_set_column_address()  argument
980 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_COLUMN_ADDRESS, payload,  in mipi_dsi_dcs_set_column_address()
992  * @dsi: DSI peripheral device
998 int mipi_dsi_dcs_set_page_address(struct mipi_dsi_device *dsi, u16 start,  in mipi_dsi_dcs_set_page_address()  argument
1004 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_PAGE_ADDRESS, payload,  in mipi_dsi_dcs_set_page_address()
1016  * @dsi: DSI peripheral device
1020 int mipi_dsi_dcs_set_tear_off(struct mipi_dsi_device *dsi)  in mipi_dsi_dcs_set_tear_off()  argument
1024 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_TEAR_OFF, NULL, 0);  in mipi_dsi_dcs_set_tear_off()
1035  * @dsi: DSI peripheral device
1040 int mipi_dsi_dcs_set_tear_on(struct mipi_dsi_device *dsi,  in mipi_dsi_dcs_set_tear_on()  argument
1046 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_TEAR_ON, &value,  in mipi_dsi_dcs_set_tear_on()
1058  * @dsi: DSI peripheral device
1063 int mipi_dsi_dcs_set_pixel_format(struct mipi_dsi_device *dsi, u8 format)  in mipi_dsi_dcs_set_pixel_format()  argument
1067 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_PIXEL_FORMAT, &format,  in mipi_dsi_dcs_set_pixel_format()
1079  * @dsi: DSI peripheral device
1084 int mipi_dsi_dcs_set_tear_scanline(struct mipi_dsi_device *dsi, u16 scanline)  in mipi_dsi_dcs_set_tear_scanline()  argument
1089 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_TEAR_SCANLINE, payload,  in mipi_dsi_dcs_set_tear_scanline()
1101  * @dsi: DSI peripheral device
1106 int mipi_dsi_dcs_set_display_brightness(struct mipi_dsi_device *dsi,  in mipi_dsi_dcs_set_display_brightness()  argument
1112 	err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_BRIGHTNESS,  in mipi_dsi_dcs_set_display_brightness()
1124  * @dsi: DSI peripheral device
1129 int mipi_dsi_dcs_get_display_brightness(struct mipi_dsi_device *dsi,  in mipi_dsi_dcs_get_display_brightness()  argument
1134 	err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_DISPLAY_BRIGHTNESS,  in mipi_dsi_dcs_get_display_brightness()
1150 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_drv_probe()  local
1152 	return drv->probe(dsi);  in mipi_dsi_drv_probe()
1158 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_drv_remove()  local
1160 	return drv->remove(dsi);  in mipi_dsi_drv_remove()
1166 	struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);  in mipi_dsi_drv_shutdown()  local
1168 	drv->shutdown(dsi);  in mipi_dsi_drv_shutdown()
1172  * mipi_dsi_driver_register_full() - register a driver for DSI devices
1173  * @drv: DSI driver structure
1196  * mipi_dsi_driver_unregister() - unregister a driver for DSI devices
1197  * @drv: DSI driver structure
1214 MODULE_DESCRIPTION("MIPI DSI Bus");