Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752788AbbKCJRF (ORCPT ); Tue, 3 Nov 2015 04:17:05 -0500 Received: from mailout1.w1.samsung.com ([210.118.77.11]:9245 "EHLO mailout1.w1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752296AbbKCJQy (ORCPT ); Tue, 3 Nov 2015 04:16:54 -0500 X-AuditID: cbfec7f5-f794b6d000001495-b8-56387b80a597 From: Pavel Fedin To: devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , Kukjin Kim , Krzysztof Kozlowski Subject: [PATCH v5 1/4] Documentation: dt-bindings: Describe SROMc configuration Date: Tue, 03 Nov 2015 12:16:38 +0300 Message-id: <9a1edb15c06e27fa1fba5773c937e3a3d363c32a.1446542020.git.p.fedin@samsung.com> X-Mailer: git-send-email 2.4.4 In-reply-to: References: In-reply-to: References: X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFjrJLMWRmVeSWpSXmKPExsVy+t/xa7oN1RZhBnNni1rMP3KO1aL/zUJW i3OvVjJavH5haNH/+DWzxabH11gtLu+aw2Yx4/w+Joul1y8yWUyYvpbFonXvEXYHbo8189Yw elzu62XyWLn8C5vHplWdbB6bl9R79G1ZxejxeZNcAHsUl01Kak5mWWqRvl0CV8bd7dIF26Qq Dl1ZztjAeFK4i5GTQ0LAROLu1DPsELaYxIV769m6GLk4hASWMkqcefiVEcJpY5LYufISWBWb gLrE6a8fWEASIgLtjBLHGjcygTjMAhOZJJZM388IUiUsECDR8OMhmM0ioCpx5s8yFhCbVyBa YvXRg2wQ++QkrlyfDmZzCphLPP4+BcwWEjCT6H73hB2X+ARG/gWMDKsYRVNLkwuKk9JzjfSK E3OLS/PS9ZLzczcxQgL46w7GpcesDjEKcDAq8fAuWGIeJsSaWFZcmXuIUYKDWUmEtyDQIkyI NyWxsiq1KD++qDQntfgQozQHi5I478xd70OEBNITS1KzU1MLUotgskwcnFINjGuZfV7tehaU 6SX/sypvaui+vKuMh37LakQ5zInZ82Zl0+SO2tyaHXH3ZxS/0t+ZNznwzWfWawo+N/7qWOZ0 nX6TeSJ11YL7pj8frLgyrf0LI9N56QuvapVubc14EyH7kCsxoZWnV875tM+ZkuOs2ztW+O06 wHBedd5TPmtNZd7vja+fbLVXWq/EUpyRaKjFXFScCAAAOJ2zXAIAAA== Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3537 Lines: 95 Add documentation for new subnode properties, allowing bank configuration. Based on u-boot implementation, but heavily reworked. Signed-off-by: Pavel Fedin --- .../bindings/arm/samsung/exynos-srom.txt | 68 +++++++++++++++++++++- 1 file changed, 66 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/arm/samsung/exynos-srom.txt b/Documentation/devicetree/bindings/arm/samsung/exynos-srom.txt index 33886d5..ee378ca 100644 --- a/Documentation/devicetree/bindings/arm/samsung/exynos-srom.txt +++ b/Documentation/devicetree/bindings/arm/samsung/exynos-srom.txt @@ -5,8 +5,72 @@ Required properties: - reg: offset and length of the register set -Example: +- #address-cells: Must be set to 2 to allow memory address translation + +- #size-cells: Must be set to 1 to allow CS address passing + +- ranges: Must be set up to reflect the memory layout with four integer values + per bank: + 0 + +Sub-nodes: +The SROM controller can be used to attach external peripherials. In this case +device nodes should be added as subnodes to the SROMc node. These subnodes, +except regular device specification, should contain the following properties, +describing configuration of the relevant SROM bank: + +Required properties: +- reg: bank number, base address (relative to start of the bank) and size of + the memory mapped for the device. Note that base address will be + typically 0 as this is the start of the bank. + +- samsung,srom-timing : array of 6 integers, specifying bank timings in the + following order: Tacp, Tcah, Tcoh, Tacc, Tcos, Tacs. + Each value is specified in cycles (0 - 15) and has the + following meaning: + Tacp : Page mode access cycle at Page mode + Tcah : Address holding time after CSn + Tcoh : Chip selection hold on OEn + Tacc : Access cycle + Tcos : Chip selection set-up before OEn + Tacs : Address set-up before CSn + +Optional properties: +- reg-io-width : data width in bytes (1 or 2). If omitted, default of 1 is used. + +- samsung,srom-page-mode : page mode configuration for the bank: + 0 - normal (one data) + 1 - four data + If omitted, default of 0 is used. + +Example: basic definition, no banks are configured + sromc@12570000 { + compatible = "samsung,exynos-srom"; + reg = <0x12570000 0x14>; + }; + +Example: SROMc with smsc 911x ethernet chip on bank 3 sromc@12570000 { + #address-cells = <2>; + #size-cells = <1>; + ranges = <0 0 0x04000000 0x20000 // Bank0 + 1 0 0x05000000 0x20000 // Bank1 + 2 0 0x06000000 0x20000 // Bank2 + 3 0 0x07000000 0x20000>; // Bank3 + compatible = "samsung,exynos-srom"; - reg = <0x12570000 0x10>; + reg = <0x12570000 0x14>; + + ethernet@3 { + compatible = "smsc,lan9115"; + reg = <3 0 0x10000>; // Bank 3, offset = 0 + phy-mode = "mii"; + interrupt-parent = <&gpx0>; + interrupts = <5 8>; + reg-io-width = <2>; + smsc,irq-push-pull; + smsc,force-internal-phy; + + samsung,srom-config = <1 9 12 1 9 1 1>; + }; }; -- 2.4.4 -- 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/