From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755686AbcLQMuW (ORCPT ); Sat, 17 Dec 2016 07:50:22 -0500 Received: from mail-qt0-f195.google.com ([209.85.216.195]:34322 "EHLO mail-qt0-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751993AbcLQMuU (ORCPT ); Sat, 17 Dec 2016 07:50:20 -0500 Date: Sat, 17 Dec 2016 10:50:11 -0200 From: Sergio Prado To: Rob Herring Cc: gregkh@linuxfoundation.org, mark.rutland@arm.com, balbi@kernel.org, linux-usb@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 1/2] dt-bindings: usb: add DT binding for s3c2410 USB device controller Message-ID: <20161217125011.GA12499@sprado-desktop> References: <1481310400-28676-1-git-send-email-sergio.prado@e-labworks.com> <1481310400-28676-2-git-send-email-sergio.prado@e-labworks.com> <20161213185915.z2ze7wzx4im5hxdh@rob-hp-laptop> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20161213185915.z2ze7wzx4im5hxdh@rob-hp-laptop> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Dec 13, 2016 at 12:59:15PM -0600, Rob Herring wrote: > > +Samsung S3C2410 and compatible USB device controller > > + > > +Required properties: > > + - compatible: Should be one of the following > > + "samsung,s3c2410-udc" > > + "samsung,s3c2440-udc" > > + - reg: address and length of the controller memory mapped region > > + - interrupts: interrupt number for the USB device controller > > + - clocks: Should reference the bus and host clocks > > + - clock-names: Should contain two strings > > + "usb-bus-gadget" for the USB bus clock > > Pretty sure the h/w clock name in the datasheet does not use the Linux > term gadget. You are right. The datasheet calls it UCLK. In the S3c24010 clock driver (clk-s3c2410.c), there's is a clock alias to UCLK called "usb-bus-gadget" that was used in the USB device controller's driver. We can change the driver and the DT binding to use "uclk" to better reflect the name used in the datasheet. What do you think? > > > + "usb-device" for the USB device clock > > + > > +Optional properties: > > + - samsung,vbus-gpio: If present, specifies a gpio that needs to be > > + activated for the bus to be powered. > > Isn't it the host side that controls Vbus? Yes. I'll change the description to "specifies a gpio that allows to detect whether vbus is present (USB is connected)." > > > + - samsung,pullup-gpio: If present, specifies a gpio to control the > > Both GPIOs need to specify the active state. OK. > > > + USB D+ pullup. > > + > > +usb1: udc@52000000 { > > + compatible = "samsung,s3c2440-udc"; > > + reg = <0x52000000 0x100000>; > > + interrupts = <0 0 25 3>; > > + clocks = <&clocks UCLK>, <&clocks HCLK_USBD>; > > + clock-names = "usb-bus-gadget", "usb-device"; > > + samsung,pullup-gpio = <&gpc 5 GPIO_ACTIVE_HIGH>; > > +}; > > -- > > 1.9.1 > > Best regards, -- Sergio Prado Embedded Labworks