3 * (C) COPYRIGHT 2013-2016 ARM Limited. All rights reserved.
5 * This program is free software and is provided to you under the terms of the
6 * GNU General Public License version 2 as published by the Free Software
7 * Foundation, and any use by you of this program is subject to the terms
10 * ARM Mali DP hardware manipulation routines.
13 #ifndef __MALIDP_HW_H__
14 #define __MALIDP_HW_H__
16 #include <linux/bitops.h>
17 #include "malidp_regs.h"
22 /* Mali DP IP blocks */
29 /* Mali DP layer IDs */
32 DE_GRAPHICS1 = BIT(1),
33 DE_GRAPHICS2 = BIT(2), /* used only in DP500 */
38 struct malidp_format_id {
39 u32 format; /* DRM fourcc */
40 u8 layer; /* bitmask of layers supporting it */
41 u8 id; /* used internally */
44 #define MALIDP_INVALID_FORMAT_ID 0xff
47 * hide the differences between register maps
48 * by using a common structure to hold the
49 * base register offsets
52 struct malidp_irq_map {
53 u32 irq_mask; /* mask of IRQs that can be enabled in the block */
54 u32 vsync_irq; /* IRQ bit used for signaling during VSYNC */
58 u16 id; /* layer ID */
59 u16 base; /* address offset for the register bank */
60 u16 ptr; /* address offset for the pointer register */
61 u16 stride_offset; /* Offset to the first stride register. */
64 enum malidp_scaling_coeff_set {
65 MALIDP_UPSCALING_COEFFS = 1,
66 MALIDP_DOWNSCALING_1_5_COEFFS = 2,
67 MALIDP_DOWNSCALING_2_COEFFS = 3,
68 MALIDP_DOWNSCALING_2_75_COEFFS = 4,
69 MALIDP_DOWNSCALING_4_COEFFS = 5,
72 struct malidp_se_config {
78 u16 output_w, output_h;
79 u32 h_init_phase, h_delta_phase;
80 u32 v_init_phase, v_delta_phase;
84 #define MALIDP_REGMAP_HAS_CLEARIRQ (1 << 0)
86 struct malidp_hw_regmap {
87 /* address offset of the DE register bank */
88 /* is always 0x0000 */
89 /* address offset of the DE coefficients registers */
90 const u16 coeffs_base;
91 /* address offset of the SE registers bank */
93 /* address offset of the DC registers bank */
96 /* address offset for the output depth register */
97 const u16 out_depth_base;
99 /* bitmap with register map features */
102 /* list of supported layers */
104 const struct malidp_layer *layers;
106 const struct malidp_irq_map de_irq_map;
107 const struct malidp_irq_map se_irq_map;
108 const struct malidp_irq_map dc_irq_map;
110 /* list of supported pixel formats for each layer */
111 const struct malidp_format_id *pixel_formats;
112 const u8 n_pixel_formats;
114 /* pitch alignment requirement in bytes */
115 const u8 bus_align_bytes;
118 /* device features */
119 /* Unlike DP550/650, DP500 has 3 stride registers in its video layer. */
120 #define MALIDP_DEVICE_LV_HAS_3_STRIDES BIT(0)
122 struct malidp_hw_device {
123 const struct malidp_hw_regmap map;
130 /* main clock for display core */
132 /* pixel clock for display core */
136 * Validate the driver instance against the hardware bits
138 int (*query_hw)(struct malidp_hw_device *hwdev);
141 * Set the hardware into config mode, ready to accept mode changes
143 void (*enter_config_mode)(struct malidp_hw_device *hwdev);
146 * Tell hardware to exit configuration mode
148 void (*leave_config_mode)(struct malidp_hw_device *hwdev);
151 * Query if hardware is in configuration mode
153 bool (*in_config_mode)(struct malidp_hw_device *hwdev);
156 * Set configuration valid flag for hardware parameters that can
157 * be changed outside the configuration mode. Hardware will use
158 * the new settings when config valid is set after the end of the
159 * current buffer scanout
161 void (*set_config_valid)(struct malidp_hw_device *hwdev);
164 * Set a new mode in hardware. Requires the hardware to be in
165 * configuration mode before this function is called.
167 void (*modeset)(struct malidp_hw_device *hwdev, struct videomode *m);
170 * Calculate the required rotation memory given the active area
171 * and the buffer format.
173 int (*rotmem_required)(struct malidp_hw_device *hwdev, u16 w, u16 h, u32 fmt);
175 int (*se_set_scaling_coeffs)(struct malidp_hw_device *hwdev,
176 struct malidp_se_config *se_config,
177 struct malidp_se_config *old_config);
184 /* track the device PM state */
187 /* size of memory used for rotating layers, up to two banks available */
188 u32 rotation_memory[2];
191 /* Supported variants of the hardware */
196 /* keep the next entry last */
200 extern const struct malidp_hw_device malidp_device[MALIDP_MAX_DEVICES];
202 static inline u32 malidp_hw_read(struct malidp_hw_device *hwdev, u32 reg)
204 WARN_ON(hwdev->pm_suspended);
205 return readl(hwdev->regs + reg);
208 static inline void malidp_hw_write(struct malidp_hw_device *hwdev,
211 WARN_ON(hwdev->pm_suspended);
212 writel(value, hwdev->regs + reg);
215 static inline void malidp_hw_setbits(struct malidp_hw_device *hwdev,
218 u32 data = malidp_hw_read(hwdev, reg);
221 malidp_hw_write(hwdev, data, reg);
224 static inline void malidp_hw_clearbits(struct malidp_hw_device *hwdev,
227 u32 data = malidp_hw_read(hwdev, reg);
230 malidp_hw_write(hwdev, data, reg);
233 static inline u32 malidp_get_block_base(struct malidp_hw_device *hwdev,
237 case MALIDP_SE_BLOCK:
238 return hwdev->map.se_base;
239 case MALIDP_DC_BLOCK:
240 return hwdev->map.dc_base;
246 static inline void malidp_hw_disable_irq(struct malidp_hw_device *hwdev,
249 u32 base = malidp_get_block_base(hwdev, block);
251 malidp_hw_clearbits(hwdev, irq, base + MALIDP_REG_MASKIRQ);
254 static inline void malidp_hw_enable_irq(struct malidp_hw_device *hwdev,
257 u32 base = malidp_get_block_base(hwdev, block);
259 malidp_hw_setbits(hwdev, irq, base + MALIDP_REG_MASKIRQ);
262 int malidp_de_irq_init(struct drm_device *drm, int irq);
263 void malidp_de_irq_fini(struct drm_device *drm);
264 int malidp_se_irq_init(struct drm_device *drm, int irq);
265 void malidp_se_irq_fini(struct drm_device *drm);
267 u8 malidp_hw_get_format_id(const struct malidp_hw_regmap *map,
268 u8 layer_id, u32 format);
270 static inline bool malidp_hw_pitch_valid(struct malidp_hw_device *hwdev,
273 return !(pitch & (hwdev->map.bus_align_bytes - 1));
277 #define FP_1_00000 0x00010000 /* 1.0 */
278 #define FP_0_66667 0x0000AAAA /* 0.6667 = 1/1.5 */
279 #define FP_0_50000 0x00008000 /* 0.5 = 1/2 */
280 #define FP_0_36363 0x00005D17 /* 0.36363 = 1/2.75 */
281 #define FP_0_25000 0x00004000 /* 0.25 = 1/4 */
283 static inline enum malidp_scaling_coeff_set
284 malidp_se_select_coeffs(u32 upscale_factor)
286 return (upscale_factor >= FP_1_00000) ? MALIDP_UPSCALING_COEFFS :
287 (upscale_factor >= FP_0_66667) ? MALIDP_DOWNSCALING_1_5_COEFFS :
288 (upscale_factor >= FP_0_50000) ? MALIDP_DOWNSCALING_2_COEFFS :
289 (upscale_factor >= FP_0_36363) ? MALIDP_DOWNSCALING_2_75_COEFFS :
290 MALIDP_DOWNSCALING_4_COEFFS;
299 * background color components are defined as 12bits values,
300 * they will be shifted right when stored on hardware that
301 * supports only 8bits per channel
303 #define MALIDP_BGND_COLOR_R 0x000
304 #define MALIDP_BGND_COLOR_G 0x000
305 #define MALIDP_BGND_COLOR_B 0x000
307 #define MALIDP_COLORADJ_NUM_COEFFS 12
308 #define MALIDP_COEFFTAB_NUM_COEFFS 64
310 #define MALIDP_GAMMA_LUT_SIZE 4096
312 #endif /* __MALIDP_HW_H__ */