4  * Copyright (C) 2012-2013, Samsung Electronics, Co., Ltd.
21  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
60 	if (!strcmp(dsi->name, drv->name))  in mipi_dsi_device_match()
72 	if (err != -ENODEV)  in mipi_dsi_uevent()
76 		       dsi->name);  in mipi_dsi_uevent()
93 	.name = "mipi-dsi",
100  * of_find_mipi_dsi_device_by_node() - find the MIPI DSI device matching a
121 	of_node_put(dev->of_node);  in mipi_dsi_dev_release()
135 		return ERR_PTR(-ENOMEM);  in mipi_dsi_device_alloc()
137 	dsi->host = host;  in mipi_dsi_device_alloc()
138 	dsi->dev.bus = &mipi_dsi_bus_type;  in mipi_dsi_device_alloc()
139 	dsi->dev.parent = host->dev;  in mipi_dsi_device_alloc()
140 	dsi->dev.type = &mipi_dsi_device_type;  in mipi_dsi_device_alloc()
142 	device_initialize(&dsi->dev);  in mipi_dsi_device_alloc()
149 	struct mipi_dsi_host *host = dsi->host;  in mipi_dsi_device_add()
151 	dev_set_name(&dsi->dev, "%s.%d", dev_name(host->dev),  dsi->channel);  in mipi_dsi_device_add()
153 	return device_add(&dsi->dev);  in mipi_dsi_device_add()
166 		return ERR_PTR(-EINVAL);  in of_mipi_dsi_device_add()
173 		return ERR_PTR(-EINVAL);  in of_mipi_dsi_device_add()
185 	return ERR_PTR(-ENODEV);  in of_mipi_dsi_device_add()
190  * mipi_dsi_device_register_full - create a MIPI DSI device
210 		return ERR_PTR(-EINVAL);  in mipi_dsi_device_register_full()
213 	if (info->channel > 3) {  in mipi_dsi_device_register_full()
214 		drm_err(host, "invalid virtual channel: %u\n", info->channel);  in mipi_dsi_device_register_full()
215 		return ERR_PTR(-EINVAL);  in mipi_dsi_device_register_full()
225 	device_set_node(&dsi->dev, of_fwnode_handle(info->node));  in mipi_dsi_device_register_full()
226 	dsi->channel = info->channel;  in mipi_dsi_device_register_full()
227 	strscpy(dsi->name, info->type, sizeof(dsi->name));  in mipi_dsi_device_register_full()
241  * mipi_dsi_device_unregister - unregister MIPI DSI device
246 	device_unregister(&dsi->dev);  in mipi_dsi_device_unregister()
258  * devm_mipi_dsi_device_register_full - create a managed MIPI DSI device
259  * @dev: device to tie the MIPI-DSI device lifetime to
300  * of_find_mipi_dsi_host_by_node() - find the MIPI DSI host matching a
315 		if (host->dev->of_node == node) {  in of_find_mipi_dsi_host_by_node()
331 	for_each_available_child_of_node(host->dev->of_node, node) {  in mipi_dsi_host_register()
339 	list_add_tail(&host->list, &host_list);  in mipi_dsi_host_register()
350 	if (dsi->attached)  in mipi_dsi_remove_device_fn()
359 	device_for_each_child(host->dev, NULL, mipi_dsi_remove_device_fn);  in mipi_dsi_host_unregister()
362 	list_del_init(&host->list);  in mipi_dsi_host_unregister()
368  * mipi_dsi_attach - attach a DSI device to its DSI host
373 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_attach()
376 	if (!ops || !ops->attach)  in mipi_dsi_attach()
377 		return -ENOSYS;  in mipi_dsi_attach()
379 	ret = ops->attach(dsi->host, dsi);  in mipi_dsi_attach()
383 	dsi->attached = true;  in mipi_dsi_attach()
390  * mipi_dsi_detach - detach a DSI device from its DSI host
395 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_detach()
397 	if (WARN_ON(!dsi->attached))  in mipi_dsi_detach()
398 		return -EINVAL;  in mipi_dsi_detach()
400 	if (!ops || !ops->detach)  in mipi_dsi_detach()
401 		return -ENOSYS;  in mipi_dsi_detach()
403 	dsi->attached = false;  in mipi_dsi_detach()
405 	return ops->detach(dsi->host, dsi);  in mipi_dsi_detach()
417  * devm_mipi_dsi_attach - Attach a MIPI-DSI device to its DSI Host
418  * @dev: device to tie the MIPI-DSI device attachment lifetime to
447 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;  in mipi_dsi_device_transfer()
449 	if (!ops || !ops->transfer)  in mipi_dsi_device_transfer()
450 		return -ENOSYS;  in mipi_dsi_device_transfer()
452 	if (dsi->mode_flags & MIPI_DSI_MODE_LPM)  in mipi_dsi_device_transfer()
453 		msg->flags |= MIPI_DSI_MSG_USE_LPM;  in mipi_dsi_device_transfer()
455 	return ops->transfer(dsi->host, msg);  in mipi_dsi_device_transfer()
459  * mipi_dsi_packet_format_is_short - check if a packet is of the short format
460  * @type: MIPI DSI data type of the packet
462  * Return: true if the packet for the given data type is a short packet, false
497  * mipi_dsi_packet_format_is_long - check if a packet is of the long format
498  * @type: MIPI DSI data type of the packet
500  * Return: true if the packet for the given data type is a long packet, false
530  * mipi_dsi_create_packet - create a packet from a message according to the
532  * @packet: pointer to a DSI packet structure
533  * @msg: message to translate into a packet
537 int mipi_dsi_create_packet(struct mipi_dsi_packet *packet,  in mipi_dsi_create_packet()  argument
540 	if (!packet || !msg)  in mipi_dsi_create_packet()
541 		return -EINVAL;  in mipi_dsi_create_packet()
544 	if (!mipi_dsi_packet_format_is_short(msg->type) &&  in mipi_dsi_create_packet()
545 	    !mipi_dsi_packet_format_is_long(msg->type))  in mipi_dsi_create_packet()
546 		return -EINVAL;  in mipi_dsi_create_packet()
548 	if (msg->channel > 3)  in mipi_dsi_create_packet()
549 		return -EINVAL;  in mipi_dsi_create_packet()
551 	memset(packet, 0, sizeof(*packet));  in mipi_dsi_create_packet()
552 	packet->header[0] = ((msg->channel & 0x3) << 6) | (msg->type & 0x3f);  in mipi_dsi_create_packet()
563 	if (mipi_dsi_packet_format_is_long(msg->type)) {  in mipi_dsi_create_packet()
564 		packet->header[1] = (msg->tx_len >> 0) & 0xff;  in mipi_dsi_create_packet()
565 		packet->header[2] = (msg->tx_len >> 8) & 0xff;  in mipi_dsi_create_packet()
567 		packet->payload_length = msg->tx_len;  in mipi_dsi_create_packet()
568 		packet->payload = msg->tx_buf;  in mipi_dsi_create_packet()
570 		const u8 *tx = msg->tx_buf;  in mipi_dsi_create_packet()
572 		packet->header[1] = (msg->tx_len > 0) ? tx[0] : 0;  in mipi_dsi_create_packet()
573 		packet->header[2] = (msg->tx_len > 1) ? tx[1] : 0;  in mipi_dsi_create_packet()
576 	packet->size = sizeof(packet->header) + packet->payload_length;  in mipi_dsi_create_packet()
583  * mipi_dsi_shutdown_peripheral() - sends a Shutdown Peripheral command
591 		.channel = dsi->channel,  in mipi_dsi_shutdown_peripheral()
603  * mipi_dsi_turn_on_peripheral() - sends a Turn On Peripheral command
613 		.channel = dsi->channel,  in mipi_dsi_turn_on_peripheral()
625  * mipi_dsi_set_maximum_return_packet_size() - specify the maximum size of
626  *    the payload in a long packet transmitted from the peripheral back to the
627  *    host processor
638 		.channel = dsi->channel,  in mipi_dsi_set_maximum_return_packet_size()
650  * mipi_dsi_compression_mode_ext() - enable/disable DSC on the peripheral
654  * @pps_selector: Select PPS from the table of pre-stored or uploaded PPS entries
667 		.channel = dsi->channel,  in mipi_dsi_compression_mode_ext()
675 		return -EINVAL;  in mipi_dsi_compression_mode_ext()
688  * mipi_dsi_compression_mode() - enable/disable DSC on the peripheral
704  * mipi_dsi_picture_parameter_set() - transmit the DSC PPS to the peripheral
717 		.channel = dsi->channel,  in mipi_dsi_picture_parameter_set()
729  * mipi_dsi_generic_write() - transmit data using a generic write packet
744 		.channel = dsi->channel,  in mipi_dsi_generic_write()
772  * mipi_dsi_generic_write_chatty() - mipi_dsi_generic_write() w/ an error log
785 	struct device *dev = &dsi->dev;  in mipi_dsi_generic_write_chatty()
800  * mipi_dsi_generic_write_multi() - mipi_dsi_generic_write_chatty() w/ accum_err
811 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_generic_write_multi()
812 	struct device *dev = &dsi->dev;  in mipi_dsi_generic_write_multi()
815 	if (ctx->accum_err)  in mipi_dsi_generic_write_multi()
820 		ctx->accum_err = ret;  in mipi_dsi_generic_write_multi()
822 			(int)size, payload, ctx->accum_err);  in mipi_dsi_generic_write_multi()
828  * mipi_dsi_generic_read() - receive data using a generic read packet
845 		.channel = dsi->channel,  in mipi_dsi_generic_read()
866 		return -EINVAL;  in mipi_dsi_generic_read()
874  * mipi_dsi_dcs_write_buffer() - transmit a DCS command with payload
889 		.channel = dsi->channel,  in mipi_dsi_dcs_write_buffer()
896 		return -EINVAL;  in mipi_dsi_dcs_write_buffer()
916  * mipi_dsi_dcs_write_buffer_chatty - mipi_dsi_dcs_write_buffer() w/ an error log
929 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_write_buffer_chatty()
944  * mipi_dsi_dcs_write_buffer_multi - mipi_dsi_dcs_write_buffer_chatty() w/ accum_err
955 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_write_buffer_multi()
956 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_write_buffer_multi()
959 	if (ctx->accum_err)  in mipi_dsi_dcs_write_buffer_multi()
964 		ctx->accum_err = ret;  in mipi_dsi_dcs_write_buffer_multi()
966 			(int)len, data, ctx->accum_err);  in mipi_dsi_dcs_write_buffer_multi()
972  * mipi_dsi_dcs_write() - send DCS write command
993 	if (len > ARRAY_SIZE(stack_tx) - 1) {  in mipi_dsi_dcs_write()
996 			return -ENOMEM;  in mipi_dsi_dcs_write()
1016  * mipi_dsi_dcs_read() - send DCS read request command
1028 		.channel = dsi->channel,  in mipi_dsi_dcs_read()
1041  * mipi_dsi_dcs_nop() - send DCS nop packet
1061  * mipi_dsi_dcs_soft_reset() - perform a software reset of the display module
1081  * mipi_dsi_dcs_get_power_mode() - query the display module's current power
1096 			err = -ENODATA;  in mipi_dsi_dcs_get_power_mode()
1106  * mipi_dsi_dcs_get_pixel_format() - gets the pixel format for the RGB image
1121 			err = -ENODATA;  in mipi_dsi_dcs_get_pixel_format()
1131  * mipi_dsi_dcs_enter_sleep_mode() - disable all unnecessary blocks inside the
1152  * mipi_dsi_dcs_exit_sleep_mode() - enable all blocks inside the display
1173  * mipi_dsi_dcs_set_display_off() - stop displaying the image data on the
1194  * mipi_dsi_dcs_set_display_on() - start displaying the image data on the
1215  * mipi_dsi_dcs_set_column_address() - define the column extent of the frame
1216  *    memory accessed by the host processor
1242  * mipi_dsi_dcs_set_page_address() - define the page extent of the frame
1243  *    memory accessed by the host processor
1269  * mipi_dsi_dcs_set_tear_off() - turn off the display module's Tearing Effect
1288  * mipi_dsi_dcs_set_tear_on() - turn on the display module's Tearing Effect
1313  * mipi_dsi_dcs_set_pixel_format() - sets the pixel format for the RGB image
1337  * mipi_dsi_dcs_set_tear_scanline() - set the scanline to use as trigger for
1362  * mipi_dsi_dcs_set_display_brightness() - sets the brightness value of the
1388  * mipi_dsi_dcs_get_display_brightness() - gets the current brightness value
1404 			err = -ENODATA;  in mipi_dsi_dcs_get_display_brightness()
1414  * mipi_dsi_dcs_set_display_brightness_large() - sets the 16-bit brightness value
1437  * mipi_dsi_dcs_get_display_brightness_large() - gets the current 16-bit
1454 			err = -ENODATA;  in mipi_dsi_dcs_get_display_brightness_large()
1466  * mipi_dsi_picture_parameter_set_multi() - transmit the DSC PPS to the peripheral
1476 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_picture_parameter_set_multi()
1477 	struct device *dev = &dsi->dev;  in mipi_dsi_picture_parameter_set_multi()
1480 	if (ctx->accum_err)  in mipi_dsi_picture_parameter_set_multi()
1485 		ctx->accum_err = ret;  in mipi_dsi_picture_parameter_set_multi()
1487 			ctx->accum_err);  in mipi_dsi_picture_parameter_set_multi()
1493  * mipi_dsi_compression_mode_ext_multi() - enable/disable DSC on the peripheral
1497  * @pps_selector: Select PPS from the table of pre-stored or uploaded PPS entries
1507 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_compression_mode_ext_multi()
1508 	struct device *dev = &dsi->dev;  in mipi_dsi_compression_mode_ext_multi()
1511 	if (ctx->accum_err)  in mipi_dsi_compression_mode_ext_multi()
1516 		ctx->accum_err = ret;  in mipi_dsi_compression_mode_ext_multi()
1518 			ctx->accum_err);  in mipi_dsi_compression_mode_ext_multi()
1524  * mipi_dsi_compression_mode_multi() - enable/disable DSC on the peripheral
1540  * mipi_dsi_dcs_nop_multi() - send DCS NOP packet
1548 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_nop_multi()
1549 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_nop_multi()
1552 	if (ctx->accum_err)  in mipi_dsi_dcs_nop_multi()
1557 		ctx->accum_err = ret;  in mipi_dsi_dcs_nop_multi()
1559 			ctx->accum_err);  in mipi_dsi_dcs_nop_multi()
1565  * mipi_dsi_dcs_enter_sleep_mode_multi() - send DCS ENTER_SLEEP_MODE  packet
1573 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_enter_sleep_mode_multi()
1574 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_enter_sleep_mode_multi()
1577 	if (ctx->accum_err)  in mipi_dsi_dcs_enter_sleep_mode_multi()
1582 		ctx->accum_err = ret;  in mipi_dsi_dcs_enter_sleep_mode_multi()
1584 			ctx->accum_err);  in mipi_dsi_dcs_enter_sleep_mode_multi()
1590  * mipi_dsi_dcs_exit_sleep_mode_multi() - send DCS EXIT_SLEEP_MODE packet
1598 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_exit_sleep_mode_multi()
1599 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_exit_sleep_mode_multi()
1602 	if (ctx->accum_err)  in mipi_dsi_dcs_exit_sleep_mode_multi()
1607 		ctx->accum_err = ret;  in mipi_dsi_dcs_exit_sleep_mode_multi()
1609 			ctx->accum_err);  in mipi_dsi_dcs_exit_sleep_mode_multi()
1615  * mipi_dsi_dcs_set_display_off_multi() - send DCS SET_DISPLAY_OFF packet
1623 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_display_off_multi()
1624 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_display_off_multi()
1627 	if (ctx->accum_err)  in mipi_dsi_dcs_set_display_off_multi()
1632 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_display_off_multi()
1634 			ctx->accum_err);  in mipi_dsi_dcs_set_display_off_multi()
1640  * mipi_dsi_dcs_set_display_on_multi() - send DCS SET_DISPLAY_ON packet
1648 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_display_on_multi()
1649 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_display_on_multi()
1652 	if (ctx->accum_err)  in mipi_dsi_dcs_set_display_on_multi()
1657 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_display_on_multi()
1659 			ctx->accum_err);  in mipi_dsi_dcs_set_display_on_multi()
1665  * mipi_dsi_dcs_set_tear_on_multi() - send DCS SET_TEAR_ON packet
1675 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_tear_on_multi()
1676 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_tear_on_multi()
1679 	if (ctx->accum_err)  in mipi_dsi_dcs_set_tear_on_multi()
1684 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_tear_on_multi()
1686 			ctx->accum_err);  in mipi_dsi_dcs_set_tear_on_multi()
1692  * mipi_dsi_turn_on_peripheral_multi() - sends a Turn On Peripheral command
1700 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_turn_on_peripheral_multi()
1701 	struct device *dev = &dsi->dev;  in mipi_dsi_turn_on_peripheral_multi()
1704 	if (ctx->accum_err)  in mipi_dsi_turn_on_peripheral_multi()
1709 		ctx->accum_err = ret;  in mipi_dsi_turn_on_peripheral_multi()
1711 			ctx->accum_err);  in mipi_dsi_turn_on_peripheral_multi()
1717  * mipi_dsi_dcs_soft_reset_multi() - perform a software reset of the display module
1725 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_soft_reset_multi()
1726 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_soft_reset_multi()
1729 	if (ctx->accum_err)  in mipi_dsi_dcs_soft_reset_multi()
1734 		ctx->accum_err = ret;  in mipi_dsi_dcs_soft_reset_multi()
1736 			ctx->accum_err);  in mipi_dsi_dcs_soft_reset_multi()
1742  * mipi_dsi_dcs_set_display_brightness_multi() - sets the brightness value of
1753 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_display_brightness_multi()
1754 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_display_brightness_multi()
1757 	if (ctx->accum_err)  in mipi_dsi_dcs_set_display_brightness_multi()
1762 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_display_brightness_multi()
1764 			ctx->accum_err);  in mipi_dsi_dcs_set_display_brightness_multi()
1770  * mipi_dsi_dcs_set_pixel_format_multi() - sets the pixel format for the RGB image
1781 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_pixel_format_multi()
1782 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_pixel_format_multi()
1785 	if (ctx->accum_err)  in mipi_dsi_dcs_set_pixel_format_multi()
1790 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_pixel_format_multi()
1792 			ctx->accum_err);  in mipi_dsi_dcs_set_pixel_format_multi()
1798  * mipi_dsi_dcs_set_column_address_multi() - define the column extent of the
1799  *	frame memory accessed by the host processor
1810 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_column_address_multi()
1811 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_column_address_multi()
1814 	if (ctx->accum_err)  in mipi_dsi_dcs_set_column_address_multi()
1819 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_column_address_multi()
1821 			ctx->accum_err);  in mipi_dsi_dcs_set_column_address_multi()
1827  * mipi_dsi_dcs_set_page_address_multi() - define the page extent of the
1828  *	frame memory accessed by the host processor
1839 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_page_address_multi()
1840 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_page_address_multi()
1843 	if (ctx->accum_err)  in mipi_dsi_dcs_set_page_address_multi()
1848 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_page_address_multi()
1850 			ctx->accum_err);  in mipi_dsi_dcs_set_page_address_multi()
1856  * mipi_dsi_dcs_set_tear_scanline_multi() - set the scanline to use as trigger for
1867 	struct mipi_dsi_device *dsi = ctx->dsi;  in mipi_dsi_dcs_set_tear_scanline_multi()
1868 	struct device *dev = &dsi->dev;  in mipi_dsi_dcs_set_tear_scanline_multi()
1871 	if (ctx->accum_err)  in mipi_dsi_dcs_set_tear_scanline_multi()
1876 		ctx->accum_err = ret;  in mipi_dsi_dcs_set_tear_scanline_multi()
1878 			ctx->accum_err);  in mipi_dsi_dcs_set_tear_scanline_multi()
1885 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_probe()
1888 	return drv->probe(dsi);  in mipi_dsi_drv_probe()
1893 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_remove()
1896 	drv->remove(dsi);  in mipi_dsi_drv_remove()
1903 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_shutdown()
1906 	drv->shutdown(dsi);  in mipi_dsi_drv_shutdown()
1910  * mipi_dsi_driver_register_full() - register a driver for DSI devices
1919 	drv->driver.bus = &mipi_dsi_bus_type;  in mipi_dsi_driver_register_full()
1920 	drv->driver.owner = owner;  in mipi_dsi_driver_register_full()
1922 	if (drv->probe)  in mipi_dsi_driver_register_full()
1923 		drv->driver.probe = mipi_dsi_drv_probe;  in mipi_dsi_driver_register_full()
1924 	if (drv->remove)  in mipi_dsi_driver_register_full()
1925 		drv->driver.remove = mipi_dsi_drv_remove;  in mipi_dsi_driver_register_full()
1926 	if (drv->shutdown)  in mipi_dsi_driver_register_full()
1927 		drv->driver.shutdown = mipi_dsi_drv_shutdown;  in mipi_dsi_driver_register_full()
1929 	return driver_register(&drv->driver);  in mipi_dsi_driver_register_full()
1934  * mipi_dsi_driver_unregister() - unregister a driver for DSI devices
1941 	driver_unregister(&drv->driver);  in mipi_dsi_driver_unregister()