Skip to content

Commit

Permalink
dt-bindings: fsi: fsi2spi: Document SPI controller child nodes
Browse files Browse the repository at this point in the history
The FSI2SPI bridge has several SPI controllers behind it, which
should be documented. Also, therefore the node needs to specify
address and size cells.

Signed-off-by: Eddie James <eajames@linux.ibm.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20240522192524.3286237-3-eajames@linux.ibm.com
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
  • Loading branch information
Eddie James authored and Rob Herring (Arm) committed Jul 9, 2024
1 parent c184d44 commit c7bcbb8
Showing 1 changed file with 32 additions and 4 deletions.
36 changes: 32 additions & 4 deletions Documentation/devicetree/bindings/fsi/ibm,fsi2spi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,10 @@ title: IBM FSI-attached SPI controllers
maintainers:
- Eddie James <eajames@linux.ibm.com>

description: |
description:
This binding describes an FSI CFAM engine called the FSI2SPI. Therefore this
node will always be a child of an FSI CFAM node; see fsi.txt for details on
FSI slave and CFAM nodes. This FSI2SPI engine provides access to a number of
SPI controllers.
node will always be a child of an FSI CFAM node. This FSI2SPI engine provides
access to a number of SPI controllers.

properties:
compatible:
Expand All @@ -24,6 +23,17 @@ properties:
items:
- description: FSI slave address

"#address-cells":
const: 1

"#size-cells":
const: 0

patternProperties:
"^spi@[0-9a-f]+$":
type: object
$ref: /schemas/spi/ibm,spi-fsi.yaml

required:
- compatible
- reg
Expand All @@ -35,4 +45,22 @@ examples:
fsi2spi@1c00 {
compatible = "ibm,fsi2spi";
reg = <0x1c00 0x400>;
#address-cells = <1>;
#size-cells = <0>;
spi@0 {
compatible = "ibm,spi-fsi";
reg = <0>;
#address-cells = <1>;
#size-cells = <0>;
eeprom@0 {
compatible = "atmel,at25";
reg = <0>;
address-width = <24>;
pagesize = <256>;
size = <0x80000>;
spi-max-frequency = <1000000>;
};
};
};

0 comments on commit c7bcbb8

Please sign in to comment.