WebSVN – HelenOS – Diff – /trunk/boot/arch/arm32/loader/mm.h


/*
 * Copyright (c) 2007 Pavel Jancik, Michal Kebrt
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
 
/** @addtogroup arm32boot
 * @{
 */
/** @file
 *  @brief Memory management used while booting the kernel.
 *
 *  So called "section" paging is used while booting the kernel. The term "section"
 *  comes from the ARM architecture specification and stands for the following:
 *  one-level paging, 1MB sized pages, 4096 entries in the page table.
 */
 
 
#ifndef BOOT_arm32__MM_H
#define BOOT_arm32__MM_H
 
 
#ifndef __ASM__
#include "types.h"
#endif
 
 
/** Frame width. */
#define FRAME_WIDTH                 20
 
/** Frame size. */
#define FRAME_SIZE                  (1 << FRAME_WIDTH)
 
/** Page size in 2-level paging which is switched on later after the kernel initialization. */
#define KERNEL_PAGE_SIZE            (1 << 12)
 
 
#ifndef __ASM__
/** Converts kernel address to physical address. */
#   define KA2PA(x)                 (((uintptr_t) (x)) - 0x80000000)
/** Converts physical address to kernel address. */
#   define PA2KA(x)                 (((uintptr_t) (x)) + 0x80000000)
#else
#   define KA2PA(x)                 ((x) - 0x80000000)
#   define PA2KA(x)                 ((x) + 0x80000000)
#endif
 
 
/** Number of entries in PTL0. */
#define PTL0_ENTRIES                (1<<12)             /* 4096 */
 
/** Size of an entry in PTL0. */
#define PTL0_ENTRY_SIZE             4
 
/** Returns number of frame the address belongs to. */
#define ADDR2PFN( addr )            ( ((uintptr_t)(addr)) >> FRAME_WIDTH )
 
/** Describes "section" page table entry (one-level paging with 1MB sized pages). */  
#define PTE_DESCRIPTOR_SECTION      0x2
 
/** Page table access rights: user - no access, kernel - read/write. */
#define PTE_AP_USER_NO_KERNEL_RW    0x1
 
 
#ifndef __ASM__
 
 
/** Page table level 0 entry - "section" format is used (one-level paging, 1MB sized
 * pages). Used only while booting the kernel.
 */
typedef struct {
    unsigned descriptor_type     : 2;
    unsigned bufferable          : 1;
    unsigned cacheable           : 1;
    unsigned impl_specific       : 1;
    unsigned domain              : 4;
    unsigned should_be_zero_1    : 1;
    unsigned access_permission   : 2;  
    unsigned should_be_zero_2    : 8;
    unsigned section_base_addr   : 12;
} __attribute__ ((packed)) pte_level0_section_t;
 
 
/** Page table that holds 1:1 virtual to physical mapping used while booting the kernel. */
extern pte_level0_section_t page_table[PTL0_ENTRIES];
 
extern void mmu_start(void);
 
 
/** Enables paging. */
static inline void enable_paging()
{
    /* c3 - each two bits controls access to the one of domains (16)
     *      0b01 - behave as a client (user) of a domain
     */
    asm volatile (
        // behave as a client of domains
        "ldr r0, =0x55555555       \n"
        "mcr p15, 0, r0, c3, c0, 0 \n"
 
        // current settings
        "mrc p15, 0, r0, c1, c0, 0 \n"
 
        // mask to enable paging
        "ldr r1, =0x00000001       \n"
        "orr r0, r0, r1            \n"
 
        // store settings
        "mcr p15, 0, r0, c1, c0, 0 \n"
        :
        :
        : "r0", "r1"
    );
}
 
 
/** Sets the address of level 0 page table to CP15 register 2.
 *
 * @param pt Address of a page table to set.
 */  
static inline void set_ptl0_address(pte_level0_section_t* pt)
{
    asm volatile (
        "mcr p15, 0, %0, c2, c0, 0 \n"
        :
        : "r"(pt)
    );
}
 
 
#endif
 
#endif
 
/** @}
 */
 
 

Subversion Repositories HelenOS

(root)/trunk/boot/arch/arm32/loader/mm.h @ 2468 – Rev 2349 → 2465

Rev 2349		Rev 2465
1	/*	1	/*
2	* Copyright (c) 2007 Pavel Jancik, Michal Kebrt	2	* Copyright (c) 2007 Pavel Jancik, Michal Kebrt
3	* All rights reserved.	3	* All rights reserved.
4	*	4	*
5	* Redistribution and use in source and binary forms, with or without	5	* Redistribution and use in source and binary forms, with or without
6	* modification, are permitted provided that the following conditions	6	* modification, are permitted provided that the following conditions
7	* are met:	7	* are met:
8	*	8	*
9	* - Redistributions of source code must retain the above copyright	9	* - Redistributions of source code must retain the above copyright
10	* notice, this list of conditions and the following disclaimer.	10	* notice, this list of conditions and the following disclaimer.
11	* - Redistributions in binary form must reproduce the above copyright	11	* - Redistributions in binary form must reproduce the above copyright
12	* notice, this list of conditions and the following disclaimer in the	12	* notice, this list of conditions and the following disclaimer in the
13	* documentation and/or other materials provided with the distribution.	13	* documentation and/or other materials provided with the distribution.
14	* - The name of the author may not be used to endorse or promote products	14	* - The name of the author may not be used to endorse or promote products
15	* derived from this software without specific prior written permission.	15	* derived from this software without specific prior written permission.
16	*	16	*
17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR	17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES	18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.	19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,	20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT	21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,	22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY	23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT	24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF	25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.	26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27	*/	27	*/
28		28
29		29
30	/** @addtogroup arm32boot	30	/** @addtogroup arm32boot
31	* @{	31	* @{
32	*/	32	*/
33	/** @file	33	/** @file
34	* @brief Memory management used while booting the kernel.	34	* @brief Memory management used while booting the kernel.
35	*	35	*
36	* So called "section" paging is used while booting the kernel. The term "section"	36	* So called "section" paging is used while booting the kernel. The term "section"
37	* comes from the ARM architecture specification and stands for the following:	37	* comes from the ARM architecture specification and stands for the following:
38	* one-level paging, 1MB sized pages, 4096 entries in the page table.	38	* one-level paging, 1MB sized pages, 4096 entries in the page table.
39	*/	39	*/
40		40
41		41
42	#ifndef BOOT_arm32__MM_H	42	#ifndef BOOT_arm32__MM_H
43	#define BOOT_arm32__MM_H	43	#define BOOT_arm32__MM_H
44		44
45		45
46	#ifndef __ASM__	46	#ifndef __ASM__
47	#include "types.h"	47	#include "types.h"
48	#endif	48	#endif
49		49
50		50
51	/** Frame width. */	51	/** Frame width. */
52	#define FRAME_WIDTH 20	52	#define FRAME_WIDTH 20
53		53
54	/** Frame size. */	54	/** Frame size. */
55	#define FRAME_SIZE (1 << FRAME_WIDTH)	55	#define FRAME_SIZE (1 << FRAME_WIDTH)
56		56
57	/** Page size in 2-level paging which is switched on later after the kernel initialization. */	57	/** Page size in 2-level paging which is switched on later after the kernel initialization. */
58	#define KERNEL_PAGE_SIZE (1 << 12)	58	#define KERNEL_PAGE_SIZE (1 << 12)
59		59
60		60
61	#ifndef __ASM__	61	#ifndef __ASM__
62	/** Converts kernel address to physical address. */	62	/** Converts kernel address to physical address. */
63	# define KA2PA(x) (((uintptr_t) (x)) - 0x80000000)	63	# define KA2PA(x) (((uintptr_t) (x)) - 0x80000000)
64	/** Converts physical address to kernel address. */	64	/** Converts physical address to kernel address. */
65	# define PA2KA(x) (((uintptr_t) (x)) + 0x80000000)	65	# define PA2KA(x) (((uintptr_t) (x)) + 0x80000000)
66	#else	66	#else
67	# define KA2PA(x) ((x) - 0x80000000)	67	# define KA2PA(x) ((x) - 0x80000000)
68	# define PA2KA(x) ((x) + 0x80000000)	68	# define PA2KA(x) ((x) + 0x80000000)
69	#endif	69	#endif
70		70
71		71
72	/** Number of entries in PTL0. */	72	/** Number of entries in PTL0. */
73	#define PTL0_ENTRIES (1<<12) /* 4096 */	73	#define PTL0_ENTRIES (1<<12) /* 4096 */
74		74
75	/** Size of an entry in PTL0. */	75	/** Size of an entry in PTL0. */
76	#define PTL0_ENTRY_SIZE 4	76	#define PTL0_ENTRY_SIZE 4
77		77
78	/** Returns number of frame the address belongs to. */	78	/** Returns number of frame the address belongs to. */
79	#define ADDR2PFN( addr ) ( ((uintptr_t)(addr)) >> FRAME_WIDTH )	79	#define ADDR2PFN( addr ) ( ((uintptr_t)(addr)) >> FRAME_WIDTH )
80		80
81	/** Describes "section" page table entry (one-level paging with 1MB sized pages). */	81	/** Describes "section" page table entry (one-level paging with 1MB sized pages). */
82	#define PTE_DESCRIPTOR_SECTION 0x2	82	#define PTE_DESCRIPTOR_SECTION 0x2
83		83
84	/** Page table access rights: user - no access, kernel - read/write. */	84	/** Page table access rights: user - no access, kernel - read/write. */
85	#define PTE_AP_USER_NO_KERNEL_RW 0x1	85	#define PTE_AP_USER_NO_KERNEL_RW 0x1
86		86
87		87
88	#ifndef __ASM__	88	#ifndef __ASM__
89		89
90		90
91	/** Page table level 0 entry - "section" format is used (one-level paging, 1MB sized	91	/** Page table level 0 entry - "section" format is used (one-level paging, 1MB sized
92	* pages). Used only while booting the kernel.	92	* pages). Used only while booting the kernel.
93	*/	93	*/
94	typedef struct {	94	typedef struct {
95	unsigned descriptor_type : 2;	95	unsigned descriptor_type : 2;
96	unsigned bufferable : 1;	96	unsigned bufferable : 1;
97	unsigned cacheable : 1;	97	unsigned cacheable : 1;
98	unsigned impl_specific : 1;	98	unsigned impl_specific : 1;
99	unsigned domain : 4;	99	unsigned domain : 4;
100	unsigned should_be_zero_1 : 1;	100	unsigned should_be_zero_1 : 1;
101	unsigned access_permission : 2;	101	unsigned access_permission : 2;
102	unsigned should_be_zero_2 : 8;	102	unsigned should_be_zero_2 : 8;
103	unsigned section_base_addr : 12;	103	unsigned section_base_addr : 12;
104	} __attribute__ ((packed)) pte_level0_section_t;	104	} __attribute__ ((packed)) pte_level0_section_t;
105		105
106		106
107	/** Page table that holds 1:1 virtual to physical mapping used while booting the kernel. */	107	/** Page table that holds 1:1 virtual to physical mapping used while booting the kernel. */
108	extern pte_level0_section_t page_table[PTL0_ENTRIES];	108	extern pte_level0_section_t page_table[PTL0_ENTRIES];
109		109
110	extern void mmu_start(void);	110	extern void mmu_start(void);
111		111
112		112
113	/** Enables paging. */	113	/** Enables paging. */
114	static inline void enable_paging()	114	static inline void enable_paging()
115	{	115	{
116	/* c3 - each two bits controls access to the one of domains (16)	116	/* c3 - each two bits controls access to the one of domains (16)
117	* 0b01 - behave as a client (user) of a domain	117	* 0b01 - behave as a client (user) of a domain
118	*/	118	*/
119	asm volatile (	119	asm volatile (
120	// behave as a client of domains	120	// behave as a client of domains
121	"ldr r0, =0x55555555 \n"	121	"ldr r0, =0x55555555 \n"
122	"mcr p15, 0, r0, c3, c0, 0 \n"	122	"mcr p15, 0, r0, c3, c0, 0 \n"
123		123
124	// current settings	124	// current settings
125	"mrc p15, 0, r0, c1, c0, 0 \n"	125	"mrc p15, 0, r0, c1, c0, 0 \n"
126		126
127	// mask to enable paging	127	// mask to enable paging
128	"ldr r1, =0x00000001 \n"	128	"ldr r1, =0x00000001 \n"
129	"orr r0, r0, r1 \n"	129	"orr r0, r0, r1 \n"
130		130
131	// store settings	131	// store settings
132	"mcr p15, 0, r0, c1, c0, 0 \n"	132	"mcr p15, 0, r0, c1, c0, 0 \n"
133	:	133	:
134	:	134	:
135	: "r0", "r1"	135	: "r0", "r1"
136	);	136	);
137	}	137	}
138		138
139		139
140	/** Sets the address of level 0 page table to CP15 register 2.	140	/** Sets the address of level 0 page table to CP15 register 2.
141	*	141	*
142	* @param pt Address of a page table to set.	142	* @param pt Address of a page table to set.
143	*/	143	*/
144	static inline void set_ptl0_address(pte_level0_section_t* pt)	144	static inline void set_ptl0_address(pte_level0_section_t* pt)
145	{	145	{
146	asm volatile (	146	asm volatile (
147	"mcr p15, 0, %0, c2, c0, 0 \n"	147	"mcr p15, 0, %0, c2, c0, 0 \n"
148	:	148	:
149	: "r"(pt)	149	: "r"(pt)
150	);	150	);
151	}	151	}
152		152
153		153
154	#endif	154	#endif
155		155
156	#endif	156	#endif
157		157
158	/** @}	158	/** @}
159	*/	159	*/
160		160
161		161