Commit 2e3036a2 authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'mtd/for-6.3' of git://git.kernel.org/pub/scm/linux/kernel/git/mtd/linux 

Pull MTD updates from Miquel Raynal:
 "MTD changes:

   - parsers: ofpart: add workaround for #size-cells 0

   - dt-bindings: partitions: Fix partition node name pattern

   - dataflash: remove duplicate SPI ID table

  Raw NAND core changes:

   - Check the data only read pattern only once

   - Prepare the late addition of supported operation checks

   - Support for sequential cache reads

   - Fix nand_chip kdoc

  Raw NAND driver changes:

   - Fsl_elbc: Propagate HW ECC settings to HW

   - Marvell: Add missing layouts

   - Pasemi: Don't use static data to track per-device state

   - Sunxi:
      - Fix the size of the last OOB region
      - Remove an unnecessary check
      - Remove an unnecessary check
      - Clean up chips after failed init
      - Precompute the ECC_CTL register value
      - Embed sunxi_nand_hw_ecc by value
      - Update OOB layout to match hardware

   - tmio_nand: Remove driver

   - vf610_nfc: Use regular comments for functions

  SPI-NAND driver changes:

   - Add support for AllianceMemory AS5F34G04SND

   - Macronix: use scratch buffer for DMA operation

  NAND ECC changes:

   - Mediatek:
      - Add ECC support fot MT7986 IC
      - Add compatible for MT7986
      - dt-bindings: Split ECC engine with rawnand controller

  SPI NOR changes:

   - Misc core fixes

  SPI NOR driver changes:

   - Spansion: Minor fixes"

* tag 'mtd/for-6.3' of git://git.kernel.org/pub/scm/linux/kernel/git/mtd/linux: (33 commits)
  mtd: parsers: ofpart: add workaround for #size-cells 0
  mtd: rawnand: sunxi: Precompute the ECC_CTL register value
  mtd: rawnand: sunxi: Embed sunxi_nand_hw_ecc by value
  mtd: rawnand: sunxi: Update OOB layout to match hardware
  mtd: spi-nor: Sort headers alphabetically
  mtd: spi-nor: Fix shift-out-of-bounds in spi_nor_set_erase_type
  mtd: nand: ecc-mtk: Add ECC support fot MT7986 IC
  dt-bindings: mtd: mediatek,nand-ecc-engine: Add compatible for MT7986
  dt-bindings: mtd: Split ECC engine with rawnand controller
  mtd: rawnand: fsl_elbc: Propagate HW ECC settings to HW
  mtd: spinand: Add support for AllianceMemory AS5F34G04SND
  dt-bindings: mtd: partitions: Fix partition node name pattern
  mtd: spi-nor: Create macros to define chip IDs and geometries
  mtd: spi-nor: spansion: Make CFRx reg fields generic
  mtd: spi-nor: spansion: Consider reserved bits in CFR5 register
  mtd: spi-nor: core: fix implicit declaration warning
  mtd: spinand: macronix: use scratch buffer for DMA operation
  mtd: rawnand: Fix nand_chip kdoc
  mtd: rawnand: vf610_nfc: use regular comments for functions
  mtd: rawnand: Support for sequential cache reads
  ...
parents 60e2bf7d f4440abc

Documentation/devicetree/bindings/mtd/mediatek,mtk-nfc.yaml

0 → 100644
+155 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/mtd/mediatek,mtk-nfc.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: MediaTek(MTK) SoCs raw NAND FLASH controller (NFC)



maintainers:

  - Xiangsheng Hou <xiangsheng.hou@mediatek.com>



properties:

  compatible:

    enum:

      - mediatek,mt2701-nfc

      - mediatek,mt2712-nfc

      - mediatek,mt7622-nfc



  reg:

    items:

      - description: Base physical address and size of NFI.



  interrupts:

    items:

      - description: NFI interrupt



  clocks:

    items:

      - description: clock used for the controller

      - description: clock used for the pad



  clock-names:

    items:

      - const: nfi_clk

      - const: pad_clk



  ecc-engine:

    description: device-tree node of the required ECC engine.

    $ref: /schemas/types.yaml#/definitions/phandle



patternProperties:

  "^nand@[a-f0-9]$":

    $ref: nand-chip.yaml#

    unevaluatedProperties: false

    properties:

      reg:

        maximum: 1

      nand-on-flash-bbt: true

      nand-ecc-mode:

        const: hw



allOf:

  - $ref: nand-controller.yaml#



  - if:

      properties:

        compatible:

          contains:

            const: mediatek,mt2701-nfc

    then:

      patternProperties:

        "^nand@[a-f0-9]$":

          properties:

            nand-ecc-step-size:

              enum: [ 512, 1024 ]

            nand-ecc-strength:

              enum: [4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 28, 32, 36,

                     40, 44, 48, 52, 56, 60]



  - if:

      properties:

        compatible:

          contains:

            const: mediatek,mt2712-nfc

    then:

      patternProperties:

        "^nand@[a-f0-9]$":

          properties:

            nand-ecc-step-size:

              enum: [ 512, 1024 ]

            nand-ecc-strength:

              enum: [4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 28, 32, 36,

                     40, 44, 48, 52, 56, 60, 68, 72, 80]



  - if:

      properties:

        compatible:

          contains:

            const: mediatek,mt7622-nfc

    then:

      patternProperties:

        "^nand@[a-f0-9]$":

          properties:

            nand-ecc-step-size:

              const: 512

            nand-ecc-strength:

              enum: [4, 6, 8, 10, 12]



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - ecc-engine



unevaluatedProperties: false



examples:

  - |

    #include <dt-bindings/clock/mt2701-clk.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/interrupt-controller/irq.h>



    soc {

        #address-cells = <2>;

        #size-cells = <2>;



        nand-controller@1100d000 {

            compatible = "mediatek,mt2701-nfc";

            reg = <0 0x1100d000 0 0x1000>;

            interrupts = <GIC_SPI 56 IRQ_TYPE_LEVEL_LOW>;

            clocks = <&pericfg CLK_PERI_NFI>,

                     <&pericfg CLK_PERI_NFI_PAD>;

            clock-names = "nfi_clk", "pad_clk";

            ecc-engine = <&bch>;

            #address-cells = <1>;

            #size-cells = <0>;



            nand@0 {

                reg = <0>;



                nand-on-flash-bbt;

                nand-ecc-mode = "hw";

                nand-ecc-step-size = <1024>;

                nand-ecc-strength = <24>;



                partitions {

                    compatible = "fixed-partitions";

                    #address-cells = <1>;

                    #size-cells = <1>;



                    preloader@0 {

                        label = "pl";

                        read-only;

                        reg = <0x0 0x400000>;

                    };

                    android@400000 {

                        label = "android";

                        reg = <0x400000 0x12c00000>;

                    };

                };

            };

        };

    };

Documentation/devicetree/bindings/mtd/mediatek,nand-ecc-engine.yaml

0 → 100644
+63 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/mtd/mediatek,nand-ecc-engine.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: MediaTek(MTK) SoCs NAND ECC engine



maintainers:

  - Xiangsheng Hou <xiangsheng.hou@mediatek.com>



description: |

  MTK NAND ECC engine can cowork with MTK raw NAND and SPI NAND controller.



properties:

  compatible:

    enum:

      - mediatek,mt2701-ecc

      - mediatek,mt2712-ecc

      - mediatek,mt7622-ecc

      - mediatek,mt7986-ecc



  reg:

    items:

      - description: Base physical address and size of ECC.



  interrupts:

    items:

      - description: ECC interrupt



  clocks:

    maxItems: 1



  clock-names:

    const: nfiecc_clk



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/mt2701-clk.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/interrupt-controller/irq.h>



    soc {

        #address-cells = <2>;

        #size-cells = <2>;



        bch: ecc@1100e000 {

            compatible = "mediatek,mt2701-ecc";

            reg = <0 0x1100e000 0 0x1000>;

            interrupts = <GIC_SPI 55 IRQ_TYPE_LEVEL_LOW>;

            clocks = <&pericfg CLK_PERI_NFI_ECC>;

            clock-names = "nfiecc_clk";

        };

    };

Documentation/devicetree/bindings/mtd/mtk-nand.txt

deleted100644 → 0
+0 −176
Original line number Diff line number Diff line 
MTK SoCs NAND FLASH controller (NFC) DT binding



This file documents the device tree bindings for MTK SoCs NAND controllers.

The functional split of the controller requires two drivers to operate:

the nand controller interface driver and the ECC engine driver.



The hardware description for both devices must be captured as device

tree nodes.



1) NFC NAND Controller Interface (NFI):

=======================================



The first part of NFC is NAND Controller Interface (NFI) HW.

Required NFI properties:

- compatible:			Should be one of

				"mediatek,mt2701-nfc",

				"mediatek,mt2712-nfc",

				"mediatek,mt7622-nfc".

- reg:				Base physical address and size of NFI.

- interrupts:			Interrupts of NFI.

- clocks:			NFI required clocks.

- clock-names:			NFI clocks internal name.

- ecc-engine:			Required ECC Engine node.

- #address-cells:		NAND chip index, should be 1.

- #size-cells:			Should be 0.



Example:



	nandc: nfi@1100d000 {

		compatible = "mediatek,mt2701-nfc";

		reg = <0 0x1100d000 0 0x1000>;

		interrupts = <GIC_SPI 56 IRQ_TYPE_LEVEL_LOW>;

		clocks = <&pericfg CLK_PERI_NFI>,

			 <&pericfg CLK_PERI_NFI_PAD>;

		clock-names = "nfi_clk", "pad_clk";

		ecc-engine = <&bch>;

		#address-cells = <1>;

		#size-cells = <0>;

        };



Platform related properties, should be set in {platform_name}.dts:

- children nodes:	NAND chips.



Children nodes properties:

- reg:			Chip Select Signal, default 0.

			Set as reg = <0>, <1> when need 2 CS.

Optional:

- nand-on-flash-bbt:	Store BBT on NAND Flash.

- nand-ecc-mode:	the NAND ecc mode (check driver for supported modes)

- nand-ecc-step-size:	Number of data bytes covered by a single ECC step.

			valid values:

			512 and 1024 on mt2701 and mt2712.

			512 only on mt7622.

			1024 is recommended for large page NANDs.

- nand-ecc-strength:	Number of bits to correct per ECC step.

			The valid values that each controller supports:

			mt2701: 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 28,

				32, 36, 40, 44, 48, 52, 56, 60.

			mt2712: 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 28,

				32, 36, 40, 44, 48, 52, 56, 60, 68, 72, 80.

			mt7622: 4, 6, 8, 10, 12, 14, 16.

			The strength should be calculated as follows:

			E = (S - F) * 8 / B

			S = O / (P / Q)

				E :	nand-ecc-strength.

				S :	spare size per sector.

				F :	FDM size, should be in the range [1,8].

					It is used to store free oob data.

				O :	oob size.

				P :	page size.

				Q :	nand-ecc-step-size.

				B :	number of parity bits needed to correct

					1 bitflip.

					According to MTK NAND controller design,

					this number depends on max ecc step size

					that MTK NAND controller supports.

					If max ecc step size supported is 1024,

					then it should be always 14. And if max

					ecc step size is 512, then it should be

					always 13.

			If the result does not match any one of the listed

			choices above, please select the smaller valid value from

			the list.

			(otherwise the driver will do the adjustment at runtime)

- pinctrl-names:	Default NAND pin GPIO setting name.

- pinctrl-0:		GPIO setting node.



Example:

	&pio {

		nand_pins_default: nanddefault {

			pins_dat {

				pinmux = <MT2701_PIN_111_MSDC0_DAT7__FUNC_NLD7>,

					 <MT2701_PIN_112_MSDC0_DAT6__FUNC_NLD6>,

					 <MT2701_PIN_114_MSDC0_DAT4__FUNC_NLD4>,

					 <MT2701_PIN_118_MSDC0_DAT3__FUNC_NLD3>,

					 <MT2701_PIN_121_MSDC0_DAT0__FUNC_NLD0>,

					 <MT2701_PIN_120_MSDC0_DAT1__FUNC_NLD1>,

					 <MT2701_PIN_113_MSDC0_DAT5__FUNC_NLD5>,

					 <MT2701_PIN_115_MSDC0_RSTB__FUNC_NLD8>,

					 <MT2701_PIN_119_MSDC0_DAT2__FUNC_NLD2>;

				input-enable;

				drive-strength = <MTK_DRIVE_8mA>;

				bias-pull-up;

			};



			pins_we {

				pinmux = <MT2701_PIN_117_MSDC0_CLK__FUNC_NWEB>;

				drive-strength = <MTK_DRIVE_8mA>;

				bias-pull-up = <MTK_PUPD_SET_R1R0_10>;

			};



			pins_ale {

				pinmux = <MT2701_PIN_116_MSDC0_CMD__FUNC_NALE>;

				drive-strength = <MTK_DRIVE_8mA>;

				bias-pull-down = <MTK_PUPD_SET_R1R0_10>;

			};

		};

	};



	&nandc {

		status = "okay";

		pinctrl-names = "default";

		pinctrl-0 = <&nand_pins_default>;

		nand@0 {

			reg = <0>;

			nand-on-flash-bbt;

			nand-ecc-mode = "hw";

			nand-ecc-strength = <24>;

			nand-ecc-step-size = <1024>;

		};

	};



NAND chip optional subnodes:

- Partitions, see Documentation/devicetree/bindings/mtd/mtd.yaml



Example:

	nand@0 {

		partitions {

			compatible = "fixed-partitions";

			#address-cells = <1>;

			#size-cells = <1>;



			preloader@0 {

				label = "pl";

				read-only;

				reg = <0x00000000 0x00400000>;

			};

			android@00400000 {

				label = "android";

				reg = <0x00400000 0x12c00000>;

			};

		};

	};



2) ECC Engine:

==============



Required BCH properties:

- compatible:	Should be one of

		"mediatek,mt2701-ecc",

		"mediatek,mt2712-ecc",

		"mediatek,mt7622-ecc".

- reg:		Base physical address and size of ECC.

- interrupts:	Interrupts of ECC.

- clocks:	ECC required clocks.

- clock-names:	ECC clocks internal name.



Example:



	bch: ecc@1100e000 {

		compatible = "mediatek,mt2701-ecc";

		reg = <0 0x1100e000 0 0x1000>;

		interrupts = <GIC_SPI 55 IRQ_TYPE_LEVEL_LOW>;

		clocks = <&pericfg CLK_PERI_NFI_ECC>;

		clock-names = "nfiecc_clk";

	};

Documentation/devicetree/bindings/mtd/partitions/partitions.yaml

+1 −1
Original line number Diff line number Diff line
@@ -32,7 +32,7 @@ properties: 
    enum: [1, 2]



patternProperties:

  "partition(-.+|@[0-9a-f]+)":

  "^partition(-.+|@[0-9a-f]+)$":

    $ref: partition.yaml



required:

MAINTAINERS

+1 −1
Original line number Diff line number Diff line
@@ -13139,7 +13139,7 @@ F: drivers/phy/ralink/phy-mt7621-pci.c 
MEDIATEK NAND CONTROLLER DRIVER

L:	linux-mtd@lists.infradead.org

S:	Orphan

F:	Documentation/devicetree/bindings/mtd/mtk-nand.txt

F:	Documentation/devicetree/bindings/mtd/mediatek,mtk-nfc.yaml

F:	drivers/mtd/nand/raw/mtk_*









MEDIATEK PMIC LED DRIVER