Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752922AbbEFSBM (ORCPT ); Wed, 6 May 2015 14:01:12 -0400 Received: from mail-pd0-f170.google.com ([209.85.192.170]:33645 "EHLO mail-pd0-f170.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752786AbbEFSBG (ORCPT ); Wed, 6 May 2015 14:01:06 -0400 From: Brian Norris To: Cc: Brian Norris , Dmitry Torokhov , Anatol Pomazao , Ray Jui , Corneliu Doban , Jonathan Richardson , Scott Branden , Florian Fainelli , =?UTF-8?q?Rafa=C5=82=20Mi=C5=82ecki?= , bcm-kernel-feedback-list@broadcom.com, Dan Ehrenberg , Gregory Fong , , , Kevin Cernekee Subject: [PATCH v3 05/10] Documentation: devicetree: brcmstb_nand: add 'brcm,nand-soc' bindings Date: Wed, 6 May 2015 10:59:49 -0700 Message-Id: <1430935194-7579-6-git-send-email-computersforpeace@gmail.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1430935194-7579-1-git-send-email-computersforpeace@gmail.com> References: <1430935194-7579-1-git-send-email-computersforpeace@gmail.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3786 Lines: 77 Signed-off-by: Brian Norris --- .../devicetree/bindings/mtd/brcm,brcmstb-nand.txt | 39 +++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/mtd/brcm,brcmstb-nand.txt b/Documentation/devicetree/bindings/mtd/brcm,brcmstb-nand.txt index 662c857e74fe..6a3ab751db99 100644 --- a/Documentation/devicetree/bindings/mtd/brcm,brcmstb-nand.txt +++ b/Documentation/devicetree/bindings/mtd/brcm,brcmstb-nand.txt @@ -30,7 +30,10 @@ Required properties: "flash-dma" and/or "nand-cache". - interrupts : The NAND CTLRDY interrupt and (if Flash DMA is available) FLASH_DMA_DONE -- interrupt-names : May be "nand_ctlrdy" or "flash_dma_done" +- interrupt-names : For hardware without a dedicated 'brcm,nand-soc' node, may + be "nand_ctlrdy" or "flash_dma_done" + For hardware with a dedicated 'brcm,nand-soc' node for + breaking out individual interrupt types, may be "nand" - interrupt-parent : See standard interrupt bindings - #address-cells : <1> - subnodes give the chip-select number - #size-cells : <0> @@ -40,6 +43,10 @@ Optional properties: (WP) control bit. It is always available on >= v7.0. Use this property to describe the rare earlier versions of this core that include WP +- brcm,nand-soc : Phandle to SoC control node. This is necessary + for SoCs where NAND interrupts and bus + infrastructure are integrated in non-standard + ways. * NAND chip-select @@ -74,6 +81,36 @@ Optional properties: Each nandcs device node may optionally contain sub-nodes describing the flash partition mapping. See partition.txt for more detail. + +* NAND SoC control node: + +The NAND controller is integrated differently on the variety of SoCs on which it +is found. Part of this integration involves providing status and enable bits +with which to control the 8 exposed NAND interrupts, as well as hardware for +configuring the endianness of the data bus. On some SoCs, these features are +handled via standard, modular components (e.g., their interrupts look like a +normal IRQ chip), but on others, they are controlled in unique and interesting +ways, sometimes with registers that lump multiple NAND-related functions +together. The former case can be described simply by the standard interrupts +properties in the main controller node. But for the latter exceptional cases, +we can describe these extra SoC-specific integration hardware via the following +node, referenced from the brcm,brcmnand node above. + + - compatible: Can be one of several SoC-specific strings. Each SoC may have + different requirements for its additional properties, as described below each + bullet point below. + + * "brcm,nand-soc-bcm63138" + - reg: (required) the 'NAND_INT_BASE' register range, with separate status + and enable registers + + * "brcm,nand-soc-iproc" + - reg: (required) the "IDM" register range, for interrupt enable and APB + bus access endianness configuration, and the "EXT" register range, + for interrupt status/ack. + - reg-names: (required) a list of the names corresponding to the previous + register ranges. Should contain "idm" and "ext". + Example: nand@f0442800 { -- 1.9.1 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/