Received-SPF: pass (google.com: domain of linux-kernel+bounces-22565-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
From: Frank Li <Frank.Li@nxp.com>
To: frank.li@nxp.com,
	robh@kernel.org
Cc: alexandre.belloni@bootlin.com,
	conor.culhane@silvaco.com,
	gregkh@linuxfoundation.org,
	imx@lists.linux.dev,
	jirislaby@kernel.org,
	joe@perches.com,
	linux-i3c@lists.infradead.org,
	linux-kernel@vger.kernel.org,
	linux-serial@vger.kernel.org,
	miquel.raynal@bootlin.com,
	zbigniew.lukwinski@linux.intel.com,
	devicetree@vger.kernel.org,
	krzysztof.kozlowski+dt@linaro.org,
	krzysztof.kozlowski@linaro.org
Subject: [PATCH v2 0/7] I3C target mode support
Date: Wed, 10 Jan 2024 12:52:14 -0500
Message-Id: <20240110175221.2335480-1-Frank.Li@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?OTeQOviWeloyQDFLVCZhtbu4wzAOMshI35JgtT81FAPfoULYyyBf2YVLcWF6?=
 =?us-ascii?Q?G6VuhW+dsP3sGH1zzckXSl9RJtrNvAZ/5O+/YeMvdTib/PjPMjL1S7/z7TCL?=
 =?us-ascii?Q?zdbbK+KiCPrkhhbUK4FwzGDH4Y1mGznArvfwG+YJRQLLKwj2SwXZ1c2VQuP2?=
 =?us-ascii?Q?W6FeQOkO/OMiTcRbQdJax0Wah08XvBJ7F6js4oq0JRigtP6ghZ3ntwwhyEtF?=
 =?us-ascii?Q?8FH0xXNL3lzcdZLyhyF2QSXN/Yqst2Z78leIxCAGMJF/tZDWhxKmH5Yvj1gG?=
 =?us-ascii?Q?H+I1Lb9qKC+kno1oLhkhJUJeBi2exCgGMtZ6IKmxIitnb9OqcsOkZHzu5I/4?=
 =?us-ascii?Q?A4wOhJy5SRt13MXPQYIgkSKcndUliVwDBtjVgl/OGZHlVrcKJPUZj1Tibm5w?=
 =?us-ascii?Q?/k1S5YlSx5bQm1xy7GymV3jEcbA4IbHfHXYiABhfkU5qOdTwCj3AzVeDxEoS?=
 =?us-ascii?Q?BNWAanEDnb8E87ZSZ2fMd58ChbMTx71EiFiuO3gj8jhr2UeDSoPrTyUCO+NG?=
 =?us-ascii?Q?hQrZfS8YhQnhv2rp9MlVgOdCu30m/ecxP+RgvOZTCgAs4o5zbP4TtitqyyOA?=
 =?us-ascii?Q?Btw+/PpgqCZRUgqPIALTH3LL5y2n3+HfcDvey3u87v3WJqxqsF89n4MzP++1?=
 =?us-ascii?Q?5ZlkZERoyiHzT+h+PtTQvaRFfEkwiZdJRerKE8ow4id8CCBTdseeU3I3AaML?=
 =?us-ascii?Q?YBEBWvCaMGrW5cuC1h+fN55DTK4kjak1ugTaY7UHNu2YBH3bRYyB2AepoCHa?=
 =?us-ascii?Q?8bo0x9IxFTPOxlH0u7x+8iZq4sn5h0LJaPTuOdUx896Z1QMrx4vogDMSB1e+?=
 =?us-ascii?Q?ILDKrN5yeqn23tH7k7mu3hmUrrWA1yY2YpU9b95y402C/rGlzXvBem8Zn3wx?=
 =?us-ascii?Q?MW0R6C9FXRPiLtEld8gDyarPRzfj0ioasGoeS6tyAh65wG/KLq6fLtrYf7X2?=
 =?us-ascii?Q?p8G7PbhRP5HFTgup4/9JazbvGNMzdFAkYORuEfZqD+RmLTRAoWVnW+KZ5C8G?=
 =?us-ascii?Q?cCYqOQV3Pj90I7YpdkbJZj9zvILK+ITfsnIDUzE15S+ujqUbynHn32Y9cOMm?=
 =?us-ascii?Q?MpdF8bplh7B8R/6PHdPSB+iSzkvnhYZRZwSqT3DUUS10d6jg0s7m5ya7EMhY?=
 =?us-ascii?Q?Z61asftS3RtCP0xuja4OxR8+HPe3ljh2wK2jTZfFLKkSSEUyFmsSTUxL6f+K?=
 =?us-ascii?Q?jKdvE4PRF8KC7qx5QBWWUnPfLke8wJ1tqBk5+uztC619urxH35yQs9XWxhqg?=
 =?us-ascii?Q?9EVAu6V93alLZih4mNJUw9wuA5KR24gMPiiMvoojputUKCEshHBEV+n6Ecj3?=
 =?us-ascii?Q?JOEAs4TkTj48JvkaX5eUthhLjtwXXrm7OPTtZh8Zv04aURxvPhKTv/juq/BB?=
 =?us-ascii?Q?U4jgBU572PysKAHcG50SjPMB9qoaudWdt3Q1PsLQqCt5TWlHhzzKtaOAahXG?=
 =?us-ascii?Q?HYtuVHIa7CydEIutq5aDXpEzfRl4lkd3ZIg0l2fsWaBEPvzD/ZZGDYR59vBx?=
 =?us-ascii?Q?KIxlXU+p4coGNaw6humYa1mX1iopFmjujR5+fegJ3F0bMTkaoNbTxQKLv1Yp?=
 =?us-ascii?Q?F9UIOAEU4kmeMl25cpU=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 8ab9a493-8cba-4c4d-27f6-08dc1204f054
X-MS-Exchange-CrossTenant-AuthSource: AS8PR04MB7511.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Jan 2024 17:52:40.2778
 (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: VTeGZNaEb9N+mjPZVsi10GRev1sv7Fq50sQiBaultAtMknQqWqwbb+/2m1WWVo2hFDaduwWSMdjgMcw5H8pC6g==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB9332

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

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 (7):
  i3c: add target mode support
  dt-bindings: i3c: svc: add compatible string i3c:
    silvaco,i3c-target-v1
  Documentation: i3c: Add I3C target mode controller and function
  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      |   7 +-
 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                           |  32 +-
 drivers/i3c/Makefile                          |   4 +
 drivers/i3c/device.c                          |  24 +
 drivers/i3c/func/Kconfig                      |   9 +
 drivers/i3c/func/Makefile                     |   3 +
 drivers/i3c/func/tty.c                        | 475 +++++++++++
 drivers/i3c/i3c-cfs.c                         | 389 +++++++++
 drivers/i3c/internals.h                       |   1 +
 drivers/i3c/master.c                          |  26 +
 drivers/i3c/target.c                          | 453 ++++++++++
 drivers/i3c/target/Kconfig                    |   9 +
 drivers/i3c/target/Makefile                   |   4 +
 drivers/i3c/target/svc-i3c-target.c           | 795 ++++++++++++++++++
 drivers/tty/Kconfig                           |  13 +
 drivers/tty/Makefile                          |   1 +
 drivers/tty/i3c_tty.c                         | 426 ++++++++++
 include/linux/i3c/device.h                    |   1 +
 include/linux/i3c/target.h                    | 511 +++++++++++
 24 files changed, 3600 insertions(+), 4 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/target.c
 create mode 100644 drivers/i3c/target/Kconfig
 create mode 100644 drivers/i3c/target/Makefile
 create mode 100644 drivers/i3c/target/svc-i3c-target.c
 create mode 100644 drivers/tty/i3c_tty.c
 create mode 100644 include/linux/i3c/target.h

-- 
2.34.1