Quelle  phy-miphy365x.txt   Sprache: Text

STMicroelectronics STi MIPHY365x PHY binding
============================================

This binding describes a miphy device that is used to control PHY hardware
for SATA and PCIe.

Required properties (controller (parent) node):
- compatible    : Should be "st,miphy365x-phy"
- st,syscfg     : Phandle / integer array property. Phandle of sysconfig group
    containing the miphy registers and integer array should contain
    an entry for each port sub-node, specifying the control
    register offset inside the sysconfig group.

Required nodes :  A sub-node is required for each channel the controller
     provides. Address range information including the usual
     'reg' and 'reg-names' properties are used inside these
     nodes to describe the controller's topology. These nodes
     are translated by the driver's .xlate() function.

Required properties (port (child) node):
- #phy-cells  : Should be 1 (See second example)
    Cell after port phandle is device type from:
   - PHY_TYPE_SATA
   - PHY_TYPE_PCI
- reg         : Address and length of register sets for each device in
    "reg-names"
- reg-names     : The names of the register addresses corresponding to the
    registers filled in "reg":
   - sata:   For SATA devices
   - pcie:   For PCIe devices

Optional properties (port (child) node):
- st,sata-gen      : Generation of locally attached SATA IP. Expected values
   are {1,2,3). If not supplied generation 1 hardware will
   be expected
- st,pcie-tx-pol-inv : Bool property to invert the polarity PCIe Tx (Txn/Txp)
- st,sata-tx-pol-inv : Bool property to invert the polarity SATA Tx (Txn/Txp)

Example:

 miphy365x_phy: miphy365x@fe382000 {
  compatible      = "st,miphy365x-phy";
  st,syscfg   = <&syscfg_rear 0x824 0x828>;
  #address-cells = <1>;
  #size-cells = <1>;
  ranges;

  phy_port0: port@fe382000 {
   reg = <0xfe382000 0x100>, <0xfe394000 0x100>;
   reg-names = "sata", "pcie";
   #phy-cells = <1>;
   st,sata-gen = <3>;
  };

  phy_port1: port@fe38a000 {
   reg = <0xfe38a000 0x100>, <0xfe804000 0x100>;;
   reg-names = "sata", "pcie", "syscfg";
   #phy-cells = <1>;
   st,pcie-tx-pol-inv;
  };
 };

Specifying phy control of devices
=================================

Device nodes should specify the configuration required in their "phys"
property, containing a phandle to the phy port node and a device type.

Example:

#include <dt-bindings/phy/phy.h>

 sata0: sata@fe380000 {
  ...
  phys   = <&phy_port0 PHY_TYPE_SATA>;
  ...
 };