[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <CAPnjgZ0Xf3U1aj32LbU-xiU1AqwnM3JL1F8xX-wZ18oEmg+irw@mail.gmail.com>
Date: Mon, 2 Oct 2023 11:53:56 -0600
From: Simon Glass <sjg@...omium.org>
To: devicetree@...r.kernel.org
Cc: Mark Rutland <mark.rutland@....com>, Rob Herring <robh@...nel.org>,
Lean Sheng Tan <sheng.tan@...ements.com>,
lkml <linux-kernel@...r.kernel.org>,
Dhaval Sharma <dhaval@...osinc.com>,
Maximilian Brune <maximilian.brune@...ements.com>,
Yunhui Cui <cuiyunhui@...edance.com>,
Guo Dong <guo.dong@...el.com>, Tom Rini <trini@...sulko.com>,
ron minnich <rminnich@...il.com>, Gua Guo <gua.guo@...el.com>,
Chiu Chasel <chasel.chiu@...el.com>,
linux-acpi@...r.kernel.org,
U-Boot Mailing List <u-boot@...ts.denx.de>,
Ard Biesheuvel <ardb@...nel.org>
Subject: Re: [PATCH v7 2/2] schemas: Add some common reserved-memory usages
Hi Rob,
On Tue, 26 Sept 2023 at 13:42, Simon Glass <sjg@...omium.org> wrote:
>
> It is common to split firmware into 'Platform Init', which does the
> initial hardware setup and a "Payload" which selects the OS to be booted.
> Thus an handover interface is required between these two pieces.
>
> Where UEFI boot-time services are not available, but UEFI firmware is
> present on either side of this interface, information about memory usage
> and attributes must be presented to the "Payload" in some form.
>
> This aims to provide an small schema addition for the memory mapping
> needed to keep these two pieces working together well.
>
> Signed-off-by: Simon Glass <sjg@...omium.org>
> ---
>
> Changes in v7:
> - Rename acpi-reclaim to acpi
> - Drop individual mention of when memory can be reclaimed
> - Rewrite the item descriptions
> - Add back the UEFI text (with trepidation)
I am again checking on this series. Can it be applied, please?
>
> Changes in v6:
> - Drop mention of UEFI
> - Use compatible strings instead of node names
>
> Changes in v5:
> - Drop the memory-map node (should have done that in v4)
> - Tidy up schema a bit
>
> Changes in v4:
> - Make use of the reserved-memory node instead of creating a new one
>
> Changes in v3:
> - Reword commit message again
> - cc a lot more people, from the FFI patch
> - Split out the attributes into the /memory nodes
>
> Changes in v2:
> - Reword commit message
>
> .../reserved-memory/common-reserved.yaml | 71 +++++++++++++++++++
> 1 file changed, 71 insertions(+)
> create mode 100644 dtschema/schemas/reserved-memory/common-reserved.yaml
>
> diff --git a/dtschema/schemas/reserved-memory/common-reserved.yaml b/dtschema/schemas/reserved-memory/common-reserved.yaml
> new file mode 100644
> index 0000000..f7fbdfd
> --- /dev/null
> +++ b/dtschema/schemas/reserved-memory/common-reserved.yaml
> @@ -0,0 +1,71 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/reserved-memory/common-reserved.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Common memory reservations
> +
> +description: |
> + Specifies that the reserved memory region can be used for the purpose
> + indicated by its compatible string.
> +
> + Clients may reuse this reserved memory if they understand what it is for,
> + subject to the notes below.
> +
> +maintainers:
> + - Simon Glass <sjg@...omium.org>
> +
> +allOf:
> + - $ref: reserved-memory.yaml
> +
> +properties:
> + compatible:
> + description: |
> + This describes some common memory reservations, with the compatible
> + string indicating what it is used for:
> +
> + acpi: Advanced Configuration and Power Interface (ACPI) tables
> + acpi-nvs: ACPI Non-Volatile-Sleeping Memory (NVS). This is reserved by
> + the firmware for its use and is required to be saved and restored
> + across an NVS sleep
> + boot-code: Contains code used for booting which is not needed by the OS
> + boot-code: Contains data used for booting which is not needed by the OS
> + runtime-code: Contains code used for interacting with the system when
> + running the OS
> + runtime-data: Contains data used for interacting with the system when
> + running the OS
> +
> + enum:
> + - acpi
> + - acpi-nvs
> + - boot-code
> + - boot-data
> + - runtime-code
> + - runtime-data
> +
> + reg:
> + description: region of memory that is reserved for the purpose indicated
> + by the compatible string.
> +
> +required:
> + - reg
> +
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + reserved-memory {
> + #address-cells = <1>;
> + #size-cells = <1>;
> +
> + reserved@...40000 {
> + compatible = "boot-code";
> + reg = <0x12340000 0x00800000>;
> + };
> +
> + reserved@...10000 {
> + compatible = "boot-data";
> + reg = <0x43210000 0x00800000>;
> + };
> + };
> --
> 2.42.0.515.g380fc7ccd1-goog
>
Regards,
Simon
Powered by blists - more mailing lists