From patchwork Tue Apr 28 12:19:18 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Baruch Siach X-Patchwork-Id: 6288441 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 880169F373 for ; Tue, 28 Apr 2015 12:23:45 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id A25A120320 for ; Tue, 28 Apr 2015 12:23:44 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id B9F7A20306 for ; Tue, 28 Apr 2015 12:23:43 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Yn4VW-0001gs-Vq; Tue, 28 Apr 2015 12:20:58 +0000 Received: from guitar.tcltek.co.il ([192.115.133.116] helo=mx.tkos.co.il) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Yn4VQ-0001cN-I2; Tue, 28 Apr 2015 12:20:54 +0000 Received: from tarshish.tkos.co.il (unknown [10.0.8.6]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by mx.tkos.co.il (Postfix) with ESMTPSA id 44FE0440609; Tue, 28 Apr 2015 15:20:28 +0300 (IDT) From: Baruch Siach To: David Woodhouse , Brian Norris Subject: [PATCH v3 1/2] mtd: nand: dt binding documentation for digicolor NFC Date: Tue, 28 Apr 2015 15:19:18 +0300 Message-Id: <2bba276e3a1808a9fc49d30cabe8d9de8bc60efd.1430223559.git.baruch@tkos.co.il> X-Mailer: git-send-email 2.1.4 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20150428_052053_732044_53B38783 X-CRM114-Status: GOOD ( 10.45 ) X-Spam-Score: 0.0 (/) Cc: devicetree@vger.kernel.org, Baruch Siach , linux-mtd@lists.infradead.org, linux-arm-kernel@lists.infradead.org, Boris Brezillon X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP The CX92755 SoC is one of Conexant Digicolor series of SoCs. This devicetree binding document describes the NAND flash controller the is shared by some SoCs in the Digicolor series. Not all of the properties are currently actually used by the driver. Specifically, the driver doesn't make use of interrupts. This may change in the future. Also worth noting that the only supported ECC mode is "hw_syndrome". In the future the driver may add support for additional modes. Signed-off-by: Baruch Siach --- v3: Make all generic nand binding properties for child nodes optional as suggested by Boris Brezillon. --- .../devicetree/bindings/mtd/digicolor-nand.txt | 71 ++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/digicolor-nand.txt diff --git a/Documentation/devicetree/bindings/mtd/digicolor-nand.txt b/Documentation/devicetree/bindings/mtd/digicolor-nand.txt new file mode 100644 index 000000000000..f2b725580885 --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/digicolor-nand.txt @@ -0,0 +1,71 @@ +Conexant Digicolor NAND Flash Controller (NFC) + +Required properties: +- compatible : "cnxt,cx92755-nfc". +- reg : shall contain registers location and length for data and reg. +- interrupts : shall define the nand controller interrupt. +- #address-cells: shall be set to 1. Encode the nand CS. +- #size-cells : shall be set to 0. +- clocks : shall reference nand controller clocks. + +Optional children nodes: +Children nodes represent the available nand chips. + +Optional children properties: +- nand-ecc-mode : defaults be "hw_syndrome". +- nand-ecc-strength : must be one of 6, 7, 8, 24, 28, 30. +- nand-ecc-step-size : must be either 512 or 1024. + +see Documentation/devicetree/bindings/mtd/nand.txt for generic bindings. + +Each nand chip child node may optionally have partition sub-nodes. See +Documentation/devicetree/bindings/mtd/partition.txt for partitions binding. + +Example: +nfc: nfc@f00a4000 { + compatible = "cnxt,cx92755-nfc"; + reg = <0xf00a4000 0x200>; + interrupts = <26>; + clocks = <&main_clk>; + #address-cells = <1>; + #size-cells = <0>; + + nand@0 { + reg = <0>; + #address-cells = <1>; + #size-cells = <1>; + nand-ecc-mode = "hw_syndrome"; + nand-ecc-step-size = <1024>; + nand-ecc-strength = <28>; + + partition@0 { + label = "boot"; + reg = <0x00000000 0x00700000>; + }; + + partition@700000 { + label = "splash"; + reg = <0x00700000 0x00500000>; + }; + + partition@c00000 { + label = "maint"; + reg = <0x00c00000 0x00500000>; + }; + + partition@1100000 { + label = "kernel"; + reg = <0x01100000 0x00500000>; + }; + + partition@1600000 { + label = "rootfs"; + reg = <0x01600000 0x18000000>; + }; + + partition@19600000 { + label = "data1"; + reg = <0x19600000 0x66a00000>; + }; + }; +};