Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754687AbcDKPKe (ORCPT ); Mon, 11 Apr 2016 11:10:34 -0400 Received: from mail.kernel.org ([198.145.29.136]:54295 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754632AbcDKPKc (ORCPT ); Mon, 11 Apr 2016 11:10:32 -0400 Date: Mon, 11 Apr 2016 10:10:22 -0500 From: Rob Herring To: Purna Chandra Mandal Cc: linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org, Joshua Henderson , devicetree@vger.kernel.org, Kumar Gala , Ian Campbell , Pawel Moll , Mark Rutland Subject: Re: [PATCH v2 1/2] dt/bindings/usb: Add bindings for PIC32 MUSB driver. Message-ID: <20160411151022.GA6187@rob-hp-laptop> References: <460027775-20729-2-git-send-email-purna.mandal@microchip.com> <1460032381-32677-1-git-send-email-purna.mandal@microchip.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1460032381-32677-1-git-send-email-purna.mandal@microchip.com> User-Agent: Mutt/1.5.23 (2014-03-12) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3921 Lines: 102 On Thu, Apr 07, 2016 at 06:02:59PM +0530, Purna Chandra Mandal wrote: > Document devicetree binding for the USB controller > and USB Phy found on Microchip PIC32 class devices. > > Signed-off-by: Purna Chandra Mandal > > --- > > Changes in v2: None > > .../bindings/usb/microchip,pic32-musb.txt | 67 ++++++++++++++++++++++ > 1 file changed, 67 insertions(+) > create mode 100644 Documentation/devicetree/bindings/usb/microchip,pic32-musb.txt > > diff --git a/Documentation/devicetree/bindings/usb/microchip,pic32-musb.txt b/Documentation/devicetree/bindings/usb/microchip,pic32-musb.txt > new file mode 100644 > index 0000000..e1cec9d > --- /dev/null > +++ b/Documentation/devicetree/bindings/usb/microchip,pic32-musb.txt > @@ -0,0 +1,67 @@ > +Microchip PIC32 MUSB DRC/OTG controller > +------------------------------------------- > + > +Required properties: > + - compatible : should be "microchip,pic32mzda-usb". > + - reg : offset and length of "MUSB Core Registers" and > + "USB Clock & Reset Registers". > + - reg-names : should be "mc", and "usbcr" in order > + - clocks : clock specifier for the musb controller clock > + - clock-names : should be "usb_clk" > + - interrupts : interrupt number for MUSB Core General interrupt > + and DMA interrupt > + - interrupt-names : must be "mc" and "dma" in order. > + - phys : phy specifier for the otg phy. > + - dr_mode : should be one of "host", "peripheral" or "otg". > + - mentor,multipoint: Should be "1" indicating the musb controller supports > + multipoint. This is MUSB configuration-specific setting. > + - mentor,num-eps : Specifies the number of endpoints. This is also a > + MUSB configuration-specific setting. Should be set to "8". > + - mentor,ram-bits : Specifies the ram address size. Should be set to "11". > + - mentor,power : Should be "500". This signifies the controller can supply > + up to 500mA when operating in host mode. > + - phys : phandle of the USB phy. > + - usb_overcurrent : phandle to MUSB over-current note. It should have > + interrupt number for over-current detection logic. This node is only an interrupt? Then you should use interrupts-extended and make this interrupt the 3rd one. interrupts-extended will let you have different interrupt parents for each irq. > + > +Optional properties: > + - microchip,fifo-mode: Specifies layout of internal SRAM for end-point fifos. > + Should be 0 (default) or 1. Make this a boolean. > + > +Example: > + aliases { > + usb1 = &usb1; > + phy1 = &usb1_phy; > + }; > + > + usb1: hsusb1_core@1f8e3000 { > + compatible = "microchip,pic32mzda-usb"; > + reg = <0x1f8e3000 0x1000>, > + <0x1f884000 0x1000>; > + reg-names = "mc", "usbcr"; > + interrupts = <132 IRQ_TYPE_EDGE_RISING>, > + <133 IRQ_TYPE_LEVEL_HIGH>; > + interrupt-names = "mc", "dma"; > + dr_mode = "host"; > + mentor,multipoint = <1>; > + mentor,num-eps = <8>; > + mentor,ram-bits = <11>; > + mentor,power = <500>; > + phys = <&usb1_phy>; > + clocks = <&rootclk PB5CLK>; > + clock-names = "usb_clk"; > + usb_overcurrent = <&usb1_overcurrent>; > + }; > + > + usb1_phy: hsusb1_phy@1f8e4000 { > + compatible = "usb-nop-xceiv"; > + reg = <0x1f8e4000 0x1000>; > + clocks = <&rootclk UPLLCLK>; > + clock-names = "main_clk"; > + clock-frequency = <24000000>; > + }; > + > + usb1_overcurrent: hsusb1_oc@0 { > + interrupt-parent = <&gpio1>; > + interrupts = <11 IRQ_TYPE_EDGE_FALLING>; > + }; > -- > 1.8.3.1 > > -- > To unsubscribe from this list: send the line "unsubscribe devicetree" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html