master
1/*-
2 * Copyright 2014 Svatopluk Kraus <onwahe@gmail.com>
3 * Copyright 2014 Michal Meloun <meloun@miracle.cz>
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 * SUCH DAMAGE.
26 */
27
28#ifndef _MACHINE_PTE_V6_H_
29#define _MACHINE_PTE_V6_H_
30
31/*
32 * Domain Types for the Domain Access Control Register.
33 */
34#define DOMAIN_FAULT 0x00 /* no access */
35#define DOMAIN_CLIENT 0x01 /* client */
36#define DOMAIN_RESERVED 0x02 /* reserved */
37#define DOMAIN_MANAGER 0x03 /* manager */
38
39/*
40 * TEX remap registers attributes
41 */
42#define PRRR_SO 0 /* Strongly ordered memory */
43#define PRRR_DEV 1 /* Device memory */
44#define PRRR_MEM 2 /* Normal memory */
45#define PRRR_DS0 (1 << 16) /* Shared bit for Device, S = 0 */
46#define PRRR_DS1 (1 << 17) /* Shared bit for Device, S = 1 */
47#define PRRR_NS0 (1 << 18) /* Shared bit for Normal, S = 0 */
48#define PRRR_NS1 (1 << 19) /* Shared bit for Normal, S = 1 */
49#define PRRR_NOS_SHIFT 24 /* base shif for Not Outer Shared bits */
50
51#define NMRR_NC 0 /* Noncachable*/
52#define NMRR_WB_WA 1 /* Write Back, Write Allocate */
53#define NMRR_WT 2 /* Write Through, Non-Write Allocate */
54#define NMRR_WB 3 /* Write Back, Non-Write Allocate */
55
56/*
57 *
58 * The ARM MMU is capable of mapping memory in the following chunks:
59 *
60 * 16M Supersections (L1 table)
61 *
62 * 1M Sections (L1 table)
63 *
64 * 64K Large Pages (L2 table)
65 *
66 * 4K Small Pages (L2 table)
67 *
68 *
69 * Coarse Tables can map Large and Small Pages.
70 * Coarse Tables are 1K in length.
71 *
72 * The Translation Table Base register holds the pointer to the
73 * L1 Table. The L1 Table is a 16K contiguous chunk of memory
74 * aligned to a 16K boundary. Each entry in the L1 Table maps
75 * 1M of virtual address space, either via a Section mapping or
76 * via an L2 Table.
77 *
78 */
79#define L1_TABLE_SIZE 0x4000 /* 16K */
80#define L1_ENTRIES 0x1000 /* 4K */
81#define L2_TABLE_SIZE 0x0400 /* 1K */
82#define L2_ENTRIES 0x0100 /* 256 */
83
84/* ARMv6 super-sections. */
85#define L1_SUP_SIZE 0x01000000 /* 16M */
86#define L1_SUP_OFFSET (L1_SUP_SIZE - 1)
87#define L1_SUP_FRAME (~L1_SUP_OFFSET)
88#define L1_SUP_SHIFT 24
89
90#define L1_S_SIZE 0x00100000 /* 1M */
91#define L1_S_OFFSET (L1_S_SIZE - 1)
92#define L1_S_FRAME (~L1_S_OFFSET)
93#define L1_S_SHIFT 20
94
95#define L2_L_SIZE 0x00010000 /* 64K */
96#define L2_L_OFFSET (L2_L_SIZE - 1)
97#define L2_L_FRAME (~L2_L_OFFSET)
98#define L2_L_SHIFT 16
99
100#define L2_S_SIZE 0x00001000 /* 4K */
101#define L2_S_OFFSET (L2_S_SIZE - 1)
102#define L2_S_FRAME (~L2_S_OFFSET)
103#define L2_S_SHIFT 12
104
105/*
106 * ARM MMU L1 Descriptors
107 */
108#define L1_TYPE_INV 0x00 /* Invalid (fault) */
109#define L1_TYPE_C 0x01 /* Coarse L2 */
110#define L1_TYPE_S 0x02 /* Section */
111#define L1_TYPE_MASK 0x03 /* Mask of type bits */
112
113/* L1 Section Descriptor */
114#define L1_S_B 0x00000004 /* bufferable Section */
115#define L1_S_C 0x00000008 /* cacheable Section */
116#define L1_S_NX 0x00000010 /* not executeable */
117#define L1_S_DOM(x) ((x) << 5) /* domain */
118#define L1_S_DOM_MASK L1_S_DOM(0xf)
119#define L1_S_P 0x00000200 /* ECC enable for this section */
120#define L1_S_AP(x) ((x) << 10) /* access permissions */
121#define L1_S_AP0 0x00000400 /* access permissions bit 0 */
122#define L1_S_AP1 0x00000800 /* access permissions bit 1 */
123#define L1_S_TEX(x) ((x) << 12) /* type extension */
124#define L1_S_TEX0 0x00001000 /* type extension bit 0 */
125#define L1_S_TEX1 0x00002000 /* type extension bit 1 */
126#define L1_S_TEX2 0x00004000 /* type extension bit 2 */
127#define L1_S_AP2 0x00008000 /* access permissions bit 2 */
128#define L1_S_SHARED 0x00010000 /* shared */
129#define L1_S_NG 0x00020000 /* not global */
130#define L1_S_SUPERSEC 0x00040000 /* Section is a super-section. */
131#define L1_S_ADDR_MASK 0xfff00000 /* phys address of section */
132
133/* L1 Coarse Descriptor */
134#define L1_C_DOM(x) ((x) << 5) /* domain */
135#define L1_C_DOM_MASK L1_C_DOM(0xf)
136#define L1_C_P 0x00000200 /* ECC enable for this section */
137#define L1_C_ADDR_MASK 0xfffffc00 /* phys address of L2 Table */
138
139/*
140 * ARM MMU L2 Descriptors
141 */
142#define L2_TYPE_INV 0x00 /* Invalid (fault) */
143#define L2_TYPE_L 0x01 /* Large Page - 64k - not used yet*/
144#define L2_TYPE_S 0x02 /* Small Page - 4 */
145#define L2_TYPE_MASK 0x03
146
147#define L2_NX 0x00000001 /* Not executable */
148#define L2_B 0x00000004 /* Bufferable page */
149#define L2_C 0x00000008 /* Cacheable page */
150#define L2_CB_SHIFT 2 /* C,B bit field shift */
151#define L2_AP(x) ((x) << 4)
152#define L2_AP0 0x00000010 /* access permissions bit 0*/
153#define L2_AP1 0x00000020 /* access permissions bit 1*/
154#define L2_TEX_SHIFT 6 /* type extension field shift */
155#define L2_TEX(x) ((x) << L2_TEX_SHIFT) /* type extension */
156#define L2_TEX0 0x00000040 /* type extension bit 0 */
157#define L2_TEX1 0x00000080 /* type extension bit 1 */
158#define L2_TEX2 0x00000100 /* type extension bit 2 */
159#define L2_AP2 0x00000200 /* access permissions bit 2*/
160#define L2_SHARED 0x00000400 /* shared */
161#define L2_NG 0x00000800 /* not global */
162
163/*
164 * TEX classes encoding
165 */
166#define TEX1_CLASS_0 ( 0)
167#define TEX1_CLASS_1 ( L1_S_B)
168#define TEX1_CLASS_2 ( L1_S_C )
169#define TEX1_CLASS_3 ( L1_S_C | L1_S_B)
170#define TEX1_CLASS_4 (L1_S_TEX0 )
171#define TEX1_CLASS_5 (L1_S_TEX0 | L1_S_B)
172#define TEX1_CLASS_6 (L1_S_TEX0 | L1_S_C ) /* Reserved for ARM11 */
173#define TEX1_CLASS_7 (L1_S_TEX0 | L1_S_C | L1_S_B)
174
175#define TEX2_CLASS_0 ( 0)
176#define TEX2_CLASS_1 ( L2_B)
177#define TEX2_CLASS_2 ( L2_C )
178#define TEX2_CLASS_3 ( L2_C | L2_B)
179#define TEX2_CLASS_4 (L2_TEX0 )
180#define TEX2_CLASS_5 (L2_TEX0 | L2_B)
181#define TEX2_CLASS_6 (L2_TEX0 | L2_C ) /* Reserved for ARM11 */
182#define TEX2_CLASS_7 (L2_TEX0 | L2_C | L2_B)
183
184/* L1 table definitions. */
185#define NB_IN_PT1 L1_TABLE_SIZE
186#define NPTE1_IN_PT1 L1_ENTRIES
187
188/* L2 table definitions. */
189#define NB_IN_PT2 L2_TABLE_SIZE
190#define NPTE2_IN_PT2 L2_ENTRIES
191
192/*
193 * Map memory attributes to TEX classes
194 */
195#define PTE2_ATTR_WB_WA TEX2_CLASS_0
196#define PTE2_ATTR_NOCACHE TEX2_CLASS_1
197#define PTE2_ATTR_DEVICE TEX2_CLASS_2
198#define PTE2_ATTR_SO TEX2_CLASS_3
199#define PTE2_ATTR_WT TEX2_CLASS_4
200/*
201 * Software defined bits for L1 descriptors
202 * - L1_AP0 is used as page accessed bit
203 * - L1_AP2 (RO / not RW) is used as page not modified bit
204 * - L1_TEX0 is used as software emulated RO bit
205 */
206#define PTE1_V L1_TYPE_S /* Valid bit */
207#define PTE1_A L1_S_AP0 /* Accessed - software emulated */
208#define PTE1_NM L1_S_AP2 /* not modified bit - software emulated
209 * used as real write enable bit */
210#define PTE1_M 0 /* Modified (dummy) */
211#define PTE1_S L1_S_SHARED /* Shared */
212#define PTE1_NG L1_S_NG /* Not global */
213#define PTE1_G 0 /* Global (dummy) */
214#define PTE1_NX L1_S_NX /* Not executable */
215#define PTE1_X 0 /* Executable (dummy) */
216#define PTE1_RO L1_S_TEX1 /* Read Only */
217#define PTE1_RW 0 /* Read-Write (dummy) */
218#define PTE1_U L1_S_AP1 /* User */
219#define PTE1_NU 0 /* Not user (kernel only) (dummy) */
220#define PTE1_W L1_S_TEX2 /* Wired */
221
222#define PTE1_SHIFT L1_S_SHIFT
223#define PTE1_SIZE L1_S_SIZE
224#define PTE1_OFFSET L1_S_OFFSET
225#define PTE1_FRAME L1_S_FRAME
226
227#define PTE1_ATTR_MASK (L1_S_TEX0 | L1_S_C | L1_S_B)
228
229#define PTE1_AP_KR (PTE1_RO | PTE1_NM)
230#define PTE1_AP_KRW 0
231#define PTE1_AP_KRUR (PTE1_RO | PTE1_NM | PTE1_U)
232#define PTE1_AP_KRWURW PTE1_U
233
234/*
235 * PTE1 descriptors creation macros.
236 */
237#define PTE1_PA(pa) ((pa) & PTE1_FRAME)
238#define PTE1_AP_COMMON (PTE1_V | PTE1_S)
239
240#define PTE1(pa, ap, attr) (PTE1_PA(pa) | (ap) | (attr) | PTE1_AP_COMMON)
241
242#define PTE1_KERN(pa, ap, attr) PTE1(pa, (ap) | PTE1_A | PTE1_G, attr)
243#define PTE1_KERN_NG(pa, ap, attr) PTE1(pa, (ap) | PTE1_A | PTE1_NG, attr)
244
245#define PTE1_LINK(pa) (((pa) & L1_C_ADDR_MASK) | L1_TYPE_C)
246
247/*
248 * Software defined bits for L2 descriptors
249 * - L2_AP0 is used as page accessed bit
250 * - L2_AP2 (RO / not RW) is used as page not modified bit
251 * - L2_TEX0 is used as software emulated RO bit
252 */
253#define PTE2_V L2_TYPE_S /* Valid bit */
254#define PTE2_A L2_AP0 /* Accessed - software emulated */
255#define PTE2_NM L2_AP2 /* not modified bit - software emulated
256 * used as real write enable bit */
257#define PTE2_M 0 /* Modified (dummy) */
258#define PTE2_S L2_SHARED /* Shared */
259#define PTE2_NG L2_NG /* Not global */
260#define PTE2_G 0 /* Global (dummy) */
261#define PTE2_NX L2_NX /* Not executable */
262#define PTE2_X 0 /* Not executable (dummy) */
263#define PTE2_RO L2_TEX1 /* Read Only */
264#define PTE2_U L2_AP1 /* User */
265#define PTE2_NU 0 /* Not user (kernel only) (dummy) */
266#define PTE2_W L2_TEX2 /* Wired */
267
268#define PTE2_SHIFT L2_S_SHIFT
269#define PTE2_SIZE L2_S_SIZE
270#define PTE2_OFFSET L2_S_OFFSET
271#define PTE2_FRAME L2_S_FRAME
272
273#define PTE2_ATTR_MASK (L2_TEX0 | L2_C | L2_B)
274/* PTE2 attributes to TEX class index: (TEX0 C B) */
275#define PTE2_ATTR2IDX(attr) \
276 ((((attr) & (L2_C | L2_B)) >> L2_CB_SHIFT) | \
277 (((attr) & L2_TEX0) >> (L2_TEX_SHIFT - L2_CB_SHIFT)))
278
279#define PTE2_AP_KR (PTE2_RO | PTE2_NM)
280#define PTE2_AP_KRW 0
281#define PTE2_AP_KRUR (PTE2_RO | PTE2_NM | PTE2_U)
282#define PTE2_AP_KRWURW PTE2_U
283
284/*
285 * PTE2 descriptors creation macros.
286 */
287#define PTE2_PA(pa) ((pa) & PTE2_FRAME)
288#define PTE2_AP_COMMON (PTE2_V | PTE2_S)
289
290#define PTE2(pa, ap, attr) (PTE2_PA(pa) | (ap) | (attr) | PTE2_AP_COMMON)
291
292#define PTE2_KERN(pa, ap, attr) PTE2(pa, (ap) | PTE2_A | PTE2_G, attr)
293#define PTE2_KERN_NG(pa, ap, attr) PTE2(pa, (ap) | PTE2_A | PTE2_NG, attr)
294
295#endif /* !_MACHINE_PTE_V6_H_ */