Re: [PATCH] Documentation/devicetree: document OCTEON USB bindings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




On Thu, Apr 30, 2015 at 2:44 PM, Aaro Koskinen <aaro.koskinen@xxxxxx> wrote:
> Document device-tree bindings for the USB controller on older
> OCTEON SOCs (OCTEON, OCTEON+).
>
> Signed-off-by: Aaro Koskinen <aaro.koskinen@xxxxxx>
> ---
>  .../devicetree/bindings/usb/octeon-usb.txt         | 58 ++++++++++++++++++++++
>  1 file changed, 58 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/usb/octeon-usb.txt
>
> diff --git a/Documentation/devicetree/bindings/usb/octeon-usb.txt b/Documentation/devicetree/bindings/usb/octeon-usb.txt
> new file mode 100644
> index 0000000..fd121c4
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/usb/octeon-usb.txt
> @@ -0,0 +1,58 @@
> +OCTEON/OCTEON+ USB BLOCK
> +
> +1) Main node
> +
> +   Required properties:
> +
> +   - compatible: must be "cavium,octeon-5750-usbn"
> +
> +   - reg: specifies the physical base address of the USBN block and
> +     the length of the memory mapped region.
> +
> +   - #address-cells: specifies the number of cells needed to encode an
> +     address. The value must be 2.
> +
> +   - #size-cells: specifies the number of cells used to represent the size
> +     of an address. The value must be 2.
> +
> +   - ranges: specifies the translation between child address space and parent
> +     address space.
> +
> +   - refclk-frequency: speed of the USB reference clock. Allowed values are
> +     12000000, 24000000 or 48000000.

We already have a standard property for this if you only have 1 clock:
clock-frequency.

> +   - refclk-type: type of the USB reference clock. Allowed values are
> +     "crystal" or "external".

Should be prefixed with "cavium,".

> +
> +2) Child node
> +
> +   The main node must have one child node which describes the built-in
> +   USB controller.
> +
> +   Required properties:
> +
> +   - compatible: must be "cavium,octeon-5750-usbc"
> +
> +   - reg: specifies the physical base address of the USBC block and
> +     the length of the memory mapped region.
> +
> +   - interrupts: specifies the interrupt number for the USB controller.
> +
> +3) Example:
> +
> +       usbn: usbn@1180068000000 {
> +               compatible = "cavium,octeon-5750-usbn";
> +               reg = <0x11800 0x68000000 0x0 0x1000>;
> +               ranges; /* Direct mapping */
> +               #address-cells = <2>;
> +               #size-cells = <2>;
> +               refclk-frequency = <12000000>;
> +               refclk-type = "crystal";
> +
> +               usbc@16f0010000000 {
> +                       compatible = "cavium,octeon-5750-usbc";
> +                       reg = <0x16f00 0x10000000 0x0 0x80000>;
> +                       interrupts = <0 56>;
> +               };
> +       };
> +
> --
> 2.3.3
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]
  Powered by Linux