mirror of
https://github.com/seL4/seL4.git
synced 2026-04-09 08:49:54 +00:00
cf997974a8
The kernel device IRQs and Frame mappings generated by this script will only come from nodes specified in the seL4,kernel-devices property of the chosen node. Previously these devices were inferred by the script but this led to false matching and didn't support easily overriding which devices to match under different configurations or across different platforms. Explicitly specifying which devices from the device tree will be used in the kernel makes it easier to check which devices the kernel is actually using and makes it easier to change on a per platform or per configuration basis.
148 lines
4.6 KiB
YAML
148 lines
4.6 KiB
YAML
#
|
|
# Copyright 2018, Data61
|
|
# Commonwealth Scientific and Industrial Research Organisation (CSIRO)
|
|
# ABN 41 687 119 230.
|
|
#
|
|
# This software may be distributed and modified according to the terms of
|
|
# the GNU General Public License version 2. Note that NO WARRANTY is provided.
|
|
# See "LICENSE_GPLv2.txt" for details.
|
|
#
|
|
# @TAG(DATA61_GPL)
|
|
#
|
|
---
|
|
$schema: http://json-schema.org/draft-07/schema#
|
|
description: Schema for seL4 hardware.yml
|
|
type: object
|
|
additionalProperties: false
|
|
properties:
|
|
devices:
|
|
type: array
|
|
uniqueItems: true
|
|
description: top-level list of devices
|
|
items:
|
|
$ref: '#/definitions/device'
|
|
required: [devices]
|
|
definitions:
|
|
device:
|
|
type: object
|
|
additionalProperties: false
|
|
properties:
|
|
compatible:
|
|
description: List of compatible strings to which this rule applies
|
|
type: array
|
|
minItems: 1
|
|
uniqueItems: true
|
|
regions:
|
|
description: Memory regions this device has that the kernel might use
|
|
type: array
|
|
items:
|
|
$ref: '#/definitions/region'
|
|
uniqueItems: true
|
|
interrupts:
|
|
description: Interrupts this device has that the kernel might use.
|
|
type: object
|
|
additionalProperties: false
|
|
patternProperties:
|
|
'^[A-Za-z_][A-Za-z0-9_]*$':
|
|
$ref: '#/definitions/interrupt'
|
|
required: [compatible]
|
|
region:
|
|
type: object
|
|
additionalProperties: false
|
|
properties:
|
|
executeNever:
|
|
description: should this region be mapped as execute never?
|
|
type: boolean
|
|
index:
|
|
description: Region index this property should apply to
|
|
type: integer
|
|
minimum: 0
|
|
kernel:
|
|
description: kernel macro used to access this region. If not present, region will not be mapped.
|
|
$ref: '#/definitions/macro'
|
|
kernel_size:
|
|
description: >
|
|
Maximum size of the region in the kernel.
|
|
This will map PAGE_ALIGN_UP(max(kernel_size, region_size)) bytes starting at the
|
|
device's base address into the kernel.
|
|
type: integer
|
|
default: 1 << PAGE_BITS
|
|
macro:
|
|
description: only map the region to the kernel if this macro is defined
|
|
$ref: '#/definitions/macro'
|
|
user:
|
|
description: >
|
|
Whether or not to make a device untyped for userspace.
|
|
If true, will always expose this device to userspace.
|
|
If there is a macro and the macro is undefined, and user is not present,
|
|
the device will be made.
|
|
If false, the device will never be made.
|
|
type: boolean
|
|
dependencies:
|
|
kernel: [executeNever, index]
|
|
executeNever: [kernel]
|
|
interrupt:
|
|
oneOf:
|
|
- type: object
|
|
additionalProperties: false
|
|
properties:
|
|
macro:
|
|
description: only set interrupt if this macro is defined
|
|
$ref: '#/definitions/macro'
|
|
index:
|
|
description: index of interrupt in device's interrupts array
|
|
$ref: '#/definitions/interrupt_index'
|
|
priority:
|
|
description: if multiple conflicting IRQs are present, the IRQ with the highest priority will be selected.
|
|
type: integer
|
|
required: [index]
|
|
- type: integer
|
|
description: index of interrupt in device's interrupts array
|
|
minimum: 0
|
|
- $ref: '#/definitions/boot-cpu'
|
|
interrupt_index:
|
|
oneOf:
|
|
- type: object
|
|
additionalProperties: false
|
|
properties:
|
|
macro:
|
|
description: macro to use when picking index
|
|
$ref: '#/definitions/macro'
|
|
defined:
|
|
description: if macro is defined, use this index in the interrupts array
|
|
type: integer
|
|
minimum: 0
|
|
undefined:
|
|
description: if macro is undefined, use this index in the interrupts array.
|
|
type: integer
|
|
minimum: 0
|
|
required: [macro, defined, undefined]
|
|
- type: integer
|
|
description: index of interrupt in device's interrupts array
|
|
minimum: 0
|
|
- $ref: '#/definitions/boot-cpu'
|
|
macro:
|
|
type: string
|
|
pattern: '^[A-Za-z_][A-Za-z0-9_]*$'
|
|
minLength: 1
|
|
boot-cpu:
|
|
type: string # TODO: why does 'const' not work here?
|
|
description: >
|
|
Use interrupt associated with the seL4,boot-cpu set in the chosen node.
|
|
For instance, a chosen node like
|
|
|
|
chosen {
|
|
seL4,boot-cpu = <&cpu2>;
|
|
}
|
|
|
|
and a device like
|
|
|
|
device {
|
|
interrupts = <0x1 0x2 0x3 0x4>;
|
|
interrupt-affinity = <&cpu0 &cpu1 &cpu2 &cpu3>;
|
|
}
|
|
|
|
would use interrupt 0x3 if the boot-cpu option was used as the index.
|
|
pattern: '^boot-cpu$'
|
|
|