From patchwork Tue Aug 28 11:19:40 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonas Gorski X-Patchwork-Id: 962848 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="LGPO5uME"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 4205rg6Y2Yz9rvt for ; Tue, 28 Aug 2018 21:20:03 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727860AbeH1PLM (ORCPT ); Tue, 28 Aug 2018 11:11:12 -0400 Received: from mail-wr1-f68.google.com ([209.85.221.68]:45686 "EHLO mail-wr1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727879AbeH1PLM (ORCPT ); Tue, 28 Aug 2018 11:11:12 -0400 Received: by mail-wr1-f68.google.com with SMTP id 20-v6so1196077wrb.12 for ; Tue, 28 Aug 2018 04:20:01 -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; bh=FA4LHoYrwI9N5Fqi8+5cCwgMGFmlAXyyzASAeV7PlNo=; b=LGPO5uMET6NXIfa+D1/9RfvnyV3q9vL7Dl9SFJW0qNDEKPqwTgfpT6HMcp1DLLQZbL Y5RUA0dc2ZX9x2NElY6OkuPLFgThuz/mcUf8G+C79edZ6PxMXgU/zG2V/OcxU4o8mw9h HAtciS+sNpM8PKcLtbDQpELLwPbasu9oYzemmUX+B5guczv0FxJ36cbFBlDZBdd5wA5b bPctIzDIHl61t+pQAUeJfuWE504rAEXOiPt/isjtp8Dz+X+y8pkmX2NBmtBQUYMUdf/N jzF8sFf2b0gXPqHEyeQ+BiQWSpOw/KTPJGUQkqzeDForLfEuhwW7p2BV8G98iyFym+fW 1oSw== 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; bh=FA4LHoYrwI9N5Fqi8+5cCwgMGFmlAXyyzASAeV7PlNo=; b=GZdwy5OQeVhX15krUOXT6sUvsKANHHD1hmepe7AR+AOIeTT/5/eWtKKxilaHcusxhU Z60FG/vOK4tnEsisykKClFhRzf/yFETbDfFIjjaD2DLN1VVYWqFfqWwAFUQYTTKkPwkZ pe1h3d8qY42ybg3vLxjgRXkCF0FudwUpUYdp9yS4B+qyCLaIvIVQKbLAcLwv4cgXnE+l 23Ir/UHqWq/qN7KHTJD3ShFMHms2OdgVzGSTmlJKJwiKMQoaNfrQfnhHW3XDuOpeCwgC T8mCpZ3OtZ0spx+gOK85fce9HwUpXqa5W/byplvnZZG0hoYfYUi3tX4dpMNnXhO0xu0k vA4g== X-Gm-Message-State: APzg51A0AkT7Ohjh2wDknMPO3o6DJ8EQ3FPuCP4rceITtwVbCkW/DVNy RvgAk5mqimBNrupzI3qv+DU= X-Google-Smtp-Source: ANB0VdY3QW4zRKlmqm/CwUl8Sq0oWoZW1hUjCteWMELVAd1ze4/9hNvtTbEq+SQ6WMeMJRNvs8SPPA== X-Received: by 2002:adf:8504:: with SMTP id 4-v6mr829652wrh.72.1535455201335; Tue, 28 Aug 2018 04:20:01 -0700 (PDT) Received: from localhost.localdomain ([2001:470:9e39::64]) by smtp.gmail.com with ESMTPSA id e141-v6sm1520282wmd.32.2018.08.28.04.19.59 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Aug 2018 04:20:00 -0700 (PDT) From: Jonas Gorski To: linux-mtd@lists.infradead.org, devicetree@vger.kernel.org Cc: David Woodhouse , Brian Norris , Boris Brezillon , Marek Vasut , Richard Weinberger , Rob Herring , Mark Rutland , Florian Fainelli Subject: [PATCH 1/5] dt-bindings: mtd: describe the simple BCM963XX NOR flash layout Date: Tue, 28 Aug 2018 13:19:40 +0200 Message-Id: <20180828111944.5956-2-jonas.gorski@gmail.com> X-Mailer: git-send-email 2.13.2 In-Reply-To: <20180828111944.5956-1-jonas.gorski@gmail.com> References: <20180828111944.5956-1-jonas.gorski@gmail.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add binding documentation for the standard CFE based BCM963XX flash layout, found in most devices using a BCM63XX SoC with NOR flash. Signed-off-by: Jonas Gorski --- .../brcm,bcm963xx-cfe-nor-partitions.txt | 24 ++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-cfe-nor-partitions.txt diff --git a/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-cfe-nor-partitions.txt b/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-cfe-nor-partitions.txt new file mode 100644 index 000000000000..9f630e95f180 --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-cfe-nor-partitions.txt @@ -0,0 +1,24 @@ +Broadcom BCM963XX CFE Loader NOR Flash Partitions +================================================= + +Most Broadcom BCM63XX SoC based devices follow the Broadcom reference layout for +NOR. The first erase block used for the CFE bootloader, the last for an +NVRAM partition, and the remainder in-between for one to two firmware partitions +at fixed offsets. A valid firmware partition is identified by the ImageTag +header found at beginning of the second erase block, containing the rootfs and +kernel offsets and sizes within the firmware partition. + +Required properties: +- compatible : must be "brcm,bcm963xx-cfe-nor-partitions" + +Example: + +flash@1fc00000 { + compatible = "cfi-flash"; + reg = <0x1fc00000 0x400000>; + bank-width = <2>; + + partitions { + compatible = "brcm,bcm963xx-cfe-nor-partitions"; + }; +}; From patchwork Tue Aug 28 11:19:43 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonas Gorski X-Patchwork-Id: 962849 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="qEAopsPE"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 4205rm0c8mz9rvt for ; Tue, 28 Aug 2018 21:20:08 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728023AbeH1PLR (ORCPT ); Tue, 28 Aug 2018 11:11:17 -0400 Received: from mail-wr1-f65.google.com ([209.85.221.65]:38478 "EHLO mail-wr1-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727951AbeH1PLR (ORCPT ); Tue, 28 Aug 2018 11:11:17 -0400 Received: by mail-wr1-f65.google.com with SMTP id w11-v6so1212310wrc.5 for ; Tue, 28 Aug 2018 04:20:06 -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; bh=Sp7tdRbq7xHl3fmuesQSXf3FVzLU0TAectp9Ieuy97o=; b=qEAopsPEORNrH7fhdzgZwVqAnYrMfER3h8IHk7I5uqMVJDzVtg2NVqyNJq0sI/O7gD b7pTNeuILuKDfaTn1na0i+vMrQuowsST1WtyxRtooIB4aWyTXMPNiVfwKR4VTJhKNEte QOrqkSCd+ZkNleY+nte6sghTd/x4LZc3RwD61X16Ncuc5UoFeljL6ucM51x+2nVJ+WSM XBouShUjNqTe6YsRNv/Qoye5dfI/OVMoNSNk6AxrV8qMp4I6PVjtfM+UrpS6vp9Iewys /uCzOhBdBix7tVM5XJTmGbtHYb1dgB/AUnaND7pp2bvKok0WpElNaOhwu7m8pUHo+5ew Fx5w== 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; bh=Sp7tdRbq7xHl3fmuesQSXf3FVzLU0TAectp9Ieuy97o=; b=lQHrVeAkeWGlzgVIicXDXdioj30bs4vjL17cY2+G5DrUJu1OpgrM+P5B8EHLFmSd9R jtivePZtTRX4MVLqrISgnTVU7iRX+l8bG0Cyw9RBbXxmjfHP0CcqayuAbqUlG0/0AhSq QuOCKcaR6ciyEk8ZdvCVQ0AShOYkI4xc9z8BWqxOM6CtMNwTVMElD9CDI7JwmCTfm1nj CsCGHEfSUZa4zdYxzUJewu9ATTo7LWj8Xq9DsHiYZocDmV0oyAg7NBbuphpG8Sos54xf dl3Bnt6pij7eXG4TGB4DSmojLKGF7OmNmJs50jZKCZIJRxAIABqEp15bk/sY7Ko+q1CV yFaQ== X-Gm-Message-State: APzg51CjnjN40G2S2BaFt4+DA2JbwGRaviZXabvWlrQXE7SJ+jfJhKBt 3FXNRfVP5ftpygGvkdPM1tMctPwI X-Google-Smtp-Source: ANB0VdZ2AuZKwYhavww/9Wv5azz8WNvxQZowriSxD1UMU7WiQUR5Zi7MPLxx1sKNuhliE9bGCN6Y8Q== X-Received: by 2002:a5d:6347:: with SMTP id b7-v6mr781517wrw.163.1535455205753; Tue, 28 Aug 2018 04:20:05 -0700 (PDT) Received: from localhost.localdomain ([2001:470:9e39::64]) by smtp.gmail.com with ESMTPSA id e141-v6sm1520282wmd.32.2018.08.28.04.20.04 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Aug 2018 04:20:05 -0700 (PDT) From: Jonas Gorski To: linux-mtd@lists.infradead.org, devicetree@vger.kernel.org Cc: David Woodhouse , Brian Norris , Boris Brezillon , Marek Vasut , Richard Weinberger , Rob Herring , Mark Rutland , Florian Fainelli Subject: [PATCH 4/5] dt-bindings: mtd: describe BCM963XX ImageTag format and usage Date: Tue, 28 Aug 2018 13:19:43 +0200 Message-Id: <20180828111944.5956-5-jonas.gorski@gmail.com> X-Mailer: git-send-email 2.13.2 In-Reply-To: <20180828111944.5956-1-jonas.gorski@gmail.com> References: <20180828111944.5956-1-jonas.gorski@gmail.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Describe how to use the BCM963XX ImageTag format in a mixed flash layout environment. Signed-off-by: Jonas Gorski --- .../mtd/partitions/brcm,bcm963xx-imagetag.txt | 78 ++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-imagetag.txt diff --git a/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-imagetag.txt b/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-imagetag.txt new file mode 100644 index 000000000000..f4a444d69d9a --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/partitions/brcm,bcm963xx-imagetag.txt @@ -0,0 +1,78 @@ +Broadcom BCM963XX ImageTag Partition Container +============================================== + +Some Broadcom BCM63XX SoC based devices contain additional, non discoverable +partitions or non standard bootloader partition sizes. For these a mixed layout +needs to be used with an explicit firmware partition. + +The BCM963XX ImageTag is a simple firmware header describing the offsets and +sizes of the rootfs and kernel parts contained in the firmware. + +Required properties: +- compatible : must be "brcm,bcm963xx-imagetag" + +Examples: + +flash@1e000000 { + compatible = "cfi-flash"; + reg = <0x1e000000 0x2000000>; + bank-width = <2>; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + cfe@0 { + reg = <0x0 0x10000>; + read-only; + }; + + firmware@10000 { + reg = <0x10000 0x7d0000>; + compatible = "brcm,bcm963xx-imagetag"; + }; + + caldata@7e0000 { + reg = <0x7e0000 0x10000>; + read-only; + }; + + nvram@7f0000 { + reg = <0x7f0000 0x10000>; + }; + }; +}; + + +flash@1e000000 { + compatible = "cfi-flash"; + reg = <0x1e000000 0x2000000>; + bank-width = <2>; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + /* + * Some devices use a flash chip with 64k erase blocks, some + * use one with 128k erase blocks, so the vendor decided to + * always use 128k as the firmware offset. + */ + + cfe@0 { + reg = <0x0 0x20000>; + read-only; + }; + + firmware@20000 { + reg = <0x20000 0x7c0000>; + compatible = "brcm,bcm963xx-imagetag"; + }; + + nvram@7e0000 { + reg = <0x7e0000 0x20000>; + }; + }; +};