1 * Qualcomm QCA7000 1 * Qualcomm QCA7000
2 2
3 The QCA7000 is a serial-to-powerline bridge wi 3 The QCA7000 is a serial-to-powerline bridge with a host interface which could
4 be configured either as SPI or UART slave. Thi 4 be configured either as SPI or UART slave. This configuration is done by
5 the QCA7000 firmware. 5 the QCA7000 firmware.
6 6
7 (a) Ethernet over SPI 7 (a) Ethernet over SPI
8 8
9 In order to use the QCA7000 as SPI device it m 9 In order to use the QCA7000 as SPI device it must be defined as a child of a
10 SPI master in the device tree. 10 SPI master in the device tree.
11 11
12 Required properties: 12 Required properties:
13 - compatible : Should be "qca,qca7000" 13 - compatible : Should be "qca,qca7000"
14 - reg : Should specify the SPI c 14 - reg : Should specify the SPI chip select
15 - interrupts : The first cell should sp 15 - interrupts : The first cell should specify the index of the source
16 interrupt and the second 16 interrupt and the second cell should specify the trigger
17 type as rising edge 17 type as rising edge
18 - spi-cpha : Must be set 18 - spi-cpha : Must be set
19 - spi-cpol : Must be set 19 - spi-cpol : Must be set
20 20
21 Optional properties: 21 Optional properties:
22 - spi-max-frequency : Maximum frequency of the 22 - spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at.
23 Numbers smaller than 100 23 Numbers smaller than 1000000 or greater than 16000000
24 are invalid. Missing the 24 are invalid. Missing the property will set the SPI
25 frequency to 8000000 Her 25 frequency to 8000000 Hertz.
26 - qca,legacy-mode : Set the SPI data transfe 26 - qca,legacy-mode : Set the SPI data transfer of the QCA7000 to legacy mode.
27 In this mode the SPI mas 27 In this mode the SPI master must toggle the chip select
28 between each data word. 28 between each data word. In burst mode these gaps aren't
29 necessary, which is fast 29 necessary, which is faster. This setting depends on how
30 the QCA7000 is setup via 30 the QCA7000 is setup via GPIO pin strapping. If the
31 property is missing the 31 property is missing the driver defaults to burst mode.
32 32
33 The MAC address will be determined using the o 33 The MAC address will be determined using the optional properties
34 defined in ethernet.txt. 34 defined in ethernet.txt.
35 35
36 SPI Example: 36 SPI Example:
37 37
38 /* Freescale i.MX28 SPI master*/ 38 /* Freescale i.MX28 SPI master*/
39 ssp2: spi@80014000 { 39 ssp2: spi@80014000 {
40 #address-cells = <1>; 40 #address-cells = <1>;
41 #size-cells = <0>; 41 #size-cells = <0>;
42 compatible = "fsl,imx28-spi"; 42 compatible = "fsl,imx28-spi";
43 pinctrl-names = "default"; 43 pinctrl-names = "default";
44 pinctrl-0 = <&spi2_pins_a>; 44 pinctrl-0 = <&spi2_pins_a>;
45 45
46 qca7000: ethernet@0 { 46 qca7000: ethernet@0 {
47 compatible = "qca,qca7000"; 47 compatible = "qca,qca7000";
48 reg = <0x0>; 48 reg = <0x0>;
49 interrupt-parent = <&gpio3>; 49 interrupt-parent = <&gpio3>; /* GPIO Bank 3 */
50 interrupts = <25 0x1>; 50 interrupts = <25 0x1>; /* Index: 25, rising edge */
51 spi-cpha; 51 spi-cpha; /* SPI mode: CPHA=1 */
52 spi-cpol; 52 spi-cpol; /* SPI mode: CPOL=1 */
53 spi-max-frequency = <8000000>; 53 spi-max-frequency = <8000000>; /* freq: 8 MHz */
54 local-mac-address = [ A0 B0 C0 54 local-mac-address = [ A0 B0 C0 D0 E0 F0 ];
55 }; 55 };
56 }; 56 };
57 57
58 (b) Ethernet over UART 58 (b) Ethernet over UART
59 59
60 In order to use the QCA7000 as UART slave it m 60 In order to use the QCA7000 as UART slave it must be defined as a child of a
61 UART master in the device tree. It is possible 61 UART master in the device tree. It is possible to preconfigure the UART
62 settings of the QCA7000 firmware, but it's not 62 settings of the QCA7000 firmware, but it's not possible to change them during
63 runtime. 63 runtime.
64 64
65 Required properties: 65 Required properties:
66 - compatible : Should be "qca,qca7000" 66 - compatible : Should be "qca,qca7000"
67 67
68 Optional properties: 68 Optional properties:
69 - local-mac-address : see ./ethernet.txt 69 - local-mac-address : see ./ethernet.txt
70 - current-speed : current baud rate of QCA 70 - current-speed : current baud rate of QCA7000 which defaults to 115200
71 if absent, see also ../s !! 71 if absent, see also ../serial/slave-device.txt
72 72
73 UART Example: 73 UART Example:
74 74
75 /* Freescale i.MX28 UART */ 75 /* Freescale i.MX28 UART */
76 auart0: serial@8006a000 { 76 auart0: serial@8006a000 {
77 compatible = "fsl,imx28-auart", "fsl,i 77 compatible = "fsl,imx28-auart", "fsl,imx23-auart";
78 reg = <0x8006a000 0x2000>; 78 reg = <0x8006a000 0x2000>;
79 pinctrl-names = "default"; 79 pinctrl-names = "default";
80 pinctrl-0 = <&auart0_2pins_a>; 80 pinctrl-0 = <&auart0_2pins_a>;
81 81
82 qca7000: ethernet { 82 qca7000: ethernet {
83 compatible = "qca,qca7000"; 83 compatible = "qca,qca7000";
84 local-mac-address = [ A0 B0 C0 84 local-mac-address = [ A0 B0 C0 D0 E0 F0 ];
85 current-speed = <38400>; 85 current-speed = <38400>;
86 }; 86 };
87 }; 87 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.