Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: add Device tree bindings for QCA7000

This patch adds the Device tree bindings for the
Ethernet over SPI protocol driver of the Qualcomm
QCA7000 HomePlug GreenPHY.

Signed-off-by: Stefan Wahren <stefan.wahren@i2se.com>
Signed-off-by: David S. Miller <davem@davemloft.net>

authored by

Stefan Wahren and committed by
David S. Miller
7d50df8f a11238ec

+47
+47
Documentation/devicetree/bindings/net/qca-qca7000-spi.txt
··· 1 + * Qualcomm QCA7000 (Ethernet over SPI protocol) 2 + 3 + Note: The QCA7000 is useable as a SPI device. In this case it must be defined 4 + as a child of a SPI master in the device tree. 5 + 6 + Required properties: 7 + - compatible : Should be "qca,qca7000" 8 + - reg : Should specify the SPI chip select 9 + - interrupts : The first cell should specify the index of the source interrupt 10 + and the second cell should specify the trigger type as rising edge 11 + - spi-cpha : Must be set 12 + - spi-cpol: Must be set 13 + 14 + Optional properties: 15 + - interrupt-parent : Specify the pHandle of the source interrupt 16 + - spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at. 17 + Numbers smaller than 1000000 or greater than 16000000 are invalid. Missing 18 + the property will set the SPI frequency to 8000000 Hertz. 19 + - local-mac-address: 6 bytes, MAC address 20 + - qca,legacy-mode : Set the SPI data transfer of the QCA7000 to legacy mode. 21 + In this mode the SPI master must toggle the chip select between each data 22 + word. In burst mode these gaps aren't necessary, which is faster. 23 + This setting depends on how the QCA7000 is setup via GPIO pin strapping. 24 + If the property is missing the driver defaults to burst mode. 25 + 26 + Example: 27 + 28 + /* Freescale i.MX28 SPI master*/ 29 + ssp2: spi@80014000 { 30 + #address-cells = <1>; 31 + #size-cells = <0>; 32 + compatible = "fsl,imx28-spi"; 33 + pinctrl-names = "default"; 34 + pinctrl-0 = <&spi2_pins_a>; 35 + status = "okay"; 36 + 37 + qca7000: ethernet@0 { 38 + compatible = "qca,qca7000"; 39 + reg = <0x0>; 40 + interrupt-parent = <&gpio3>; /* GPIO Bank 3 */ 41 + interrupts = <25 0x1>; /* Index: 25, rising edge */ 42 + spi-cpha; /* SPI mode: CPHA=1 */ 43 + spi-cpol; /* SPI mode: CPOL=1 */ 44 + spi-max-frequency = <8000000>; /* freq: 8 MHz */ 45 + local-mac-address = [ A0 B0 C0 D0 E0 F0 ]; 46 + }; 47 + };