From patchwork Wed Apr 20 19:07:54 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Martin_Povi=C5=A1er?= X-Patchwork-Id: 12820721 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 B8C67C433FE for ; Wed, 20 Apr 2022 19:10:19 +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:References:In-Reply-To: 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: List-Owner; bh=WGR6C3bYyxe3GlxiNuZh/af/vC39+looHdeOs/hD9lw=; b=GkJS/9Kw7UrWU0 bLoCyF06csoQVeXQ20iZHYhsWtb4B5QXtzErJwVWQFOOkV2fkdO+xHPAj/BTWSs9RutFEeL+k/+Rr yKTLqwq6sUv26vghvttfKXaDJloeiw5SYdcOa/DET+ZzEeEO0mbAEFMvehKJ6HuSMHbAAdVtl8HJZ JKVvhR07Aboubf1zeNl6XIewgajRHk/6keSTmtsRuaag6TeFkPPOBjSgcXJSgzePkQpMW49KfFCQ1 RuJEZXbtGAEjSKHkm20eVCBLAYAI9bK3s3hjOjW9CkqF8sOLGFXokkb3HWI28hOS4tEU+our0bTjF 1/ezZ4xipFkeEqw7Z8nw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nhFha-00A9nh-VK; Wed, 20 Apr 2022 19:09:23 +0000 Received: from [2a03:3b40:fe:f0::1] (helo=hutie.ust.cz) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1nhFhN-00A9iF-6q for linux-arm-kernel@lists.infradead.org; Wed, 20 Apr 2022 19:09:12 +0000 From: =?utf-8?q?Martin_Povi=C5=A1er?= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cutebit.org; s=mail; t=1650481741; bh=WLCIlxSm+6HZPp+Lk7ZxfdPzXTPGBGvfuCUxsxsFRgQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=AcRTv0XQg9PbiJfjLbg8cdSfl18R5taSOM+39xgQkc92HqnK96aiKYtXmauMSyF66 cOxDXhLLP/UCTww4YXtHSOu5lHm3akRWsNdXIhdzJQVlxyvioQrzYLw+AtGptsQ6TM 6ZnWMWK9012z8Me1v6qRKnqMLPs7I9F9cDEsZFqI= To: Hector Martin , Sven Peter , Vinod Koul , Rob Herring , Krzysztof Kozlowski Cc: Alyssa Rosenzweig , linux-arm-kernel@lists.infradead.org, dmaengine@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Mark Kettenis , =?utf-8?q?Martin_Povi=C5=A1er?= Subject: [PATCH v3 1/2] dt-bindings: dma: Add Apple ADMAC Date: Wed, 20 Apr 2022 21:07:54 +0200 Message-Id: <20220420190755.76617-2-povik+lin@cutebit.org> In-Reply-To: <20220420190755.76617-1-povik+lin@cutebit.org> References: <20220420190755.76617-1-povik+lin@cutebit.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220420_120910_010172_86B2997C X-CRM114-Status: GOOD ( 11.82 ) 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 Apple's Audio DMA Controller (ADMAC) is used to fetch and store audio samples on SoCs from the "Apple Silicon" family. Signed-off-by: Martin Povišer Reviewed-by: Rob Herring --- .../devicetree/bindings/dma/apple,admac.yaml | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 Documentation/devicetree/bindings/dma/apple,admac.yaml diff --git a/Documentation/devicetree/bindings/dma/apple,admac.yaml b/Documentation/devicetree/bindings/dma/apple,admac.yaml new file mode 100644 index 000000000000..ab8a4ec7779f --- /dev/null +++ b/Documentation/devicetree/bindings/dma/apple,admac.yaml @@ -0,0 +1,75 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/dma/apple,admac.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Apple Audio DMA Controller (ADMAC) + +description: | + Apple's Audio DMA Controller (ADMAC) is used to fetch and store audio samples + on SoCs from the "Apple Silicon" family. + + The controller has been seen with up to 24 channels. Even-numbered channels + are TX-only, odd-numbered are RX-only. Individual channels are coupled to + fixed device endpoints. + +maintainers: + - Martin Povišer + +allOf: + - $ref: "dma-controller.yaml#" + +properties: + compatible: + items: + - enum: + - apple,t6000-admac + - apple,t8103-admac + - const: apple,admac + + reg: + maxItems: 1 + + '#dma-cells': + const: 1 + description: + Clients specify a single cell with channel number. + + dma-channels: + maximum: 24 + + interrupts: + minItems: 4 + maxItems: 4 + description: + Interrupts that correspond to the 4 IRQ outputs of the controller. Usually + only one of the controller outputs will be connected as an usable interrupt + source. The remaining interrupts will be left without a valid value, e.g. + in an interrupts-extended list the disconnected positions will contain + an empty phandle reference <0>. + +required: + - compatible + - reg + - '#dma-cells' + - dma-channels + - interrupts + +additionalProperties: false + +examples: + - | + #include + #include + + admac: dma-controller@238200000 { + compatible = "apple,t8103-admac", "apple,admac"; + reg = <0x38200000 0x34000>; + dma-channels = <24>; + interrupts-extended = <0>, + <&aic AIC_IRQ 626 IRQ_TYPE_LEVEL_HIGH>, + <0>, + <0>; + #dma-cells = <1>; + };