Merge tag 'nfs-for-4.16-2' of git://git.linux-nfs.org/projects/trondmy/linux-nfs
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / sff,sfp.txt
1 Small Form Factor (SFF) Committee Small Form-factor Pluggable (SFP)
2 Transceiver
3
4 Required properties:
5
6 - compatible : must be one of
7   "sff,sfp" for SFP modules
8   "sff,sff" for soldered down SFF modules
9
10 Optional Properties:
11
12 - i2c-bus : phandle of an I2C bus controller for the SFP two wire serial
13   interface
14
15 - mod-def0-gpios : GPIO phandle and a specifier of the MOD-DEF0 (AKA Mod_ABS)
16   module presence input gpio signal, active (module absent) high. Must
17   not be present for SFF modules
18
19 - los-gpios : GPIO phandle and a specifier of the Receiver Loss of Signal
20   Indication input gpio signal, active (signal lost) high
21
22 - tx-fault-gpios : GPIO phandle and a specifier of the Module Transmitter
23   Fault input gpio signal, active (fault condition) high
24
25 - tx-disable-gpios : GPIO phandle and a specifier of the Transmitter Disable
26   output gpio signal, active (Tx disable) high
27
28 - rate-select0-gpios : GPIO phandle and a specifier of the Rx Signaling Rate
29   Select (AKA RS0) output gpio signal, low: low Rx rate, high: high Rx rate
30   Must not be present for SFF modules
31
32 - rate-select1-gpios : GPIO phandle and a specifier of the Tx Signaling Rate
33   Select (AKA RS1) output gpio signal (SFP+ only), low: low Tx rate, high:
34   high Tx rate. Must not be present for SFF modules
35
36 Example #1: Direct serdes to SFP connection
37
38 sfp_eth3: sfp-eth3 {
39         compatible = "sff,sfp";
40         i2c-bus = <&sfp_1g_i2c>;
41         los-gpios = <&cpm_gpio2 22 GPIO_ACTIVE_HIGH>;
42         mod-def0-gpios = <&cpm_gpio2 21 GPIO_ACTIVE_LOW>;
43         pinctrl-names = "default";
44         pinctrl-0 = <&cpm_sfp_1g_pins &cps_sfp_1g_pins>;
45         tx-disable-gpios = <&cps_gpio1 24 GPIO_ACTIVE_HIGH>;
46         tx-fault-gpios = <&cpm_gpio2 19 GPIO_ACTIVE_HIGH>;
47 };
48
49 &cps_emac3 {
50         phy-names = "comphy";
51         phys = <&cps_comphy5 0>;
52         sfp = <&sfp_eth3>;
53 };
54
55 Example #2: Serdes to PHY to SFP connection
56
57 sfp_eth0: sfp-eth0 {
58         compatible = "sff,sfp";
59         i2c-bus = <&sfpp0_i2c>;
60         los-gpios = <&cps_gpio1 28 GPIO_ACTIVE_HIGH>;
61         mod-def0-gpios = <&cps_gpio1 27 GPIO_ACTIVE_LOW>;
62         pinctrl-names = "default";
63         pinctrl-0 = <&cps_sfpp0_pins>;
64         tx-disable-gpios = <&cps_gpio1 29 GPIO_ACTIVE_HIGH>;
65         tx-fault-gpios  = <&cps_gpio1 26 GPIO_ACTIVE_HIGH>;
66 };
67
68 p0_phy: ethernet-phy@0 {
69         compatible = "ethernet-phy-ieee802.3-c45";
70         pinctrl-names = "default";
71         pinctrl-0 = <&cpm_phy0_pins &cps_phy0_pins>;
72         reg = <0>;
73         interrupt = <&cpm_gpio2 18 IRQ_TYPE_EDGE_FALLING>;
74         sfp = <&sfp_eth0>;
75 };
76
77 &cpm_eth0 {
78         phy = <&p0_phy>;
79         phy-mode = "10gbase-kr";
80 };