1174102f4SNoralf Trønnes /* SPDX-License-Identifier: GPL-2.0-or-later */
2174102f4SNoralf Trønnes /*
3174102f4SNoralf Trønnes * MIPI Display Bus Interface (DBI) LCD controller support
4174102f4SNoralf Trønnes *
5174102f4SNoralf Trønnes * Copyright 2016 Noralf Trønnes
6174102f4SNoralf Trønnes */
7174102f4SNoralf Trønnes
8174102f4SNoralf Trønnes #ifndef __LINUX_MIPI_DBI_H
9174102f4SNoralf Trønnes #define __LINUX_MIPI_DBI_H
10174102f4SNoralf Trønnes
11174102f4SNoralf Trønnes #include <linux/mutex.h>
12174102f4SNoralf Trønnes #include <drm/drm_device.h>
13174102f4SNoralf Trønnes #include <drm/drm_simple_kms_helper.h>
14174102f4SNoralf Trønnes
154cd24d4bSThomas Zimmermann struct drm_format_conv_state;
16174102f4SNoralf Trønnes struct drm_rect;
17174102f4SNoralf Trønnes struct gpio_desc;
18b5f636e6SThomas Zimmermann struct iosys_map;
19174102f4SNoralf Trønnes struct regulator;
20b5f636e6SThomas Zimmermann struct spi_device;
21174102f4SNoralf Trønnes
22174102f4SNoralf Trønnes /**
23174102f4SNoralf Trønnes * struct mipi_dbi - MIPI DBI interface
24174102f4SNoralf Trønnes */
25174102f4SNoralf Trønnes struct mipi_dbi {
26174102f4SNoralf Trønnes /**
27174102f4SNoralf Trønnes * @cmdlock: Command lock
28174102f4SNoralf Trønnes */
29174102f4SNoralf Trønnes struct mutex cmdlock;
30174102f4SNoralf Trønnes
31174102f4SNoralf Trønnes /**
32174102f4SNoralf Trønnes * @command: Bus specific callback executing commands.
33174102f4SNoralf Trønnes */
34174102f4SNoralf Trønnes int (*command)(struct mipi_dbi *dbi, u8 *cmd, u8 *param, size_t num);
35174102f4SNoralf Trønnes
36174102f4SNoralf Trønnes /**
37174102f4SNoralf Trønnes * @read_commands: Array of read commands terminated by a zero entry.
38174102f4SNoralf Trønnes * Reading is disabled if this is NULL.
39174102f4SNoralf Trønnes */
40174102f4SNoralf Trønnes const u8 *read_commands;
41174102f4SNoralf Trønnes
42174102f4SNoralf Trønnes /**
43174102f4SNoralf Trønnes * @swap_bytes: Swap bytes in buffer before transfer
44174102f4SNoralf Trønnes */
45174102f4SNoralf Trønnes bool swap_bytes;
46174102f4SNoralf Trønnes
47174102f4SNoralf Trønnes /**
48174102f4SNoralf Trønnes * @reset: Optional reset gpio
49174102f4SNoralf Trønnes */
50174102f4SNoralf Trønnes struct gpio_desc *reset;
51174102f4SNoralf Trønnes
52174102f4SNoralf Trønnes /* Type C specific */
53174102f4SNoralf Trønnes
54174102f4SNoralf Trønnes /**
55174102f4SNoralf Trønnes * @spi: SPI device
56174102f4SNoralf Trønnes */
57174102f4SNoralf Trønnes struct spi_device *spi;
58174102f4SNoralf Trønnes
59174102f4SNoralf Trønnes /**
60df3fb27aSNoralf Trønnes * @write_memory_bpw: Bits per word used on a MIPI_DCS_WRITE_MEMORY_START transfer
61df3fb27aSNoralf Trønnes */
62df3fb27aSNoralf Trønnes unsigned int write_memory_bpw;
63df3fb27aSNoralf Trønnes
64df3fb27aSNoralf Trønnes /**
65174102f4SNoralf Trønnes * @dc: Optional D/C gpio.
66174102f4SNoralf Trønnes */
67174102f4SNoralf Trønnes struct gpio_desc *dc;
68174102f4SNoralf Trønnes
69174102f4SNoralf Trønnes /**
70174102f4SNoralf Trønnes * @tx_buf9: Buffer used for Option 1 9-bit conversion
71174102f4SNoralf Trønnes */
72174102f4SNoralf Trønnes void *tx_buf9;
73174102f4SNoralf Trønnes
74174102f4SNoralf Trønnes /**
75174102f4SNoralf Trønnes * @tx_buf9_len: Size of tx_buf9.
76174102f4SNoralf Trønnes */
77174102f4SNoralf Trønnes size_t tx_buf9_len;
78174102f4SNoralf Trønnes };
79174102f4SNoralf Trønnes
80174102f4SNoralf Trønnes /**
81174102f4SNoralf Trønnes * struct mipi_dbi_dev - MIPI DBI device
82174102f4SNoralf Trønnes */
83174102f4SNoralf Trønnes struct mipi_dbi_dev {
84174102f4SNoralf Trønnes /**
85174102f4SNoralf Trønnes * @drm: DRM device
86174102f4SNoralf Trønnes */
87174102f4SNoralf Trønnes struct drm_device drm;
88174102f4SNoralf Trønnes
89174102f4SNoralf Trønnes /**
90174102f4SNoralf Trønnes * @pipe: Display pipe structure
91174102f4SNoralf Trønnes */
92174102f4SNoralf Trønnes struct drm_simple_display_pipe pipe;
93174102f4SNoralf Trønnes
94174102f4SNoralf Trønnes /**
95174102f4SNoralf Trønnes * @connector: Connector
96174102f4SNoralf Trønnes */
97174102f4SNoralf Trønnes struct drm_connector connector;
98174102f4SNoralf Trønnes
99174102f4SNoralf Trønnes /**
100174102f4SNoralf Trønnes * @mode: Fixed display mode
101174102f4SNoralf Trønnes */
102174102f4SNoralf Trønnes struct drm_display_mode mode;
103174102f4SNoralf Trønnes
104174102f4SNoralf Trønnes /**
105*4aebb790SNoralf Trønnes * @pixel_format: Native pixel format (DRM_FORMAT\_\*)
106*4aebb790SNoralf Trønnes */
107*4aebb790SNoralf Trønnes u32 pixel_format;
108*4aebb790SNoralf Trønnes
109*4aebb790SNoralf Trønnes /**
110174102f4SNoralf Trønnes * @tx_buf: Buffer used for transfer (copy clip rect area)
111174102f4SNoralf Trønnes */
112174102f4SNoralf Trønnes u16 *tx_buf;
113174102f4SNoralf Trønnes
114174102f4SNoralf Trønnes /**
115174102f4SNoralf Trønnes * @rotation: initial rotation in degrees Counter Clock Wise
116174102f4SNoralf Trønnes */
117174102f4SNoralf Trønnes unsigned int rotation;
118174102f4SNoralf Trønnes
119174102f4SNoralf Trønnes /**
120f41a8a69SGeert Uytterhoeven * @left_offset: Horizontal offset of the display relative to the
121f41a8a69SGeert Uytterhoeven * controller's driver array
122f41a8a69SGeert Uytterhoeven */
123f41a8a69SGeert Uytterhoeven unsigned int left_offset;
124f41a8a69SGeert Uytterhoeven
125f41a8a69SGeert Uytterhoeven /**
126f41a8a69SGeert Uytterhoeven * @top_offset: Vertical offset of the display relative to the
127f41a8a69SGeert Uytterhoeven * controller's driver array
128f41a8a69SGeert Uytterhoeven */
129f41a8a69SGeert Uytterhoeven unsigned int top_offset;
130f41a8a69SGeert Uytterhoeven
131f41a8a69SGeert Uytterhoeven /**
132174102f4SNoralf Trønnes * @backlight: backlight device (optional)
133174102f4SNoralf Trønnes */
134174102f4SNoralf Trønnes struct backlight_device *backlight;
135174102f4SNoralf Trønnes
136174102f4SNoralf Trønnes /**
1373b1fb8b3SOtto Pflüger * @regulator: power regulator (Vdd) (optional)
138174102f4SNoralf Trønnes */
139174102f4SNoralf Trønnes struct regulator *regulator;
140174102f4SNoralf Trønnes
141174102f4SNoralf Trønnes /**
1423b1fb8b3SOtto Pflüger * @io_regulator: I/O power regulator (Vddi) (optional)
1433b1fb8b3SOtto Pflüger */
1443b1fb8b3SOtto Pflüger struct regulator *io_regulator;
1453b1fb8b3SOtto Pflüger
1463b1fb8b3SOtto Pflüger /**
147174102f4SNoralf Trønnes * @dbi: MIPI DBI interface
148174102f4SNoralf Trønnes */
149174102f4SNoralf Trønnes struct mipi_dbi dbi;
1501e7e8e18SNoralf Trønnes
1511e7e8e18SNoralf Trønnes /**
1521e7e8e18SNoralf Trønnes * @driver_private: Driver private data.
1531e7e8e18SNoralf Trønnes * Necessary for drivers with private data since devm_drm_dev_alloc()
1541e7e8e18SNoralf Trønnes * can't allocate structures that embed a structure which then again
1551e7e8e18SNoralf Trønnes * embeds drm_device.
1561e7e8e18SNoralf Trønnes */
1571e7e8e18SNoralf Trønnes void *driver_private;
158174102f4SNoralf Trønnes };
159174102f4SNoralf Trønnes
drm_to_mipi_dbi_dev(struct drm_device * drm)160174102f4SNoralf Trønnes static inline struct mipi_dbi_dev *drm_to_mipi_dbi_dev(struct drm_device *drm)
161174102f4SNoralf Trønnes {
162174102f4SNoralf Trønnes return container_of(drm, struct mipi_dbi_dev, drm);
163174102f4SNoralf Trønnes }
164174102f4SNoralf Trønnes
165174102f4SNoralf Trønnes int mipi_dbi_spi_init(struct spi_device *spi, struct mipi_dbi *dbi,
166174102f4SNoralf Trønnes struct gpio_desc *dc);
167174102f4SNoralf Trønnes int mipi_dbi_dev_init_with_formats(struct mipi_dbi_dev *dbidev,
168174102f4SNoralf Trønnes const struct drm_simple_display_pipe_funcs *funcs,
169174102f4SNoralf Trønnes const uint32_t *formats, unsigned int format_count,
170174102f4SNoralf Trønnes const struct drm_display_mode *mode,
171174102f4SNoralf Trønnes unsigned int rotation, size_t tx_buf_size);
172174102f4SNoralf Trønnes int mipi_dbi_dev_init(struct mipi_dbi_dev *dbidev,
173174102f4SNoralf Trønnes const struct drm_simple_display_pipe_funcs *funcs,
174174102f4SNoralf Trønnes const struct drm_display_mode *mode, unsigned int rotation);
175216b9bbaSThomas Zimmermann enum drm_mode_status mipi_dbi_pipe_mode_valid(struct drm_simple_display_pipe *pipe,
176216b9bbaSThomas Zimmermann const struct drm_display_mode *mode);
177174102f4SNoralf Trønnes void mipi_dbi_pipe_update(struct drm_simple_display_pipe *pipe,
178174102f4SNoralf Trønnes struct drm_plane_state *old_state);
179174102f4SNoralf Trønnes void mipi_dbi_enable_flush(struct mipi_dbi_dev *dbidev,
180174102f4SNoralf Trønnes struct drm_crtc_state *crtc_state,
181174102f4SNoralf Trønnes struct drm_plane_state *plan_state);
182174102f4SNoralf Trønnes void mipi_dbi_pipe_disable(struct drm_simple_display_pipe *pipe);
183e7caf04dSThomas Zimmermann int mipi_dbi_pipe_begin_fb_access(struct drm_simple_display_pipe *pipe,
184e7caf04dSThomas Zimmermann struct drm_plane_state *plane_state);
185e7caf04dSThomas Zimmermann void mipi_dbi_pipe_end_fb_access(struct drm_simple_display_pipe *pipe,
186e7caf04dSThomas Zimmermann struct drm_plane_state *plane_state);
187e7caf04dSThomas Zimmermann void mipi_dbi_pipe_reset_plane(struct drm_simple_display_pipe *pipe);
188e7caf04dSThomas Zimmermann struct drm_plane_state *mipi_dbi_pipe_duplicate_plane_state(struct drm_simple_display_pipe *pipe);
189e7caf04dSThomas Zimmermann void mipi_dbi_pipe_destroy_plane_state(struct drm_simple_display_pipe *pipe,
190e7caf04dSThomas Zimmermann struct drm_plane_state *plane_state);
191e7caf04dSThomas Zimmermann
192174102f4SNoralf Trønnes void mipi_dbi_hw_reset(struct mipi_dbi *dbi);
193174102f4SNoralf Trønnes bool mipi_dbi_display_is_on(struct mipi_dbi *dbi);
194174102f4SNoralf Trønnes int mipi_dbi_poweron_reset(struct mipi_dbi_dev *dbidev);
195174102f4SNoralf Trønnes int mipi_dbi_poweron_conditional_reset(struct mipi_dbi_dev *dbidev);
196174102f4SNoralf Trønnes
197174102f4SNoralf Trønnes u32 mipi_dbi_spi_cmd_max_speed(struct spi_device *spi, size_t len);
198174102f4SNoralf Trønnes int mipi_dbi_spi_transfer(struct spi_device *spi, u32 speed_hz,
199174102f4SNoralf Trønnes u8 bpw, const void *buf, size_t len);
200174102f4SNoralf Trønnes
201174102f4SNoralf Trønnes int mipi_dbi_command_read(struct mipi_dbi *dbi, u8 cmd, u8 *val);
202174102f4SNoralf Trønnes int mipi_dbi_command_buf(struct mipi_dbi *dbi, u8 cmd, u8 *data, size_t len);
203f019190bSGeert Uytterhoeven int mipi_dbi_command_stackbuf(struct mipi_dbi *dbi, u8 cmd, const u8 *data,
204f019190bSGeert Uytterhoeven size_t len);
205b5f636e6SThomas Zimmermann int mipi_dbi_buf_copy(void *dst, struct iosys_map *src, struct drm_framebuffer *fb,
2064cd24d4bSThomas Zimmermann struct drm_rect *clip, bool swap,
2074cd24d4bSThomas Zimmermann struct drm_format_conv_state *fmtcnv_state);
208b5f636e6SThomas Zimmermann
209174102f4SNoralf Trønnes /**
210174102f4SNoralf Trønnes * mipi_dbi_command - MIPI DCS command with optional parameter(s)
211174102f4SNoralf Trønnes * @dbi: MIPI DBI structure
212174102f4SNoralf Trønnes * @cmd: Command
2132b405ec0SJonathan Neuschäfer * @seq: Optional parameter(s)
214174102f4SNoralf Trønnes *
215174102f4SNoralf Trønnes * Send MIPI DCS command to the controller. Use mipi_dbi_command_read() for
216174102f4SNoralf Trønnes * get/read.
217174102f4SNoralf Trønnes *
218174102f4SNoralf Trønnes * Returns:
219174102f4SNoralf Trønnes * Zero on success, negative error code on failure.
220174102f4SNoralf Trønnes */
221174102f4SNoralf Trønnes #define mipi_dbi_command(dbi, cmd, seq...) \
222174102f4SNoralf Trønnes ({ \
223f019190bSGeert Uytterhoeven const u8 d[] = { seq }; \
2243f5aa5acSLinus Walleij struct device *dev = &(dbi)->spi->dev; \
2253f5aa5acSLinus Walleij int ret; \
2263f5aa5acSLinus Walleij ret = mipi_dbi_command_stackbuf(dbi, cmd, d, ARRAY_SIZE(d)); \
2273f5aa5acSLinus Walleij if (ret) \
2283f5aa5acSLinus Walleij dev_err_ratelimited(dev, "error %d when sending command %#02x\n", ret, cmd); \
2293f5aa5acSLinus Walleij ret; \
230174102f4SNoralf Trønnes })
231174102f4SNoralf Trønnes
232174102f4SNoralf Trønnes #ifdef CONFIG_DEBUG_FS
2337ce84471SWambui Karuga void mipi_dbi_debugfs_init(struct drm_minor *minor);
234174102f4SNoralf Trønnes #else
mipi_dbi_debugfs_init(struct drm_minor * minor)2356844a288SVille Syrjälä static inline void mipi_dbi_debugfs_init(struct drm_minor *minor) {}
236174102f4SNoralf Trønnes #endif
237174102f4SNoralf Trønnes
23863aa5ec6SThomas Zimmermann /**
23963aa5ec6SThomas Zimmermann * DRM_MIPI_DBI_SIMPLE_DISPLAY_PIPE_FUNCS - Initializes struct drm_simple_display_pipe_funcs
24063aa5ec6SThomas Zimmermann * for MIPI-DBI devices
24163aa5ec6SThomas Zimmermann * @enable_: Enable-callback implementation
24263aa5ec6SThomas Zimmermann *
24363aa5ec6SThomas Zimmermann * This macro initializes struct drm_simple_display_pipe_funcs with default
24463aa5ec6SThomas Zimmermann * values for MIPI-DBI-based devices. The only callback that depends on the
24563aa5ec6SThomas Zimmermann * hardware is @enable, for which the driver has to provide an implementation.
24663aa5ec6SThomas Zimmermann * MIPI-based drivers are encouraged to use this macro for initialization.
24763aa5ec6SThomas Zimmermann */
24863aa5ec6SThomas Zimmermann #define DRM_MIPI_DBI_SIMPLE_DISPLAY_PIPE_FUNCS(enable_) \
24963aa5ec6SThomas Zimmermann .mode_valid = mipi_dbi_pipe_mode_valid, \
25063aa5ec6SThomas Zimmermann .enable = (enable_), \
25163aa5ec6SThomas Zimmermann .disable = mipi_dbi_pipe_disable, \
252e7caf04dSThomas Zimmermann .update = mipi_dbi_pipe_update, \
253e7caf04dSThomas Zimmermann .begin_fb_access = mipi_dbi_pipe_begin_fb_access, \
254e7caf04dSThomas Zimmermann .end_fb_access = mipi_dbi_pipe_end_fb_access, \
255e7caf04dSThomas Zimmermann .reset_plane = mipi_dbi_pipe_reset_plane, \
256e7caf04dSThomas Zimmermann .duplicate_plane_state = mipi_dbi_pipe_duplicate_plane_state, \
257e7caf04dSThomas Zimmermann .destroy_plane_state = mipi_dbi_pipe_destroy_plane_state
25863aa5ec6SThomas Zimmermann
259174102f4SNoralf Trønnes #endif /* __LINUX_MIPI_DBI_H */
260