ArmGicDispatcher.c File Reference

#include "FdtHwInfoParser.h"
#include "Arm/Gic/ArmGicCParser.h"
#include "Arm/Gic/ArmGicDispatcher.h"
#include "Arm/Gic/ArmGicDParser.h"
#include "Arm/Gic/ArmGicItsParser.h"
#include "Arm/Gic/ArmGicMsiFrameParser.h"
#include "Arm/Gic/ArmGicRParser.h"

Go to the source code of this file.

Functions
EFI_STATUS EFIAPI	GetGicVersion (IN CONST VOID *Fdt, IN INT32 IntcNode, OUT UINT32 *GicVersion)
EFI_STATUS EFIAPI	ArmGicDispatcher (IN CONST FDT_HW_INFO_PARSER_HANDLE FdtParserHandle, IN INT32 FdtBranch)

Variables
STATIC CONST COMPATIBILITY_STR	GicV2CompatibleStr []
CONST COMPATIBILITY_INFO	GicV2CompatibleInfo
STATIC CONST COMPATIBILITY_STR	GicV3CompatibleStr []
CONST COMPATIBILITY_INFO	GicV3CompatibleInfo

Detailed Description

Arm Gic dispatcher.

Copyright (c) 2021, ARM Limited. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Reference(s):

• linux/Documentation/devicetree/bindings/interrupt-controller/arm,gic.yaml
• linux/Documentation/devicetree/bindings/interrupt-controller/arm,gic-v3.yaml

Definition in file ArmGicDispatcher.c.

Function Documentation

ArmGicDispatcher()

EFI_STATUS EFIAPI ArmGicDispatcher	(	IN CONST FDT_HW_INFO_PARSER_HANDLE	FdtParserHandle,
		IN INT32	FdtBranch
	)

Gic dispatcher.

This disptacher populates the following structures:

• CM_ARM_GICC_INFO
• CM_ARM_GICD_INFO
• CM_ARM_GIC_MSI_FRAME_INFO

A parser parses a Device Tree to populate a specific CmObj type. None, one or many CmObj can be created by the parser. The created CmObj are then handed to the parser's caller through the HW_INFO_ADD_OBJECT interface. This can also be a dispatcher. I.e. a function that not parsing a Device Tree but calling other parsers.

Parameters

[in]	FdtParserHandle	A handle to the parser instance.
[in]	FdtBranch	When searching for DT node name, restrict the search to this Device Tree branch.

Return values

EFI_SUCCESS	The function completed successfully.
EFI_ABORTED	An error occurred.
EFI_INVALID_PARAMETER	Invalid parameter.
EFI_NOT_FOUND	Not found.
EFI_UNSUPPORTED	Unsupported.

Definition at line 115 of file ArmGicDispatcher.c.

GetGicVersion()

EFI_STATUS EFIAPI GetGicVersion	(	IN CONST VOID *	Fdt,
		IN INT32	IntcNode,
		OUT UINT32 *	GicVersion
	)

Get the Gic version of am interrupt-controller node.

Parameters

[in]	Fdt	Pointer to a Flattened Device Tree (Fdt).
[in]	IntcNode	Interrupt-controller node.
[out]	GicVersion	If success, contains the Gic version of the interrupt-controller node.

Return values

EFI_SUCCESS	The function completed successfully.
EFI_INVALID_PARAMETER	Invalid parameter.
EFI_UNSUPPORTED	Unsupported.

Definition at line 63 of file ArmGicDispatcher.c.

Variable Documentation

GicV2CompatibleInfo

CONST COMPATIBILITY_INFO GicV2CompatibleInfo

Initial value:

= {
  ARRAY_SIZE (GicV2CompatibleStr),
  GicV2CompatibleStr
}

COMPATIBILITY_INFO structure for the GICv2.

Definition at line 30 of file ArmGicDispatcher.c.

GicV2CompatibleStr

STATIC CONST COMPATIBILITY_STR GicV2CompatibleStr[]

Initial value:

= {
  { "arm,cortex-a15-gic" }
}

List of "compatible" property values for GicV2 interrupt nodes.

Any other "compatible" value is not supported by this module.

Definition at line 24 of file ArmGicDispatcher.c.

GicV3CompatibleInfo

CONST COMPATIBILITY_INFO GicV3CompatibleInfo

Initial value:

= {
  ARRAY_SIZE (GicV3CompatibleStr),
  GicV3CompatibleStr
}

COMPATIBILITY_INFO structure for the GICv3.

Definition at line 45 of file ArmGicDispatcher.c.

GicV3CompatibleStr

STATIC CONST COMPATIBILITY_STR GicV3CompatibleStr[]

Initial value:

= {
  { "arm,gic-v3" }
}

List of "compatible" property values for GicV3 interrupt nodes.

Any other "compatible" value is not supported by this module.

Definition at line 39 of file ArmGicDispatcher.c.