Commit bce49d1e authored by Christophe Kerello's avatar Christophe Kerello Committed by Miquel Raynal
Browse files

dt-bindings: mtd: update STM32 FMC2 NAND controller documentation 



These bindings can be used on SOCs where the FMC2 NAND controller is
in standalone. In case that the FMC2 embeds 2 controllers (an external
bus controller and a raw NAND controller), the register base address,
the clock and the reset will be defined in the parent node.

Signed-off-by: default avatarChristophe Kerello <christophe.kerello@st.com>
Signed-off-by: default avatarMiquel Raynal <miquel.raynal@bootlin.com>
Link: https://lore.kernel.org/linux-mtd/1591975362-22009-3-git-send-email-christophe.kerello@st.com
parent 5eeb7fe9

Documentation/devicetree/bindings/mtd/st,stm32-fmc2-nand.yaml

+57 −26
Original line number Diff line number Diff line
@@ -9,32 +9,19 @@ title: STMicroelectronics Flexible Memory Controller 2 (FMC2) Bindings 
maintainers:

  - Christophe Kerello <christophe.kerello@st.com>



allOf:

  - $ref: "nand-controller.yaml#"



properties:

  compatible:

    const: st,stm32mp15-fmc2

    enum:

      - st,stm32mp15-fmc2

      - st,stm32mp1-fmc2-nfc



  reg:

    items:

      - description: Registers

      - description: Chip select 0 data

      - description: Chip select 0 command

      - description: Chip select 0 address space

      - description: Chip select 1 data

      - description: Chip select 1 command

      - description: Chip select 1 address space

    minItems: 6

    maxItems: 7



  interrupts:

    maxItems: 1



  clocks:

    maxItems: 1



  resets:

    maxItems: 1



  dmas:

    items:

      - description: tx DMA channel
@@ -57,11 +44,55 @@ patternProperties: 
      nand-ecc-strength:

        enum: [1, 4 ,8 ]



allOf:

  - $ref: "nand-controller.yaml#"



  - if:

      properties:

        compatible:

          contains:

            const: st,stm32mp15-fmc2

    then:

      properties:

        reg:

          items:

            - description: Registers

            - description: Chip select 0 data

            - description: Chip select 0 command

            - description: Chip select 0 address space

            - description: Chip select 1 data

            - description: Chip select 1 command

            - description: Chip select 1 address space



        clocks:

          maxItems: 1



        resets:

          maxItems: 1



      required:

        - clocks



  - if:

      properties:

        compatible:

          contains:

            const: st,stm32mp1-fmc2-nfc

    then:

      properties:

        reg:

          items:

            - description: Chip select 0 data

            - description: Chip select 0 command

            - description: Chip select 0 address space

            - description: Chip select 1 data

            - description: Chip select 1 command

            - description: Chip select 1 address space



required:

  - compatible

  - reg

  - interrupts

  - clocks



examples:

  - |
@@ -78,9 +109,9 @@ examples: 
            <0x89010000 0x1000>,

            <0x89020000 0x1000>;

      interrupts = <GIC_SPI 48 IRQ_TYPE_LEVEL_HIGH>;

            dmas = <&mdma1 20 0x10 0x12000a02 0x0 0x0>,

                   <&mdma1 20 0x10 0x12000a08 0x0 0x0>,

                   <&mdma1 21 0x10 0x12000a0a 0x0 0x0>;

      dmas = <&mdma1 20 0x2 0x12000a02 0x0 0x0>,

             <&mdma1 20 0x2 0x12000a08 0x0 0x0>,

             <&mdma1 21 0x2 0x12000a0a 0x0 0x0>;

      dma-names = "tx", "rx", "ecc";

      clocks = <&rcc FMC_K>;

      resets = <&rcc FMC_R>;

CRA Git | Maintained and supported by SUSTech CRA and CCSE