4  * Copyright (C) 2012-2013, Samsung Electronics, Co., Ltd.
21  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
28 #include <linux/device.h>
51 static int mipi_dsi_device_match(struct device *dev, struct device_driver *drv)  in mipi_dsi_device_match()
59 	/* compare DSI device and driver names */  in mipi_dsi_device_match()
60 	if (!strcmp(dsi->name, drv->name))  in mipi_dsi_device_match()
66 static int mipi_dsi_uevent(const struct device *dev, struct kobj_uevent_env *env)  in mipi_dsi_uevent()
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
101  *    device tree node
102  * @np: device tree node
104  * Return: A pointer to the MIPI DSI device corresponding to @np or NULL if no
105  *    such device exists (or has not been registered yet).
109 	struct device *dev;  in of_find_mipi_dsi_device_by_node()
117 static void mipi_dsi_dev_release(struct device *dev)  in mipi_dsi_dev_release()
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()
165 		drm_err(host, "modalias failure on %pOF\n", node);  in of_mipi_dsi_device_add()
166 		return ERR_PTR(-EINVAL);  in of_mipi_dsi_device_add()
171 		drm_err(host, "device node %pOF has no valid reg property: %d\n",  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
191  * @host: DSI host to which this device is connected
192  * @info: pointer to template containing DSI device information
194  * Create a MIPI DSI device by using the device information provided by
198  * A pointer to the newly created MIPI DSI device, or, a pointer encoded
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()
220 		drm_err(host, "failed to allocate DSI device %ld\n",  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()
231 		drm_err(host, "failed to add DSI device %d\n", ret);  in mipi_dsi_device_register_full()
241  * mipi_dsi_device_unregister - unregister MIPI DSI device
242  * @dsi: DSI peripheral 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
260  * @host: DSI host to which this device is connected
261  * @info: pointer to template containing DSI device information
263  * Create a MIPI DSI device by using the device information provided by
271  * A pointer to the newly created MIPI DSI device, or, a pointer encoded
275 devm_mipi_dsi_device_register_full(struct device *dev,  in devm_mipi_dsi_device_register_full()
300  * of_find_mipi_dsi_host_by_node() - find the MIPI DSI host matching a
301  *				     device tree node
302  * @node: device tree node
306  * such device exists (or has not been registered yet).
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()
346 static int mipi_dsi_remove_device_fn(struct device *dev, void *priv)  in mipi_dsi_remove_device_fn()
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
425  * 0 on success, a negative error code on failure.
427 int devm_mipi_dsi_attach(struct device *dev,  in devm_mipi_dsi_attach()
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
497  * mipi_dsi_packet_format_is_long - check if a packet is of the long format
530  * mipi_dsi_create_packet - create a packet from a message according to the
535  * Return: 0 on success or a negative error code on failure.
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()
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
584  * @dsi: DSI peripheral device
586  * Return: 0 on success or a negative error code on failure.
591 		.channel = dsi->channel,  in mipi_dsi_shutdown_peripheral()
603  * mipi_dsi_turn_on_peripheral() - sends a Turn On Peripheral command
604  * @dsi: DSI peripheral device
606  * Return: 0 on success or a negative error code on failure.
611 		.channel = dsi->channel,  in mipi_dsi_turn_on_peripheral()
623  * mipi_dsi_set_maximum_return_packet_size() - specify the maximum size of
626  * @dsi: DSI peripheral device
629  * Return: 0 on success or a negative error code on failure.
636 		.channel = dsi->channel,  in mipi_dsi_set_maximum_return_packet_size()
648  * mipi_dsi_compression_mode() - enable/disable DSC on the peripheral
649  * @dsi: DSI peripheral device
652  * Enable or disable Display Stream Compression on the peripheral using the
655  * Return: 0 on success or a negative error code on failure.
659 	/* Note: Needs updating for non-default PPS or algorithm */  in mipi_dsi_compression_mode()
662 		.channel = dsi->channel,  in mipi_dsi_compression_mode()
674  * mipi_dsi_picture_parameter_set() - transmit the DSC PPS to the peripheral
675  * @dsi: DSI peripheral device
680  * Return: 0 on success or a negative error code on failure.
686 		.channel = dsi->channel,  in mipi_dsi_picture_parameter_set()
698  * mipi_dsi_generic_write() - transmit data using a generic write packet
699  * @dsi: DSI peripheral device
703  * This function will automatically choose the right data type depending on
706  * Return: The number of bytes transmitted on success or a negative error code
707  * on failure.
713 		.channel = dsi->channel,  in mipi_dsi_generic_write()
741  * mipi_dsi_generic_read() - receive data using a generic read packet
742  * @dsi: DSI peripheral device
748  * This function will automatically choose the right data type depending on
751  * Return: The number of bytes successfully read or a negative error code on
758 		.channel = dsi->channel,  in mipi_dsi_generic_read()
779 		return -EINVAL;  in mipi_dsi_generic_read()
787  * mipi_dsi_dcs_write_buffer() - transmit a DCS command with payload
788  * @dsi: DSI peripheral device
792  * This function will automatically choose the right data type depending on
796  * code on failure.
802 		.channel = dsi->channel,  in mipi_dsi_dcs_write_buffer()
809 		return -EINVAL;  in mipi_dsi_dcs_write_buffer()
829  * mipi_dsi_dcs_write() - send DCS write command
830  * @dsi: DSI peripheral device
835  * This function will automatically choose the right data type depending on
839  * code on failure.
850 	if (len > ARRAY_SIZE(stack_tx) - 1) {  in mipi_dsi_dcs_write()
853 			return -ENOMEM;  in mipi_dsi_dcs_write()
873  * mipi_dsi_dcs_read() - send DCS read request command
874  * @dsi: DSI peripheral device
879  * Return: The number of bytes read or a negative error code on failure.
885 		.channel = dsi->channel,  in mipi_dsi_dcs_read()
898  * mipi_dsi_dcs_nop() - send DCS nop packet
899  * @dsi: DSI peripheral device
901  * Return: 0 on success or a negative error code on failure.
916  * mipi_dsi_dcs_soft_reset() - perform a software reset of the display module
917  * @dsi: DSI peripheral device
919  * Return: 0 on success or a negative error code on failure.
934  * mipi_dsi_dcs_get_power_mode() - query the display module's current power
936  * @dsi: DSI peripheral device
939  * Return: 0 on success or a negative error code on failure.
949 			err = -ENODATA;  in mipi_dsi_dcs_get_power_mode()
959  * mipi_dsi_dcs_get_pixel_format() - gets the pixel format for the RGB image
961  * @dsi: DSI peripheral device
964  * Return: 0 on success or a negative error code on failure.
974 			err = -ENODATA;  in mipi_dsi_dcs_get_pixel_format()
984  * mipi_dsi_dcs_enter_sleep_mode() - disable all unnecessary blocks inside the
986  * @dsi: DSI peripheral device
988  * Return: 0 on success or a negative error code on failure.
1003  * mipi_dsi_dcs_exit_sleep_mode() - enable all blocks inside the display
1005  * @dsi: DSI peripheral device
1007  * Return: 0 on success or a negative error code on failure.
1022  * mipi_dsi_dcs_set_display_off() - stop displaying the image data on the
1023  *    display device
1024  * @dsi: DSI peripheral device
1026  * Return: 0 on success or a negative error code on failure.
1041  * mipi_dsi_dcs_set_display_on() - start displaying the image data on the
1042  *    display device
1043  * @dsi: DSI peripheral device
1045  * Return: 0 on success or a negative error code on failure
1060  * mipi_dsi_dcs_set_column_address() - define the column extent of the frame
1062  * @dsi: DSI peripheral device
1066  * Return: 0 on success or a negative error code on failure.
1084  * mipi_dsi_dcs_set_page_address() - define the page extent of the frame
1086  * @dsi: DSI peripheral device
1090  * Return: 0 on success or a negative error code on failure.
1108  * mipi_dsi_dcs_set_tear_off() - turn off the display module's Tearing Effect
1109  *    output signal on the TE signal line
1110  * @dsi: DSI peripheral device
1112  * Return: 0 on success or a negative error code on failure
1127  * mipi_dsi_dcs_set_tear_on() - turn on the display module's Tearing Effect
1128  *    output signal on the TE signal line.
1129  * @dsi: DSI peripheral device
1132  * Return: 0 on success or a negative error code on failure
1150  * mipi_dsi_dcs_set_pixel_format() - sets the pixel format for the RGB image
1152  * @dsi: DSI peripheral device
1155  * Return: 0 on success or a negative error code on failure.
1171  * mipi_dsi_dcs_set_tear_scanline() - set the scanline to use as trigger for
1173  * @dsi: DSI peripheral device
1176  * Return: 0 on success or a negative error code on failure
1193  * mipi_dsi_dcs_set_display_brightness() - sets the brightness value of the
1195  * @dsi: DSI peripheral device
1198  * Return: 0 on success or a negative error code on failure.
1216  * mipi_dsi_dcs_get_display_brightness() - gets the current brightness value
1218  * @dsi: DSI peripheral device
1221  * Return: 0 on success or a negative error code on failure.
1232 			err = -ENODATA;  in mipi_dsi_dcs_get_display_brightness()
1242  * mipi_dsi_dcs_set_display_brightness_large() - sets the 16-bit brightness value
1244  * @dsi: DSI peripheral device
1247  * Return: 0 on success or a negative error code on failure.
1265  * mipi_dsi_dcs_get_display_brightness_large() - gets the current 16-bit
1267  * @dsi: DSI peripheral device
1270  * Return: 0 on success or a negative error code on failure.
1282 			err = -ENODATA;  in mipi_dsi_dcs_get_display_brightness_large()
1293 static int mipi_dsi_drv_probe(struct device *dev)  in mipi_dsi_drv_probe()
1295 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_probe()
1298 	return drv->probe(dsi);  in mipi_dsi_drv_probe()
1301 static int mipi_dsi_drv_remove(struct device *dev)  in mipi_dsi_drv_remove()
1303 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_remove()
1306 	drv->remove(dsi);  in mipi_dsi_drv_remove()
1311 static void mipi_dsi_drv_shutdown(struct device *dev)  in mipi_dsi_drv_shutdown()
1313 	struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);  in mipi_dsi_drv_shutdown()
1316 	drv->shutdown(dsi);  in mipi_dsi_drv_shutdown()
1320  * mipi_dsi_driver_register_full() - register a driver for DSI devices
1324  * Return: 0 on success or a negative error code on failure.
1329 	drv->driver.bus = &mipi_dsi_bus_type;  in mipi_dsi_driver_register_full()
1330 	drv->driver.owner = owner;  in mipi_dsi_driver_register_full()
1332 	if (drv->probe)  in mipi_dsi_driver_register_full()
1333 		drv->driver.probe = mipi_dsi_drv_probe;  in mipi_dsi_driver_register_full()
1334 	if (drv->remove)  in mipi_dsi_driver_register_full()
1335 		drv->driver.remove = mipi_dsi_drv_remove;  in mipi_dsi_driver_register_full()
1336 	if (drv->shutdown)  in mipi_dsi_driver_register_full()
1337 		drv->driver.shutdown = mipi_dsi_drv_shutdown;  in mipi_dsi_driver_register_full()
1339 	return driver_register(&drv->driver);  in mipi_dsi_driver_register_full()
1344  * mipi_dsi_driver_unregister() - unregister a driver for DSI devices
1347  * Return: 0 on success or a negative error code on failure.
1351 	driver_unregister(&drv->driver);  in mipi_dsi_driver_unregister()