From patchwork Tue Sep 26 00:45:18 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jun Li X-Patchwork-Id: 818449 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" (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.b="nGzUb3Vt"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3y1T3f4btdz9t2S for ; Tue, 26 Sep 2017 14:48:14 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S935119AbdIZEsN (ORCPT ); Tue, 26 Sep 2017 00:48:13 -0400 Received: from mail-eopbgr10077.outbound.protection.outlook.com ([40.107.1.77]:12416 "EHLO EUR02-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S935062AbdIZEsM (ORCPT ); Tue, 26 Sep 2017 00:48:12 -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=t8+EQyh7xW3/7bPJoTqtfTAvc2UnjiHHQ0Kj6tk5xaA=; b=nGzUb3VtTAxfp9sabYY0y4Y/b2ZfM8kJ8W/zPpOFNlDd1WpwupH2OgUXzYEPOZUm812dOBZEGUDor1Nj5/nWCdPWM5EBxV1YE/xniYUiMCUPkHQ4SUg8kpsWFRY9CUJP4tvaq2deLJ4EPucuNUq5puSxAsdEQ1vAtF2qCVmZXXA= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=jun.li@nxp.com; Received: from linux-hcu8.ap.freescale.net (199.59.231.64) by AM3PR04MB0760.eurprd04.prod.outlook.com (2a01:111:e400:883c::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.77.7; Tue, 26 Sep 2017 04:48:05 +0000 From: Li Jun To: gregkh@linuxfoundation.org, linux@roeck-us.net, robh+dt@kernel.org, mark.rutland@arm.com, heikki.krogerus@linux.intel.com Cc: yueyao@google.com, o_leveque@orange.fr, peter.chen@nxp.com, aisheng.dong@nxp.com, jun.li@nxp.com, linux-usb@vger.kernel.org, devicetree@vger.kernel.org Subject: [PATCH 03/12] staging: typec: tcpci: add documentation for tcpci Date: Tue, 26 Sep 2017 08:45:18 +0800 Message-Id: <1506386727-16370-4-git-send-email-jun.li@nxp.com> X-Mailer: git-send-email 2.6.6 In-Reply-To: <1506386727-16370-1-git-send-email-jun.li@nxp.com> References: <1506386727-16370-1-git-send-email-jun.li@nxp.com> MIME-Version: 1.0 X-Originating-IP: [199.59.231.64] X-ClientProxiedBy: HK2PR04CA0056.apcprd04.prod.outlook.com (2603:1096:202:14::24) To AM3PR04MB0760.eurprd04.prod.outlook.com (2a01:111:e400:883c::18) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0db7234e-8c3f-4e8f-76ef-08d50499c956 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(2017030254152)(48565401081)(2017052603199)(201703131423075)(201703031133081)(201702281549075); SRVR:AM3PR04MB0760; X-Microsoft-Exchange-Diagnostics: 1; AM3PR04MB0760; 3:YHRstCRdHTYQqzvZY7Zd1EMYAZ/Kgc8YCRaRkY1A9NKZ3BEa8QOJfBqtMwa9vFKRYyg9IPiGyOLzRc7d4xXLT7jW9ENp8KD4uFH6qmhikv23I3dLfHbLV498zuWnj7zO9L3CQS7wbba0+DqRyV/DPsSdJ9vAGzYQWouMz5i6QMtWIWoW0HoHf3vkkiDGvFvF3BlPTwyaziA22eoiPNqv5gHzSHMfL9HH0/tWUermlKcUzdWnr5JUDmG91PAkT5BO; 25:6YJmwUGQmYPuPsn6ZmQ/Z3q9ODYd3Y3x+t9aRnG6hy2iLf2u8KGw8S4EvmmLkd6DJ7j8XFDJcWce7KdWrimNkJHAwwrEu/O70b9/9uidgvHJJBpp5ucqKOLk7wFH3XA8H2zVPYkVihdQzWdij0+gXVSFXVWRN5ToTsoFmofzR1D1TGtZtqdqEk66lS+lBOmvBb4ZDIwzNBOr9RLhcqST+HGHou9YOrPdvclk/6VUOpb0SeZxCWv8pG/L8WLvUUPJUWgZA8hCZRfO6uObtjYPx46Axg/JLSvTW/T0lf7YsDLwRhzVIn8G6ARPpcntXq6qBJO68H1zr/o+yNhjol5oPg==; 31:q8/W4m+qURU98Y1Te+WcQupAg/rWzKZ0te/rXsAg7LmiPux8hUAiPu5w/0hWVGMqhHlAug77iHAcHweRcO+C4MbNGEQeZjjIAIZSTzvgXX9NOgbr+1D9EwYEzE9SRMizdws1g4vlwv3/BFY1yquuF4VHz3Tl1BCWZkAMF5tIjUwyh++LqlDHY5tHxbuP1rj5zYji94SFC6A4lBI9lzKWITSESB40UWy93jMKW3Hv0qM= X-MS-TrafficTypeDiagnostic: AM3PR04MB0760: X-Microsoft-Exchange-Diagnostics: 1; AM3PR04MB0760; 20:5GtYYTWz3nvfYKSog5DP17Jocx1oa1PVXsF7JSl9HTRT3ubab+Vg2tJ+bqMxBroOJuQ0hAl+Zlf13fB53TwFfFWq4+sAnrCRFO1uCZfypdeYiqxVQgEpT6lNnCnFPGCOkxuAKf27R2MTNzzRDYegqtAyke32sC7+OB1WK9G+ibiyBQHsbyXgJiqrCjGh9efzsI8cTDNbSXvQBJbEGz5NWk1aim7qsuM1XtbTi2X2PGJxke94QVteaxWzZRg4rhjgRCloPvN8JsLZToVADozVG6HPft0f4INMlQp21fPfXbWuMzYknCmS/9mb+VRqWWAXcO+ENPlm/Wf+3HnMcCRZnUPujyFt48lXeg8GnzV+Hvc6gOyhPK0U85bEZJ2f6sRghMp+h9GerdUrDQIwfl8DivrluF8UMvecczJvog0R4G/YHMa4q82DkNkZ4H9n0o2CPIxVFPz3FfYRhfl/iUq8NoT3vavmdsAE6wqfwSJOP7s6zt29Ph16YXZwc4pHjqVy; 4:JpwO4XaQ6FdKJmcK9UMhhNwr11wmyYnNgWTmVHnlExMZ9MkhyGD+I4Y+b+jbV1YXByhzH6NDkkE/3u5apLfV9kkoHSsbl0WnnMNUVaHRIQ75jqMF0ozu/z2V+t+aVgebBzt2+lhgZb+xb9er/DlmhU3e2VOkK8kqXNjnbE2tmri2/WLcTasDxk280OPK8vXnZgWZATrAf6SkCvUPzn8A2d4yzdwEWOKggauJrDCyZ6WG88tGT9TL9oxt0A468RDfQkr1l60+6dWoNMf7k1DRW8ktJAGIfZ5nscxt5G7rLVw= X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(8121501046)(5005006)(10201501046)(100000703101)(100105400095)(93006095)(93001095)(3002001)(6055026)(6041248)(20161123560025)(20161123558100)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123555025)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:AM3PR04MB0760; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:AM3PR04MB0760; X-Forefront-PRVS: 0442E569BC X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(376002)(346002)(39860400002)(189002)(199003)(50226002)(189998001)(316002)(16526017)(68736007)(25786009)(7736002)(6486002)(86362001)(6512007)(53936002)(101416001)(105586002)(2950100002)(81156014)(76176999)(305945005)(6666003)(8936002)(8676002)(36756003)(81166006)(106356001)(5660300001)(47776003)(5003940100001)(97736004)(3846002)(4326008)(6116002)(575784001)(6506006)(50986999)(33646002)(16586007)(48376002)(66066001)(50466002)(478600001)(2906002); DIR:OUT; SFP:1101; SCL:1; SRVR:AM3PR04MB0760; H:linux-hcu8.ap.freescale.net; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM3PR04MB0760; 23:VhoDQq4kSz+Bqi4wnvQmh/VPhiCRDnd9XANGN/yiY?= h8PyDToYxYJgRFTkLY0q72hhFC+CRGReaED7H2XF6YdWWdlwdoH268dLepeAZyybapQJqZ32vXUMNHG60uXsLOfvu8pQvezifJlpJxJwS4y+2r3d6uftYf7yD0aIpmVEcf6zc24grtBR/FoHTahU3KzabziXURleeSY34yfC1Z5KYF4cRvkmyJ1YXI0KM5akQfrifTE1cYFwPfYfJOHbectQDuOhYvzevMru10os/x2Wei9TEkv4ats1pMk/B3s2R/H1KTf0ZU7WckW17Jd7TttyvJ1pYP/6m2fLrs3HblGjCjTTZPxL8RjshqWrCZD6zeoVId1/4zoJkv0MBzaS7dd73dxytzlcTDNRV7C3914mpL8t7RFXMIrHe6eg0x4qy9LMMCXzNuMhmgvr0BJbOSLmdLnisl2/MEyMTyXEEr29A1aj5wtjC7zjH5YnGz/EC4klehBntSVqlLfU0q3VjFmS/ZRB9uVC4zHN3Jwz2lsN2capt/GMDc581KCdbNt3OdH1Nxqgjv8jvZ1lrnv5ji9hfR0RVmsUCY7vmm9F7PkED47RoF1wxIP7gbpv0Nj3LkL5ebOLMTjminflpD7cppCo/UBkd4fGb3CGVKEIGuWZ62obc7cPjksmuQXquj0Y87JLCsXt/7Vs9qVghZdb/J4ooi/K25GTVNk2rJ/JuAi5OdFq5FMXWoIgeW56n1CPECv3IrxCu6WJuwHYKLj2S6gBCrUOV7NJI7OAU62fxgC+FbbRWylH4q1DOdVZXgtGoyZsqQgTVU5KXwW8P0J7GKdTy2oPY7cH9RCWm5r1miCmq9jKs/y0XpAr0hQ+16Oy/9zjkwZWoLiVPd2jY6hBz8ExIvq3ixAWlDZMhMqRo6KMvZEp1Z8/lqEuydAkD0U3S+aZ7n3K/mxeDpKGubPGx0c43hn+OC5gqVUVagKvHTR9vhQZTVTRbr5MxvtZq2i0E6acqGyt5V7HTNHMXnNTy2Efu2WQjcXlhMzunXfr2PAOyypX6Ah5GozIPGS508PU54XVTaNhwWo6Qo7tIHZCeWyGzq8eKDxMOg2fN+nyy/p9w== X-Microsoft-Exchange-Diagnostics: 1; AM3PR04MB0760; 6:crGAtVthRLoEnmdGy3ocr04LkZNTOXMEZTWdwwNCI2Z8tSFoh54X1Rl3tjtz9T69FZeeTW0uQcDbdeCMhMD/FQ+6o5JYu0kL9k0+yEEVym0h1saexmC5j9gYDnYE39kqMfsVhFPGUgco0miM/+EGHIcI2sqUy0YnX2oMkv0+F8NhRyRa0Su78cEfGgt7po3xugmTdCteGZVv+TQQV3aeyewxplCYh4GMU2R/VIfW3+M8ureHBiaE5lwAaEcRJ4W8gxxXUVQIvk4fbim2VLHNwRLV/3XYFvd5AcWmRlb6GwY4teF0K68MLXYKdBKZ7DLFYbGDZurI3YUbHXDD9jsz4Q==; 5:7OxEwIbqz3cWAL4ZpDMLw0/LzTK+82vIzbwdaWT3+K5YbxUvtaFnFRK2PSyPcitju2OoyGoLYqwf8fC+ptubiQTdC5ot0GYcpQB5WeazkHlLpqOUuDziYRysMvWsB6RBSbdlJhrs/dHBmHh9ZkrQvw==; 24:+E0ZZ6X5LbbrkxpdRUR67yf/YPIchyaUoxrvZUgK4IhlxIALoNPU3kkwINyam5iTfVf/p0ga8MqRWR67Q9BNkw18bNV1AjS/m5K57mYrxQc=; 7:Lxa6mAqySC6hJ9ZmStciSCJS0ghdOnw7Mjlm1Zi6GqgiokbPGnDpg9lMqUWKkZFdnv7CjaZ4Zaz/TgEknmwdVM0Hnfpt5fb5BkFu5wUyg+2xpL8FaO1X3HcV9OIipj/M0YkuyA1TxvHrZwyUHL8ztACdjPDutW4bpJiOKL1hG6QOD/9kXbWtpLji7TDlH5R6gJ6Zy40vdEL5I74D7f0a1wk5mfMTVSgO30ASdA34mmU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Sep 2017 04:48:05.2031 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM3PR04MB0760 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 --- .../devicetree/bindings/usb/typec-tcpci.txt | 36 ++++++++++++++++++++++ 1 file changed, 36 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..9268440 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/typec-tcpci.txt @@ -0,0 +1,36 @@ +TCPCI(Typec port cotroller interface) binding +--------------------------------------------- + +Required properties: +- compatible: should be "usb,tcpci". +- 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. +- port-type: typec port type. +- default-role: preferred power role if port type is "dual". + +Required properties only for power source or drp: +- src-pdos + +Required properties only for power sink or drp: +- snk-pdos +- max-snk-mv +- max-snk-ma +- op-snk-mw + +Example: + +ptn5110@50 { + compatible = "usb,tcpci"; + reg = <0x50>; + interrupt-parent = <&gpio3>; + interrupts = <3 IRQ_TYPE_LEVEL_LOW>; + port-type = "dual"; + default-role = "sink"; + src-pdos = <0x380190c8>; + snk-pdos = <0x380190c8 0x3802d0c8>; + max-snk-mv = <9000>; + max-snk-ma = <1000>; + op-snk-mw = <9000>; +};