From patchwork Tue May 7 20:43:03 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 13657798 Received: from EUR02-AM0-obe.outbound.protection.outlook.com (mail-am0eur02on2070.outbound.protection.outlook.com [40.107.247.70]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0C92854BEF for ; Tue, 7 May 2024 20:43:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.247.70 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715114619; cv=fail; b=PFBoJ2sOu6i3rSwPWYdSbmYgLniPlH4D2cPzCkf4VkQO1NUcGYsSvlWowob6AJ1U6UJJ4a0rLjSIuc9sVsRXndi8fgHqk5xt0oRWX6djK7rdEuER0LvsofKPTIL47Nyu7dXhruSDMZFE5ivOW/oJFhFdhjYDnzaL1uq17Yuen8Q= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715114619; c=relaxed/simple; bh=hc0vWKzWBYmTQPNA0uhujkmwegxnId+yCijUqEvVwaI=; h=From:To:Cc:Subject:Date:Message-Id:Content-Type:MIME-Version; b=hjiQtt9z3XRVvDuZyZjAOqQtQbdLHWJK/PuAKFL42uGxc2cffh5agmUCSV5ebIf4E86kq9jXQZX1M/aZ6V8E8LPe4FE1pfsakAi1W4/mFBNFHhygSlnEn+RHkfbfnj5hf4N8B09EIxHtvc4Aw8Dy5c7O54jdYsSyMMtNFw0B0WM= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com; spf=pass smtp.mailfrom=nxp.com; dkim=pass (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b=nkYxF85O; arc=fail smtp.client-ip=40.107.247.70 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=nxp.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b="nkYxF85O" ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RniAJHX9QAXk12uEk70UXS3AquGgMbjS2OjpfAuUCeLfGknyb3psHUx3hu6ZAQf8Zeh/iIgiwS4EMjzjQkHeOdSRQxHNfCQkaig+/vsSbgdr2n2wJ/dUcSojLpHLzJHVp5Q7dwQf0UMZ4WI5F18hUHEVv7DK6Qbk+T0EWovneenpS2ZDwD97d4/WG7z3qgZjZClKqgDq/fzqin16kyagyk+kUb4UHFGBDZIYMbyttCgpFkfWdclLrjUh5q6WiKOP873tWXlMXPTR+pzqjRIcT63ekgFCBOAaqf4XU4oWxcZh2RG4/h8qsOoNI/vQn8nmwvplzfRfZzcQ4sfXfwx47A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=qV44oIZVXxGjMUN038mXUA0fEvu2yZSoG67eTDt2HkM=; b=H5oyecKKb04h6ohmk/vTXpGgiYSfdu7laDUQ6nXNdSCkdv3vWx8cxAR8J48jE07it2K8zEnSGfgnzotGQ5fG2ylwJKMnLBCceRBSoqu36nsfSRhTaGCj/Vk8ll+N0NKApULZCtBxbNqrcZPtUqpmpt1MeCCCEvuWHc548oJ8P86lrxbpmLfwV9qSG47S/zFX0v/JXi5wwzUA8r03Sx2IM/NRcX0ZRDDSeMQwbKDcABbd0iRceErQZGQTJyXOcOBkUF0FwyhVxsMtCQgH+sIhf4cGXf1VnSNFRiZG68xKIo3KmKgwnIwmHkbcJZFY5V7G5LVmNnRP3tTab1wDOvvYQQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=qV44oIZVXxGjMUN038mXUA0fEvu2yZSoG67eTDt2HkM=; b=nkYxF85O2rB0OraZTKk1jzDTZJtMNkxG2MJ6kTsNbBOf+kjZcSKPYX4iyeQWM3J/zpOygsiVyZrg28yDYkF/Xr9bW7eJk2SxCvbxhbZKn/+Leizf2W+3ka/RBuPU0FiMgob0R+qFrOTQ3WUfg1TzrE6/JwO6Q44JXC43LqsiOt8= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) by PAXPR04MB8576.eurprd04.prod.outlook.com (2603:10a6:102:217::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7519.34; Tue, 7 May 2024 20:43:35 +0000 Received: from PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::1e67:dfc9:d0c1:fe58]) by PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::1e67:dfc9:d0c1:fe58%7]) with mapi id 15.20.7544.041; Tue, 7 May 2024 20:43:35 +0000 From: Frank Li To: alexandre.belloni@bootlin.com Cc: conor.culhane@silvaco.com, devicetree@vger.kernel.org, gregkh@linuxfoundation.org, ilpo.jarvinen@linux.intel.com, imx@lists.linux.dev, jirislaby@kernel.org, joe@perches.com, krzysztof.kozlowski+dt@linaro.org, krzysztof.kozlowski@linaro.org, linux-i3c@lists.infradead.org, linux-kernel@vger.kernel.org, linux-serial@vger.kernel.org, miquel.raynal@bootlin.com, robh@kernel.org, zbigniew.lukwinski@linux.intel.com Subject: [PATCH resend v9 0/8] I3C target mode support Date: Tue, 7 May 2024 16:43:03 -0400 Message-Id: <20240507204311.2898714-1-Frank.Li@nxp.com> X-Mailer: git-send-email 2.34.1 X-ClientProxiedBy: SA1PR02CA0018.namprd02.prod.outlook.com (2603:10b6:806:2cf::26) To PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) Precedence: bulk X-Mailing-List: imx@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXPR04MB9642:EE_|PAXPR04MB8576:EE_ X-MS-Office365-Filtering-Correlation-Id: 44a393d1-542d-4311-1d9a-08dc6ed65d71 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230031|7416005|1800799015|376005|52116005|366007|38350700005; X-Microsoft-Antispam-Message-Info: =?utf-8?q?ox9uinRoa7ZBa6VOuBwDqffnyw9QwM4?= =?utf-8?q?vX9Er9VOmkwfBOUbppdyEiNGgXiAXUkIU4i0AX6LrbxmF9j5dRZLNLIP74A0y6Lrh?= =?utf-8?q?TgcwuUWCStWvMnDH2tE5Hrav72mznnkK8gHDhw/F5qFFzwVQ9nUDRnQYFgyUJauXT?= =?utf-8?q?11s/pmm3QDRJDbdpiaZbCoCLEPwIBq0R/sPrc09qunSAvEwyoeiLesYjReeOETJX2?= =?utf-8?q?4VTPzkauOXxR5LYSou9x0WgfnRifKdRsqx9XiPXBBagTpH5RWtG176WmbezsQxEmu?= =?utf-8?q?oYjN11LCFbeeQRpXyQR7cfb9BnK7h9LfPiGGBRvKmtOMmq4w+4qjquLalJNzvTxtJ?= =?utf-8?q?YX20euUpqpgAsMpnV++287mcBYiYm5ZFxoQBq2jVwbfy/tPxAUy8Pj13hN6t+q4QZ?= =?utf-8?q?Lj16t2iZVCnGsMh9GmzNoTmVPoS7Wy4pz8pBvE42zZS7xkHDc1rxT1i4VFTcqHU2E?= =?utf-8?q?xsa1MTGFNj4WTwyIeqXdID7NZg2JRKO9M/I1Ytz7TZucXjU6Jc5uMLCwDtoiZM+DA?= =?utf-8?q?zOYRgfr7S3ol5f889lu4d+MB6juY+99DY1iI0CtQaVhOeLeZiVsO7EhnPr5kbJUd0?= =?utf-8?q?NJN25vmNt6NKU4p3O/yxuzRKP2Ol+wbmlhRkXV9sJTOpzxy7cVmWWd/grWT6UStaA?= =?utf-8?q?SsEcmVeAeoOoGaUXBDnmAQ1Fr2+WsUpE9Yto0PCP3+Kg9S4PSPtS5or1nCrWPzRFc?= =?utf-8?q?i/xvP2M07HsEkDfdFv5N5nAfvwjVlDe7pwm6fn4zZwU7MKERFYpxUUp6G1MXbL7zl?= =?utf-8?q?8imi8Wx7rmvxl4A+1AU+kFDUeLGond6CKAvf8NVQhIm0tT6IXAh2INWk2vH4Pl+2S?= =?utf-8?q?rMeX5Nm8lCKRF1b/unfvK+Iu3ruQo77/t0pSl2jfBXC7fQwR6zhY6+KJL3PDFSwjH?= =?utf-8?q?/o5kewS5D2XaA4jyZRuodFxc5jqPdaLOvIpo9gMEXDGwQ27KzQlC0WQGxPTx8EUFt?= =?utf-8?q?QL1VCqH5LcEt/NJmKwjYPdU4LsopPncAU4ktJ7CcnOcu5DYyRnw0ca5jJ1MYV/YJl?= =?utf-8?q?seiwj7gr5NQ1OM/a9KiceCT78JmL/8JVBmBsHDuUSbuG2pFIOsBdaA3gfr2oGLvvX?= =?utf-8?q?7F9wtAP21kDzfMAjdgHuH5bptgORT1opVasJVKJl0ws7CjfqvyLlWwx7I6lgwurMY?= =?utf-8?q?xjI/B3iL5HGbGGqlEHriVKDs0ejv8X1kC5+L5yxyw5fL0AmjHrXz/ddqQuyg9mL6x?= =?utf-8?q?KTclVENHZo4zSUzqXKEst4s/D4H+SFUP2VrFhWyt0g1FZg2atvxJr6qm2QPtcB1lx?= =?utf-8?q?nbP7J4HuPXxnq?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAXPR04MB9642.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(7416005)(1800799015)(376005)(52116005)(366007)(38350700005);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?kCIhZVLYd/o6ivt1zGkdnZ3lVZYS?= =?utf-8?q?4PFBOmxmXWvPyqrUY3ewLOi0P46za+fRQ0hm2pNbZfLUEi5aLwyvYa3PIHSgTPNos?= =?utf-8?q?5VssWbtnLVbZ8ThltQyDM7kJ+9fzD1DNMxevyhHTCv5rdBbWhEr8MzM5vPeJvUW4n?= =?utf-8?q?6eZEhWsljH66D9zkPZVFDYS7/dn3W6YDCNltc1S0jDfk6FnMz2JwZbkZugD6rarMC?= =?utf-8?q?Zo1Oqgju1CHX7ayalV9eLbSLu+EjMF8Szm5F0KQ+Gb5l6Q867KlujZRg9CHoH+n/9?= =?utf-8?q?vEyr3ljdAO6bkZtqPKrqaSvtWni+5lLHQI9E0UtlZSq0U69Gad+UyHsAdfY9bu+Zi?= =?utf-8?q?4L+z7KkAMumiX2R5g5Pi1lSqxPS0up4iIX4QyKcgReRjx+38XX8H+gvQsbho6oMzR?= =?utf-8?q?aNhYjZFe8L1nDJtgrBEdg3zUXu4PnGOYfvoMrUJBBb7RYk1GAWaFdX0HYz1JrxE9O?= =?utf-8?q?/vNXXKOO+9lyCdA7c9O300LQm/nDiIXLm/dw8uP/O16XRSSIZfr8pZ34OeSbIqt3B?= =?utf-8?q?YRqj77JSNdur8PU+lUr1m9A/dvSMROQtndretwC/HCU8AMEXljnP8YslHIQT8gPKP?= =?utf-8?q?OX/QGn0aIFQ/kW1fa2SqFdE124lQM3UKsDFTgjGj8KfpAAISB0bmfCRCWSHp2Z5wl?= =?utf-8?q?XnqhirVcn3XrlM1lsJGeaMq6yyl33YpBdkTLpMrKYCBg+NOp+EzyLJYFCo2U28/ne?= =?utf-8?q?uc9onkJ0H8eCEZgiohRrZXcaNurH2D9PG5OjKQuNtF8tObI4cy4BsVYo5qYuhL6sp?= =?utf-8?q?q+j/ZT6uAh3wIKa3uBw/9/rNiiHE3A6hnCsulA1ZNZq/g0fX4RcjQSAj6Rmc9o1Y2?= =?utf-8?q?p2ScJK7L3FeStpNbKL0c/Ah5bTcDtwRt9ju4YKCVJu2WZtWRAKg3BW6HShJM4+DuU?= =?utf-8?q?PHzZ6tMZpufyWNjsAsxWqbbECbXs18bGxkPIFLKrjBu7S9KSS8nnt4eoi9iDBaiqn?= =?utf-8?q?iXR/PmDjXazWvNlf3LMXzenxuT71ZqTQ3OLaXkUksOUNyZw+tBXFwKh22uShw0QQZ?= =?utf-8?q?RDMAySMyjNfWkQ2eumKEc9kWD6o4BBlUfIe0wu0XDFS3VMAC0KYDn+OKxUQCDngCP?= =?utf-8?q?F1lhIxyMQdLV4PcF37drEVju84Bw1ZBKFxxLSOwy5dYg3dYrHU09iWta6OvHaI1lp?= =?utf-8?q?2Fw86JvytSsJNG96c2saedBY25Qg9rqJ+nDWEwLunSI429PTOd5Gkmj4s3slqH3gA?= =?utf-8?q?ZBfR+vL2L9u6CfrXxeRXJpf83O7FdWeCt6yTf8nfrfIFa5wSFnKmK7gsULCodVMl9?= =?utf-8?q?XNGwQzXKLB4SVbwBKjNilrY9bfSx88gB50AbgFltj+RwBBf8S4vgqF6liA6AHp1Ew?= =?utf-8?q?QAEK+ySSS/D9vuNsCJ86cSsJZQV9r6xLqtYmvt53qR5cXymLmVP5+1dfmJ+S3zhar?= =?utf-8?q?1y4FyJpMb0E4UxR1Vx85Dl06Cxujbf0QTVLyOuyi6A+40GD0WpqTkXILyu9cYPWbM?= =?utf-8?q?izE7bKUzEhhWpfsOzEfw6bpLjvPRF87uAgHvC1NeYzyqoDNUaVKPl/6y2I1VaOh09?= =?utf-8?q?wzPPqXg7bDn5?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 44a393d1-542d-4311-1d9a-08dc6ed65d71 X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 May 2024 20:43:35.0769 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: iuHXPWexR8UqZravOKmLLAo/sY0KL0qCrWer6rA6n6hbPhc4lFGXqZ/mob08QlbV55HYUNu8YHi4P+XzoiZrpw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAXPR04MB8576 This patch introduces support for I3C target mode, which is referenced with a PCIe Endpoint system. It also establishes a configuration framework (configfs) for the I3C target controller driver and the I3C target function driver Typic usage as The user can configure the i3c-target-tty device using configfs entry. In order to change the vendorid, the following commands can be used # echo 0x011b > functions/tty/func1/vendor_id # echo 0x1000 > functions/tty/func1/part_id # echo 0x6 > functions/tty/t/bcr Binding i3c-target-tty Device to target Controller ------------------------------------------------ In order for the target function device to be useful, it has to be bound to a I3C target controller driver. Use the configfs to bind the function device to one of the controller driver present in the system:: # ln -s functions/pci_epf_test/func1 controllers/44330000.i3c-target/ Host side: cat /dev/ttyI3C0 Taret side: echo abc >/dev/ttyI3C0 Notes about header files. About Ilpo Järvinen's header file comments, it can pass build, some header should be included by other header files. I added some, but I am not sure that is all needs. There may have tools, which can help check, but I don't know. Chagne from v2 to v3 - using 'mode' distingiush master and target. - move svc-i3c-target.c to under master, - built together with svc-i3c-master.c Change from v1 to v2 - change "slave" to "target" - include master side tty patch - fixed dtbcheck problem - fixed kerne-doc check warning Some review comment may be lost since it is quite long time since v1. Now master side dependent patches already in linux-next. So sent target side patches with tty support again. No sure why an additional "\r\n" appended. Frank Li (8): i3c: add target mode support dt-bindings: i3c: svc: add proptery mode Documentation: i3c: Add I3C target mode controller and function i3c: svc: Add svc-i3c-main.c and svc-i3c.h i3c: target: add svc target controller support i3c: target: func: add tty driver i3c: add API i3c_dev_gettstatus_format1() to get target device status tty: i3c: add TTY over I3C master support .../bindings/i3c/silvaco,i3c-master.yaml | 11 +- Documentation/driver-api/i3c/index.rst | 1 + .../driver-api/i3c/target/i3c-target-cfs.rst | 109 +++ .../driver-api/i3c/target/i3c-target.rst | 189 +++++ .../driver-api/i3c/target/i3c-tty-howto.rst | 109 +++ Documentation/driver-api/i3c/target/index.rst | 13 + drivers/i3c/Kconfig | 31 +- drivers/i3c/Makefile | 3 + drivers/i3c/device.c | 24 + drivers/i3c/func/Kconfig | 9 + drivers/i3c/func/Makefile | 3 + drivers/i3c/func/tty.c | 481 +++++++++++ drivers/i3c/i3c-cfs.c | 389 +++++++++ drivers/i3c/internals.h | 1 + drivers/i3c/master.c | 26 + drivers/i3c/master/Makefile | 3 +- drivers/i3c/master/svc-i3c-main.c | 80 ++ drivers/i3c/master/svc-i3c-master.c | 34 +- drivers/i3c/master/svc-i3c-target.c | 776 ++++++++++++++++++ drivers/i3c/master/svc-i3c.h | 15 + drivers/i3c/target.c | 453 ++++++++++ drivers/tty/Kconfig | 13 + drivers/tty/Makefile | 1 + drivers/tty/i3c_tty.c | 432 ++++++++++ include/linux/i3c/device.h | 1 + include/linux/i3c/target.h | 548 +++++++++++++ 26 files changed, 3724 insertions(+), 31 deletions(-) create mode 100644 Documentation/driver-api/i3c/target/i3c-target-cfs.rst create mode 100644 Documentation/driver-api/i3c/target/i3c-target.rst create mode 100644 Documentation/driver-api/i3c/target/i3c-tty-howto.rst create mode 100644 Documentation/driver-api/i3c/target/index.rst create mode 100644 drivers/i3c/func/Kconfig create mode 100644 drivers/i3c/func/Makefile create mode 100644 drivers/i3c/func/tty.c create mode 100644 drivers/i3c/i3c-cfs.c create mode 100644 drivers/i3c/master/svc-i3c-main.c create mode 100644 drivers/i3c/master/svc-i3c-target.c create mode 100644 drivers/i3c/master/svc-i3c.h create mode 100644 drivers/i3c/target.c create mode 100644 drivers/tty/i3c_tty.c create mode 100644 include/linux/i3c/target.h