doc: bindings: Aquantia PHY node binding
[oweals/u-boot.git] / doc / device-tree-bindings / net / aquantia-phy.txt
1 PHY nodes for Aquantia devices.
2
3 This text describes properties that are applicable to Aquantia PHY nodes in
4 addition to the bindings in phy.txt.
5
6 Aquantia PHYs allow some flexibility in the way they are wired in a system,
7 they allow MDI pins to be reversed, LEDs linked up in different weays, have an
8 I2C slave interface that can be used for debug.  Normally the configuration
9 corresponding to these is driven by the PHY firmware with the downside that
10 a custom firmware is needed for each integration of a PHY.
11 Several optional bindings are defined that allow these configuration points to
12 be driven by the PHY driver and reduce dependency on specific FW versions.
13
14 Optional properties:
15 mdi-reversal: 0 or 1 indicating that reversal must be disabled/enabled.
16               Firmware default is used if the property is missing.
17 smb-addr:     I2C/SMBus address to use, firmware default is used if the property
18               is missing.
19
20 Example node:
21 phy@00 {
22         reg = <0x00>;
23         mdi-reversal = <1>;
24         smb-addr = <0x25>;
25 };