From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lee Jones Subject: Re: [PATCH 01/18] Documentation: Describe the ux500 realated audio related DT nodes Date: Mon, 30 Jul 2012 15:32:08 +0100 Message-ID: <50169AE8.4020601@linaro.org> References: <1343393162-11938-1-git-send-email-lee.jones@linaro.org> <1343393162-11938-2-git-send-email-lee.jones@linaro.org> <20120729203106.GD4384@opensource.wolfsonmicro.com> <50163A09.8060203@linaro.org> <20120730134804.GE4468@opensource.wolfsonmicro.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Received: from mail-ee0-f51.google.com (mail-ee0-f51.google.com [74.125.83.51]) by alsa0.perex.cz (Postfix) with ESMTP id A1ED5265338 for ; Mon, 30 Jul 2012 16:32:08 +0200 (CEST) Received: by eeke50 with SMTP id e50so1055652eek.38 for ; Mon, 30 Jul 2012 07:32:10 -0700 (PDT) In-Reply-To: <20120730134804.GE4468@opensource.wolfsonmicro.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: alsa-devel-bounces@alsa-project.org Sender: alsa-devel-bounces@alsa-project.org To: Mark Brown Cc: ola.o.lilja@stericsson.com, alsa-devel@alsa-project.org, linus.walleij@stericsson.com, arnd@arndb.de, olalilja@yahoo.se, linux-kernel@vger.kernel.org, STEricsson_nomadik_linux@list.st.com, lrg@ti.com, linux-arm-kernel@lists.infradead.org List-Id: alsa-devel@alsa-project.org T24gMzAvMDcvMTIgMTQ6NDgsIE1hcmsgQnJvd24gd3JvdGU6Cj4gT24gTW9uLCBKdWwgMzAsIDIw MTIgYXQgMDg6Mzg6NDlBTSArMDEwMCwgTGVlIEpvbmVzIHdyb3RlOgo+PiBPbiAyOS8wNy8xMiAy MTozMSwgTWFyayBCcm93biB3cm90ZToKPj4+IE9uIEZyaSwgSnVsIDI3LCAyMDEyIGF0IDAxOjQ1 OjQ1UE0gKzAxMDAsIExlZSBKb25lcyB3cm90ZToKPgo+Pj4+ICsgICAtIE1hY2hpbmUgRHJpdmVy IDogInN0ZXJpY3Nzb24sc25kLXNvYy1tb3A1MDAiCj4+Pj4gKyAgIC0gQ1BVLXNpZGUgREFJICAg OiAic3Rlcmljc3Nvbix1eDUwMC1tc3AtaTJzIgo+Pj4+ICsgICAtIERNQSAocGxhdGZvcm0pIDog InN0ZXJpY3Nzb24sdXg1MDAtcGNtIgo+Pj4+ICsgICAtIEF1ZGlvIENPREVDICAgIDogInN0ZXJp Y3Nzb24sYWI4NTAwLWNvZGVjIgo+Cj4+PiBXaGF0IGlzIHRoaXMgYSBiaW5kaW5nIGRvY3VtZW50 IGZvcj8gIEl0IGxvb2tzIGxpa2UgdGhlIGJpbmRpbmcgZm9yIGEKPj4+IG1hY2hpbmUgZHJpdmVy Li4uCj4KPj4gTm8sIGl0J3MgYSBiaW5kaW5nIGRvY3VtZW50IGZvciBhbGwgb2YgdGhlIHV4NTAw IGRyaXZlciBhbmQgQ09ERUMKPj4gYmxvY2tzLiBEbyB5b3UgcmVhbGx5IHdhbnQgbWUgdG8gc3Bs aXQgaXQgYWxsIHVwPyBJIHRoaW5rIHRoZSBvbmx5Cj4+IGNvbXBvbmVudCB3aGljaCBjb3VsZCBi ZSBzYW5lbHkgc3BsaXQtb3V0IGlzIHRoZSBhYjg1MDAtY29kZWMsIHdoaWNoCj4+IGNvdWxkIChz aG91bGQ/KSBsaXZlIGluIFsxXS4KPgo+IFllcywgb2YgY291cnNlISAgRWFjaCBkZXZpY2Ugd2ls bCBoYXZlIGEgc2VwYXJhdGUgYmluZGluZyB3aXRoIGRpZmZlcmVudAo+IHJlcXVpcmVtZW50cy4K Pgo+PiBUaGVzZSBwcm9wZXJ0aWVzIGFyZSByZWxldmFudCBmb3Igc29tZSwgYnV0IG5vdCBhbGwg b2YgdGhlCj4+IGNvbXBvbmVudHMgYWJvdmUsIGhlbmNlIHdoeSB0aGUgYXJlIGxpc3RlZCBhdCAn b3B0aW9uYWwgcHJvcGVydGllcycuCj4KPiBXaGljaCBpcyBwYXJ0IG9mIHRoZSBwcm9ibGVtIGhl cmUsIGl0IG1ha2VzIGl0IG11Y2ggaGFyZGVyIHRvIHRlbGwgd2hhdAo+IHlvdSBuZWVkIHRvIGRv IGZvciB0aGUgaW5kaXZpZHVhbCBkZXZpY2VzLgoKT25jZSBhZ2FpbiwgSSdsbCBzcGxpdCB0aGVt IG91dCwgYnV0IEkgdGhpbmsgdGhlcmUgYXJlIHBlb3BsZSB0YWxraW5nIAphYm91dCBkb2N1bWVu dGF0aW9uIGNvbnNvbGlkYXRpb24sIGFzIGl0J3MgZ29pbmcgdG8gYmVjb21lIHZlcnkgbWVzc3ks IAp2ZXJ5IHF1aWNrbHkgaWYgd2Uga2VlcCBhZGRpbmcgbmV3IGZpbGVzIGZvciBlYWNoIGRldmlj ZS4gU29vbiB0aGUgCkRvY3VtZW50YXRpb24gZGlyZWN0b3J5IHdpbGwgYmUgYXMgbGFyZ2UgYXMg dGhlIGRyaXZlciBiYXNlLiA6KQoKLS0gCkxlZSBKb25lcwpMaW5hcm8gU1QtRXJpY3Nzb24gTGFu ZGluZyBUZWFtIExlYWQKTGluYXJvLm9yZyDilIIgT3BlbiBzb3VyY2Ugc29mdHdhcmUgZm9yIEFS TSBTb0NzCkZvbGxvdyBMaW5hcm86IEZhY2Vib29rIHwgVHdpdHRlciB8IEJsb2cKX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KQWxzYS1kZXZlbCBtYWlsaW5n IGxpc3QKQWxzYS1kZXZlbEBhbHNhLXByb2plY3Qub3JnCmh0dHA6Ly9tYWlsbWFuLmFsc2EtcHJv amVjdC5vcmcvbWFpbG1hbi9saXN0aW5mby9hbHNhLWRldmVsCg== From mboxrd@z Thu Jan 1 00:00:00 1970 From: lee.jones@linaro.org (Lee Jones) Date: Mon, 30 Jul 2012 15:32:08 +0100 Subject: [PATCH 01/18] Documentation: Describe the ux500 realated audio related DT nodes In-Reply-To: <20120730134804.GE4468@opensource.wolfsonmicro.com> References: <1343393162-11938-1-git-send-email-lee.jones@linaro.org> <1343393162-11938-2-git-send-email-lee.jones@linaro.org> <20120729203106.GD4384@opensource.wolfsonmicro.com> <50163A09.8060203@linaro.org> <20120730134804.GE4468@opensource.wolfsonmicro.com> Message-ID: <50169AE8.4020601@linaro.org> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org On 30/07/12 14:48, Mark Brown wrote: > On Mon, Jul 30, 2012 at 08:38:49AM +0100, Lee Jones wrote: >> On 29/07/12 21:31, Mark Brown wrote: >>> On Fri, Jul 27, 2012 at 01:45:45PM +0100, Lee Jones wrote: > >>>> + - Machine Driver : "stericsson,snd-soc-mop500" >>>> + - CPU-side DAI : "stericsson,ux500-msp-i2s" >>>> + - DMA (platform) : "stericsson,ux500-pcm" >>>> + - Audio CODEC : "stericsson,ab8500-codec" > >>> What is this a binding document for? It looks like the binding for a >>> machine driver... > >> No, it's a binding document for all of the ux500 driver and CODEC >> blocks. Do you really want me to split it all up? I think the only >> component which could be sanely split-out is the ab8500-codec, which >> could (should?) live in [1]. > > Yes, of course! Each device will have a separate binding with different > requirements. > >> These properties are relevant for some, but not all of the >> components above, hence why the are listed at 'optional properties'. > > Which is part of the problem here, it makes it much harder to tell what > you need to do for the individual devices. Once again, I'll split them out, but I think there are people talking about documentation consolidation, as it's going to become very messy, very quickly if we keep adding new files for each device. Soon the Documentation directory will be as large as the driver base. :) -- Lee Jones Linaro ST-Ericsson Landing Team Lead Linaro.org ? Open source software for ARM SoCs Follow Linaro: Facebook | Twitter | Blog From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754707Ab2G3OcO (ORCPT ); Mon, 30 Jul 2012 10:32:14 -0400 Received: from mail-ee0-f46.google.com ([74.125.83.46]:36289 "EHLO mail-ee0-f46.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754270Ab2G3OcM (ORCPT ); Mon, 30 Jul 2012 10:32:12 -0400 Message-ID: <50169AE8.4020601@linaro.org> Date: Mon, 30 Jul 2012 15:32:08 +0100 From: Lee Jones User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:14.0) Gecko/20120714 Thunderbird/14.0 MIME-Version: 1.0 To: Mark Brown CC: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, STEricsson_nomadik_linux@list.st.com, linus.walleij@stericsson.com, arnd@arndb.de, olalilja@yahoo.se, ola.o.lilja@stericsson.com, alsa-devel@alsa-project.org, lrg@ti.com Subject: Re: [PATCH 01/18] Documentation: Describe the ux500 realated audio related DT nodes References: <1343393162-11938-1-git-send-email-lee.jones@linaro.org> <1343393162-11938-2-git-send-email-lee.jones@linaro.org> <20120729203106.GD4384@opensource.wolfsonmicro.com> <50163A09.8060203@linaro.org> <20120730134804.GE4468@opensource.wolfsonmicro.com> In-Reply-To: <20120730134804.GE4468@opensource.wolfsonmicro.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 30/07/12 14:48, Mark Brown wrote: > On Mon, Jul 30, 2012 at 08:38:49AM +0100, Lee Jones wrote: >> On 29/07/12 21:31, Mark Brown wrote: >>> On Fri, Jul 27, 2012 at 01:45:45PM +0100, Lee Jones wrote: > >>>> + - Machine Driver : "stericsson,snd-soc-mop500" >>>> + - CPU-side DAI : "stericsson,ux500-msp-i2s" >>>> + - DMA (platform) : "stericsson,ux500-pcm" >>>> + - Audio CODEC : "stericsson,ab8500-codec" > >>> What is this a binding document for? It looks like the binding for a >>> machine driver... > >> No, it's a binding document for all of the ux500 driver and CODEC >> blocks. Do you really want me to split it all up? I think the only >> component which could be sanely split-out is the ab8500-codec, which >> could (should?) live in [1]. > > Yes, of course! Each device will have a separate binding with different > requirements. > >> These properties are relevant for some, but not all of the >> components above, hence why the are listed at 'optional properties'. > > Which is part of the problem here, it makes it much harder to tell what > you need to do for the individual devices. Once again, I'll split them out, but I think there are people talking about documentation consolidation, as it's going to become very messy, very quickly if we keep adding new files for each device. Soon the Documentation directory will be as large as the driver base. :) -- Lee Jones Linaro ST-Ericsson Landing Team Lead Linaro.org │ Open source software for ARM SoCs Follow Linaro: Facebook | Twitter | Blog