[PATCH 2/2] schemas: Add a schema for binman
Simon Glass
sjg at chromium.org
Tue Jul 11 23:18:08 CEST 2023
I am unsure whether to add this with a generic name, such as 'layout',
but for now am using /firmware/binman to avoid conflicts with any other
firmware-layout schema that others might be working on.
Signed-off-by: Simon Glass <sjg at chromium.org>
---
dtschema/schemas/firmware/binman.yaml | 51 ++++++++++++++++++
dtschema/schemas/firmware/binman/entry.yaml | 57 +++++++++++++++++++++
2 files changed, 108 insertions(+)
create mode 100644 dtschema/schemas/firmware/binman.yaml
create mode 100644 dtschema/schemas/firmware/binman/entry.yaml
diff --git a/dtschema/schemas/firmware/binman.yaml b/dtschema/schemas/firmware/binman.yaml
new file mode 100644
index 0000000..4b1ecf6
--- /dev/null
+++ b/dtschema/schemas/firmware/binman.yaml
@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright 2023 Google LLC
+
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/firmware/binman.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Binman firmware layout
+
+maintainers:
+ - Simon Glass <sjg at chromium.org>
+
+description: |
+ The binman node provides a layout for firmware, used when packaging firmware
+ from multiple projects. For now it just supports a very simple set of
+ features, as a starting point for discussion.
+
+ Documentation for Binman is available at:
+
+ https://u-boot.readthedocs.io/en/latest/develop/package/binman.html
+
+ with the current image-description format at:
+
+ https://u-boot.readthedocs.io/en/latest/develop/package/binman.html#image-description-format
+
+properties:
+ $nodename:
+ const: binman
+
+required:
+ - compatible
+
+additionalProperties: false
+
+examples:
+ - |
+ - |
+ firmware {
+ binman {
+ compatible = "u-boot,binman";
+
+ u-boot {
+ size = <0xa0000>;
+ };
+
+ atf-bl31 {
+ offset = <0x100000>;
+ };
+ };
+ };
diff --git a/dtschema/schemas/firmware/binman/entry.yaml b/dtschema/schemas/firmware/binman/entry.yaml
new file mode 100644
index 0000000..16b84c5
--- /dev/null
+++ b/dtschema/schemas/firmware/binman/entry.yaml
@@ -0,0 +1,57 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright 2023 Google LLC
+
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/firmware/binman/entry.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Binman entry
+
+maintainers:
+ - Simon Glass <sjg at chromium.org>
+
+description: |
+ The entry node specifies a single entry in the firmware.
+
+ Entries have a specific type, such as "u-boot" or "atf-bl31". If the type
+ is missing, the name is used as the type.
+
+ Note: This definition is intended to be hierarchical, so that entries can
+ appear in other entries. Schema for that is TBD.
+
+properties:
+ $nodename:
+ pattern: "^[-a-z]+(-[0-9]+)?$"
+
+ type:
+ $ref: /schemas/types.yaml#/definitions/string
+
+ offset:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description: |
+ Provides the offset of this entry from the start of its parent section.
+
+ size:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description: |
+ Provides the size of this entry in bytes.
+
+additionalProperties: false
+
+examples:
+ - |
+ firmware {
+ binman {
+ compatible = "u-boot,binman";
+
+ u-boot {
+ size = <0xa0000>;
+ };
+
+ second-area {
+ type = "atf-bl31";
+ offset = <0x100000>;
+ };
+ };
+ };
--
2.41.0.255.g8b1d071c50-goog
More information about the U-Boot
mailing list