1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * MIPI Display Bus Interface (DBI) LCD controller support
5 * Copyright 2016 Noralf Trønnes
8 #ifndef __LINUX_MIPI_DBI_H
9 #define __LINUX_MIPI_DBI_H
11 #include <linux/mutex.h>
12 #include <drm/drm_device.h>
13 #include <drm/drm_simple_kms_helper.h>
21 * struct mipi_dbi - MIPI DBI interface
25 * @cmdlock: Command lock
30 * @command: Bus specific callback executing commands.
32 int (*command)(struct mipi_dbi *dbi, u8 *cmd, u8 *param, size_t num);
35 * @read_commands: Array of read commands terminated by a zero entry.
36 * Reading is disabled if this is NULL.
38 const u8 *read_commands;
41 * @swap_bytes: Swap bytes in buffer before transfer
46 * @reset: Optional reset gpio
48 struct gpio_desc *reset;
55 struct spi_device *spi;
58 * @dc: Optional D/C gpio.
63 * @tx_buf9: Buffer used for Option 1 9-bit conversion
68 * @tx_buf9_len: Size of tx_buf9.
74 * struct mipi_dbi_dev - MIPI DBI device
80 struct drm_device drm;
83 * @pipe: Display pipe structure
85 struct drm_simple_display_pipe pipe;
88 * @connector: Connector
90 struct drm_connector connector;
93 * @mode: Fixed display mode
95 struct drm_display_mode mode;
98 * @enabled: Pipeline is enabled
103 * @tx_buf: Buffer used for transfer (copy clip rect area)
108 * @rotation: initial rotation in degrees Counter Clock Wise
110 unsigned int rotation;
113 * @backlight: backlight device (optional)
115 struct backlight_device *backlight;
118 * @regulator: power regulator (optional)
120 struct regulator *regulator;
123 * @dbi: MIPI DBI interface
128 static inline struct mipi_dbi_dev *drm_to_mipi_dbi_dev(struct drm_device *drm)
130 return container_of(drm, struct mipi_dbi_dev, drm);
133 int mipi_dbi_spi_init(struct spi_device *spi, struct mipi_dbi *dbi,
134 struct gpio_desc *dc);
135 int mipi_dbi_dev_init_with_formats(struct mipi_dbi_dev *dbidev,
136 const struct drm_simple_display_pipe_funcs *funcs,
137 const uint32_t *formats, unsigned int format_count,
138 const struct drm_display_mode *mode,
139 unsigned int rotation, size_t tx_buf_size);
140 int mipi_dbi_dev_init(struct mipi_dbi_dev *dbidev,
141 const struct drm_simple_display_pipe_funcs *funcs,
142 const struct drm_display_mode *mode, unsigned int rotation);
143 void mipi_dbi_release(struct drm_device *drm);
144 void mipi_dbi_pipe_update(struct drm_simple_display_pipe *pipe,
145 struct drm_plane_state *old_state);
146 void mipi_dbi_enable_flush(struct mipi_dbi_dev *dbidev,
147 struct drm_crtc_state *crtc_state,
148 struct drm_plane_state *plan_state);
149 void mipi_dbi_pipe_disable(struct drm_simple_display_pipe *pipe);
150 void mipi_dbi_hw_reset(struct mipi_dbi *dbi);
151 bool mipi_dbi_display_is_on(struct mipi_dbi *dbi);
152 int mipi_dbi_poweron_reset(struct mipi_dbi_dev *dbidev);
153 int mipi_dbi_poweron_conditional_reset(struct mipi_dbi_dev *dbidev);
155 u32 mipi_dbi_spi_cmd_max_speed(struct spi_device *spi, size_t len);
156 int mipi_dbi_spi_transfer(struct spi_device *spi, u32 speed_hz,
157 u8 bpw, const void *buf, size_t len);
159 int mipi_dbi_command_read(struct mipi_dbi *dbi, u8 cmd, u8 *val);
160 int mipi_dbi_command_buf(struct mipi_dbi *dbi, u8 cmd, u8 *data, size_t len);
161 int mipi_dbi_command_stackbuf(struct mipi_dbi *dbi, u8 cmd, u8 *data, size_t len);
162 int mipi_dbi_buf_copy(void *dst, struct drm_framebuffer *fb,
163 struct drm_rect *clip, bool swap);
165 * mipi_dbi_command - MIPI DCS command with optional parameter(s)
166 * @dbi: MIPI DBI structure
168 * @seq...: Optional parameter(s)
170 * Send MIPI DCS command to the controller. Use mipi_dbi_command_read() for
174 * Zero on success, negative error code on failure.
176 #define mipi_dbi_command(dbi, cmd, seq...) \
179 mipi_dbi_command_stackbuf(dbi, cmd, d, ARRAY_SIZE(d)); \
182 #ifdef CONFIG_DEBUG_FS
183 int mipi_dbi_debugfs_init(struct drm_minor *minor);
185 #define mipi_dbi_debugfs_init NULL
188 #endif /* __LINUX_MIPI_DBI_H */