From patchwork Thu May 3 00:24:41 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jun Li X-Patchwork-Id: 907784 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; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.b="RBAs4gZx"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40bxCd3Hxmz9s4s for ; Thu, 3 May 2018 10:41:17 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751749AbeECAlQ (ORCPT ); Wed, 2 May 2018 20:41:16 -0400 Received: from mail-eopbgr10067.outbound.protection.outlook.com ([40.107.1.67]:11698 "EHLO EUR02-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751745AbeECAlP (ORCPT ); Wed, 2 May 2018 20:41:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=kkxd/KYHG2z1KSqTukvUpuURP5IkIq8GQsU8K1r+nb8=; b=RBAs4gZx7j1/f0+9s6zl+wg3IW6F/4wEahawOrCyoJAtQNWkVr8ZE6dlE9iFQuNfG9FuvmNcBXVeGBkWWG+p9L88FvOJHYrLLZOvk+I5TWF0hdvrKzWxMDEy6TCuZzQe+SH/CNjiudMGTkoDd0p1dgVAt/tL9JA690EO7Jyu0LM= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=jun.li@nxp.com; Received: from b47624-OptiPlex-7040.ap.freescale.net (92.121.68.129) by DB3PR0402MB3914.eurprd04.prod.outlook.com (2603:10a6:8:f::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.715.24; Thu, 3 May 2018 00:41:06 +0000 From: Li Jun To: robh+dt@kernel.org, gregkh@linuxfoundation.org, heikki.krogerus@linux.intel.com, linux@roeck-us.net Cc: jun.li@nxp.com, a.hajda@samsung.com, cw00.choi@samsung.com, shufan_lee@richtek.com, peter.chen@nxp.com, gsomlo@gmail.com, devicetree@vger.kernel.org, linux-usb@vger.kernel.org, linux-imx@nxp.com Subject: [PATCH v5 01/14] dt-bindings: connector: add properties for typec Date: Thu, 3 May 2018 08:24:41 +0800 Message-Id: <1525307094-27402-2-git-send-email-jun.li@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1525307094-27402-1-git-send-email-jun.li@nxp.com> References: <1525307094-27402-1-git-send-email-jun.li@nxp.com> MIME-Version: 1.0 X-Originating-IP: [92.121.68.129] X-ClientProxiedBy: OSAPR01CA0012.jpnprd01.prod.outlook.com (2603:1096:603:2a::24) To DB3PR0402MB3914.eurprd04.prod.outlook.com (2603:10a6:8:f::29) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:DB3PR0402MB3914; X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 3:+eQeZ78NrgEVXTPvsQwbA29bGb5EM8gF7tyd2S0f5QAnvZMphPkMomO0w7ZPHsDBCmJrXjItyV8d8+X+YdMASsBi2mjr6HTKNeIsKRj2Jr4yc31CRq9hNthi5TuxxM7ye9CJT36LveqQJgupCsMw4SK+SrdMTACN5PJ1mps2ZpgV9w9fvTLnlM1RIdCQU3WrnsMZhr9yp7ElwqEalXcYjIl6pVEqMcwsc3pd/kS2f+4kbc8V11Qw3UM3h4yFeVzZ; 25:qTUEJZBsAdn2kRq3T1zak1FOHt+Sr9A1zOijXaRElfnIOf7b+Trxi7HRpiPYxBK0sD2vhr38LX2QWz8LGy/BpxgjGPgonhp81nUerIH/a8S1Ro/IN9pBje3NxUkm8u1Lre/Cf4MhSYel2bXBnfPeq0+p+3WJRGNrmIWi2UEvjSYNBvpgWd+7quauuBVWnvVzfmOihv4jLtYqYd0VvVC7p6tijwBjVYi5zgwqsKYx1/ASMU/oIMkx7qLadhgNDqgvbDQE8w+u35F9JXjIn1NXhm0oCASlUoC5eog3k0baJWY8/GkK75G78kNz21RyU20i0OuJtuwBTAIS7fBQtTE5fA==; 31:J+IWGJI0ZuIE2akT3NHgWpoWAK/Pe8Nr5RrN+7YGQbPvJs9BT34PPDua2ED/mLuX/2F4m4aOkBfNRLTXlYdeSlR3WZPJVJJope2geiTKGh2p2FCKDM5jnJS9jnNhGCMWwMidbFRDxV2LNLvY/ZDJgvnFtkfxzkeBgjMNXqjjrw+Qv3nq+Dtcc7RrlEbn8Ot0bgOuo/kKFt7VE75sZ8fLi/u0xGRsWsqxP5g08I1u4yU= X-MS-TrafficTypeDiagnostic: DB3PR0402MB3914: X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 20:rRtsRzm174Usq2miIPzHN4iHuFqef4y/e9d+yv8Cf5RxHZFFj/t5GhM4xtQ56x/wIsy800OCqXdwunDvYJslc/y+KHlyNkG0oCEWO95wBDAfu2JyGTyhjSmmiNQTdr2RX6XXjptyU2jqBd75A2SAhK86fpEmyrIJcLLXJvEBM+9Z/onnus7oeg9smHDzWrECxjKQEmP+nFoTkyhY5DLblaDUr50xdPhrFeB0Ap7RbGwdin4WVSahfttqAzK6ryrUMQbgfJDYU4LmyATrJB1i5RrNrMOUw3qvlsuzibXaEqHJUVlEPyAsVJbZJgAg3kczSkWf/94sRJPVw/CBoz+7o4AbNfcEXWeawYzProBDIaQ+AoOvL44ql3R4V/2ccP8RlizC+T3ooGFlwjQyGsW+eLgRLUYhAQQksF/DoyxjFSeUvAsbjr/vTBYLx0mv27SyYONUeUqvQASjELcZARUFEXPf6fV8wcvqkp2oHZc/VJ07yXKD80+Cq50GIbhsJWnm; 4:zDEwotel4hfdL1pPU0a3qerB5gLRB401HcNRdn1Hgr3nIHAorZGh0QbHqClwbLqI+7MxFVwI83Ep1ggSF+ShZAAI4Jyli8XxQVPWXM5LLax8zGncrO8eC+6abn7Iqh1otINrY5+z6DNLLgxE8XjzCTzIAGQN6pwfkvhHExyuWSa/4OVcsGl4ShKrUCSZ7qda2XvmX3zZdF+1vPbfxOjpD4JXgaxYxswrxotkxNs4/h94uCUwPPtlb/Gd/I+tpZehHcEz0UXbNAi7dP4CUOCI05h8MOluFnZdmQGLUbG0yhxgWSF/UOL5qjgdnUw91wPj X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3002001)(93006095)(93001095)(10201501046)(3231254)(944501410)(52105095)(6055026)(6041310)(20161123562045)(20161123560045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(6072148)(201708071742011); SRVR:DB3PR0402MB3914; BCL:0; PCL:0; RULEID:; SRVR:DB3PR0402MB3914; X-Forefront-PRVS: 066153096A X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(39380400002)(376002)(39860400002)(346002)(366004)(189003)(199004)(7416002)(47776003)(7736002)(8936002)(66066001)(305945005)(106356001)(2906002)(5660300001)(6486002)(105586002)(6116002)(3846002)(6666003)(81166006)(8676002)(50226002)(68736007)(81156014)(36756003)(956004)(2616005)(386003)(16586007)(476003)(50466002)(6506007)(59450400001)(6512007)(97736004)(316002)(446003)(39060400002)(52116002)(26005)(76176011)(48376002)(4326008)(5890100001)(11346002)(486006)(16526019)(86362001)(51416003)(53936002)(186003)(478600001)(25786009); DIR:OUT; SFP:1101; SCL:1; SRVR:DB3PR0402MB3914; H:b47624-OptiPlex-7040.ap.freescale.net; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DB3PR0402MB3914; 23:5AAXgWYQf+wNOpfhwXtVFDJ23QPZum/ygescoGi?= lSs4qfN78rmwLSIDXMYbgjapuDq/Z8tHQ3zIdhh+kTugwlDGsHsF8pXKvrDE7H4gfTfYhMkLr6XkzlKzxYuXLUF/3b0mM9TZciO71PBPUHeE5BIqyTZ930bzcpibyLVa/ukSng3PdrOeNer/47mNzfBhGJjMPixx0ev1WfjEuv1G0n9l7zBvy74DOEq9PLsm3viU9zHvK1y9lAuIF86aV2OtI/V6gbW+hK8B5f1BmeH/ymlhVGaWBkE5lbdV20jGnLsW3I15cEEpIPbKc5xupTVhgO78Z8IOYhifUKySOkVRbA9UeCxdvgC8HZXjLAVEB8R9MF7ruAYLpsCxD0AcxEhvYj96KreHWVbOEW1nJl+qeu3J+fWNqJCX2/rAwY1ZdH3bj1M9Ra/B6ZMcXUZ3O9DS0Cx1RV5iQ5coZbi1c7QGEfr1zX0FkoAthD9ku8xm6k+YPBssLlHTV+Xcn3tc0r2F/zsw5pUGPepkMwaRPJPCk3Glo1euJsJpVSN3DXafZZVGByj1pzc6vVeLrwpwyCYcujnGJW94O1lZX+Do+LR1DkXrQBk5HLBqLHXYn7cQZxktU5Fnr0lIoVcdiNJdnsnYev/MIUXoNZrmjfckiTO2UqOrtrH+ygvnNSltcCRsBmK7Zihp5nyr3rgzC0SBeKauXBAe1NPh85+7PAATbzDEiE+sx1p6Q0aDHqoUvOm40RHYje90XlSQywWuiF6bt1s5oF4s/n8FZaTko1kuWlpgWTlox8ORbdw+f09M/or8krT3jcYWc8r3IDFvFz4lZAGoWgZ5jY91NX8yViLpbv/kFI9DgAht2wA6M3gLY6WP62jHs9zYq3GFQXfBqRxoD5vV1xHQKz3pzkEETIj4NMwXebRPJ7UYS5Z6K0v766Fs5nqYfljPZDjeiA+O6nvZNRo67OKBkhd8rm0PJfuL0DUq1zYCuqaDqrWmeeMDcn0CKw6/KHizGrwrDeu7m7WC3j9yc44G5CHL3yDwRP7BVgCtoMWYvm7tmquhO6Il5DUH3uNJyv/RXdPzWeiLbapW0bmMlQ+TTZvH1ICOmpyzKIdFSrBbS+PED9QUCyikQfvjFsGIP+FBcHJYZpshBBBwcRwitN8aTFp/PL6kZ6WuoNmp0yHiMskEnZfl+TLAtv/1dmg64LhalFEwD1Yl/F2nKXIuP4MPG9xXIxAGRI6+HrIcG6Zs2v6MsQi/nxxn//aM169o= X-Microsoft-Antispam-Message-Info: 9U/gyeL/DHICTLpFyx3YbfwdShv77TKalDYs7GmKt4BmNXm+WQOhht9pmQrhKH0wg02Fp6IEfXuVQZa5brxQT5wM2li682kdAzSEFZohAIQMkhHZoXdo60stXVE/Qra89RWY4DfM5mXTe5MsscPNKRwu5u6gCv5PeNY3HB2Gnn3tgedCkCSph80jPe5Xz3fg X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 6:EJveEmqpJBjser27xX6cGDG7YhqukVSV6LgEgwlfTOK1ccbi5QWz58/fEjuv9cr7HQy4ts0o3XAdVdWkGrPE8JjdlOud5CMvfRN4HBWRB27oDmj1tbViF2wyy5LxdFsrUwUIcbX0drBKv+HrPHY07VNlz3sarvk2zgh0tBFe91Kf1aqPtQUstXyUy0SrNb/vC5M0QjKnCExZyom0J/onNa7sC4TZOaqiBo4cHPRVnqgwVLt6mbgg3ueCwTsW9pEcWPwUov3g/bvoc5BzJygNHqESFM/JtvzHI5fmyQOw3oZgqI2XqZaf6+IbIMzGDEccjeLEONnvKAzcGhoiPei3gpaUGrw4Uqh/0FCsO6JJZQjDKFtH6odeUn5Bxzzl44juhaNp1n7Yx8uAm+2MW6o0BgAVyvBG4QZnvHw5Uf0s+MFqW06ZfOkxHq67aGYdAv19ezLnJ8N7nqGMjroaMI59Tg==; 5:jWqE4JiQqsqMS3FUam0wtyG0xRJ/ysF9/UZZB8KPyhWKfKuk/cMMVXEYXwROTkcBYSlIFff1DyNQTN0IFFulcsrs3aTbw7c9cvMijcrStdZEwwz7FPdNVg0G0ml0MV/xddPIZ83Ahi5L/q54y6TfNrNd7xz4aGK3fRTsb2jXtBg=; 24:VlKzKD5d4RMZw0MN1I6Qh/Awa9Q+IXzybltZe9GoaKfMJJQ7KhmEFT6Qm/V6+QyeRZBJuuZ9O5FGscpDlXrTLt7CfxHs7CD1YarsRjCTT0U= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 7:uD5da2DB+sVYohI8Gamm7Nc5pQtRuz/LQK4D0dzDSiCH9WxO5nlszDCQjwKn/C6Y81k0lWjzlo3ry2RMQG04KcDJkD/NEDReDZtDlweRRVVVtw1CwddicgXxXDosuyYvHlkBhoTNAnGmUkV+RwYv2Oaz25/7fv+eYRseUGkKCEa/84KivHkL5uJUjj4SNhc+HSMQF5mGA2R5axNlXHsTl5NZKXPmwk78YPmLe157f/7HXQ3RVzGBFWXiyF3hTsFb X-MS-Office365-Filtering-Correlation-Id: 2893d871-83c9-47b7-b98a-08d5b08e918d X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 May 2018 00:41:06.0840 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2893d871-83c9-47b7-b98a-08d5b08e918d X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB3PR0402MB3914 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add bingdings supported by current typec driver, so user can pass all those properties via dt. Signed-off-by: Li Jun --- .../bindings/connector/usb-connector.txt | 44 +++++++++++++++ include/dt-bindings/usb/pd.h | 62 ++++++++++++++++++++++ 2 files changed, 106 insertions(+) diff --git a/Documentation/devicetree/bindings/connector/usb-connector.txt b/Documentation/devicetree/bindings/connector/usb-connector.txt index e1463f1..4b19de6d0 100644 --- a/Documentation/devicetree/bindings/connector/usb-connector.txt +++ b/Documentation/devicetree/bindings/connector/usb-connector.txt @@ -15,6 +15,33 @@ Optional properties: - type: size of the connector, should be specified in case of USB-A, USB-B non-fullsize connectors: "mini", "micro". +Optional properties for usb-c-connector: +- power-role: should be one of "source", "sink" or "dual"(DRP) if typec + connector has power support. +- try-power-role: preferred power role if "dual"(DRP) can support Try.SNK + or Try.SRC, should be "sink" for Try.SNK or "source" for Try.SRC. +- data-role: should be one of "host", "device", "dual"(DRD) if typec + connector supports USB data. + +Required properties for usb-c-connector with power delivery support: +- source-pdos: An array of u32 with each entry providing supported power + source data object(PDO), the detailed bit definitions of PDO can be found + in "Universal Serial Bus Power Delivery Specification" chapter 6.4.1.2 + Source_Capabilities Message, the order of each entry(PDO) should follow + the PD spec chapter 6.4.1. Required for power source and power dual role. + User can specify the source PDO array via PDO_FIXED/BATT/VAR() defined in + dt-bindings/usb/pd.h. +- sink-pdos: An array of u32 with each entry providing supported power + sink data object(PDO), the detailed bit definitions of PDO can be found + in "Universal Serial Bus Power Delivery Specification" chapter 6.4.1.3 + Sink Capabilities Message, the order of each entry(PDO) should follow + the PD spec chapter 6.4.1. Required for power sink and power dual role. + User can specify the sink PDO array via PDO_FIXED/BATT/VAR() defined in + dt-bindings/usb/pd.h. +- op-sink-microwatt: Sink required operating power in microwatt, if source + can't offer the power, Capability Mismatch is set, required for power + sink and power dual role. + Required nodes: - any data bus to the connector should be modeled using the OF graph bindings specified in bindings/graph.txt, unless the bus is between parent node and @@ -73,3 +100,20 @@ ccic: s2mm005@33 { }; }; }; + +3. USB-C connector attached to a typec port controller(ptn5110), which has +power delivery support and enables drp. + +typec: ptn5110@50 { + ... + usb_con: connector { + compatible = "usb-c-connector"; + label = "USB-C"; + power-role = "dual"; + try-power-role = "sink"; + source-pdos = ; + sink-pdos = ; + op-sink-microwatt = <10000000>; + }; +}; diff --git a/include/dt-bindings/usb/pd.h b/include/dt-bindings/usb/pd.h new file mode 100644 index 0000000..7b7a92f --- /dev/null +++ b/include/dt-bindings/usb/pd.h @@ -0,0 +1,62 @@ +/* SPDX-License-Identifier: GPL-2.0 */ +#ifndef __DT_POWER_DELIVERY_H +#define __DT_POWER_DELIVERY_H + +/* Power delivery Power Data Object definitions */ +#define PDO_TYPE_FIXED 0 +#define PDO_TYPE_BATT 1 +#define PDO_TYPE_VAR 2 +#define PDO_TYPE_APDO 3 + +#define PDO_TYPE_SHIFT 30 +#define PDO_TYPE_MASK 0x3 + +#define PDO_TYPE(t) ((t) << PDO_TYPE_SHIFT) + +#define PDO_VOLT_MASK 0x3ff +#define PDO_CURR_MASK 0x3ff +#define PDO_PWR_MASK 0x3ff + +#define PDO_FIXED_DUAL_ROLE (1 << 29) /* Power role swap supported */ +#define PDO_FIXED_SUSPEND (1 << 28) /* USB Suspend supported (Source) */ +#define PDO_FIXED_HIGHER_CAP (1 << 28) /* Requires more than vSafe5V (Sink) */ +#define PDO_FIXED_EXTPOWER (1 << 27) /* Externally powered */ +#define PDO_FIXED_USB_COMM (1 << 26) /* USB communications capable */ +#define PDO_FIXED_DATA_SWAP (1 << 25) /* Data role swap supported */ +#define PDO_FIXED_VOLT_SHIFT 10 /* 50mV units */ +#define PDO_FIXED_CURR_SHIFT 0 /* 10mA units */ + +#define PDO_FIXED_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_FIXED_VOLT_SHIFT) +#define PDO_FIXED_CURR(ma) ((((ma) / 10) & PDO_CURR_MASK) << PDO_FIXED_CURR_SHIFT) + +#define PDO_FIXED(mv, ma, flags) \ + (PDO_TYPE(PDO_TYPE_FIXED) | (flags) | \ + PDO_FIXED_VOLT(mv) | PDO_FIXED_CURR(ma)) + +#define VSAFE5V 5000 /* mv units */ + +#define PDO_BATT_MAX_VOLT_SHIFT 20 /* 50mV units */ +#define PDO_BATT_MIN_VOLT_SHIFT 10 /* 50mV units */ +#define PDO_BATT_MAX_PWR_SHIFT 0 /* 250mW units */ + +#define PDO_BATT_MIN_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_BATT_MIN_VOLT_SHIFT) +#define PDO_BATT_MAX_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_BATT_MAX_VOLT_SHIFT) +#define PDO_BATT_MAX_POWER(mw) ((((mw) / 250) & PDO_PWR_MASK) << PDO_BATT_MAX_PWR_SHIFT) + +#define PDO_BATT(min_mv, max_mv, max_mw) \ + (PDO_TYPE(PDO_TYPE_BATT) | PDO_BATT_MIN_VOLT(min_mv) | \ + PDO_BATT_MAX_VOLT(max_mv) | PDO_BATT_MAX_POWER(max_mw)) + +#define PDO_VAR_MAX_VOLT_SHIFT 20 /* 50mV units */ +#define PDO_VAR_MIN_VOLT_SHIFT 10 /* 50mV units */ +#define PDO_VAR_MAX_CURR_SHIFT 0 /* 10mA units */ + +#define PDO_VAR_MIN_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_VAR_MIN_VOLT_SHIFT) +#define PDO_VAR_MAX_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_VAR_MAX_VOLT_SHIFT) +#define PDO_VAR_MAX_CURR(ma) ((((ma) / 10) & PDO_CURR_MASK) << PDO_VAR_MAX_CURR_SHIFT) + +#define PDO_VAR(min_mv, max_mv, max_ma) \ + (PDO_TYPE(PDO_TYPE_VAR) | PDO_VAR_MIN_VOLT(min_mv) | \ + PDO_VAR_MAX_VOLT(max_mv) | PDO_VAR_MAX_CURR(max_ma)) + + #endif /* __DT_POWER_DELIVERY_H */ From patchwork Thu May 3 00:24:42 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jun Li X-Patchwork-Id: 907785 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; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.b="u1ojCIBO"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40bxCl4hwgz9s4n for ; Thu, 3 May 2018 10:41:23 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751785AbeECAlW (ORCPT ); Wed, 2 May 2018 20:41:22 -0400 Received: from mail-eopbgr10088.outbound.protection.outlook.com ([40.107.1.88]:31339 "EHLO EUR02-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751747AbeECAlU (ORCPT ); Wed, 2 May 2018 20:41:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=/Ebr2vReSgsORQtXglRx/bgrogdvJvvAQ+AcwyJ4VrI=; b=u1ojCIBOuIkUMR4lIxTkSlBfCvelUZVddLd+YKOXylzaC5J1xrYo2Lhm6JDtllXuiP/Jp/29HSfAlEr7tkdwXQRfkKPABdq9BauBKFLivpsmwbBOWAKaiSlKEXqt+dN4qwHsm2YVEnBgCIxGhNFAP2kG26bKbqptMjkyUUr/sK8= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=jun.li@nxp.com; Received: from b47624-OptiPlex-7040.ap.freescale.net (92.121.68.129) by DB3PR0402MB3914.eurprd04.prod.outlook.com (2603:10a6:8:f::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.715.24; Thu, 3 May 2018 00:41:12 +0000 From: Li Jun To: robh+dt@kernel.org, gregkh@linuxfoundation.org, heikki.krogerus@linux.intel.com, linux@roeck-us.net Cc: jun.li@nxp.com, a.hajda@samsung.com, cw00.choi@samsung.com, shufan_lee@richtek.com, peter.chen@nxp.com, gsomlo@gmail.com, devicetree@vger.kernel.org, linux-usb@vger.kernel.org, linux-imx@nxp.com Subject: [PATCH v5 02/14] dt-bindings: usb: add documentation for typec port controller(TCPCI) Date: Thu, 3 May 2018 08:24:42 +0800 Message-Id: <1525307094-27402-3-git-send-email-jun.li@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1525307094-27402-1-git-send-email-jun.li@nxp.com> References: <1525307094-27402-1-git-send-email-jun.li@nxp.com> MIME-Version: 1.0 X-Originating-IP: [92.121.68.129] X-ClientProxiedBy: OSAPR01CA0012.jpnprd01.prod.outlook.com (2603:1096:603:2a::24) To DB3PR0402MB3914.eurprd04.prod.outlook.com (2603:10a6:8:f::29) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:DB3PR0402MB3914; X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 3:VvFB95fonbb0D7sLurOnzWURMSMKsBAH6T5y1/O04kZWyWg57uMRi6afl7qBFIWmdxIqaj38QTWZkwCmaRsi7G8t0b/tT1AtY+qRifoWqO149Mj8F+JogiFwUt+U6FH5b0U9HOthOdYQOECwxXB4Gv7ta4HCfNxTcYQNKqshPK8fQJ55QVy6TcpxWyol2AvuM729uigqXIBJPI3n5Z+cLk/xqJ4Wa5Ny8iKoCt4zkHTnadgPykUOjHe99pODvg0m; 25:BVNSd3yjy1l9WuI8Iolxq98bp5/dhrVtorWDZ+5Ln+mwZCUjzra03rhQmIs3bNNBHK9zrt0NbHeucRdwL0gYQlPcrQWHZ3GdlFFgkQArp6XSEgDSTPoVBcQwU5flksuMFpPEwHBNlwt+4X+Z2Bwoybm27GFVZYCp3bRjYvc76dTEjT/xWIFQcwMI2ZHRLINPrffhzQgdhyzpdIKJxaM0cQpTnnTX+oaC5ovAqDMMQ88/C5wpvzmhHSurbnNKY1zPShV2XmQSeqIXtkwEOkWYxPREiDHZnY4vV48xvWYE85djIychiQVmTkoCQwEmFk7Cs9Z0QmCa5ZlMCVIza2J3kQ==; 31:TroN3HNdR4nL2131RL0XcXpBZotX4U5jtsX64J/AUrA1Vm/kZLiZybtobS/H2iJTQNkcl7+uK4SNy8QkzGMNO5nRAyZr30f24xKUyXSjN+ILmP0CWzac8gAsdaKyRRuWIdLCrmppvsZ+pZqoSi1M2uLngv/9HIJ+dKegXQbkcPt6vBgcpBfNgUzwmv86o8r5fquQtGJRBFzMr7TJahqe+XeUoziwrYXTqSV7VqqPedY= X-MS-TrafficTypeDiagnostic: DB3PR0402MB3914: X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 20:D7ELUleTgR2e0TaL5mthnAesyONAUi0TdSOQritCm1yFakwPU9k8dxMafY6tZNTIORz6xwaEk01m6pibok4gmHgi1CTzHIia0B1/sqVGK1DfLywKp83+q1hcUXzSB14NZBsnVlynrb8MC8YIfodqXyaakSZetcQB0WmFCbzTy2/AgbUmay3/d93IkaNfUgxB1fjDjtRqAAZVpwxX148qm68Ufvqrl9JMZXncS1d5G2Pxtp35r/FBGLJN3inFJ2/+qdxKkpAi4L7FnybDur01Lf+BkfGgqcQdPHCZ2Xv9JjzRO61Gcoe7v+MxzcyIcbvFHWN0HRUrOZz2m9f8Ygp/R+I+r57RFllWA2TrgAnpDY3bR7bvr+l5pc3VTxX5GlfuNmyG+uePHGEOMu5k7Pamlb2cgZILL8FGIgImUxg4E5QSQPKTGnQOGpf3VRduCWSt7sBGR17RsthET0M9c6VhFLx55bG+H1sweRVQN3fE+IVflvz6CZ5PskYLi4FqsT/f; 4:m1fnxxJ/pxe2Zqiw0RaZZQSnP6/OwzNo9SE3M3pzdxChUwJf5goJnixDTnsP7N+lLnuk8tym0wO44I/qzGfNqVtbSkbSSfyH610Xb8CVyDRWcnC9n6MJeJ19wMzgPEeUGVOThMBHM00RS0myyW6d3LWx0/eRJ+0rQI+1ZJXy55B92f4sw2b0ILnflPkvQ3r9kB64wQND7eXxlvm/SQU4s0ZfSxwp5UbPMVMVHmUfTNfFkMLvgGOfJVlGql+cgMMqggtlBTHIw3Vy+gxqy8xXBVoXs2pp7Xw3/YT7H6Pa/GHeMpLPZvMx4jSNJJX1OE0f X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3002001)(93006095)(93001095)(10201501046)(3231254)(944501410)(52105095)(6055026)(6041310)(20161123562045)(20161123560045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(6072148)(201708071742011); SRVR:DB3PR0402MB3914; BCL:0; PCL:0; RULEID:; SRVR:DB3PR0402MB3914; X-Forefront-PRVS: 066153096A X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(39380400002)(376002)(39860400002)(346002)(366004)(189003)(199004)(7416002)(47776003)(7736002)(8936002)(66066001)(305945005)(106356001)(2906002)(5660300001)(6486002)(105586002)(6116002)(3846002)(6666003)(81166006)(8676002)(50226002)(68736007)(81156014)(36756003)(956004)(2616005)(386003)(16586007)(476003)(50466002)(6506007)(6512007)(97736004)(316002)(446003)(39060400002)(52116002)(26005)(76176011)(48376002)(4326008)(5890100001)(11346002)(486006)(16526019)(86362001)(51416003)(53936002)(186003)(478600001)(25786009); DIR:OUT; SFP:1101; SCL:1; SRVR:DB3PR0402MB3914; H:b47624-OptiPlex-7040.ap.freescale.net; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DB3PR0402MB3914; 23:JTy6GyWhMWsFsIt2lyxSVek6t2x6GLNxilY2sbG?= 97Ydt5AlTrCt+TX7I40wmy62+GGzdox7U35dwO/9mOctFW/Cqi8THwS20TPV2uF4CeZ1pFeGI96GAgGAAg0nX2UCC7HbamO7H7R9fczJRZl9/cFVwANlGhtCxeQHJHtQ/HGIE/F3S2yfIHQLj1ef/LZJb4PyuMC+ILAXMotWWEDQLC3FIj0UnyUcu1IRtW7Dp6N/ZnVqdS4npoTEm4HhmqhYTcsva6YAiR2lucGtPtFU4a/QhZop/G7lDAAm0S/wb5tUtuNpiJYOtVVeYug0oa0MCxAbrV+wSz4ohraa2L/FofvZjrrCz4HrvL/LdAoXMePx5CanDLp0l3tkPJx+d1oD3Klk8a3O1FTy6ypFLV9ZiSuxNdixNS3wgmyCv/NoTc8DyvQiaZuhyTfJoZ6wf1/OJOguahAu+uDqwFsb8+m2AVChif3+ps3Uqt8WrFxMV3mHbStPccK++o/1ZPIw3VngCrQ9nz+pO8dAyQMuARxHzgCoP+7XmVzAMTUW009cFkZTb0jTACxemp0tPIgPVaP3IWOUwBVG0OVO5tjJwsKRKWMMuVwo7QXzJFpOd5sGrPnSYw3XdXwH6hNjb+WNX2VEolt88u9l+96HhcVAd5ESntEB2YiwOk0LbTGN5FnrfVxWRcqbj0iMFjB5vSCdsoscWcw2nBk3K6HJ9rY47svbO4Ruy0Sd+dop5LrC6yX3C5PQPPvIJix7KQtp04JpCQK7WuutraePGWyyKh3c2CX/0I+0OklXowiCNh2mqwDBwLp7yNEICwjFtissTRBT0JLe0Wzi9+hcBBeGShj1HpC+fZ9Ii95RxjXfuqmaQAwMjyh2M9/JA4WMN6UnLhtLGgpq/2LJZH0YkuCm+yWmhOALH5LCc8/Se/yqj6tohX3W1mM8oeoRqkpz75ggcdCN635Z8SFdJUL3hOiN5a0vqkRYlUedr1rhOl32vSgWjoqLKJULiU0EsPSWE4W80kmv6bbZCoV7rrjBqCKw/3Tq/wCr5/AcgwIW1EVuvsAibciOcjxi3mw/ZT4IcA8BAbrjMH5KNmp5qzFo6iwdFqrJo1fETbbsFU4zUcaiKo6u8qCh31Bh+cIEOWY3fUaJI+yPd5UJCXXW4xIMSyUMg7MtL/6youdWX/93JHhKpc040lLMntHU2IWFQl2jsjZ10TrqiWQxgcr/27BHt7ru0Wky/WCgzjA== X-Microsoft-Antispam-Message-Info: TfeVHKpK9RXhdsFqjSsTM30ANN+qoNSC6OOin4g2EJYzd5eXhUOGz3tGKc79++ENhe2La2m0RkE/XMdCXc/oGRvXTW4Qq5groARNEtrPd6OdyRWPOHervNBCc5VlimSijvofbsEKHOfb/kRtArnbvuMSmZiRxFnUrcyxv3JoLoQr8S3sF5+zJPSrM6dBhWm/ X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 6:dJtWWVzTU0utDtnCHHalkC8klR0AbZ37hKVSkrA2EFqlbghjynK84MAw3jOViNUPjeGHcnjrb0NOSLZh6w0BNA1MB4ai1qEPbx7RpNVXHxJhIu6SiMlPMK2kpj8JPJEINZQEnC4lYG9shLBHw+iXJONnZzP8IlmBnfM8A9rszC104W8XuFdTbYrvNRrp27KtE1ddJurGKUsVDZ26BT7plsQxgZoS5wohFxTohSFGeIRv4SVDGD1wQCm0ZDtXsTw8kj+8OHTV2+NizZZ97prwG+pr5pItoTVBtRIS4Fgmadh5qG99+x8E82Xu5KOzfm+FJ7rMC9iFemmQURqmIh1fLQ2I4dAeArR8aY6zWdEpenyIAngvfCcDgpC+To3xlfM84gNvmzYhsIwagcsqe4y8bfgh59UFL51u/1F35PyGbyUv8PrfP45G1QsoGACD3vSpcqL/zScw9+3Lr7kpPgK79w==; 5:388kSfmmBEK5NkM1yxVNhmRpi2dhEkaOZ9nTk7KVeTrSFr7VVeXH60MhBocKDES2WAyBLxyEo66lZ6Kfax1Shaa4HwWjrcsrTTi4lMAGNfavnsCVXEZjNZS9x4Ou+htylCLoOyLTXvSlWlNnPyPlonbGFqzzAPTZjOz9+g5jqdY=; 24:eWjY1xZ+7FpH+LAvuP2Eq0yOnt2jb6cSUX7kof+1pzTSzTxDJaZKpSU7pprsJ5GZTPcuksbm1ixnTTvZ4AfSX1+WbOjWZfHPqBOxfKkGknw= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB3PR0402MB3914; 7:CdzXfiDtAAyaA5tWRy5VL9DnXRZbCenUYO+VCHcSDT49Zdm30LA9QsD6s2A0PGgyH35Re0j/jYticIbb7dCu4Ove4ojKWOOXWfP2RFT1BQchqdQ9N9wc4KRkWqtZKzWcCKMoZOQ7/Hx6kdUQEphuxhbrLXrNu8cjqk3Sv2uzk1//+T1iDbT7gqOcPHGkj4BBC3cOPkkDa8PTkZGnG+eyXoD/Rx8t6/I3r4bEj+FZXbOdYhnXUdYO8kUDFMtQLfXq X-MS-Office365-Filtering-Correlation-Id: 06ab370b-c33e-4ba1-cc25-08d5b08e9549 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 May 2018 00:41:12.3497 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 06ab370b-c33e-4ba1-cc25-08d5b08e9549 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB3PR0402MB3914 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org TCPCI stands for typec port controller interface, its implementation has full typec port control with power delivery support, it's a standard i2c slave with GPIO input as irq interface, detail see spec "Universal Serial Bus Type-C Port Controller Interface Specification Revision 1.0, Version 1.1" Signed-off-by: Li Jun Reviewed-by: Rob Herring --- .../devicetree/bindings/usb/typec-tcpci.txt | 49 ++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/Documentation/devicetree/bindings/usb/typec-tcpci.txt b/Documentation/devicetree/bindings/usb/typec-tcpci.txt new file mode 100644 index 0000000..0dd1469 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/typec-tcpci.txt @@ -0,0 +1,49 @@ +TCPCI(Typec port cotroller interface) binding +--------------------------------------------- + +Required properties: +- compatible: should be set one of following: + - "nxp,ptn5110" for NXP USB PD TCPC PHY IC ptn5110. + +- reg: the i2c slave address of typec port controller device. +- interrupt-parent: the phandle to the interrupt controller which provides + the interrupt. +- interrupts: interrupt specification for tcpci alert. + +Required sub-node: +- connector: The "usb-c-connector" attached to the tcpci chip, the bindings + of connector node are specified in + Documentation/devicetree/bindings/connector/usb-connector.txt + +Example: + +ptn5110@50 { + compatible = "nxp,ptn5110"; + reg = <0x50>; + interrupt-parent = <&gpio3>; + interrupts = <3 IRQ_TYPE_LEVEL_LOW>; + + usb_con: connector { + compatible = "usb-c-connector"; + label = "USB-C"; + data-role = "dual"; + power-role = "dual"; + try-power-role = "sink"; + source-pdos = ; + sink-pdos = ; + op-sink-microwatt = <10000000>; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + port@1 { + reg = <1>; + usb_con_ss: endpoint { + remote-endpoint = <&usb3_data_ss>; + }; + }; + }; + }; +};