From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753336AbbJFW5V (ORCPT ); Tue, 6 Oct 2015 18:57:21 -0400 Received: from avon.wwwdotorg.org ([70.85.31.133]:49208 "EHLO avon.wwwdotorg.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753153AbbJFW5U (ORCPT ); Tue, 6 Oct 2015 18:57:20 -0400 Subject: Re: [PATCH V2 1/2] Documentation: DT: Add binding documentation for NVIDIA ADMA To: Jon Hunter References: <1444047007-30494-1-git-send-email-jonathanh@nvidia.com> <1444047007-30494-2-git-send-email-jonathanh@nvidia.com> <20151005131215.GN19064@leverpostej> <56139181.4090706@nvidia.com> Cc: Mark Rutland , Laxman Dewangan , Vinod Koul , Thierry Reding , Alexandre Courbot , Rob Herring , Pawel Moll , Ian Campbell , Kumar Gala , Arnd Bergmann , dmaengine@vger.kernel.org, linux-tegra@vger.kernel.org, linux-kernel@vger.kernel.org From: Stephen Warren Message-ID: <561451D3.2070605@wwwdotorg.org> Date: Tue, 6 Oct 2015 16:57:23 -0600 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.2.0 MIME-Version: 1.0 In-Reply-To: <56139181.4090706@nvidia.com> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 10/06/2015 03:16 AM, Jon Hunter wrote: > > On 05/10/15 14:12, Mark Rutland wrote: >> On Mon, Oct 05, 2015 at 01:10:06PM +0100, Jon Hunter wrote: >>> Add device-tree binding documentation for the Tegra210 Audio DMA >>> controller. >>> >>> Signed-off-by: Jon Hunter >>> --- >>> .../devicetree/bindings/dma/tegra210-adma.txt | 63 ++++++++++++++++++++++ >>> 1 file changed, 63 insertions(+) >>> create mode 100644 Documentation/devicetree/bindings/dma/tegra210-adma.txt >>> >>> diff --git a/Documentation/devicetree/bindings/dma/tegra210-adma.txt b/Documentation/devicetree/bindings/dma/tegra210-adma.txt >>> new file mode 100644 >>> index 000000000000..df0e46868a63 >>> --- /dev/null >>> +++ b/Documentation/devicetree/bindings/dma/tegra210-adma.txt >>> @@ -0,0 +1,63 @@ >>> +* NVIDIA Tegra Audio DMA (ADMA) controller >>> + >>> +Required properties: >>> +- compatible: Must be "nvidia,tegra210-adma". >>> +- reg: Should contain DMA registers location and length. This should be >>> + a single entry that includes all of the per-channel registers in one >>> + contiguous bank. >>> +- interrupt-parent: Phandle to the interrupt parent controller. >>> +- interrupts: Should contain all of the per-channel DMA interrupts in >>> + ascending order with respect to the DMA channel index. >>> +- clocks: Must contain one entry for the ADMA module clock, "adma_ape". >>> +- clock-names: Must contain the entry "adma_ape". >>> +- dma-channels: Must be 22. Defines the number of DMA channels supported >>> + by the DMA controller. >> >> If this has to be a fixed value, why is it necessary? Why does the >> driver not just know this? >> >> Are there other instances of this IP block where this differs? > > So this will change for future devices and yes it may seem silly now to > have something that fixed and appears to be constant but I was trying to > future proof the binding. May be the comment should read "For tegra210 > must be 22", however, I thought the compatible string would imply this. Typically you'd want a table in the driver that maps from compatible value to the set of per-SoC data that's associated with the compatible value. Then, you don't need to put this data into the DT. Even if you don't want to do that (e.g. so the driver can work on future HW without code changes), then you can always add this property in the future if needed; if the property is present the value in it will be used, but if missing, any driver should default to the value in use for/on HW before the binding update.