diff mbox series

[1/3] dt-bindings: net: Add DT bindings for Socionext Netsec

Message ID 1512058351-15851-1-git-send-email-jassisinghbrar@gmail.com
State New
Headers show
Series [1/3] dt-bindings: net: Add DT bindings for Socionext Netsec | expand

Commit Message

Jassi Brar Nov. 30, 2017, 4:12 p.m. UTC
From: Jassi Brar <jassisinghbrar@gmail.com>


This patch adds documentation for Device-Tree bindings for the
Socionext NetSec Controller driver.

Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>

Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

---
 .../devicetree/bindings/net/socionext-netsec.txt   | 43 ++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/net/socionext-netsec.txt

-- 
2.7.4

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Comments

Ard Biesheuvel Dec. 1, 2017, 9:12 a.m. UTC | #1
Hi Jassi,

On 30 November 2017 at 16:12,  <jassisinghbrar@gmail.com> wrote:
> From: Jassi Brar <jassisinghbrar@gmail.com>

>

> This patch adds documentation for Device-Tree bindings for the

> Socionext NetSec Controller driver.

>

> Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>

> Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>


No need to keep my signoff here: if you are posting the patch, your
signoff should come last. (Authorship is no factor here, only the path
taken by the patch from the author/copyright holder to the sender of
the email)

> ---

>  .../devicetree/bindings/net/socionext-netsec.txt   | 43 ++++++++++++++++++++++

>  1 file changed, 43 insertions(+)

>  create mode 100644 Documentation/devicetree/bindings/net/socionext-netsec.txt

>

> diff --git a/Documentation/devicetree/bindings/net/socionext-netsec.txt b/Documentation/devicetree/bindings/net/socionext-netsec.txt

> new file mode 100644

> index 0000000..4695969

> --- /dev/null

> +++ b/Documentation/devicetree/bindings/net/socionext-netsec.txt

> @@ -0,0 +1,43 @@

> +* Socionext NetSec Ethernet Controller IP

> +

> +Required properties:

> +- compatible: Should be "socionext,synquacer-netsec"

> +- reg: Address and length of the control register area, followed by the

> +       address and length of the EEPROM holding the MAC address and

> +       microengine firmware

> +- interrupts: Should contain ethernet controller interrupt

> +- clocks: phandle to the PHY reference clock, and any other clocks to be

> +          switched by runtime_pm

> +- clock-names: Required only if more than a single clock is listed in 'clocks'.

> +               The PHY reference clock must be named 'phy_refclk'

> +- phy-mode: See ethernet.txt file in the same directory

> +- phy-handle: phandle to select child phy

> +


We should add the following property here:

- dma-coherent: Boolean property, must only be present if memory
accesses performed by the device are cache coherent

(I only added support for this in our platform earlier this week)

> +Optional properties: (See ethernet.txt file in the same directory)

> +- local-mac-address

> +- mac-address

> +- max-speed

> +- max-frame-size

> +

> +Required properties for the child phy:

> +- reg: phy address

> +

> +Example:

> +       eth0: netsec@522D0000 {

> +               compatible = "socionext,synquacer-netsec";

> +               reg = <0 0x522D0000 0x0 0x10000>, <0 0x10000000 0x0 0x10000>;

> +               interrupts = <GIC_SPI 176 IRQ_TYPE_LEVEL_HIGH>;

> +               clocks = <&clk_netsec>;

> +               phy-mode = "rgmii";

> +               max-speed = <1000>;

> +               max-frame-size = <9000>;

> +               phy-handle = <&ethphy0>;

> +

> +               #address-cells = <1>;

> +               #size-cells = <0>;

> +

> +               ethphy0: ethernet-phy@1 {

> +                       compatible = "ethernet-phy-ieee802.3-c22";

> +                       reg = <1>;

> +               };

> +       };

> --

> 2.7.4

>

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Jassi Brar Dec. 3, 2017, 11:44 a.m. UTC | #2
On Fri, Dec 1, 2017 at 2:42 PM, Ard Biesheuvel
<ard.biesheuvel@linaro.org> wrote:
> Hi Jassi,

>

> On 30 November 2017 at 16:12,  <jassisinghbrar@gmail.com> wrote:

>> From: Jassi Brar <jassisinghbrar@gmail.com>

>>

>> This patch adds documentation for Device-Tree bindings for the

>> Socionext NetSec Controller driver.

>>

>> Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>

>> Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

>

> No need to keep my signoff here: if you are posting the patch, your

> signoff should come last. (Authorship is no factor here, only the path

> taken by the patch from the author/copyright holder to the sender of

> the email)

>

Thanks for pointing out.

This patch is unchanged since I picked from your tree, so it remained
as such. The other patches do have my sob as second.

Thanks
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/net/socionext-netsec.txt b/Documentation/devicetree/bindings/net/socionext-netsec.txt
new file mode 100644
index 0000000..4695969
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/socionext-netsec.txt
@@ -0,0 +1,43 @@ 
+* Socionext NetSec Ethernet Controller IP
+
+Required properties:
+- compatible: Should be "socionext,synquacer-netsec"
+- reg: Address and length of the control register area, followed by the
+       address and length of the EEPROM holding the MAC address and
+       microengine firmware
+- interrupts: Should contain ethernet controller interrupt
+- clocks: phandle to the PHY reference clock, and any other clocks to be
+          switched by runtime_pm
+- clock-names: Required only if more than a single clock is listed in 'clocks'.
+               The PHY reference clock must be named 'phy_refclk'
+- phy-mode: See ethernet.txt file in the same directory
+- phy-handle: phandle to select child phy
+
+Optional properties: (See ethernet.txt file in the same directory)
+- local-mac-address
+- mac-address
+- max-speed
+- max-frame-size
+
+Required properties for the child phy:
+- reg: phy address
+
+Example:
+	eth0: netsec@522D0000 {
+		compatible = "socionext,synquacer-netsec";
+		reg = <0 0x522D0000 0x0 0x10000>, <0 0x10000000 0x0 0x10000>;
+		interrupts = <GIC_SPI 176 IRQ_TYPE_LEVEL_HIGH>;
+		clocks = <&clk_netsec>;
+		phy-mode = "rgmii";
+		max-speed = <1000>;
+		max-frame-size = <9000>;
+		phy-handle = <&ethphy0>;
+
+		#address-cells = <1>;
+		#size-cells = <0>;
+
+		ethphy0: ethernet-phy@1 {
+			compatible = "ethernet-phy-ieee802.3-c22";
+			reg = <1>;
+		};
+	};