From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v2,2/2] dt-bindings: Document the Synopsys DW AXI DMA bindings From: Alexey Brodkin Message-Id: <1519979538.4430.7.camel@synopsys.com> Date: Fri, 2 Mar 2018 08:32:20 +0000 To: "vinod.koul@intel.com" Cc: "linux-kernel@vger.kernel.org" , "robh+dt@kernel.org" , "Alexey.Brodkin@synopsys.com" , "devicetree@vger.kernel.org" , "Eugeniy.Paltsev@synopsys.com" , "linux-snps-arc@lists.infradead.org" , "andy.shevchenko@gmail.com" , "dan.j.williams@intel.com" , "dmaengine@vger.kernel.org" , "wan.ahmad.zainie.wan.mohamad@intel.com" List-ID: SGkgVmlub2QsDQoNCk9uIEZyaSwgMjAxOC0wMy0wMiBhdCAxMzo0NCArMDUzMCwgVmlub2QgS291 bCB3cm90ZToNCj4gT24gTW9uLCBGZWIgMjYsIDIwMTggYXQgMDU6NTY6MjhQTSArMDMwMCwgRXVn ZW5peSBQYWx0c2V2IHdyb3RlOg0KPiA+IFRoaXMgcGF0Y2ggYWRkcyBkb2N1bWVudGF0aW9uIG9m IGRldmljZSB0cmVlIGJpbmRpbmdzIGZvciB0aGUgU3lub3BzeXMNCj4gPiBEZXNpZ25XYXJlIEFY SSBETUEgY29udHJvbGxlci4NCj4gPiANCj4gPiBTaWduZWQtb2ZmLWJ5OiBFdWdlbml5IFBhbHRz ZXYgPEV1Z2VuaXkuUGFsdHNldkBzeW5vcHN5cy5jb20+DQo+ID4gLS0tDQo+ID4gIC4uLi9kZXZp Y2V0cmVlL2JpbmRpbmdzL2RtYS9zbnBzLGR3LWF4aS1kbWFjLnR4dCAgIHwgNDEgKysrKysrKysr KysrKysrKysrKysrKw0KPiA+ICAxIGZpbGUgY2hhbmdlZCwgNDEgaW5zZXJ0aW9ucygrKQ0KPiA+ ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2Rt YS9zbnBzLGR3LWF4aS1kbWFjLnR4dA0KPiA+IA0KPiA+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0 aW9uL2RldmljZXRyZWUvYmluZGluZ3MvZG1hL3NucHMsZHctYXhpLWRtYWMudHh0IGIvRG9jdW1l bnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2RtYS9zbnBzLGR3LWF4aS1kbWFjLnR4dA0KPiA+ IG5ldyBmaWxlIG1vZGUgMTAwNjQ0DQo+ID4gaW5kZXggMDAwMDAwMC4uZjIzN2I3OQ0KPiA+IC0t LSAvZGV2L251bGwNCj4gPiArKysgYi9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3Mv ZG1hL3NucHMsZHctYXhpLWRtYWMudHh0DQo+ID4gQEAgLTAsMCArMSw0MSBAQA0KPiA+ICtTeW5v cHN5cyBEZXNpZ25XYXJlIEFYSSBETUEgQ29udHJvbGxlcg0KPiA+ICsNCj4gPiArUmVxdWlyZWQg cHJvcGVydGllczoNCj4gPiArLSBjb21wYXRpYmxlOiAic25wcyxheGktZG1hLTEuMDFhIg0KPiA+ ICstIHJlZzogQWRkcmVzcyByYW5nZSBvZiB0aGUgRE1BQyByZWdpc3RlcnMuIFRoaXMgc2hvdWxk IGluY2x1ZGUNCj4gPiArICBhbGwgb2YgdGhlIHBlci1jaGFubmVsIHJlZ2lzdGVycy4NCj4gPiAr LSBpbnRlcnJ1cHQ6IFNob3VsZCBjb250YWluIHRoZSBETUFDIGludGVycnVwdCBudW1iZXIuDQo+ ID4gKy0gaW50ZXJydXB0LXBhcmVudDogU2hvdWxkIGJlIHRoZSBwaGFuZGxlIGZvciB0aGUgaW50 ZXJydXB0IGNvbnRyb2xsZXINCj4gPiArICB0aGF0IHNlcnZpY2VzIGludGVycnVwdHMgZm9yIHRo aXMgZGV2aWNlLg0KPiA+ICstIGRtYS1jaGFubmVsczogTnVtYmVyIG9mIGNoYW5uZWxzIHN1cHBv cnRlZCBieSBoYXJkd2FyZS4NCj4gPiArLSBzbnBzLGRtYS1tYXN0ZXJzOiBOdW1iZXIgb2YgQVhJ IG1hc3RlcnMgc3VwcG9ydGVkIGJ5IHRoZSBoYXJkd2FyZS4NCj4gPiArLSBzbnBzLGRhdGEtd2lk dGg6IE1heGltdW0gQVhJIGRhdGEgd2lkdGggc3VwcG9ydGVkIGJ5IGhhcmR3YXJlLg0KPiA+ICsg ICgwIC0gOGJpdHMsIDEgLSAxNmJpdHMsIDIgLSAzMmJpdHMsIC4uLiwgNiAtIDUxMmJpdHMpDQo+ ID4gKy0gc25wcyxwcmlvcml0eTogUHJpb3JpdHkgb2YgY2hhbm5lbC4gQXJyYXkgc2l6ZSBpcyBl cXVhbCB0byB0aGUgbnVtYmVyIG9mDQo+ID4gKyAgZG1hLWNoYW5uZWxzLiBQcmlvcml0eSB2YWx1 ZSBtdXN0IGJlIHByb2dyYW1tZWQgd2l0aGluIFswOmRtYS1jaGFubmVscy0xXQ0KPiA+ICsgIHJh bmdlLiAoMCAtIG1pbmltdW0gcHJpb3JpdHkpDQo+ID4gKy0gc25wcyxibG9jay1zaXplOiBNYXhp bXVtIGJsb2NrIHNpemUgc3VwcG9ydGVkIGJ5IHRoZSBjb250cm9sbGVyIGNoYW5uZWwuDQo+ID4g KyAgQXJyYXkgc2l6ZSBpcyBlcXVhbCB0byB0aGUgbnVtYmVyIG9mIGRtYS1jaGFubmVscy4NCj4g PiArDQo+ID4gK09wdGlvbmFsIHByb3BlcnRpZXM6DQo+ID4gKy0gc25wcyxheGktbWF4LWJ1cnN0 LWxlbjogUmVzdHJpY3QgbWFzdGVyIEFYSSBidXJzdCBsZW5ndGggYnkgdmFsdWUgc3BlY2lmaWVk DQo+ID4gKyAgaW4gdGhpcyBwcm9wZXJ0eS4gSWYgdGhpcyBwcm9wZXJ0eSBpcyBtaXNzaW5nIHRo ZSBtYXhpbXVtIEFYSSBidXJzdCBsZW5ndGgNCj4gPiArICBzdXBwb3J0ZWQgYnkgRE1BQyBpcyB1 c2VkLiBbMToyNTZdDQo+ID4gKw0KPiA+ICtFeGFtcGxlOg0KPiA+ICsNCj4gPiArZG1hYzogZG1h LWNvbnRyb2xsZXJAODAwMDAgew0KPiA+ICsJY29tcGF0aWJsZSA9ICJzbnBzLGF4aS1kbWEtMS4w MWEiOw0KPiANCj4gZG8gd2UgbmVlZCAic25wcyBoZXJlLi4/DQoNClN5bm9wc3lzIGlzIHRoaXMg SVAtYmxvY2sgdmVuZG9yIHNvIHNob3VsZG4ndCB3ZSBwdXQgaXQgdGhhdCB3YXk/DQoNCi1BbGV4 ZXkK From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alexey.Brodkin@synopsys.com (Alexey Brodkin) Date: Fri, 2 Mar 2018 08:32:20 +0000 Subject: [PATCH v2 2/2] dt-bindings: Document the Synopsys DW AXI DMA bindings In-Reply-To: <20180302081408.GK15443@localhost> References: <20180226145628.11892-1-Eugeniy.Paltsev@synopsys.com> <20180226145628.11892-3-Eugeniy.Paltsev@synopsys.com> <20180302081408.GK15443@localhost> List-ID: Message-ID: <1519979538.4430.7.camel@synopsys.com> To: linux-snps-arc@lists.infradead.org Hi Vinod, On Fri, 2018-03-02@13:44 +0530, Vinod Koul wrote: > On Mon, Feb 26, 2018@05:56:28PM +0300, Eugeniy Paltsev wrote: > > This patch adds documentation of device tree bindings for the Synopsys > > DesignWare AXI DMA controller. > > > > Signed-off-by: Eugeniy Paltsev > > --- > > .../devicetree/bindings/dma/snps,dw-axi-dmac.txt | 41 ++++++++++++++++++++++ > > 1 file changed, 41 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.txt > > > > diff --git a/Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.txt b/Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.txt > > new file mode 100644 > > index 0000000..f237b79 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.txt > > @@ -0,0 +1,41 @@ > > +Synopsys DesignWare AXI DMA Controller > > + > > +Required properties: > > +- compatible: "snps,axi-dma-1.01a" > > +- reg: Address range of the DMAC registers. This should include > > + all of the per-channel registers. > > +- interrupt: Should contain the DMAC interrupt number. > > +- interrupt-parent: Should be the phandle for the interrupt controller > > + that services interrupts for this device. > > +- dma-channels: Number of channels supported by hardware. > > +- snps,dma-masters: Number of AXI masters supported by the hardware. > > +- snps,data-width: Maximum AXI data width supported by hardware. > > + (0 - 8bits, 1 - 16bits, 2 - 32bits, ..., 6 - 512bits) > > +- snps,priority: Priority of channel. Array size is equal to the number of > > + dma-channels. Priority value must be programmed within [0:dma-channels-1] > > + range. (0 - minimum priority) > > +- snps,block-size: Maximum block size supported by the controller channel. > > + Array size is equal to the number of dma-channels. > > + > > +Optional properties: > > +- snps,axi-max-burst-len: Restrict master AXI burst length by value specified > > + in this property. If this property is missing the maximum AXI burst length > > + supported by DMAC is used. [1:256] > > + > > +Example: > > + > > +dmac: dma-controller at 80000 { > > + compatible = "snps,axi-dma-1.01a"; > > do we need "snps here..? Synopsys is this IP-block vendor so shouldn't we put it that way? -Alexey From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alexey Brodkin Subject: Re: [PATCH v2 2/2] dt-bindings: Document the Synopsys DW AXI DMA bindings Date: Fri, 2 Mar 2018 08:32:20 +0000 Message-ID: <1519979538.4430.7.camel@synopsys.com> References: <20180226145628.11892-1-Eugeniy.Paltsev@synopsys.com> <20180226145628.11892-3-Eugeniy.Paltsev@synopsys.com> <20180302081408.GK15443@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20180302081408.GK15443@localhost> Content-Language: en-US Content-ID: Sender: linux-kernel-owner@vger.kernel.org To: "vinod.koul@intel.com" Cc: "linux-kernel@vger.kernel.org" , "robh+dt@kernel.org" , "Alexey.Brodkin@synopsys.com" , "devicetree@vger.kernel.org" , "Eugeniy.Paltsev@synopsys.com" , "linux-snps-arc@lists.infradead.org" , "andy.shevchenko@gmail.com" , "dan.j.williams@intel.com" , "dmaengine@vger.kernel.org" , "wan.ahmad.zainie.wan.mohamad@intel.com" List-Id: devicetree@vger.kernel.org SGkgVmlub2QsDQoNCk9uIEZyaSwgMjAxOC0wMy0wMiBhdCAxMzo0NCArMDUzMCwgVmlub2QgS291 bCB3cm90ZToNCj4gT24gTW9uLCBGZWIgMjYsIDIwMTggYXQgMDU6NTY6MjhQTSArMDMwMCwgRXVn ZW5peSBQYWx0c2V2IHdyb3RlOg0KPiA+IFRoaXMgcGF0Y2ggYWRkcyBkb2N1bWVudGF0aW9uIG9m IGRldmljZSB0cmVlIGJpbmRpbmdzIGZvciB0aGUgU3lub3BzeXMNCj4gPiBEZXNpZ25XYXJlIEFY SSBETUEgY29udHJvbGxlci4NCj4gPiANCj4gPiBTaWduZWQtb2ZmLWJ5OiBFdWdlbml5IFBhbHRz ZXYgPEV1Z2VuaXkuUGFsdHNldkBzeW5vcHN5cy5jb20+DQo+ID4gLS0tDQo+ID4gIC4uLi9kZXZp Y2V0cmVlL2JpbmRpbmdzL2RtYS9zbnBzLGR3LWF4aS1kbWFjLnR4dCAgIHwgNDEgKysrKysrKysr KysrKysrKysrKysrKw0KPiA+ICAxIGZpbGUgY2hhbmdlZCwgNDEgaW5zZXJ0aW9ucygrKQ0KPiA+ ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2Rt YS9zbnBzLGR3LWF4aS1kbWFjLnR4dA0KPiA+IA0KPiA+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0 aW9uL2RldmljZXRyZWUvYmluZGluZ3MvZG1hL3NucHMsZHctYXhpLWRtYWMudHh0IGIvRG9jdW1l bnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2RtYS9zbnBzLGR3LWF4aS1kbWFjLnR4dA0KPiA+ IG5ldyBmaWxlIG1vZGUgMTAwNjQ0DQo+ID4gaW5kZXggMDAwMDAwMC4uZjIzN2I3OQ0KPiA+IC0t LSAvZGV2L251bGwNCj4gPiArKysgYi9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3Mv ZG1hL3NucHMsZHctYXhpLWRtYWMudHh0DQo+ID4gQEAgLTAsMCArMSw0MSBAQA0KPiA+ICtTeW5v cHN5cyBEZXNpZ25XYXJlIEFYSSBETUEgQ29udHJvbGxlcg0KPiA+ICsNCj4gPiArUmVxdWlyZWQg cHJvcGVydGllczoNCj4gPiArLSBjb21wYXRpYmxlOiAic25wcyxheGktZG1hLTEuMDFhIg0KPiA+ ICstIHJlZzogQWRkcmVzcyByYW5nZSBvZiB0aGUgRE1BQyByZWdpc3RlcnMuIFRoaXMgc2hvdWxk IGluY2x1ZGUNCj4gPiArICBhbGwgb2YgdGhlIHBlci1jaGFubmVsIHJlZ2lzdGVycy4NCj4gPiAr LSBpbnRlcnJ1cHQ6IFNob3VsZCBjb250YWluIHRoZSBETUFDIGludGVycnVwdCBudW1iZXIuDQo+ ID4gKy0gaW50ZXJydXB0LXBhcmVudDogU2hvdWxkIGJlIHRoZSBwaGFuZGxlIGZvciB0aGUgaW50 ZXJydXB0IGNvbnRyb2xsZXINCj4gPiArICB0aGF0IHNlcnZpY2VzIGludGVycnVwdHMgZm9yIHRo aXMgZGV2aWNlLg0KPiA+ICstIGRtYS1jaGFubmVsczogTnVtYmVyIG9mIGNoYW5uZWxzIHN1cHBv cnRlZCBieSBoYXJkd2FyZS4NCj4gPiArLSBzbnBzLGRtYS1tYXN0ZXJzOiBOdW1iZXIgb2YgQVhJ IG1hc3RlcnMgc3VwcG9ydGVkIGJ5IHRoZSBoYXJkd2FyZS4NCj4gPiArLSBzbnBzLGRhdGEtd2lk dGg6IE1heGltdW0gQVhJIGRhdGEgd2lkdGggc3VwcG9ydGVkIGJ5IGhhcmR3YXJlLg0KPiA+ICsg ICgwIC0gOGJpdHMsIDEgLSAxNmJpdHMsIDIgLSAzMmJpdHMsIC4uLiwgNiAtIDUxMmJpdHMpDQo+ ID4gKy0gc25wcyxwcmlvcml0eTogUHJpb3JpdHkgb2YgY2hhbm5lbC4gQXJyYXkgc2l6ZSBpcyBl cXVhbCB0byB0aGUgbnVtYmVyIG9mDQo+ID4gKyAgZG1hLWNoYW5uZWxzLiBQcmlvcml0eSB2YWx1 ZSBtdXN0IGJlIHByb2dyYW1tZWQgd2l0aGluIFswOmRtYS1jaGFubmVscy0xXQ0KPiA+ICsgIHJh bmdlLiAoMCAtIG1pbmltdW0gcHJpb3JpdHkpDQo+ID4gKy0gc25wcyxibG9jay1zaXplOiBNYXhp bXVtIGJsb2NrIHNpemUgc3VwcG9ydGVkIGJ5IHRoZSBjb250cm9sbGVyIGNoYW5uZWwuDQo+ID4g KyAgQXJyYXkgc2l6ZSBpcyBlcXVhbCB0byB0aGUgbnVtYmVyIG9mIGRtYS1jaGFubmVscy4NCj4g PiArDQo+ID4gK09wdGlvbmFsIHByb3BlcnRpZXM6DQo+ID4gKy0gc25wcyxheGktbWF4LWJ1cnN0 LWxlbjogUmVzdHJpY3QgbWFzdGVyIEFYSSBidXJzdCBsZW5ndGggYnkgdmFsdWUgc3BlY2lmaWVk DQo+ID4gKyAgaW4gdGhpcyBwcm9wZXJ0eS4gSWYgdGhpcyBwcm9wZXJ0eSBpcyBtaXNzaW5nIHRo ZSBtYXhpbXVtIEFYSSBidXJzdCBsZW5ndGgNCj4gPiArICBzdXBwb3J0ZWQgYnkgRE1BQyBpcyB1 c2VkLiBbMToyNTZdDQo+ID4gKw0KPiA+ICtFeGFtcGxlOg0KPiA+ICsNCj4gPiArZG1hYzogZG1h LWNvbnRyb2xsZXJAODAwMDAgew0KPiA+ICsJY29tcGF0aWJsZSA9ICJzbnBzLGF4aS1kbWEtMS4w MWEiOw0KPiANCj4gZG8gd2UgbmVlZCAic25wcyBoZXJlLi4/DQoNClN5bm9wc3lzIGlzIHRoaXMg SVAtYmxvY2sgdmVuZG9yIHNvIHNob3VsZG4ndCB3ZSBwdXQgaXQgdGhhdCB3YXk/DQoNCi1BbGV4 ZXk=