From patchwork Wed Oct 3 19:38:58 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ricardo Ribalda Delgado X-Patchwork-Id: 978499 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="qSWWASSe"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 42QRDJ4nLJz9s8J for ; Thu, 4 Oct 2018 05:39:28 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727343AbeJDC3B (ORCPT ); Wed, 3 Oct 2018 22:29:01 -0400 Received: from mail-ed1-f66.google.com ([209.85.208.66]:42675 "EHLO mail-ed1-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726964AbeJDC3B (ORCPT ); Wed, 3 Oct 2018 22:29:01 -0400 Received: by mail-ed1-f66.google.com with SMTP id n2-v6so6415265edo.9; Wed, 03 Oct 2018 12:39:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=EUdiv3GxcKIGRchs0tikWhabjt2xJ5EVou+ayt6rXzE=; b=qSWWASSedwNTvf4cXruRNmwqRV5s9Pos2P66j+SdUqiqAjtfA0OWX9/tzuCumUDe0w ro03gJzfo3bAAdhBt2d9OaI6AX3eMl9lRbHr73oWwRDV2JE1M/q5ymohBIromZFuGkm5 CAYLo/rA0usRaBrn/3Nm9Ecgv6CCv3TIjjiKkPtfZ3xDAnnJ5WOX52Xw3sNC08eOmSEW NNKOcVRfVu09Tr7tuRmNtFNyxw4qS1DI0cIpZMdgAwFXUP20nIRYpMCO2W+fhWoBsIld HV5JDJH6JehWdTz7SOt48ok9ETZRx1IOoVO7sgdaaZg6vDLEt/N9Lmr7bzaKmbbBE5/1 z+mA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=EUdiv3GxcKIGRchs0tikWhabjt2xJ5EVou+ayt6rXzE=; b=RwRHQCReM7s1UUvvvcKWDyUBfe9u8QSI9inn3EMrs1Jpgsn0y0yyb1hbX0pljUX435 Ny9kJkcXIMHA1Kv/8TL5relkXMjHf64lCG7wwHYFRr6jdFLy9Ct0eVqjg/fMBjQZ0JYr PonSDoaEJ23x+mZN/W0ELfrbZPqUe9xucF+PiZ3iQkLkaHJkBNLsScztJrsaydfgW8Tl ejcn+u239REUlwyf1JJByqv5h3H/HwzRh2rUmcHoxZLT5wNWtRlEMZwUc9qcz2CzYEHD yjMtwKB9lHk0uNcJZKYLzDRZjU6R0ABHrgMkje9dDtRoE+Nfp08hRT4v4AOsiDDfeMZY CqpQ== X-Gm-Message-State: ABuFfoi33jvwBz+hxMXZb4j0XadR2azcVWJqiRolLn2MD26V6OBJ5IlK HxTWVOZ+Pmc5LhJItA3FKr8= X-Google-Smtp-Source: ACcGV6125Uz8ifFRRuu+yBVLw3QDZH8ZrmLMErmL1j9qxy14pBPquBD4vc8gcsNixbGxPLK7iSylpQ== X-Received: by 2002:a17:906:b01:: with SMTP id u1-v6mr3428970ejg.124.1538595553273; Wed, 03 Oct 2018 12:39:13 -0700 (PDT) Received: from piling.lan (80-71-134-83.u.parknet.dk. [80.71.134.83]) by smtp.gmail.com with ESMTPSA id b49-v6sm765263eda.70.2018.10.03.12.39.10 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 03 Oct 2018 12:39:11 -0700 (PDT) From: Ricardo Ribalda Delgado To: David Woodhouse , Brian Norris , Boris Brezillon , Marek Vasut , Richard Weinberger , Zhouyang Jia , linux-mtd@lists.infradead.org, open list Cc: Ricardo Ribalda Delgado , devicetree@vger.kernel.org Subject: [PATCH v5 7/8] dt-binding: mtd: Document gpio-addr-flash Date: Wed, 3 Oct 2018 21:38:58 +0200 Message-Id: <20181003193859.23928-7-ricardo.ribalda@gmail.com> X-Mailer: git-send-email 2.19.0 In-Reply-To: <20181003193859.23928-1-ricardo.ribalda@gmail.com> References: <20181003193859.23928-1-ricardo.ribalda@gmail.com> MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add documentation for gpio-addr-flash. This binding allow creating flash devices that are paged using GPIOs. Cc: devicetree@vger.kernel.org Reviewed-by: Rob Herring Signed-off-by: Ricardo Ribalda Delgado --- .../bindings/mtd/gpio-addr-flash.txt | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/gpio-addr-flash.txt diff --git a/Documentation/devicetree/bindings/mtd/gpio-addr-flash.txt b/Documentation/devicetree/bindings/mtd/gpio-addr-flash.txt new file mode 100644 index 000000000000..5006a26e1753 --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/gpio-addr-flash.txt @@ -0,0 +1,54 @@ +Memory Mapped flash with some address lines addressed using GPIOs + +Handle the case where a flash device is mostly addressed using physical +line and supplemented by GPIOs. This way you can hook up say a 8MiB flash +to a 2MiB memory range and use the GPIOs to select a particular range. + + - compatible : "cfi-gpio-addr-flash" + - reg : Address range of the mtd chip that is memory mapped, this is, + on the previous example 2MiB. + - bank-width : Width (in bytes) of the bank. Equal to the + device width times the number of interleaved chips. + - gpios: List of GPIO specifiers that will be used to address the MSBs address + lines. The order goes from LSB to MSB. + - probe-type : (optional) "cfi_probe", "jedec_probe". How the mtd chip + is going to be probed. If omitted, assumed to be equal to "cfi_probe". + - #address-cells, #size-cells : Must be present if the device has + sub-nodes representing partitions (see below). In this case + both #address-cells and #size-cells must be equal to 1. + +The device tree may optionally contain sub-nodes describing partitions of the +address space. Check partition.txt for more details. + +Example: + + flash@300000 { + #address-cells = <1>; + #size-cells = <1>; + compatible = "cfi-gpio-addr-flash"; + bank-width = <2>; + reg = < 0x00300000 0x00200000 >; + gpios = <&gpio_0 3 0>, <&gpio_0 4 0>; + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + partition@0 { + reg = < 0x0 0x200000 >; + label = "Golden Bitstream"; + }; + partition@200000 { + reg = < 0x200000 0x200000 >; + label = "User Bitstream"; + }; + partition@400000 { + reg = < 0x400000 0x200000 >; + label = "V4L Controls"; + }; + partition@600000 { + reg = < 0x600000 0x200000 >; + label = "Production Data"; + }; + } + } ;