2 * MIPI Display Bus Interface (DBI) LCD controller support
4 * Copyright 2016 Noralf Trønnes
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
12 #ifndef __LINUX_MIPI_DBI_H
13 #define __LINUX_MIPI_DBI_H
15 #include <drm/tinydrm/tinydrm.h>
23 * struct mipi_dbi - MIPI DBI controller
24 * @tinydrm: tinydrm base
26 * @enabled: Pipeline is enabled
27 * @cmdlock: Command lock
28 * @command: Bus specific callback executing commands.
29 * @read_commands: Array of read commands terminated by a zero entry.
30 * Reading is disabled if this is NULL.
31 * @dc: Optional D/C gpio.
32 * @tx_buf: Buffer used for transfer (copy clip rect area)
33 * @tx_buf9: Buffer used for Option 1 9-bit conversion
34 * @tx_buf9_len: Size of tx_buf9.
35 * @swap_bytes: Swap bytes in buffer before transfer
36 * @reset: Optional reset gpio
37 * @rotation: initial rotation in degrees Counter Clock Wise
38 * @backlight: backlight device (optional)
39 * @regulator: power regulator (optional)
42 struct tinydrm_device tinydrm
;
43 struct spi_device
*spi
;
46 int (*command
)(struct mipi_dbi
*mipi
, u8 cmd
, u8
*param
, size_t num
);
47 const u8
*read_commands
;
53 struct gpio_desc
*reset
;
54 unsigned int rotation
;
55 struct backlight_device
*backlight
;
56 struct regulator
*regulator
;
59 static inline struct mipi_dbi
*
60 mipi_dbi_from_tinydrm(struct tinydrm_device
*tdev
)
62 return container_of(tdev
, struct mipi_dbi
, tinydrm
);
65 int mipi_dbi_spi_init(struct spi_device
*spi
, struct mipi_dbi
*mipi
,
66 struct gpio_desc
*dc
);
67 int mipi_dbi_init(struct device
*dev
, struct mipi_dbi
*mipi
,
68 const struct drm_simple_display_pipe_funcs
*pipe_funcs
,
69 struct drm_driver
*driver
,
70 const struct drm_display_mode
*mode
, unsigned int rotation
);
71 void mipi_dbi_pipe_update(struct drm_simple_display_pipe
*pipe
,
72 struct drm_plane_state
*old_state
);
73 void mipi_dbi_enable_flush(struct mipi_dbi
*mipi
,
74 struct drm_crtc_state
*crtc_state
,
75 struct drm_plane_state
*plan_state
);
76 void mipi_dbi_pipe_disable(struct drm_simple_display_pipe
*pipe
);
77 void mipi_dbi_hw_reset(struct mipi_dbi
*mipi
);
78 bool mipi_dbi_display_is_on(struct mipi_dbi
*mipi
);
79 int mipi_dbi_poweron_reset(struct mipi_dbi
*mipi
);
80 int mipi_dbi_poweron_conditional_reset(struct mipi_dbi
*mipi
);
81 u32
mipi_dbi_spi_cmd_max_speed(struct spi_device
*spi
, size_t len
);
83 int mipi_dbi_command_read(struct mipi_dbi
*mipi
, u8 cmd
, u8
*val
);
84 int mipi_dbi_command_buf(struct mipi_dbi
*mipi
, u8 cmd
, u8
*data
, size_t len
);
85 int mipi_dbi_buf_copy(void *dst
, struct drm_framebuffer
*fb
,
86 struct drm_rect
*clip
, bool swap
);
88 * mipi_dbi_command - MIPI DCS command with optional parameter(s)
89 * @mipi: MIPI structure
91 * @seq...: Optional parameter(s)
93 * Send MIPI DCS command to the controller. Use mipi_dbi_command_read() for
97 * Zero on success, negative error code on failure.
99 #define mipi_dbi_command(mipi, cmd, seq...) \
102 mipi_dbi_command_buf(mipi, cmd, d, ARRAY_SIZE(d)); \
105 #ifdef CONFIG_DEBUG_FS
106 int mipi_dbi_debugfs_init(struct drm_minor
*minor
);
108 #define mipi_dbi_debugfs_init NULL
111 #endif /* __LINUX_MIPI_DBI_H */