mirror of
https://github.com/torvalds/linux.git
synced 2026-05-27 08:33:17 +02:00
dt-bindings: mtd: partitions: Convert brcm,trx to DT schema
Convert the brcm,trx partition binding to DT schema format. As the "linksys,ns-firmware" compatible also uses "brcm,trx" as a fallback, move it to the converted binding. Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> Signed-off-by: Rob Herring (Arm) <robh@kernel.org> Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com>
This commit is contained in:
parent
6ecd7715d6
commit
a1fa0f8ca1
|
|
@ -1,42 +0,0 @@
|
|||
Broadcom TRX Container Partition
|
||||
================================
|
||||
|
||||
TRX is Broadcom's official firmware format for the BCM947xx boards. It's used by
|
||||
most of the vendors building devices based on Broadcom's BCM47xx SoCs and is
|
||||
supported by the CFE bootloader.
|
||||
|
||||
Design of the TRX format is very minimalistic. Its header contains
|
||||
identification fields, CRC32 checksum and the locations of embedded partitions.
|
||||
Its purpose is to store a few partitions in a format that can be distributed as
|
||||
a standalone file and written in a flash memory.
|
||||
|
||||
Container can hold up to 4 partitions. The first partition has to contain a
|
||||
device executable binary (e.g. a kernel) as it's what the CFE bootloader starts
|
||||
executing. Other partitions can be used for operating system purposes. This is
|
||||
useful for systems that keep kernel and rootfs separated.
|
||||
|
||||
TRX doesn't enforce any strict partition boundaries or size limits. All
|
||||
partitions have to be less than the 4GiB max size limit.
|
||||
|
||||
There are two existing/known TRX variants:
|
||||
1) v1 which contains 3 partitions
|
||||
2) v2 which contains 4 partitions
|
||||
|
||||
There aren't separated compatible bindings for them as version can be trivialy
|
||||
detected by a software parsing TRX header.
|
||||
|
||||
Required properties:
|
||||
- compatible : (required) must be "brcm,trx"
|
||||
|
||||
Optional properties:
|
||||
|
||||
- brcm,trx-magic: TRX magic, if it is different from the default magic
|
||||
0x30524448 as a u32.
|
||||
|
||||
Example:
|
||||
|
||||
flash@0 {
|
||||
partitions {
|
||||
compatible = "brcm,trx";
|
||||
};
|
||||
};
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: http://devicetree.org/schemas/mtd/partitions/brcm,trx.yaml#
|
||||
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||
|
||||
title: Broadcom TRX Container Partition
|
||||
|
||||
maintainers:
|
||||
- Hauke Mehrtens <hauke@hauke-m.de>
|
||||
- Rafał Miłecki <rafal@milecki.pl>
|
||||
|
||||
description: >
|
||||
TRX is Broadcom's official firmware format for the BCM947xx boards. It's used by
|
||||
most of the vendors building devices based on Broadcom's BCM47xx SoCs and is
|
||||
supported by the CFE bootloader.
|
||||
|
||||
Design of the TRX format is very minimalistic. Its header contains
|
||||
identification fields, CRC32 checksum and the locations of embedded partitions.
|
||||
Its purpose is to store a few partitions in a format that can be distributed as
|
||||
a standalone file and written in a flash memory.
|
||||
|
||||
Container can hold up to 4 partitions. The first partition has to contain a
|
||||
device executable binary (e.g. a kernel) as it's what the CFE bootloader starts
|
||||
executing. Other partitions can be used for operating system purposes. This is
|
||||
useful for systems that keep kernel and rootfs separated.
|
||||
|
||||
TRX doesn't enforce any strict partition boundaries or size limits. All
|
||||
partitions have to be less than the 4GiB max size limit.
|
||||
|
||||
There are two existing/known TRX variants:
|
||||
1) v1 which contains 3 partitions
|
||||
2) v2 which contains 4 partitions
|
||||
|
||||
There aren't separated compatible bindings for them as version can be trivially
|
||||
detected by a software parsing TRX header.
|
||||
|
||||
properties:
|
||||
compatible:
|
||||
oneOf:
|
||||
- items:
|
||||
- const: linksys,ns-firmware
|
||||
- const: brcm,trx
|
||||
- const: brcm,trx
|
||||
|
||||
brcm,trx-magic:
|
||||
description: TRX magic, if it is different from the default magic.
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
default: 0x30524448
|
||||
|
||||
required:
|
||||
- compatible
|
||||
|
||||
allOf:
|
||||
- $ref: partition.yaml#
|
||||
|
||||
unevaluatedProperties: false
|
||||
|
||||
examples:
|
||||
- |
|
||||
flash {
|
||||
partitions {
|
||||
compatible = "brcm,trx";
|
||||
};
|
||||
};
|
||||
|
|
@ -30,13 +30,7 @@ properties:
|
|||
|
||||
patternProperties:
|
||||
"^partition@[0-9a-f]+$":
|
||||
$ref: partition.yaml#
|
||||
properties:
|
||||
compatible:
|
||||
items:
|
||||
- const: linksys,ns-firmware
|
||||
- const: brcm,trx
|
||||
unevaluatedProperties: false
|
||||
$ref: partition.yaml#/$defs/partition-node
|
||||
|
||||
required:
|
||||
- "#address-cells"
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user