From patchwork Thu Dec 2 14:38:26 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Adam Ford X-Patchwork-Id: 12694530 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id C4546C433FE for ; Thu, 2 Dec 2021 14:39:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=+/JLAjM64BuVLF17U/sgJVWFJa5+FPpgnqAP47AzJS0=; b=fh66NeXL7sspc6 BgBTmJbQnNEsoaxIATYdsg380BNVRIyrEWyqclnFnwOOczKnsqtooCPzBEi+S85mMWL/SER+k/v5j WLWivrq0NTmGDz4kB303vW9P65hLeKiMNQH5TJ+129dInxIyVy86vyjkLAUjEiyw6+l4mnIDAbbQ7 5rGMFFbeQheVuKFfEvy51c2zUB2Jap4TTM75c0GW1mRQev20PL/AIHwFWBl3LpNZvKgUffD7ui03M VepeWJXEtyyCANPZfGmABY+EFRWaFN6zFk5W6h6WMVFRxY8lynMJ0n9WyfulXANcoSKjwf7bVDrYD O82J9pvxHDwbOUoEzMrA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1msnEV-00Cad4-0y; Thu, 02 Dec 2021 14:38:47 +0000 Received: from mail-qv1-xf35.google.com ([2607:f8b0:4864:20::f35]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1msnER-00Cab7-9x for linux-arm-kernel@lists.infradead.org; Thu, 02 Dec 2021 14:38:45 +0000 Received: by mail-qv1-xf35.google.com with SMTP id bu11so25145224qvb.0 for ; Thu, 02 Dec 2021 06:38:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=mmZpOWwjKAj2tZZlHMc2Lc6mAWK1X55bGBiJYt8O/YY=; b=UFNADGdzIP1tzOSlAXJS5dBsEdygLoXoGH2gAHGXr6tUAp2DXsRQ2YrTrNf4JavTCm QJUFr1PLbLCFD6WzIAKwHVxADdauRqPrx1MVM+DuEcTzRqhmVjXafKaRFhxc8ppmAFhE 1TZAqDcwsDSg6loX9TIeNBZONmD/qgqXrpLT1Iij29D6PqWBQXNCc+BgaNR6s95Zv6Fv AXZo0Ay4SCp9uTF0txIpb2buhwUNK1NdrzBxpCAEwlI6tY+3U1yP+CKD9lXYK7TW8dEb RpK5BJKfPwS2Rz/8S3eI7jswX8yhIjLfkSugvPvWHhraF10pfkw/cWpFI6aLc0Z86kA5 DmAg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=mmZpOWwjKAj2tZZlHMc2Lc6mAWK1X55bGBiJYt8O/YY=; b=x3LqJmi9Oi3AX8LrdvdWNpN7nYBq2etno+SN/L95RZBxZWsDq4QgHcySLxnPedSqW/ ZsUvwA5DNBUYFshGkyjG58CgLFD6LPcQQbTxMyS91dyVEstwXa2+c1tdwn4n7eNRbkQG F9IT19XR3zYnffC3boeTaK8JKFuHoyMu0p/Z3TJB3gjjXNzs0vFrPGlVDgpX1zDEaw0s ZCJ0Gh5KvVS3yhNP2xk/niDDj2zOzom55OOW7eUu5RoQuQIBy9ePWOrT2mwcSjuae4SW y5eGftt8CEU8g1aroow4QqG7Uci5tUucR5ufmmedVxlgGNSX0yauw4PmnRkKCuTCTHd4 Zb0Q== X-Gm-Message-State: AOAM533K5z9Hx1Y+aR/KOscXNDcxM/AVGBFelccauum4neONdEV0GcAF 2gnXpto+bZRpyh+wLMv+Vr9e/EUodMM= X-Google-Smtp-Source: ABdhPJx4Qm784WF1SxNlh/qAJfgLxdayFaefCLGeLLwUazVSRNQyW4gRt0+v8PkTYMegx5I/TZOyBQ== X-Received: by 2002:a05:6214:13d1:: with SMTP id cg17mr12801351qvb.131.1638455921297; Thu, 02 Dec 2021 06:38:41 -0800 (PST) Received: from aford-OptiPlex-7050.logicpd.com ([174.46.170.158]) by smtp.gmail.com with ESMTPSA id bp38sm21840qkb.66.2021.12.02.06.38.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 02 Dec 2021 06:38:40 -0800 (PST) From: Adam Ford To: linux-arm-kernel@lists.infradead.org Cc: aford@beaconembedded.com, Adam Ford , Rob Herring , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , NXP Linux Team , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH V6 1/2] dt-bindings: soc: imx: Add binding doc for spba bus Date: Thu, 2 Dec 2021 08:38:26 -0600 Message-Id: <20211202143828.3335-1-aford173@gmail.com> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20211202_063843_383931_D8A8DD1E X-CRM114-Status: GOOD ( 13.42 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add binding doc for fsl,spba-bus. Signed-off-by: Adam Ford Reviewed-by: Rob Herring --- V6: Rebase on 5.16-rc and rename spba@xxxx to spba-bus@xxxx since most dsti files use that naming convention. V5: Rebase on 5.10-rc2 to be able to check yaml Add Reg entry V4: Remove an accidental makefile change Move type:object under additional properties V3: Rebase sample from aips-bus example Split off from series adding i.MX8M Nano functions to reduce noise V2: Attempted to update yaml from feedback diff --git a/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml new file mode 100644 index 000000000000..d42dbb0bbc2e --- /dev/null +++ b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml @@ -0,0 +1,68 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/bus/fsl,spba-bus.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Shared Peripherals Bus Interface + +maintainers: + - Shawn Guo + +description: | + A simple bus enabling access to shared peripherals. + + The "spba-bus" follows the "simple-bus" set of properties, as + specified in the Devicetree Specification. It is an extension of + "simple-bus" because the SDMA controller uses this compatible flag to + determine which peripherals are available to it and the range over which + the SDMA can access. There are no special clocks for the bus, because + the SDMA controller itself has its interrupt and clock assignments. + +select: + properties: + compatible: + contains: + const: fsl,spba-bus + required: + - compatible + +properties: + $nodename: + pattern: "^spba-bus(@[0-9a-f]+)?$" + + compatible: + items: + - const: fsl,spba-bus + - const: simple-bus + + '#address-cells': + enum: [ 1, 2 ] + + '#size-cells': + enum: [ 1, 2 ] + + reg: + maxItems: 1 + + ranges: true + +required: + - compatible + - '#address-cells' + - '#size-cells' + - reg + - ranges + +additionalProperties: + type: object + +examples: + - | + spba-bus@30000000 { + compatible = "fsl,spba-bus", "simple-bus"; + #address-cells = <1>; + #size-cells = <1>; + reg = <0x30000000 0x100000>; + ranges; + };