seL4/tools/hardware/utils/memory.py
Gerwin Klein 79da079239 Convert license tags to SPDX identifiers
This commit also converts our own copyright headers to directly use
SPDX, but leaves all other copyright header intact, only adding the
SPDX ident. As far as possible this commit also merges multiple
Data61 copyright statements/headers into one for consistency.
2020-03-09 13:21:49 +08:00

113 lines
3.8 KiB
Python

#
# Copyright 2020, Data61, CSIRO (ABN 41 687 119 230)
#
# SPDX-License-Identifier: GPL-2.0-only
#
from typing import List, Set
import hardware.utils as utils
from hardware.config import Config
from hardware.device import WrappedNode
from hardware.fdt import FdtParser
from hardware.memory import Region
from hardware.utils.rule import KernelRegionGroup
def get_memory_regions(tree: FdtParser):
''' Get all regions with device_type = memory in the tree '''
regions = set()
def visitor(node: WrappedNode):
if node.has_prop('device_type') and node.get_prop('device_type').strings[0] == 'memory':
regions.update(node.get_regions())
tree.visit(visitor)
return regions
def parse_reserved_regions(node: WrappedNode) -> Set[Region]:
''' Parse a reserved-memory node, looking for regions that are
unusable by OS (e.g. reserved for firmware/bootloader) '''
if node is None:
return set()
ret = set()
for child in node:
if child.has_prop('reg') and child.has_prop('no-map'):
ret.update(child.get_regions())
return ret
def reserve_regions(regions: Set[Region], reserved: Set[Region]) -> Set[Region]:
''' Given a set of regions, and a set of reserved regions,
return a new set that is the first set of regions minus the second set. '''
ret = set(regions)
while len(reserved) > 0:
reserve = reserved.pop()
new_ret = set()
for el in ret:
r = el.reserve(reserve)
new_ret.update(r)
ret = new_ret
return ret
def align_memory(regions: Set[Region], config: Config) -> List[Region]:
''' Given a set of regions, sort them and align the first so that the ELF loader will be able to load the kernel into it. Will return the aligned
memory region list, a set of any regions of memory that were aligned out
and the physBase value that the kernel will use. '''
ret = sorted(regions)
extra_reserved = set()
if config.arch == 'riscv':
# RISC-V is special: it expects physBase to be
# the address that the bootloader is loaded at.
physBase = ret[0].base
if config.get_bootloader_reserve() > 0:
resv = Region(ret[0].base, config.get_bootloader_reserve(), None)
extra_reserved.add(resv)
ret[0].base += config.get_bootloader_reserve()
ret[0].size -= config.get_bootloader_reserve()
if config.get_kernel_phys_align() != 0:
new = ret[0].align_base(config.get_kernel_phys_align())
resv = Region(ret[0].base, new.base - ret[0].base, None)
extra_reserved.add(resv)
ret[0] = new
if config.arch != 'riscv':
# ARM (and presumably other architectures)
# want physBase to be the physical load address of the kernel.
physBase = ret[0].base
return ret, extra_reserved, physBase
def get_physical_memory(tree: FdtParser, config: Config) -> List[Region]:
''' returns a list of regions representing physical memory as used by the kernel '''
regions = get_memory_regions(tree)
reserved = parse_reserved_regions(tree.get_path('/reserved-memory'))
regions = reserve_regions(regions, reserved)
regions, extra_reserved, physBase = align_memory(regions, config)
return regions, reserved.union(extra_reserved), physBase
def get_addrspace_exclude(regions: List[Region], config: Config):
''' Returns a list of regions that represents the inverse of the given region list. '''
ret = set()
as_max = utils.align_down(config.addrspace_max, config.get_page_bits())
ret.add(Region(0, as_max, None))
for reg in regions:
if type(reg) == KernelRegionGroup:
if reg.user_ok:
continue
new_ret = set()
for el in ret:
new_ret.update(el.reserve(reg))
ret = new_ret
return sorted(ret, key=lambda a: a.base)