Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37;
From:   Frank Li <Frank.Li@nxp.com>
To:     miquel.raynal@bootlin.com
Cc:     Frank.li@nxp.com, alexandre.belloni@bootlin.com,
        conor.culhane@silvaco.com, imx@lists.linux.dev, joe@perches.com,
        linux-i3c@lists.infradead.org, linux-kernel@vger.kernel.org,
        zbigniew.lukwinski@linux.intel.com
Subject: [v5 resend 3/6] i3c: add actual_len in i3c_priv_xfer
Date:   Fri,  1 Dec 2023 17:25:29 -0500
Message-Id: <20231201222532.2431484-4-Frank.Li@nxp.com>
In-Reply-To: <20231201222532.2431484-1-Frank.Li@nxp.com>
References: <20231201222532.2431484-1-Frank.Li@nxp.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?eHlEMVpzUkgyVU0zN2hIY0lqMjk0Z2FSRGhWSVV0U1NITGsxZXU0RmMzWW90?=
 =?utf-8?B?WWh4TmtwQmt4eVltVVoxVCt3dEs1MDlMaFQybmw5KzFZakpvbTc1elBjMm12?=
 =?utf-8?B?OWd5MEd4c2taSnNGbFl3MWNoMUgwTXY0QkpYRW1TRGFlR1lUUXZDOTZCRC9x?=
 =?utf-8?B?Z0hMaFNxZG4ycU9uRnQ3UlRvN0JnbmJKVnNWLy9oVGdkRHprdm8wRHpxZ1FC?=
 =?utf-8?B?b2UzYVo0SEx5ekZER3JjL295SWdpVmVJL09QbjY4UWpaWmtyOXkwSnRSS3BZ?=
 =?utf-8?B?dytBQzF5TFR6UXZjMUZybVVJaEtIdHJVWHhsZHFvam5jMEJZNG1OeDJwMFRr?=
 =?utf-8?B?M0J5aTJGR1lMWmxUa3k5ekZwRU0yY2hHMkcwaFh4TFgrT1F6eldYamprVVdl?=
 =?utf-8?B?Tzgvbjh2MG9pQWVweTF5TG1nZ3EwSk1QcVJseHBVZnpWS3d3WDk2VGo1NkNB?=
 =?utf-8?B?NjdPNE9ibUhyZXBuRFFPZmxIZWRwZUVkQnFWbHZBUStvRThXTzlxUzR3UEp4?=
 =?utf-8?B?SmNXVTNJR0FTU283MGJ3R29VY2xUZDhWM3Q4RnhsclpNLzNHRHRObTl5OHlY?=
 =?utf-8?B?cC9kT0pUdklCbE4vNjBOcXViclVFSndVc1hNdGpBY1BqcXdGUGVqZXFNNVFF?=
 =?utf-8?B?NUNVRUhRZXRNalZLOFNTRzVIQnB3VGZzamEzQVNsTHZwdGZCa0h0NmloY2E1?=
 =?utf-8?B?UmpVRFpVNjlGTTdBSGowS0RtOGZyT3U5UTBVM3pEdGI5N2t2YzBXamxVdmho?=
 =?utf-8?B?YUt0dCtOeUhiZWtQcWZtdWZqOFdtNUdOSUZmRTV3MWlQTGxNd09henNMZzF4?=
 =?utf-8?B?ZWJlTUY1UW1IbUFhZk90Zlh5T3dVT29kcDNBcndnVlZXd3pmaGJKejRLMEFq?=
 =?utf-8?B?T0F4N3IrdkpkZFFFVXdaNE9WN3VLNlZ6UkJoV1RjRU4xODZtZDdzc1Y3dzN3?=
 =?utf-8?B?VDBsRUdGeFVUcUNSZTh6NDF3aWt1RDBSMWoreHVlM3hkZEYrTFlpQWlYbDM1?=
 =?utf-8?B?Ymt5K2hkMVJBQ200QkpiME1aOVI2dDh0bXgyaFk1VVRpTklXcVlubURFTnRs?=
 =?utf-8?B?dUhQR01oanhCR2YxZEJleW4ybDRmMDBHaXlaQzA3SUVLNHBNWEhnNExLM256?=
 =?utf-8?B?R0VDT3FmS05OcDd6amovdFRKY1pZdHB4UDNXWG9BUlBEN0tVdzZWSldwRmU4?=
 =?utf-8?B?aHYxZzZYU3ZkTTVpV00xY3VjZER6cHRkRmpRc3MvNllsVjc2TzdVK29TdjdX?=
 =?utf-8?B?ZEtvQXI4cmtpZ0ppdERhdi9KV2o1aUlpeENYdktXdkVzYmN0by9jZzFKNlNR?=
 =?utf-8?B?R2ZCNjA2dmJFc3IvaGQ2RWRHU0g3ellvRTNFWEx4d3plTENpTG5VMUUyZVdp?=
 =?utf-8?B?ZHpnN0VHYlloKzFPNTZDZWdWY09uMVYrSXdGRW5NUkE0MDhvZ21oS1ZBVnJl?=
 =?utf-8?B?SlJEeFN2TERVTHpjNFYxKzk5akpoMm9WenZrMVdUN0xQbDhsdGlxaW8vaEJ2?=
 =?utf-8?B?SnpkYzlXZEcrdncrTktTVXRZWEZjd3kwSlhWbEcvRnQvZTR6YVdaeW9uSTRU?=
 =?utf-8?B?c09xYlJuaHl4Y1gvcjgzS3dnRVkxOWFNNWVHNk1LdVlzOWdKbzRnekR3YlB3?=
 =?utf-8?B?b0JoSStiOStuWVhWd2owbmtLZlV5emE2ekFEWlNZNkFiWjBWNXFkRWdNU2d4?=
 =?utf-8?B?UWRPbUxNd2hnaEZMZENxZjNMMlZzZjFRelJUMlRqZTZRbGVQYlRVTDZIZnli?=
 =?utf-8?B?eEVPb2U0bWRrMkQ1MFY1SEFnc2NodFdrWm15UFd5dEhBTTFEdUw1bHR4TEZ0?=
 =?utf-8?B?eDVGV3JHMG9POE9FelJaQkJ6bUtGc3hVcmdMVktKM3M3UDR4Y2RVRnkxWnd4?=
 =?utf-8?B?UlZmUzNycXN4Y2ZCNTdpeWhhODdBYVdQbVdETHJYdFUyVXRxNFVEbGVyUXh0?=
 =?utf-8?B?MUFsQk5GRjVvZTMzU3FZQk9LeGNmWjBiSFQ2cFN3S1h3aVkvamd3ei9JOXky?=
 =?utf-8?B?TngxTTBHVitSZGp0R3ZRTng5YUVWUEE4clJveDZHcjc4UVd3R1RBNGl6a1ZG?=
 =?utf-8?B?Zmp2WFdIKzRmbWdjaWtsakUwNTcrcnlLc3lCZi8wNkEyY0RDUlVxNzJPU21q?=
 =?utf-8?Q?Ysa/mhk1aQpPOfceX7qCQxfo8?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 5ad3cd6b-5a01-4d9c-85fd-08dbf2bc808c
X-MS-Exchange-CrossTenant-AuthSource: AM6PR04MB4838.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Dec 2023 22:26:02.9291
 (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: 7m/GcAvMDmJACM0jynTnXT43VoZZzdffftkZpGQ1NZrlIVHGLynb+jb92++UVN9jXtJtcE4m7n+h1zXPl7qOAw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS4PR04MB9573
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 01 Dec 2023 14:26:22 -0800 (PST)

In MIPI I3C Specification:

"Ninth Bit of SDR Target Returned (Read) Data as End-of-Data: In I2C, the
ninth Data bit from Target to Controller is an ACK by the Controller. By
contrast, in I3C this bit allows the Target to end a Read, and allows the
Controller to Abort a Read. In SDR terms, the ninth bit of Read data is
referred to as the T-Bit (for ‘Transition’)"

I3C allow devices early terminate data transfer. So need "actual_len" field
to indicate how much get by i3c_priv_xfer.

Reviewed-by: Miquel Raynal <miquel.raynal@bootlin.com>
Signed-off-by: Frank Li <Frank.Li@nxp.com>
---

Notes:
    change from v4 to v5
    - Add Miquel review tag

 include/linux/i3c/device.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/include/linux/i3c/device.h b/include/linux/i3c/device.h
index 90fa83464f003..ef6217da8253b 100644
--- a/include/linux/i3c/device.h
+++ b/include/linux/i3c/device.h
@@ -54,6 +54,7 @@ enum i3c_hdr_mode {
  * struct i3c_priv_xfer - I3C SDR private transfer
  * @rnw: encodes the transfer direction. true for a read, false for a write
  * @len: transfer length in bytes of the transfer
+ * @actual_len: actual length in bytes are transferred by the controller
  * @data: input/output buffer
  * @data.in: input buffer. Must point to a DMA-able buffer
  * @data.out: output buffer. Must point to a DMA-able buffer
@@ -62,6 +63,7 @@ enum i3c_hdr_mode {
 struct i3c_priv_xfer {
 	u8 rnw;
 	u16 len;
+	u16 actual_len;
 	union {
 		void *in;
 		const void *out;
-- 
2.34.1