TianoCore EDK2 master
Loading...
Searching...
No Matches
ArmGenericTimerParser.h File Reference

Go to the source code of this file.

Typedefs

typedef enum FdtTimerInterruptItems FDT_TIMER_INTERRUPT_ITEMS
 

Enumerations

enum  FdtTimerInterruptItems {
  FdtSecureTimerIrq , FdtNonSecureTimerIrq , FdtVirtualTimerIrq , FdtHypervisorTimerIrq ,
  FdtMaxTimerItem
}
 

Functions

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

Detailed Description

Arm generic timer parser.

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

Reference(s):
  • linux/Documentation/devicetree/bindings/timer/arm,arch_timer.yaml

Definition in file ArmGenericTimerParser.h.

Typedef Documentation

◆ FDT_TIMER_INTERRUPT_ITEMS

An enum listing the FDT interrupt items.

Enumeration Type Documentation

◆ FdtTimerInterruptItems

An enum listing the FDT interrupt items.

Enumerator
FdtSecureTimerIrq 

Secure timer IRQ.

FdtNonSecureTimerIrq 

Non-secure timer IRQ.

FdtVirtualTimerIrq 

Virtual timer IRQ.

FdtHypervisorTimerIrq 

Hypervisor timer IRQ.

FdtMaxTimerItem 

Max timer item.

Definition at line 16 of file ArmGenericTimerParser.h.

Function Documentation

◆ ArmGenericTimerInfoParser()

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

CM_ARM_BOOT_ARCH_INFO parser function.

The following structure is populated: typedef struct CmArmGenericTimerInfo { UINT64 CounterControlBaseAddress; // {default} UINT64 CounterReadBaseAddress; // {default} UINT32 SecurePL1TimerGSIV; // {Populated} UINT32 SecurePL1TimerFlags; // {Populated} UINT32 NonSecurePL1TimerGSIV; // {Populated} UINT32 NonSecurePL1TimerFlags; // {Populated} UINT32 VirtualTimerGSIV; // {Populated} UINT32 VirtualTimerFlags; // {Populated} UINT32 NonSecurePL2TimerGSIV; // {Populated} UINT32 NonSecurePL2TimerFlags; // {Populated} UINT32 VirtualPL2TimerGSIV; // {default} UINT32 VirtualPL2TimerFlags; // {default} } CM_ARM_GENERIC_TIMER_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]FdtParserHandleA handle to the parser instance.
[in]FdtBranchWhen searching for DT node name, restrict the search to this Device Tree branch.
Return values
EFI_SUCCESSThe function completed successfully.
EFI_ABORTEDAn error occurred.
EFI_INVALID_PARAMETERInvalid parameter.
EFI_NOT_FOUNDNot found.
EFI_UNSUPPORTEDUnsupported.

CM_ARM_GENERIC_TIMER_INFO parser function.

The following structure is populated: typedef struct CmArmGenericTimerInfo { UINT64 CounterControlBaseAddress; // {default} UINT64 CounterReadBaseAddress; // {default} UINT32 SecurePL1TimerGSIV; // {Populated} UINT32 SecurePL1TimerFlags; // {Populated} UINT32 NonSecurePL1TimerGSIV; // {Populated} UINT32 NonSecurePL1TimerFlags; // {Populated} UINT32 VirtualTimerGSIV; // {Populated} UINT32 VirtualTimerFlags; // {Populated} UINT32 NonSecurePL2TimerGSIV; // {Populated} UINT32 NonSecurePL2TimerFlags; // {Populated} UINT32 VirtualPL2TimerGSIV; // {default} UINT32 VirtualPL2TimerFlags; // {default} } CM_ARM_GENERIC_TIMER_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]FdtParserHandleA handle to the parser instance.
[in]FdtBranchWhen searching for DT node name, restrict the search to this Device Tree branch.
Return values
EFI_SUCCESSThe function completed successfully.
EFI_ABORTEDAn error occurred.
EFI_INVALID_PARAMETERInvalid parameter.
EFI_NOT_FOUNDNot found.
EFI_UNSUPPORTEDUnsupported.

Definition at line 184 of file ArmGenericTimerParser.c.