Documentation/devicetree/bindings/usb/am33xx-usb.txt

   1   AM33xx MUSB
   2 ~~~~~~~~~~~~~~~
   3 - compatible: ti,am33xx-usb
   4 - reg: offset and length of the usbss register sets
   5 - ti,hwmods : must be "usb_otg_hs"
   6
   7 The glue layer contains multiple child nodes. It is required to have
   8 at least a control module node, USB node and a PHY node. The second USB
   9 node and its PHY node are optional. The DMA node is also optional.
  10
  11 Reset module
  12 ~~~~~~~~~~~~
  13 - compatible: ti,am335x-usb-ctrl-module
  14 - reg: offset and length of the "USB control registers" in the "Control
  15   Module" block. A second offset and length for the USB wake up control
  16   in the same memory block.
  17 - reg-names: "phy_ctrl" for the "USB control registers" and "wakeup" for
  18   the USB wake up control register.
  19
  20 USB PHY
  21 ~~~~~~~
  22 compatible: ti,am335x-usb-phy
  23 reg: offset and length of the "USB PHY" register space
  24 ti,ctrl_mod: reference to the "reset module" node
  25 reg-names: phy
  26 The PHY should have a "phy" alias numbered properly in the alias
  27 node.
  28
  29 USB
  30 ~~~
  31 - compatible: ti,musb-am33xx
  32 - reg: offset and length of "USB Controller Registers", and offset and
  33   length of "USB Core" register space.
  34 - reg-names: control for the ""USB Controller Registers" and "mc" for
  35   "USB Core" register space
  36 - interrupts: USB interrupt number
  37 - interrupt-names: mc
  38 - dr_mode: Should be one of "host", "peripheral" or "otg".
  39 - mentor,multipoint: Should be "1" indicating the musb controller supports
  40   multipoint. This is a MUSB configuration-specific setting.
  41 - mentor,num-eps: Specifies the number of endpoints. This is also a
  42   MUSB configuration-specific setting. Should be set to "16"
  43 - mentor,ram-bits: Specifies the ram address size. Should be set to "12"
  44 - mentor,power: Should be "500". This signifies the controller can supply up to
  45   500mA when operating in host mode.
  46 - phys: reference to the USB phy
  47 - dmas: specifies the dma channels
  48 - dma-names: specifies the names of the channels. Use "rxN" for receive
  49   and "txN" for transmit endpoints. N specifies the endpoint number.
  50
  51 The controller should have an "usb" alias numbered properly in the alias
  52 node.
  53
  54 DMA
  55 ~~~
  56 - compatible: ti,am3359-cppi41
  57 - reg: offset and length of the following register spaces: USBSS, USB
  58   CPPI DMA Controller, USB CPPI DMA Scheduler, USB Queue Manager
  59 - reg-names: glue, controller, scheduler, queuemgr
  60 - #dma-cells: should be set to 2. The first number represents the
  61   endpoint number (0 … 14 for endpoints 1 … 15 on instance 0 and 15 … 29
  62   for endpoints 1 … 15 on instance 1). The second number is 0 for RX and
  63   1 for TX transfers.
  64 - #dma-channels: should be set to 30 representing the 15 endpoints for
  65   each USB instance.
  66
  67 Example:
  68 ~~~~~~~~
  69 The following example contains all the nodes as used on am335x-evm:
  70
  71 aliases {
  72         usb0 = &usb0;
  73         usb1 = &usb1;
  74         phy0 = &usb0_phy;
  75         phy1 = &usb1_phy;
  76 };
  77
  78 usb: usb@47400000 {
  79         compatible = "ti,am33xx-usb";
  80         reg = <0x47400000 0x1000>;
  81         ranges;
  82         #address-cells = <1>;
  83         #size-cells = <1>;
  84         ti,hwmods = "usb_otg_hs";
  85
  86         ctrl_mod: control@44e10000 {
  87                 compatible = "ti,am335x-usb-ctrl-module";
  88                 reg = <0x44e10620 0x10
  89                         0x44e10648 0x4>;
  90                 reg-names = "phy_ctrl", "wakeup";
  91         };
  92
  93         usb0_phy: usb-phy@47401300 {
  94                 compatible = "ti,am335x-usb-phy";
  95                 reg = <0x47401300 0x100>;
  96                 reg-names = "phy";
  97                 ti,ctrl_mod = <&ctrl_mod>;
  98                 #phy-cells = <0>;
  99         };
 100
 101         usb0: usb@47401000 {
 102                 compatible = "ti,musb-am33xx";
 103                 reg = <0x47401400 0x400
 104                         0x47401000 0x200>;
 105                 reg-names = "mc", "control";
 106
 107                 interrupts = <18>;
 108                 interrupt-names = "mc";
 109                 dr_mode = "otg"
 110                 mentor,multipoint = <1>;
 111                 mentor,num-eps = <16>;
 112                 mentor,ram-bits = <12>;
 113                 mentor,power = <500>;
 114                 phys = <&usb0_phy>;
 115
 116                 dmas = <&cppi41dma  0 0 &cppi41dma  1 0
 117                         &cppi41dma  2 0 &cppi41dma  3 0
 118                         &cppi41dma  4 0 &cppi41dma  5 0
 119                         &cppi41dma  6 0 &cppi41dma  7 0
 120                         &cppi41dma  8 0 &cppi41dma  9 0
 121                         &cppi41dma 10 0 &cppi41dma 11 0
 122                         &cppi41dma 12 0 &cppi41dma 13 0
 123                         &cppi41dma 14 0 &cppi41dma  0 1
 124                         &cppi41dma  1 1 &cppi41dma  2 1
 125                         &cppi41dma  3 1 &cppi41dma  4 1
 126                         &cppi41dma  5 1 &cppi41dma  6 1
 127                         &cppi41dma  7 1 &cppi41dma  8 1
 128                         &cppi41dma  9 1 &cppi41dma 10 1
 129                         &cppi41dma 11 1 &cppi41dma 12 1
 130                         &cppi41dma 13 1 &cppi41dma 14 1>;
 131                 dma-names =
 132                         "rx1", "rx2", "rx3", "rx4", "rx5", "rx6", "rx7",
 133                         "rx8", "rx9", "rx10", "rx11", "rx12", "rx13",
 134                         "rx14", "rx15",
 135                         "tx1", "tx2", "tx3", "tx4", "tx5", "tx6", "tx7",
 136                         "tx8", "tx9", "tx10", "tx11", "tx12", "tx13",
 137                         "tx14", "tx15";
 138         };
 139
 140         usb1_phy: usb-phy@47401b00 {
 141                 compatible = "ti,am335x-usb-phy";
 142                 reg = <0x47401b00 0x100>;
 143                 reg-names = "phy";
 144                 ti,ctrl_mod = <&ctrl_mod>;
 145                 #phy-cells = <0>;
 146         };
 147
 148         usb1: usb@47401800 {
 149                 compatible = "ti,musb-am33xx";
 150                 reg = <0x47401c00 0x400
 151                         0x47401800 0x200>;
 152                 reg-names = "mc", "control";
 153                 interrupts = <19>;
 154                 interrupt-names = "mc";
 155                 dr_mode = "host"
 156                 mentor,multipoint = <1>;
 157                 mentor,num-eps = <16>;
 158                 mentor,ram-bits = <12>;
 159                 mentor,power = <500>;
 160                 phys = <&usb1_phy>;
 161
 162                 dmas = <&cppi41dma 15 0 &cppi41dma 16 0
 163                         &cppi41dma 17 0 &cppi41dma 18 0
 164                         &cppi41dma 19 0 &cppi41dma 20 0
 165                         &cppi41dma 21 0 &cppi41dma 22 0
 166                         &cppi41dma 23 0 &cppi41dma 24 0
 167                         &cppi41dma 25 0 &cppi41dma 26 0
 168                         &cppi41dma 27 0 &cppi41dma 28 0
 169                         &cppi41dma 29 0 &cppi41dma 15 1
 170                         &cppi41dma 16 1 &cppi41dma 17 1
 171                         &cppi41dma 18 1 &cppi41dma 19 1
 172                         &cppi41dma 20 1 &cppi41dma 21 1
 173                         &cppi41dma 22 1 &cppi41dma 23 1
 174                         &cppi41dma 24 1 &cppi41dma 25 1
 175                         &cppi41dma 26 1 &cppi41dma 27 1
 176                         &cppi41dma 28 1 &cppi41dma 29 1>;
 177                 dma-names =
 178                         "rx1", "rx2", "rx3", "rx4", "rx5", "rx6", "rx7",
 179                         "rx8", "rx9", "rx10", "rx11", "rx12", "rx13",
 180                         "rx14", "rx15",
 181                         "tx1", "tx2", "tx3", "tx4", "tx5", "tx6", "tx7",
 182                         "tx8", "tx9", "tx10", "tx11", "tx12", "tx13",
 183                         "tx14", "tx15";
 184         };
 185
 186         cppi41dma: dma-controller@7402000 {
 187                 compatible = "ti,am3359-cppi41";
 188                 reg =  <0x47400000 0x1000
 189                         0x47402000 0x1000
 190                         0x47403000 0x1000
 191                         0x47404000 0x4000>;
 192                 reg-names = "glue", "controller", "scheduler", "queuemgr";
 193                 interrupts = <17>;
 194                 interrupt-names = "glue";
 195                 #dma-cells = <2>;
 196                 #dma-channels = <30>;
 197                 #dma-requests = <256>;
 198         };
 199 };