Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) client-ip=2620:137:e000::3:2;
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, gregkh@linuxfoundation.org,
        jirislaby@kernel.org, linux-serial@vger.kernel.org
Subject: [PATCH v5 3/7] i3c: add actual_len in i3c_priv_xfer
Date:   Thu, 30 Nov 2023 17:44:04 -0500
Message-Id: <20231130224408.3591288-4-Frank.Li@nxp.com>
In-Reply-To: <20231130224408.3591288-1-Frank.Li@nxp.com>
References: <20231130224408.3591288-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?UUNFMkJQTFpGNUpnSzhPUzJmMWJpZWhqMllZMW0xaTNyS2xoVWxoS3hoOXpG?=
 =?utf-8?B?R2YxeHFFZW9SVEtDRkR0WkRlWXU1TURYcXBzaWVLQ2V1Vk50MFM2bkRaS1Zh?=
 =?utf-8?B?UklyOTgyeWlrcndscGw1cmRkZEl1aHlrN3ZROTdIUkV1d3lrSk9jMkZQNGVr?=
 =?utf-8?B?NEMzcWRiU3hVUHllL3FxelpnQlRXaWgzSGhnSk04TUNhRXhmOHUyRnAzSXFw?=
 =?utf-8?B?SGRuRVlSTEd4MHhOSytHYTE2V01GR1ovVFVjSnMyT25FbGplYXNNWWFlMFRF?=
 =?utf-8?B?cklEQTRydkhYQzBZOU9kS1NVTU9qNWJ6aEVMZ0gwUStlNFhnOVFuNXl4RklM?=
 =?utf-8?B?UUswQy9ocHROUWtEOGtXSDRKSmp4eWxXZkZWbVh4cnNZUUk2bWhwMy9vWHN4?=
 =?utf-8?B?Y1JPdVp6UE5WVVlqWEx2TWQ1enhxdkhiS3RwbjdFZ1htSHF6SjdOVUY0ZnZs?=
 =?utf-8?B?eG9XZkc1TGNNamZzcndHd09CdWNYQkhJNzdGbVNnZEVZQlpkY2FxVnJLL3Ja?=
 =?utf-8?B?UVdwZUw3ZGpQbzVtM2czTmJPcWVHRUFta0xaR0VKOHRNeDBrMnFoQWlTZjZl?=
 =?utf-8?B?SW5qUjNRbGlGNmFBeHEvVlQvZlpEZ3N1cTJON2wveFM4ZXJ3eDZkd2wraWpQ?=
 =?utf-8?B?ZmdKZjFZY096dUtxQU8zUnNucG1LOS9tWWZWcmxyUm9va0FVenlwOGRFM0x4?=
 =?utf-8?B?MGJjQ2NFM1dCUGN0S1k2aldEWjRPVm1JUUtTYU9ybkxsdHN6YlM1K1g4MEdG?=
 =?utf-8?B?a1QzUnUwV3M5a1hKUkFHWG9JMW4zSFdqUWpWUHlHOGd2V0h2aFZyM2dHb2Yv?=
 =?utf-8?B?a0NvRjdseTN3d0VEVktUR0FvczdyZnQxczZFSXFiMXpwUXNsTUplWUd6aUpk?=
 =?utf-8?B?U1lMdlZiYlNTRHU5dGhVNnl1dXEwL0FHY281aWdkS3dhVmVwTStlK2FkSll2?=
 =?utf-8?B?U3cyM1BCSVJ2dkpOcjhWeDZCZ3dZM0J6K0t0c2ZsckY3dllIb1NBZk9UdzYz?=
 =?utf-8?B?bEFzL1BXSXBKRU44Y09jblgzOFlPWTRmb254UnlNQTdSVWlwRG5jSGNaMW5t?=
 =?utf-8?B?cWs1T3hlUVBKcjBJWDBzT2lhZWphRm5STlM2ZFZCYU9TbWIvdTVRdmowODZi?=
 =?utf-8?B?MVNYOEYzaUFCaXpyTzN5OW55ZjZMNXJIUUpPWlRBSzg2VERMbnZKUUFjUHd5?=
 =?utf-8?B?QVNxWFRueHBqQU9sWnlJZlhjKzJYYnBNbitzWVZPRlhJc2lHS0dhcWc1S1JO?=
 =?utf-8?B?cWdJRUthZ3R0VzliOUc2R2lOSzdjemcwMTdpL0pQdGJYVjlFcktxVS82dUJ0?=
 =?utf-8?B?dWw5Ti9MSzJxMGxaZjZZb1EyajJDc2ptSGR4VW0xMXN5U2ZDeDZyWVZZMzRt?=
 =?utf-8?B?akFEU1ZXc0daaVQza1MzaXF4djhSYWxxUlZ0VlpIR0krenRYcEQyRkJSVW9o?=
 =?utf-8?B?YXhDWUsweTdZajEzMng4UkRMdXllcEdHNEpFU0Nhc214U2Y0Vm02dVpTUkRu?=
 =?utf-8?B?UytXdEJpdGlQTklCMFRqZmVJaU51bGJSUkZpNEV3bXlBQTJRUWNIekJNeHho?=
 =?utf-8?B?L0VTdVhiZitaN0trL3haMmpkSkJTNzJMVVU5ekxNbjNNV3NWU0JzcW9YUTJp?=
 =?utf-8?B?Y0hDNlRyWEJDdFlHUi9tQk0xQXhJZ2dqQnZBWEVWMm9sTWFiVlFwUDhLSXhv?=
 =?utf-8?B?UmxjanV3Kzk5K3YrZlZENkRKTkVzeXJpS2N0c0d4TnhTYitkL1JaODdFVGpG?=
 =?utf-8?B?UUh5SythZ2xzanMvUmVqdm1PeFpncHlXNitoeXVNMUVWVWw3eVpEOVJkZmQ5?=
 =?utf-8?B?Mjk5SVM1VnNqTGM1ZDdidnRHV1FnL0doRXMvMHMrdVVqL2RjTFhmcjBHSFBr?=
 =?utf-8?B?eVRVWk8wd1RWVUt0VEhCOEI5Nm5TVWNFZHNiQVRzNzZFUE5IdTlSS3lyVkZO?=
 =?utf-8?B?TTZnWS80SExwV2RTN3V3SnVEZCtpOVFBNklzMkFGcHVwM0s1aDlOZlNab2lJ?=
 =?utf-8?B?cTYwM293bllnRThneXV2SVkvUEpBVjR2SnpXZlh5NkdETytYZ2czTithOFBY?=
 =?utf-8?B?SzZtRXdiUlZ3K3ZuWVZzQXorNllKSE55ZzVacFNLVXhtdDNhK3pSTVVKQk9u?=
 =?utf-8?Q?jbcecTDIHotFZ8Rqk0plJ40DW?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a6686b44-0440-4b23-d94d-08dbf1f5eeb1
X-MS-Exchange-CrossTenant-AuthSource: AM6PR04MB4838.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2023 22:44:37.8398
 (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: 02zHrarsbY50WRY9tGSu6K1IcsU/y9tsdreY89HtyGwwLAlzO5UFOpJGOwg5pXTGuskEcSi7Wrnv0tQR4nc8eQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR04MB8851
X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,
	SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable
	autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email
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 (agentk.vger.email [0.0.0.0]); Thu, 30 Nov 2023 14:44:56 -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