Documentation/devicetree/bindings/powerpc/fsl/cpm_qe/qe/ucc.txt

   1 * UCC (Unified Communications Controllers)
   2
   3 Required properties:
   4 - device_type : should be "network", "hldc", "uart", "transparent"
   5   "bisync", "atm", or "serial".
   6 - compatible : could be "ucc_geth" or "fsl_atm" and so on.
   7 - cell-index : the ucc number(1-8), corresponding to UCCx in UM.
   8 - reg : Offset and length of the register set for the device
   9 - interrupts : <a b> where a is the interrupt number and b is a
  10   field that represents an encoding of the sense and level
  11   information for the interrupt.  This should be encoded based on
  12   the information in section 2) depending on the type of interrupt
  13   controller you have.
  14 - interrupt-parent : the phandle for the interrupt controller that
  15   services interrupts for this device.
  16 - pio-handle : The phandle for the Parallel I/O port configuration.
  17 - port-number : for UART drivers, the port number to use, between 0 and 3.
  18   This usually corresponds to the /dev/ttyQE device, e.g. <0> = /dev/ttyQE0.
  19   The port number is added to the minor number of the device.  Unlike the
  20   CPM UART driver, the port-number is required for the QE UART driver.
  21 - soft-uart : for UART drivers, if specified this means the QE UART device
  22   driver should use "Soft-UART" mode, which is needed on some SOCs that have
  23   broken UART hardware.  Soft-UART is provided via a microcode upload.
  24 - rx-clock-name: the UCC receive clock source
  25   "none": clock source is disabled
  26   "brg1" through "brg16": clock source is BRG1-BRG16, respectively
  27   "clk1" through "clk24": clock source is CLK1-CLK24, respectively
  28 - tx-clock-name: the UCC transmit clock source
  29   "none": clock source is disabled
  30   "brg1" through "brg16": clock source is BRG1-BRG16, respectively
  31   "clk1" through "clk24": clock source is CLK1-CLK24, respectively
  32 The following two properties are deprecated.  rx-clock has been replaced
  33 with rx-clock-name, and tx-clock has been replaced with tx-clock-name.
  34 Drivers that currently use the deprecated properties should continue to
  35 do so, in order to support older device trees, but they should be updated
  36 to check for the new properties first.
  37 - rx-clock : represents the UCC receive clock source.
  38   0x00 : clock source is disabled;
  39   0x1~0x10 : clock source is BRG1~BRG16 respectively;
  40   0x11~0x28: clock source is QE_CLK1~QE_CLK24 respectively.
  41 - tx-clock: represents the UCC transmit clock source;
  42   0x00 : clock source is disabled;
  43   0x1~0x10 : clock source is BRG1~BRG16 respectively;
  44   0x11~0x28: clock source is QE_CLK1~QE_CLK24 respectively.
  45
  46 Required properties for network device_type:
  47 - mac-address : list of bytes representing the ethernet address.
  48 - phy-handle : The phandle for the PHY connected to this controller.
  49
  50 Recommended properties:
  51 - phy-connection-type : a string naming the controller/PHY interface type,
  52   i.e., "mii" (default), "rmii", "gmii", "rgmii", "rgmii-id" (Internal
  53   Delay), "rgmii-txid" (delay on TX only), "rgmii-rxid" (delay on RX only),
  54   "tbi", or "rtbi".
  55
  56 Example:
  57         ucc@2000 {
  58                 device_type = "network";
  59                 compatible = "ucc_geth";
  60                 cell-index = <1>;
  61                 reg = <2000 200>;
  62                 interrupts = <a0 0>;
  63                 interrupt-parent = <700>;
  64                 mac-address = [ 00 04 9f 00 23 23 ];
  65                 rx-clock = "none";
  66                 tx-clock = "clk9";
  67                 phy-handle = <212000>;
  68                 phy-connection-type = "gmii";
  69                 pio-handle = <140001>;
  70         };