summaryrefslogtreecommitdiffstats
path: root/bsps/powerpc/virtex5/include/bsp/mmu.h
blob: 7c2295f900cbaec0ec7e3fc83ca3b83d2ed82b4d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
#ifndef RTEMS_VIRTEX5_MMU_H
#define RTEMS_VIRTEX5_MMU_H
/**
 * @file
 *
 * @ingroup RTEMSBSPsPowerPCVirtex5MMU
 *
 * @brief Routines to manipulate the PPC 440 MMU.
 */
/*
 * Authorship
 * ----------
 * This software was created by
 *     Till Straumann <strauman@slac.stanford.edu>, 2005-2007,
 *       Stanford Linear Accelerator Center, Stanford University.
 * and was transcribed for the PPC 440 by
 *     R. Claus <claus@slac.stanford.edu>, 2012,
 *       Stanford Linear Accelerator Center, Stanford University,
 *
 * Acknowledgement of sponsorship
 * ------------------------------
 * This software was produced by
 *     the Stanford Linear Accelerator Center, Stanford University,
 *     under Contract DE-AC03-76SFO0515 with the Department of Energy.
 *
 * Government disclaimer of liability
 * ----------------------------------
 * Neither the United States nor the United States Department of Energy,
 * nor any of their employees, makes any warranty, express or implied, or
 * assumes any legal liability or responsibility for the accuracy,
 * completeness, or usefulness of any data, apparatus, product, or process
 * disclosed, or represents that its use would not infringe privately owned
 * rights.
 *
 * Stanford disclaimer of liability
 * --------------------------------
 * Stanford University makes no representations or warranties, express or
 * implied, nor assumes any liability for the use of this software.
 *
 * Stanford disclaimer of copyright
 * --------------------------------
 * Stanford University, owner of the copyright, hereby disclaims its
 * copyright and all other rights in this software.  Hence, anyone may
 * freely use it for any purpose without restriction.
 *
 * Maintenance of notices
 * ----------------------
 * In the interest of clarity regarding the origin and status of this
 * SLAC software, this and all the preceding Stanford University notices
 * are to remain affixed to any copy or derivative of this software made
 * or distributed by the recipient and are to be affixed to any copy of
 * software made or distributed by the recipient that contains a copy or
 * derivative of this software.
 *
 * ------------------ SLAC Software Notices, Set 4 OTT.002a, 2004 FEB 03
 */

#include <rtems.h>
#include <inttypes.h>
#include <stdio.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @defgroup Virtex5MMU Virtex 5 - MMU Support
 *
 * @ingroup RTEMSBSPsPowerPCVirtex5
 *
 * @brief MMU support.
 *
 * @{
 */

/* Some routines require or return an index 'key'.
 */
typedef int bsp_tlb_idx_t;

/* Cache the relevant TLB entries so that we can make sure the user cannot
 * create conflicting (overlapping) entries. Keep them public for informational
 * purposes.
 */
typedef struct {
  struct {
    uint32_t pad:24;
    uint32_t tid:8;             /** Translation ID */
  }        id;
  struct {
    uint32_t epn:22;            /** Effective page number */
    uint32_t v:1;               /** Valid */
    uint32_t ts:1;              /** Translation Address Space */
    uint32_t size:4;            /** Page size */
    uint32_t tpar:4;            /** Tag parity */
  }        w0;
  struct {
    uint32_t rpn:22;            /** The real (translated) page number. */
    uint32_t par1:2;            /** For matching the TLB array parity */
    uint32_t pad:4;
    uint32_t erpn:4;            /** Extended Real Page Number */
  }        w1;
  struct {
    uint32_t par2:2;            /** Parity for TLB word 2 */
    uint32_t pad1:14;
    uint32_t att:4;             /** User-defined attributes */
    uint32_t wimge:5;           /** Write-Through/Caching Inhibited/Memory Coherent/Guarded/Endian */
    uint32_t pad2:1;
    uint32_t perm:6;            /** User-State Executable/Writeable/Readable Supervisor-State Executable/Writeable/Readable */
  }        w2;
} bsp_tlb_entry_t;

#define NTLBS  64

extern bsp_tlb_entry_t* bsp_mmu_cache;

// These constants will have to be shifted right by 20 bits before
// being inserted the high word of the TLB.

#define MMU_M_SIZE_1K               (0x00000000U)
#define MMU_M_SIZE_4K               (0x08000000U)
#define MMU_M_SIZE_16K              (0x10000000U)
#define MMU_M_SIZE_64K              (0x18000000U)
#define MMU_M_SIZE_256K             (0x20000000U)
#define MMU_M_SIZE_1M               (0x28000000U)
#define MMU_M_SIZE_16M              (0x38000000U)
#define MMU_M_SIZE_256M             (0x48000000U)
#define MMU_M_SIZE_MIN              (MMU_M_SIZE_1K)
#define MMU_M_SIZE_MAX              (MMU_M_SIZE_256M)
#define MMU_M_SIZE                  (0x78000000U)
#define MMU_V_SIZE                  (27)

// These constants have the same bit positions they'll occupy
// in low word of the TLB.

#define MMU_M_ATTR_USER0            (0x00010000U)
#define MMU_M_ATTR_USER1            (0x00008000U)
#define MMU_M_ATTR_USER2            (0x00004000U)
#define MMU_M_ATTR_USER3            (0x00002000U)
#define MMU_M_ATTR                  (0x0001e000U)
#define MMU_V_ATTR                  (13)

#define MMU_M_PROP_WRITE_THROUGH    (0x00001000U)
#define MMU_M_PROP_UNCACHED         (0x00000800U)
#define MMU_M_PROP_MEM_COHERENT     (0x00000400U)
#define MMU_M_PROP_GUARDED          (0x00000200U)
#define MMU_M_PROP_LITTLE_ENDIAN    (0x00000100U)
#define MMU_M_PROP                  (0x00000f00U)
#define MMU_V_PROP                  (8)

#define MMU_M_PERM_USER_EXEC        (0x00000020U)
#define MMU_M_PERM_USER_WRITE       (0x00000010U)
#define MMU_M_PERM_USER_READ        (0x00000008U)
#define MMU_M_PERM_SUPER_EXEC       (0x00000004U)
#define MMU_M_PERM_SUPER_WRITE      (0x00000002U)
#define MMU_M_PERM_SUPER_READ       (0x00000001U)
#define MMU_M_PERM                  (0x0000003fU)
#define MMU_V_PERM                  (0)


/*
 * Dump (cleartext) content info from cached TLB entries
 * to a file (stdout if f==NULL).
 */
void
bsp_mmu_dump_cache(FILE *f);

/* Read a TLB entry from the hardware and store the settings in the
 * bsp_mmu_cache[] structure.
 *
 * The routine can perform this operation quietly or
 * print information to a file.
 *
 *   'key': TLB entry index.
 * 'quiet': perform operation silently (no info printed) if nonzero.
 *     'f': open FILE where to print information. May be NULL, in
 *          which case 'stdout' is used.
 *
 * RETURNS:
 *       0: success; TLB entry is VALID
 *      +1: success but TLB entry is INVALID
 *     < 0: error (-1: invalid argument)
 *                (-2: driver not initialized)
 */
int
bsp_mmu_update(bsp_tlb_idx_t key, bool quiet, FILE *f);

/* Initialize cache.  Should be done only once although this is not enforced.
 *
 * RETURNS: zero on success, nonzero on error; in this case the driver will
 *          refuse to change TLB entries (other than disabling them).
 */
int
bsp_mmu_initialize(void);

/* Find first free TLB entry by examining all entries' valid bit.  The first
 * entry without the valid bit set is returned.
 *
 * RETURNS: A free TLB entry number.  -1 if no entry can be found.
 */
bsp_tlb_idx_t
bsp_mmu_find_first_free(void);

/* Write a TLB entry (can also be used to disable an entry).
 *
 * The routine checks against the cached data in bsp_mmu_cache[]
 * to prevent the user from generating overlapping entries.
 *
 *   'idx': TLB entry # to manipulate
 *    'ea': Effective address (must be page aligned)
 *    'pa': Physical  address (must be page aligned)
 *    'sz': Page size selector; page size is 1024 * 2^(2*sz) bytes.
 *          'sz' may also be one of the following:
 *          - page size in bytes ( >= 1024 ); the selector
 *            value is then computed by this routine.
 *            However, 'sz' must be a valid page size
 *            or -1 will be returned.
 *          - a value < 0 to invalidate/disable the
 *            TLB entry.
 *  'flgs': Page's User-defined flags, permissions and WIMGE page attributes
 *   'tid': Translation ID
 *    'ts': Translation Space
 *  'erpn': Extended Real Page Number
 *
 * RETURNS: 0 on success, nonzero on error:
 *
 *         >0: requested mapping would overlap with
 *             existing mapping in another entry. Return
 *             value gives conflicting entry + 1; i.e.,
 *             if a value of 4 is returned then the request
 *             conflicts with existing mapping in entry 3.
 *         -1: invalid argument
 *         -3: driver not initialized (or initialization failed).
 *         <0: other error
 */
bsp_tlb_idx_t
bsp_mmu_write(bsp_tlb_idx_t idx, uint32_t ea, uint32_t pa, int sz,
              uint32_t flgs, uint32_t tid, uint32_t ts, uint32_t erpn);

/* Check if a ea/tid/ts/sz mapping overlaps with an existing entry.
 *
 *    'ea': The Effective Address to match against
 *    'sz': The 'logarithmic' size selector; the page size
 *          is 1024*2^(2*sz).
 *   'tid': Translation ID
 *    'ts': Translation Space
 *
 * RETURNS:
 *     >= 0: index of TLB entry that already provides a mapping
 *           which overlaps within the ea range.
 *       -1: SUCCESS (no conflicting entry found)
 *     <=-2: ERROR (invalid input)
 */
bsp_tlb_idx_t
bsp_mmu_match(uint32_t ea, int sz, uint32_t tid, uint32_t ts);

/* Find TLB index that maps 'ea/tid/ts' combination
 *
 *    'ea': Effective address to match against
 *   'tid': Translation ID
 *    'ts': Translation Space
 *
 * RETURNS: index 'key'; i.e., the index number.
 *
 *          On error (no mapping) -1 is returned.
 */
bsp_tlb_idx_t
bsp_mmu_find(uint32_t ea, uint32_t tid, uint32_t ts);

/* Mark TLB entry as invalid ('disabled').
 *
 * 'key': TLB entry index.
 *
 * RETURNS: zero on success, nonzero on error (TLB unchanged).
 *
 * NOTE:  If a TLB entry is disabled the associated
 *        entry in bsp_tlb_cache[] is also marked as disabled.
 */
int
bsp_mmu_invalidate(bsp_tlb_idx_t key);

/** @} */

#ifdef __cplusplus
};
#endif

#endif