xref: /linux/drivers/gpu/drm/omapdrm/omap_dmm_tiler.h (revision ae22a94997b8a03dcb3c922857c203246711f9d4)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2011 Texas Instruments Incorporated - https://www.ti.com/
4  * Author: Rob Clark <rob@ti.com>
5  *         Andy Gross <andy.gross@ti.com>
6  */
7 #ifndef OMAP_DMM_TILER_H
8 #define OMAP_DMM_TILER_H
9 
10 #include "omap_drv.h"
11 #include "tcm.h"
12 
13 enum tiler_fmt {
14 	TILFMT_8BIT = 0,
15 	TILFMT_16BIT,
16 	TILFMT_32BIT,
17 	TILFMT_PAGE,
18 	TILFMT_NFORMATS
19 };
20 
21 struct pat_area {
22 	u32 x0:8;
23 	u32 y0:8;
24 	u32 x1:8;
25 	u32 y1:8;
26 };
27 
28 struct tiler_block {
29 	struct list_head alloc_node;	/* node for global block list */
30 	struct tcm_area area;		/* area */
31 	enum tiler_fmt fmt;		/* format */
32 };
33 
34 /* bits representing the same slot in DMM-TILER hw-block */
35 #define SLOT_WIDTH_BITS         6
36 #define SLOT_HEIGHT_BITS        6
37 
38 /* bits reserved to describe coordinates in DMM-TILER hw-block */
39 #define CONT_WIDTH_BITS         14
40 #define CONT_HEIGHT_BITS        13
41 
42 /* calculated constants */
43 #define TILER_PAGE              (1 << (SLOT_WIDTH_BITS + SLOT_HEIGHT_BITS))
44 #define TILER_WIDTH             (1 << (CONT_WIDTH_BITS - SLOT_WIDTH_BITS))
45 #define TILER_HEIGHT            (1 << (CONT_HEIGHT_BITS - SLOT_HEIGHT_BITS))
46 
47 /*
48 Table 15-11. Coding and Description of TILER Orientations
49 S Y X	Description				Alternate description
50 0 0 0	0-degree view				Natural view
51 0 0 1	0-degree view with vertical mirror 	180-degree view with horizontal mirror
52 0 1 0	0-degree view with horizontal mirror 	180-degree view with vertical mirror
53 0 1 1	180-degree view
54 1 0 0	90-degree view with vertical mirror	270-degree view with horizontal mirror
55 1 0 1	270-degree view
56 1 1 0	90-degree view
57 1 1 1	90-degree view with horizontal mirror	270-degree view with vertical mirror
58  */
59 #define MASK_XY_FLIP		(1 << 31)
60 #define MASK_Y_INVERT		(1 << 30)
61 #define MASK_X_INVERT		(1 << 29)
62 #define SHIFT_ACC_MODE		27
63 #define MASK_ACC_MODE		3
64 
65 #define MASK(bits) ((1 << (bits)) - 1)
66 
67 #define TILVIEW_8BIT    0x60000000u
68 #define TILVIEW_16BIT   (TILVIEW_8BIT  + VIEW_SIZE)
69 #define TILVIEW_32BIT   (TILVIEW_16BIT + VIEW_SIZE)
70 #define TILVIEW_PAGE    (TILVIEW_32BIT + VIEW_SIZE)
71 #define TILVIEW_END     (TILVIEW_PAGE  + VIEW_SIZE)
72 
73 /* create tsptr by adding view orientation and access mode */
74 #define TIL_ADDR(x, orient, a)\
75 	((u32) (x) | (orient) | ((a) << SHIFT_ACC_MODE))
76 
77 #ifdef CONFIG_DEBUG_FS
78 int tiler_map_show(struct seq_file *s, void *arg);
79 #endif
80 
81 /* pin/unpin */
82 int tiler_pin(struct tiler_block *block, struct page **pages,
83 		u32 npages, u32 roll, bool wait);
84 int tiler_unpin(struct tiler_block *block);
85 
86 /* reserve/release */
87 struct tiler_block *tiler_reserve_2d(enum tiler_fmt fmt, u16 w, u16 h,
88 				u16 align);
89 struct tiler_block *tiler_reserve_1d(size_t size);
90 int tiler_release(struct tiler_block *block);
91 
92 /* utilities */
93 dma_addr_t tiler_ssptr(struct tiler_block *block);
94 dma_addr_t tiler_tsptr(struct tiler_block *block, u32 orient,
95 		u32 x, u32 y);
96 u32 tiler_stride(enum tiler_fmt fmt, u32 orient);
97 size_t tiler_size(enum tiler_fmt fmt, u16 w, u16 h);
98 size_t tiler_vsize(enum tiler_fmt fmt, u16 w, u16 h);
99 void tiler_align(enum tiler_fmt fmt, u16 *w, u16 *h);
100 u32 tiler_get_cpu_cache_flags(void);
101 bool dmm_is_available(void);
102 
103 extern struct platform_driver omap_dmm_driver;
104 
105 /* GEM bo flags -> tiler fmt */
106 static inline enum tiler_fmt gem2fmt(u32 flags)
107 {
108 	switch (flags & OMAP_BO_TILED_MASK) {
109 	case OMAP_BO_TILED_8:
110 		return TILFMT_8BIT;
111 	case OMAP_BO_TILED_16:
112 		return TILFMT_16BIT;
113 	case OMAP_BO_TILED_32:
114 		return TILFMT_32BIT;
115 	default:
116 		return TILFMT_PAGE;
117 	}
118 }
119 
120 static inline bool validfmt(enum tiler_fmt fmt)
121 {
122 	switch (fmt) {
123 	case TILFMT_8BIT:
124 	case TILFMT_16BIT:
125 	case TILFMT_32BIT:
126 	case TILFMT_PAGE:
127 		return true;
128 	default:
129 		return false;
130 	}
131 }
132 
133 #endif
134