Open Menu / doc / device-tree-bindings / firmware / fwu-mdata-mtd.yaml
Loading...
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/firmware/u-boot,fwu-mdata-mtd.yaml#
$schema: http://devicetree.org/meta-schemas/base.yaml#

title: FWU metadata on MTD device without GPT

maintainers:
 - Jassi Brar <jaswinder.singh@linaro.org>

properties:
  compatible:
    items:
      - const: u-boot,fwu-mdata-mtd

  fwu-mdata-store:
    $ref: /schemas/types.yaml#/definitions/phandle
    description: Phandle of the MTD device which contains the FWU MetaData and Banks.

  mdata-parts:
    $ref: /schemas/types.yaml#/definitions/non-unique-string-array
    minItems: 2
    maxItems: 2
    description: labels of the primary and secondary FWU metadata partitions in the 'fixed-partitions' subnode of the 'jedec,spi-nor' flash device node.

  patternProperties:
    "fwu-bank[0-9]":
    type: object
    description: List of FWU mtd-backed banks. Typically two banks.

    properties:
      id:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: Index of the bank.

      label:
        $ref: /schemas/types.yaml#/definitions/non-unique-string-array
        minItems: 1
        maxItems: 1
        description: label of the partition, in the 'fixed-partitions' subnode of the 'jedec,spi-nor' flash device node, that holds this bank.

      patternProperties:
        "fwu-image[0-9]":
        type: object
        description: List of images in the FWU mtd-backed bank.

        properties:
          id:
            $ref: /schemas/types.yaml#/definitions/uint32
            description: Index of the bank.

          offset:
            $ref: /schemas/types.yaml#/definitions/uint32
            description: Offset, from start of the bank, where the image is located.

          size:
            $ref: /schemas/types.yaml#/definitions/uint32
            description: Size reserved for the image.

          uuid:
            $ref: /schemas/types.yaml#/definitions/non-unique-string-array
            minItems: 1
            maxItems: 1
            description: UUID of the image.

        required:
          - id
          - offset
          - size
          - uuid
        additionalProperties: false

    required:
      - id
      - label
      - fwu-images
    additionalProperties: false

required:
  - compatible
  - fwu-mdata-store
  - mdata-parts
  - fwu-banks
additionalProperties: false

examples:
  - |
	fwu-mdata {
		compatible = "u-boot,fwu-mdata-mtd";
		fwu-mdata-store = <&flash0>;
		mdata-parts = "MDATA-Pri", "MDATA-Sec";

		fwu-bank0 {
			id = <0>;
			label = "FIP-Bank0";
			fwu-image0 {
				id = <0>;
				offset = <0x0>;
				size = <0x400000>;
				uuid = "5a66a702-99fd-4fef-a392-c26e261a2828";
			};
		};
		fwu-bank1 {
			id = <1>;
			label = "FIP-Bank1";
			fwu-image0 {
				id = <0>;
				offset = <0x0>;
				size = <0x400000>;
				uuid = "a8f868a1-6e5c-4757-878d-ce63375ef2c0";
			};
		};
	};
...