Describe the DeviceTree node that exposes the Arm firmware-first CPER provider and hook the file into MAINTAINERS so the binding has an owner.
The initial user is the upstream zena-css platform, validated so far on FVP. Reviewed-by: Rob Herring (Arm) <[email protected]> Signed-off-by: Ahmed Tiba <[email protected]> --- .../devicetree/bindings/firmware/arm,ras-cper.yaml | 52 ++++++++++++++++++++++ MAINTAINERS | 5 +++ 2 files changed, 57 insertions(+) diff --git a/Documentation/devicetree/bindings/firmware/arm,ras-cper.yaml b/Documentation/devicetree/bindings/firmware/arm,ras-cper.yaml new file mode 100644 index 000000000000..23d54008230d --- /dev/null +++ b/Documentation/devicetree/bindings/firmware/arm,ras-cper.yaml @@ -0,0 +1,52 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/firmware/arm,ras-cper.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Arm RAS CPER provider + +maintainers: + - Ahmed Tiba <[email protected]> + +description: + Arm Reliability, Availability and Serviceability (RAS) firmware can expose + a firmware-first CPER error source directly via DeviceTree. Firmware + provides the CPER Generic Error Status block and notifies the OS through + an interrupt. + +properties: + compatible: + const: arm,ras-cper + + memory-region: + items: + - description: + CPER Generic Error Status block exposed by firmware. + - description: + Firmware-owned ack buffer. Firmware watches bit 0 and expects the + OS to set it once the current status block has been consumed + before the CPER buffer is overwritten. + + interrupts: + maxItems: 1 + description: + Interrupt used to signal that a new status record is ready. + +required: + - compatible + - memory-region + - interrupts + +additionalProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/arm-gic.h> + + error-handler { + compatible = "arm,ras-cper"; + memory-region = <&ras_cper_buffer>, <&ras_cper_ack>; + interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>; + }; +... diff --git a/MAINTAINERS b/MAINTAINERS index f37a81950e25..951342f11e6e 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -22521,6 +22521,11 @@ M: Alexandre Bounine <[email protected]> S: Maintained F: drivers/rapidio/ +RAS ERROR STATUS +M: Ahmed Tiba <[email protected]> +S: Maintained +F: Documentation/devicetree/bindings/firmware/arm,ras-cper.yaml + RAS INFRASTRUCTURE M: Tony Luck <[email protected]> M: Borislav Petkov <[email protected]> -- 2.43.0
