Hi Rob/Mark, > -----Original Message----- > From: Michal Simek [mailto:monstr@xxxxxxxxx] > Sent: Monday, March 17, 2014 6:53 PM > To: Rob Herring > Cc: Harini Katakam; Rob Herring; Pawel Moll; Mark Rutland; Ian Campbell; > Kumar Gala; Rob Landley; Mark Brown; Grant Likely; > devicetree@xxxxxxxxxxxxxxx; linux-doc@xxxxxxxxxxxxxxx; linux- > kernel@xxxxxxxxxxxxxxx; linux-spi@xxxxxxxxxxxxxxx > Subject: Re: [PATCH] SPI: Add driver for Cadence SPI controller > > Hi Rob, > > On 03/17/2014 01:47 PM, Rob Herring wrote: > > On Mon, Mar 17, 2014 at 7:05 AM, Harini Katakam <harinik@xxxxxxxxxx> > wrote: > >> Add driver for Cadence SPI controller. This is used in Xilinx Zynq. > >> > >> Signed-off-by: Harini Katakam <harinik@xxxxxxxxxx> > >> --- > >> .../devicetree/bindings/spi/spi-cadence.txt | 25 + > > > > We prefer binding docs in separate patch. > > I have heard several times that also for binding review you need driver to > look if this binding make sense that's why Harini sent this together. > It means 2 emails instead of one. > But if you wish to have this in two files no problem to split it but then I > believe both should be copied to DT mailing list. > I can split this. > > >> drivers/spi/Kconfig | 7 + > >> drivers/spi/Makefile | 1 + > >> drivers/spi/spi-cadence.c | 804 ++++++++++++++++++++ > >> 4 files changed, 837 insertions(+) > >> create mode 100644 > >> Documentation/devicetree/bindings/spi/spi-cadence.txt > >> create mode 100644 drivers/spi/spi-cadence.c > >> > >> diff --git a/Documentation/devicetree/bindings/spi/spi-cadence.txt > >> b/Documentation/devicetree/bindings/spi/spi-cadence.txt > >> new file mode 100644 > >> index 0000000..d25bc2d > >> --- /dev/null > >> +++ b/Documentation/devicetree/bindings/spi/spi-cadence.txt > >> @@ -0,0 +1,25 @@ > >> +Cadence SPI controller Device Tree Bindings > >> +------------------------------------------- > >> + > >> +Required properties: > >> +- compatible : Should be "cdns,spi-r1p6". > > > > One problem with using IP vendor info in the compatible string is an > > IP block typically has a variety of configuration options so the > > actual implementations may be very different. I would recommend adding > > a Xilinx compatible string as well even if you don't use it now. > > It means xlnx,zynq-spi-r1p6 should be fine. I can add this string. "r1p6" is specific to the cadence IP used. Is that OK? > > > > >> +- reg : Physical base address and size of SPI registers map. > >> +- interrupts : Property with a value describing the interrupt > >> + number. > >> +- interrupt-parent : Must be core interrupt controller > >> +- clock-names : List of input clock names - "ref_clk", "pclk" > >> + (See clock bindings for details). > >> +- clocks : Clock phandles (see clock bindings for details). > >> +- num-chip-select : Number of chip selects used. > > > > See Documentation/devicetree/bindings/spi/spi-bus.txt. Use "num-cs" > here. > > > >> + > >> +Example: > >> + > >> + spi@e0007000 { > >> + clock-names = "ref_clk", "pclk"; > >> + clocks = <&clkc 26>, <&clkc 35>; > >> + compatible = "cdns,spi-r1p6"; > > > > Nit. We usually put compatible first in the node. > > Our device-tree generator sorts them that's why it is just like this but not a > problem to fix just in documentation. > Will fix. > > >> + interrupt-parent = <&intc>; > >> + interrupts = <0 49 4>; > >> + num-chip-select = /bits/ 16 <4>; > > I was expecting you will comment this a little bit. :-) Because all just reading > this num-cs as 32bit and then assigning this value to master- > >num_chipselect which is 16bit. > > <snip> > > >> +/* Macros for the SPI controller read/write */ > >> +#define cdns_spi_read(addr) readl_relaxed(addr) > >> +#define cdns_spi_write(addr, val) writel_relaxed((val), (addr)) > > > > Just use readl/writel directly. > > There shouldn't be any problem to use these helper macros and even I think > this is better than using readl/writel directly because you are more flexible > if you want to change it to different IO. > Like Michal pointed out, this is more flexible. Can try what Mark suggested: "Or make them static inline structures which take the driver data structure and an offset within the register map for the device and do the maths to resolve the actual address." Thanks for the review. Regards, Harini This email and any attachments are intended for the sole use of the named recipient(s) and contain(s) confidential information that may be proprietary, privileged or copyrighted under applicable law. If you are not the intended recipient, do not read, copy, or forward this email message or any attachments. Delete this email message and any attachments immediately. -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html