From patchwork Thu Nov 9 17:07:19 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Johan Hovold X-Patchwork-Id: 836438 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="ISjJNmBx"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3yXqdH1lhlz9sMN for ; Fri, 10 Nov 2017 04:18:43 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752459AbdKIRS0 (ORCPT ); Thu, 9 Nov 2017 12:18:26 -0500 Received: from mail-lf0-f65.google.com ([209.85.215.65]:49530 "EHLO mail-lf0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751497AbdKIROT (ORCPT ); Thu, 9 Nov 2017 12:14:19 -0500 Received: by mail-lf0-f65.google.com with SMTP id w21so7996979lfc.6; Thu, 09 Nov 2017 09:14:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=UUbQUeZPs4rDNdGE1RNKuPu29Y0vNnY9ijDvV3m2ibM=; b=ISjJNmBxr3nkmHSIM0QwyfKifLFnFLFRkH2iMZ5witkFtz3k/Ibpjok9GKdV0TUGC9 TQNqFO/kYKeN7qOU0DFRKnttGXGjGe70pnkyCjx/a+KOhqa2G8qf7K3sD4UuciofSHeL rD9wZXQ+CLJGqh1Yvz838e/gkc7srwzviEkCqB0yFeKSwrckhfsgHF0CxCPHdRWWgwYd 0Ut9i5qLsQ8FhqbuMpn5nrAh58D/Eb5pF/qYrQ9zSfZgFzF0XkIHCVS5DpXCqUW8xVxX AIZwI/BcEr8ZDwgTMllJY+GCglcgQRMG96soUYZGItARJWcEBzFI/iKR1scbP96qpVOt joNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=UUbQUeZPs4rDNdGE1RNKuPu29Y0vNnY9ijDvV3m2ibM=; b=GoGjiff6h3lGGCfkNmDj6stJl9bITBCA8jB3YRx4xo3D2lAGYLfCumCM3CMWj5mQcD qT2jiWBclNOG0U20rmVorp2cPzHzjoXRBXe5+ud8kbTcQTHncZKRy0nv80FA/DfoIiKE UGsviTmiZ6cH8uC9GUfc88dzRoqiI3UWZv48DQetvp4tTLIPYcNpsTAurlwAUJouBaLJ 29M86cvAwg2B9lFXS9tUOqc7kuqkY9ugyTP86lZcn7dlfrHV8O4Lg2Ti2N98/dU/XmgT oSLnTay2NoQGTPjo+4YpV6Km13Yoya7pmeLRJdoRiRqNsaV4XzVEVVHsvj7axFBZi29V 7ZoA== X-Gm-Message-State: AJaThX6g4IgfPKKgJx6z6AJjhG5o1XTh/BHfMfhRd1RHlaJqqseAW9cf slSN8Oen9lePmf8TcyO1cqM= X-Google-Smtp-Source: ABhQp+QuPGTCavs+HQ+hcaqYQQ7PbFkINquRCOip/SGdmHng515fTCjte7Ax++1o7hK7FXm2Eqo1oA== X-Received: by 10.46.41.199 with SMTP id p68mr481593ljp.5.1510247657623; Thu, 09 Nov 2017 09:14:17 -0800 (PST) Received: from xi.terra (c-37c9e255.07-184-6d6c6d4.cust.bredbandsbolaget.se. [85.226.201.55]) by smtp.gmail.com with ESMTPSA id q27sm207705lfd.20.2017.11.09.09.14.14 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 09 Nov 2017 09:14:14 -0800 (PST) Received: from johan by xi.terra with local (Exim 4.89) (envelope-from ) id 1eCqPE-0002uS-56; Thu, 09 Nov 2017 18:14:20 +0100 From: Johan Hovold To: Greg Kroah-Hartman Cc: Rob Herring , Mark Rutland , Arnd Bergmann , Alan Stern , Peter Chen , linux-usb@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Johan Hovold Subject: [PATCH 4/8] dt-bindings: usb: document hub and host-controller properties Date: Thu, 9 Nov 2017 18:07:19 +0100 Message-Id: <20171109170723.10960-5-johan@kernel.org> X-Mailer: git-send-email 2.15.0 In-Reply-To: <20171109170723.10960-1-johan@kernel.org> References: <20171109170723.10960-1-johan@kernel.org> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Hub nodes and host-controller nodes with child nodes must specify values for #address-cells (1) and #size-cells (0). Also make the definition of the related reg property a bit more stringent, and add comments to the example source. Signed-off-by: Johan Hovold --- Documentation/devicetree/bindings/usb/usb-device.txt | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/Documentation/devicetree/bindings/usb/usb-device.txt b/Documentation/devicetree/bindings/usb/usb-device.txt index e0b562e35a0c..1b27cebb47f4 100644 --- a/Documentation/devicetree/bindings/usb/usb-device.txt +++ b/Documentation/devicetree/bindings/usb/usb-device.txt @@ -4,22 +4,34 @@ Usually, we only use device tree for hard wired USB device. The reference binding doc is from: http://www.devicetree.org/open-firmware/bindings/usb/usb-1_0.ps + Required properties: - compatible: "usbVID,PID", where VID is the vendor id and PID the product id. The textual representation of VID and PID shall be in lower case hexadecimal with leading zeroes suppressed. The other compatible strings from the above standard binding could also be used, but a device adhering to this binding may leave out all except for "usbVID,PID". -- reg: the port number which this device is connecting to, the range - is 1-255. +- reg: the number of the USB hub port or the USB host-controller port to which + this device is attached. The range is 1-255. + + +Required properties for hub nodes with device nodes: +- #address-cells: shall be 1 +- #size-cells: shall be 0 + + +Required properties for host-controller nodes with device nodes: +- #address-cells: shall be 1 +- #size-cells: shall be 0 + Example: -&usb1 { +&usb1 { /* host controller */ #address-cells = <1>; #size-cells = <0>; - hub@1 { + hub@1 { /* hub connected to port 1 */ compatible = "usb5e3,608"; reg = <1>; };