4  * SPDX-License-Identifier: Apache-2.0
9  * @brief Public APIs for MIPI-DSI drivers
16  * @brief MIPI-DSI driver APIs
17  * @defgroup mipi_dsi_interface MIPI-DSI driver APIs
27 #include <zephyr/dt-bindings/mipi_dsi/mipi_dsi.h>
33 /** MIPI-DSI display timings. */
35 	/** Horizontal active video. */
43 	/** Vertical active video. */
54  * @name MIPI-DSI Device mode flags.
66 /** Enable hsync-end packets in vsync-pulse and v-porch area */
68 /** Disable hfront-porch area */
70 /** Disable hback-porch area */
72 /** Disable hsync-active area */
78 /** Device supports non-continuous clock behavior (DSI spec 5.6.1) */
85 /** MIPI-DSI device. */
103 /** MIPI-DSI read/write message. */
121 /** MIPI-DSI host driver API. */
123 	int (*attach)(const struct device *dev, uint8_t channel,
125 	ssize_t (*transfer)(const struct device *dev, uint8_t channel,
127 	int (*detach)(const struct device *dev, uint8_t channel,
132  * @brief Attach a new device to the MIPI-DSI bus.
134  * @param dev MIPI-DSI host device.
135  * @param channel Device channel (VID).
136  * @param mdev MIPI-DSI device description.
141 				  uint8_t channel,  in mipi_dsi_attach()  argument
144 	const struct mipi_dsi_driver_api *api = (const struct mipi_dsi_driver_api *)dev->api;  in mipi_dsi_attach()
146 	return api->attach(dev, channel, mdev);  in mipi_dsi_attach()
150  * @brief Transfer data to/from a device attached to the MIPI-DSI bus.
152  * @param dev MIPI-DSI device.
153  * @param channel Device channel (VID).
159 					uint8_t channel,  in mipi_dsi_transfer()  argument
162 	const struct mipi_dsi_driver_api *api = (const struct mipi_dsi_driver_api *)dev->api;  in mipi_dsi_transfer()
164 	return api->transfer(dev, channel, msg);  in mipi_dsi_transfer()
168  * @brief MIPI-DSI generic read.
170  * @param dev MIPI-DSI host device.
171  * @param channel Device channel (VID).
179 ssize_t mipi_dsi_generic_read(const struct device *dev, uint8_t channel,
184  * @brief MIPI-DSI generic write.
186  * @param dev MIPI-DSI host device.
187  * @param channel Device channel (VID).
193 ssize_t mipi_dsi_generic_write(const struct device *dev, uint8_t channel,
197  * @brief MIPI-DSI DCS read.
199  * @param dev MIPI-DSI host device.
200  * @param channel Device channel (VID).
207 ssize_t mipi_dsi_dcs_read(const struct device *dev, uint8_t channel,
211  * @brief MIPI-DSI DCS write.
213  * @param dev MIPI-DSI host device.
214  * @param channel Device channel (VID).
221 ssize_t mipi_dsi_dcs_write(const struct device *dev, uint8_t channel,
226  * @brief Detach a device from the MIPI-DSI bus
228  * @param dev MIPI-DSI host device.
229  * @param channel Device channel (VID).
230  * @param mdev MIPI-DSI device description.
235 				  uint8_t channel,  in mipi_dsi_detach()  argument
238 	const struct mipi_dsi_driver_api *api = (const struct mipi_dsi_driver_api *)dev->api;  in mipi_dsi_detach()
240 	if (api->detach == NULL) {  in mipi_dsi_detach()
241 		return -ENOSYS;  in mipi_dsi_detach()
244 	return api->detach(dev, channel, mdev);  in mipi_dsi_detach()