1 /* SPDX-License-Identifier: GPL-2.0-only */
3  * MIPI DSI Bus
5  * Copyright (C) 2012-2013, Samsung Electronics, Co., Ltd.
25  * struct mipi_dsi_msg - read/write DSI buffer
50  * struct mipi_dsi_packet - represents a MIPI DSI packet in protocol format
68  * struct mipi_dsi_host_ops - DSI bus operations
69  * @attach: attach DSI device to DSI host
70  * @detach: detach DSI device from DSI host
71  * @transfer: transmit a DSI packet
73  * DSI packets transmitted by .transfer() are passed in as mipi_dsi_msg
81  * Note that typically DSI packet transmission is atomic, so the .transfer()
92 		      struct mipi_dsi_device *dsi);
94 		      struct mipi_dsi_device *dsi);
100  * struct mipi_dsi_host - DSI host device
101  * @dev: driver model device node for this DSI host
102  * @ops: DSI host operations
115 /* DSI mode flags */
125 /* enable hsync-end packets in vsync-pulse and v-porch area */
127 /* disable hfront-porch area */
129 /* disable hback-porch area */
131 /* disable hsync-active area */
135 /* device supports non-continuous clock behavior (DSI spec 5.6.1) */
152  * struct mipi_dsi_device_info - template for creating a mipi_dsi_device
153  * @type: DSI peripheral chip type
154  * @channel: DSI virtual channel assigned to peripheral
158  * DSI device
167  * struct mipi_dsi_device - DSI peripheral device
168  * @host: DSI host for this peripheral
170  * @attached: the DSI device has been successfully attached
171  * @name: DSI peripheral chip type
175  * @mode_flags: DSI operation mode related flags
200  * struct mipi_dsi_multi_context - Context to call multiple MIPI DSI funcs in a row
204 	 * @dsi: Pointer to the MIPI DSI device
206 	struct mipi_dsi_device *dsi;  member
213 	 * non-zero value then the function will be a noop. This allows calling
220 #define MIPI_DSI_MODULE_PREFIX "mipi-dsi:"
225 #define dev_is_mipi_dsi(dev)	((dev)->bus == &mipi_dsi_bus_type)
228  * mipi_dsi_pixel_format_to_bpp - obtain the number of bits per pixel for any
229  *                                given pixel format defined by the MIPI DSI
231  * @fmt: MIPI DSI pixel format
249 	return -EINVAL;  in mipi_dsi_pixel_format_to_bpp()
255 	/* other two values are reserved, DSI 1.3 */
261 void mipi_dsi_device_unregister(struct mipi_dsi_device *dsi);
266 int mipi_dsi_attach(struct mipi_dsi_device *dsi);
267 int mipi_dsi_detach(struct mipi_dsi_device *dsi);
268 int devm_mipi_dsi_attach(struct device *dev, struct mipi_dsi_device *dsi);
269 int mipi_dsi_shutdown_peripheral(struct mipi_dsi_device *dsi);
270 int mipi_dsi_turn_on_peripheral(struct mipi_dsi_device *dsi);
271 int mipi_dsi_set_maximum_return_packet_size(struct mipi_dsi_device *dsi,
273 int mipi_dsi_compression_mode(struct mipi_dsi_device *dsi, bool enable);
274 int mipi_dsi_compression_mode_ext(struct mipi_dsi_device *dsi, bool enable,
277 int mipi_dsi_picture_parameter_set(struct mipi_dsi_device *dsi,
289 ssize_t mipi_dsi_generic_write(struct mipi_dsi_device *dsi, const void *payload,
291 int mipi_dsi_generic_write_chatty(struct mipi_dsi_device *dsi,
295 ssize_t mipi_dsi_generic_read(struct mipi_dsi_device *dsi, const void *params,
301 		if (!(ctx)->accum_err)	\
307 		if (!(ctx)->accum_err)		\
312  * enum mipi_dsi_dcs_tear_mode - Tearing Effect Output Line mode
313  * @MIPI_DSI_DCS_TEAR_MODE_VBLANK: the TE output line consists of V-Blanking
316  *    V-Blanking and H-Blanking information
329 ssize_t mipi_dsi_dcs_write_buffer(struct mipi_dsi_device *dsi,
331 int mipi_dsi_dcs_write_buffer_chatty(struct mipi_dsi_device *dsi,
335 ssize_t mipi_dsi_dcs_write(struct mipi_dsi_device *dsi, u8 cmd,
337 ssize_t mipi_dsi_dcs_read(struct mipi_dsi_device *dsi, u8 cmd, void *data,
339 int mipi_dsi_dcs_nop(struct mipi_dsi_device *dsi);
340 int mipi_dsi_dcs_soft_reset(struct mipi_dsi_device *dsi);
341 int mipi_dsi_dcs_get_power_mode(struct mipi_dsi_device *dsi, u8 *mode);
342 int mipi_dsi_dcs_get_pixel_format(struct mipi_dsi_device *dsi, u8 *format);
343 int mipi_dsi_dcs_enter_sleep_mode(struct mipi_dsi_device *dsi);
344 int mipi_dsi_dcs_exit_sleep_mode(struct mipi_dsi_device *dsi);
345 int mipi_dsi_dcs_set_display_off(struct mipi_dsi_device *dsi);
346 int mipi_dsi_dcs_set_display_on(struct mipi_dsi_device *dsi);
347 int mipi_dsi_dcs_set_column_address(struct mipi_dsi_device *dsi, u16 start,
349 int mipi_dsi_dcs_set_page_address(struct mipi_dsi_device *dsi, u16 start,
351 int mipi_dsi_dcs_set_tear_on(struct mipi_dsi_device *dsi,
353 int mipi_dsi_dcs_set_pixel_format(struct mipi_dsi_device *dsi, u8 format);
354 int mipi_dsi_dcs_set_tear_scanline(struct mipi_dsi_device *dsi, u16 scanline);
355 int mipi_dsi_dcs_set_display_brightness(struct mipi_dsi_device *dsi,
357 int mipi_dsi_dcs_get_display_brightness(struct mipi_dsi_device *dsi,
359 int mipi_dsi_dcs_set_display_brightness_large(struct mipi_dsi_device *dsi,
361 int mipi_dsi_dcs_get_display_brightness_large(struct mipi_dsi_device *dsi,
386  * mipi_dsi_generic_write_seq - transmit data using a generic write packet
389  * FUNCTION (yes this is non-intuitive) upon error.
391  * Because of the non-intuitive return behavior, THIS MACRO IS DEPRECATED.
394  * @dsi: DSI peripheral device
397 #define mipi_dsi_generic_write_seq(dsi, seq...)                                \  argument
401 		ret = mipi_dsi_generic_write_chatty(dsi, d, ARRAY_SIZE(d));    \
407  * mipi_dsi_generic_write_seq_multi - transmit data using a generic write packet
412  * @ctx: Context for multiple DSI transactions
422  * mipi_dsi_dcs_write_seq_multi - transmit a DCS command with payload
427  * @ctx: Context for multiple DSI transactions
438  * struct mipi_dsi_driver - DSI driver
446 	int(*probe)(struct mipi_dsi_device *dsi);
447 	void (*remove)(struct mipi_dsi_device *dsi);
448 	void (*shutdown)(struct mipi_dsi_device *dsi);
457 static inline void *mipi_dsi_get_drvdata(const struct mipi_dsi_device *dsi)  in mipi_dsi_get_drvdata()  argument
459 	return dev_get_drvdata(&dsi->dev);  in mipi_dsi_get_drvdata()
462 static inline void mipi_dsi_set_drvdata(struct mipi_dsi_device *dsi, void *data)  in mipi_dsi_set_drvdata()  argument
464 	dev_set_drvdata(&dsi->dev, data);  in mipi_dsi_set_drvdata()