Re: [PATCH 3/3] mtd: spi-nand: add devicetree binding

From: Mark Rutland
Date: Thu Jan 08 2015 - 09:36:46 EST


On Thu, Jan 08, 2015 at 12:52:26AM +0000, Peter Pan ææ (peterpandong) wrote:
> This commit adds the devicetree binding document that specifies the
> spi nand devices support.
>
> Signed-off-by: Peter Pan <peterpandong@xxxxxxxxxx>
> ---
> Documentation/devicetree/bindings/mtd/spi-nand.txt | 22 ++++++++++++++++++++++
> 1 file changed, 22 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/mtd/spi-nand.txt
>
> diff --git a/Documentation/devicetree/bindings/mtd/spi-nand.txt b/Documentation/devicetree/bindings/mtd/spi-nand.txt
> new file mode 100644
> index 0000000..9dd3efd
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/mtd/spi-nand.txt
> @@ -0,0 +1,22 @@
> +* NAND driver for MT29F, GD5F and similar SPI NAND flash chips
> +
> +Required properties:
> +- #address-cells, #size-cells : Must be present if the device has sub-nodes
> + representing partitions.

Can we refer to the binding document for that?

> +- compatible : Should be the manufacturer and the name of the chip. Bear in mind
> + the DT binding is not Linux-only, but in case of Linux, see the
> + "spi_nand_id_table" array in drivers/mtd/spi-nand/spi-nand-device.c
> + for the list of supported chips.

NAK for referring to Linux internals from a binding document.

The list of compatible string should be defined in this binding
document.

> +- reg : Chip-Select number
> +- spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at
> +
> +Example:
> +
> + flash: flash@0 {
> + #address-cells = <1>;
> + #size-cells = <1>;

These aren't necessary as no partitions are defined here.

Otherwise, this looks ok.

Thanks,
Mark.

> + compatible = "micron,mt29f";
> + reg = <0>;
> + spi-max-frequency = <50000000>;
> + };
> +
> --
> 1.9.1
> Nååéçyîæbçîåvè?è{.n?åæézèz)ééw*jgî?çæåî/äéçæ?åæç??æçåîççé?é:+vååéä
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/