From patchwork Mon May 6 16:40:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 13655759 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id B90D6C25B5F for ; Mon, 6 May 2024 16:40:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=dd0VTHpy2bVFgvcWfKTOhW89P7+IXWUyI7gm237UHuw=; b=Pkhv7WLaOy6DaZ w9XtO4jGri8ETRyGd0x1gXI+tnZyjNT9SRF6zhkH/Qa3CHnQ/YFkNiUKNRzveckGAfNEgS5w5jj86 zrZ8Z0qnlS1E6i5mYHozsYscMk3SdjGPmKNxZwUMQjd4nRqU6ZFGpgqDSS4Gh2yfbVIRtp3O123YY jbvEgfnzcK+VIdb+mYg3Tzq5FMrlOIs6EXgByfqUzjUA6MSNRN+3I+BLt1hJYA23oN+oTiar1h9Mn 4Z2ZjCwE3ADvXESvAam7FbGtF7I7CY1m0RXnYWt4vOfoNY88ryXyHLp7pSFWRUheFPdRyPcNyRSXr BveTDuY/vub7vE//2vOQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1s41ON-0000000872z-35Wb; Mon, 06 May 2024 16:40:43 +0000 Received: from mail-he1eur01on0617.outbound.protection.outlook.com ([2a01:111:f400:fe1e::617] helo=EUR01-HE1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1s41OK-000000086xK-2Se0 for linux-i3c@lists.infradead.org; Mon, 06 May 2024 16:40:41 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=I4EdCr+TAD39jUdCty/h+cP1qlHHtAXpqEIqi3h+YZanGvNN2MhDWwYcxNHeHgpp8CplxLvIuPdEP4mC0UfOOAAACWRXCVaB/z2nSNu/rnm8tm3tUgY2/odGRq0IHRDpk6Z1gEM+NuowY1YTqBhm58s8NCyBw00eLuay16x7IOvgkAnbw61u4xsGIGG/UFYRCfoUHV2DVAeh+h0J/nULHS11hU9I9yV3UprKYfU3GA7acjMtBh6GhDrZMGwY9cmrEhrr4jOmlg4SQfeiy+OnKcc+6mLG0B7EHrtqcsxf1VbPOA0QUpXE+BHrxEH5ANiimsHoiX1F9+zOJX3FUpRpqQ== 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=tE3RPDL6QL2unNktTbkb+AOZpVlVxRBdqM05c+svhD0=; b=k7OB0+PWzwi7p3kEUahK6QMNE/HqrvwujMMeMZXsLUjaQcK4djXz9NG3gV0wMjFyhynoUhlleu9Mhi3WW0M2Ws2jLuE+sVHrhei5O1Mvbo829QEuFyxbjmRfpvb4ydM4iJKscsCXmc5/kEQYCuvUTzz7yt7OvTCZSOecJeyT0QW5Iokz3kEKveT3h5+klFxxNL0Wyl0EG0R1xkjeSxoaIR5vIM0EsvUv+r1t1Y7vPTucUtdlU/rhao3RKDZgOxWw0fR1NKiWHE0whXED9iT1hbiawNSOfifTKwjq4Vdw0GmGzDjn8M/mAC8pOPl7Foq3/Y1OarHgLs08+xFpRdn2ew== 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=tE3RPDL6QL2unNktTbkb+AOZpVlVxRBdqM05c+svhD0=; b=eQL9eTNMr0ovvKr+mYfRmWJnzMCKAPFuQlHCobqa/4b8YL5AkwQRMeBR/bA7JeFmlBemNBr/gmbs219tg+hwUgSmn6ZCaJNFkQobzOoNhagrE518w9s2gtp62LIvmZ6uO8g41EicQD//liYJI+6fXTkfnIlujXlUfd8pW7WwWlk= 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 AS1PR04MB9429.eurprd04.prod.outlook.com (2603:10a6:20b:4db::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7544.41; Mon, 6 May 2024 16:40:26 +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.039; Mon, 6 May 2024 16:40:26 +0000 From: Frank Li To: miquel.raynal@bootlin.com Cc: Frank.Li@nxp.com, alexandre.belloni@bootlin.com, conor.culhane@silvaco.com, imx@lists.linux.dev, linux-i3c@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 1/3] i3c: Add comment for -EAGAIN in i3c_device_do_priv_xfers() Date: Mon, 6 May 2024 12:40:07 -0400 Message-Id: <20240506164009.21375-1-Frank.Li@nxp.com> X-Mailer: git-send-email 2.34.1 X-ClientProxiedBy: SJ0PR03CA0296.namprd03.prod.outlook.com (2603:10b6:a03:39e::31) To PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXPR04MB9642:EE_|AS1PR04MB9429:EE_ X-MS-Office365-Filtering-Correlation-Id: 8929be52-c684-45ee-e55a-08dc6deb3b58 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230031|1800799015|52116005|376005|366007|38350700005; X-Microsoft-Antispam-Message-Info: a7LdjT8+niJkRId1MHRLZ1ayoPhH/6HMvPvHkUektx+Qppe+poRRbIogzFEZOsSt8WSzWQeVBfvkbyjZyP6v3LomlITIGwAftimPEEzPupJ2gw8XFbz9EfNnFrRRliTWTs/il+UJk4Et2CvymWqbJNpNF01OHAl9sReRBAdk+wMNBwn6bcqmm1A6e6ZMuP9b/fht/hzWT7qzsOGRaAUAfK3qb9GedleH9QoOH8zdnoi58tA35UdgF1PJF7++sG9HkcCch+/JbSfiTNoZpbdlae28l1ZKg9vt1DruwDIwtl926zxZ7LGNMg6Ubqp2/Rf3Ey1m4Gi8p/00Qd4mHif15htHcnI1e5g3o7sDeIvw8ACVL0DAiYgYfob0SUmBN21LO9hc+rD4JKq8Rbv81/JzJWhb/nHGM5KwmoYnp8RgP7+H/vckkhvQKT3xb0z+R5iQsIX9F/qW0pPeHHwXoxHYauae0N30RfHesimHYdEU+kdzteojDny1jv5bXvIbbX4Isk/MbEvDLSjeE4vDSANYcbmXunB6kp7WHKdIxiVt/J/pdAaq1RBjSMy8/fdOdrqKvHN/U2kzXOdWDQHF/dazhQ8ykNq9T6cQUJz6jnbGaYuE+UBBqtD6nLn0Nsgap022O9PLYYziqZNQWEWlg73x/NCJl/EQZHaFhQ2sWqh5avlS0AZRtJbAjlhd638PCI6cAN/zTCbGhYPubOok9j8GSRvtqplmr/8lGPC1akVRxmaLLQONEpyyAX4RdPh2iHOdnKinVWkmneingcCNioyfxhtbXWDIfgPuovV4oegMDaOqbT0XeWrkKFEcWtb3aZ450iUokoTRD08FY34Dj0x3txcV1/O3Zy7mc9uNTIdvlbw7N/LuFKBPVM3E9KpNO7zXx6dN1gxgHyQIYUWWtVChseSzV5nUe5y8bROrrMxcY4hsp6VTpdE6d2e+zWfMd4gyuH+IvtBwafhKN7SroZ3R8Yf20MArm6fqD8MZ8x2ggF5kv0ltpkqgUahizKPkypfjp2uFxnMDecjcGWbB7Z9PLOwmD95uGXKX+VDYyJxYh4kkAslhBM+LjUrVWelTATTgJpPQrhZFHkf/OiL6sX/o5G0WQBOnNYSdPCu7yaSzvpsfKQGzni9zcTTdcvPJyXcUgXyzLa/sbI8b2OGUJieBS1nG2HU3Zz2x0/w2pFhrJTnRmKsRkAkgv0jtagUgQBPALWzMjO8NlSUk2+DTASRILUqUvqiPMbcpsjNTN4CDkAvmq25UjZekSytpv2kNbElSKLapEsEh5W+AIZQBP6xtO7B5Muj9cvV/iy6MlcSp/pO1L+frKDS7VcASkDaafl6Wumfe8ES5f9NJzZg6Ubo3Vw== 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)(1800799015)(52116005)(376005)(366007)(38350700005);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 1EXiCe1j6onSzht7fWx7L8975QyOtm5hQ7ofbnKQcH9bZNQodLAKtQRVsCBxJzj2a7Wwdcmgc1DLwpKfhfgGO4z/lBwCFBpmuSr8MZyK8dyFF8w5oR77dE5uaNsLMYY/aTGh/7Um6eZCOmyhuv23dmmPEGPnfUaPrtmBM9i7w8OTIMDGdFjrZw+mkOQyfpc0aeX90RK+ULtVaV/EYAoQPSsuQ5xDk0NOkqpF/UP3RriKeEWetfgiMmsnFgdHG8tFPmY+/qgyGQjQY5qLxlSMVcHBEkvqi1p4j9kc15kYTpj+GE9IJYMMbXGwrqpA+yq3DBmvbk7UJFj28hw650OWfgJfbn6sYjb7Tc2dPW3XlMFKTy7205kZ1aZH5lo3a2rRdP037EAZ7vlRDS4UUE7VGR3iLUg69he4iuJgN6etcq7CMKApXIMuYVNtXLayOhpGrFmyKXLqsuqWXoQ7Hmx2ZZCumBRvAg/N+KJkQJW24pklkHZKejgzs7eqH4bmF8bpdgxfSQMwC81FcLt9yvoafpzBJbW9ciYbtvpOMXbwrClZc+vGF1ICJSp+JyINCKZIRF2N3D4pFzlcCgyDbixeA3i40ckIvjODCydurmghwU9dJ4eaYzf88l9ncijOC06aoVKO30a4adIsMb2Eej/mQeplgN94gW2BGBMp+qCEunjHx4Uk1vk6zsYw6DsggRsRzfTNf4dAysic3qgHSLQzsp8Rr+gxj/TkKqqlYOfwaP2vXgzt/dHuq8geJEmRvc1HZCBbtLy/eVRXz0GoCtwBtbjjrDd14Z1Ktg4axMfNRk9QRo/Vnph/IdCNYLdi7qTsoTv+fcI0cJ1D1s2VY+Y1TKLq4i0rBt/p2ML3Er+8FAhYGEvr+4Vyl/ANkJw6cTaOUYsRt61nLUbbCPueMJLZHToKc9nRgPl50imyZV/jjjosMElEZwy+2Fr396fRQ48Qc2flxWkUTk/x/skEmWvZwZB2acfMbBUJ5GePdx95aBBSyFkHSAj1EbxckqwdKuVK7iKoQNpPd5Z0a4M7MYQU5sxupFBYffNbOFosYUey6bveFhb0Qxi/L/b9fZZlXPVlhYoLQ2HCssI3OeMNjo12OiIFzYUqnt7SrSiyLjtDrzPsALLJdwm4t5BeaMRdiajVkHlHU7SQ+e9vz3LVPsomt2O85FEN3O6FLQxqrs2yb63DvG1ajRB8XlhoJ2eufiSrGYGn6/0R6psfvH4TK2rJNZMRDCXyaD2thY8gOtrnkW49Oq535AOzTBUyTvBEMylgQE0oejl8r8F4bH6/3ufxisEz4DB9EYAVBEiT8DD91mP+yRgwm/0cHr2irSAwDJ7oBieASrb7ZM7Ai/F97OOq/cm6pDWh2YApfTSkEshknu+QEx1pvDo2f9X61F0Bfto1T6tRif1KWQsQ2+iNEMAYmhq734BeJd/BNtiElo0HLvv3EmUWvOO2S9Qsjlqz1hS+tQEXmSUOs0gUpNNmIbMG2UpnlpIZ63EuYrjhdA9k4DKhzKcCHqQP44Fv0oEpBLf5EVXMrDWA685XXfKa9NRyq0ipehQBXmlCJBbtz8FFDNA= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8929be52-c684-45ee-e55a-08dc6deb3b58 X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 May 2024 16:40:26.3023 (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: 0Spy4mvgeojPZiI6VK1EJ0ClhgcFUUKBFSmmUxCpArIomt0jDm34uLy8EugTmTo34SbmKrlAr9dZXyRDmc82Mg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS1PR04MB9429 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240506_094040_637951_CB210B87 X-CRM114-Status: UNSURE ( 7.91 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-i3c@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-i3c" Errors-To: linux-i3c-bounces+linux-i3c=archiver.kernel.org@lists.infradead.org In accordance with I3C spec ver 1.1.1 09-Jun-2021, section: 5.1.2.2.3, if a target requests hot join (HJ), In-Band Interrupt (IBI), or controller role request (CRR) during the emission of an I3C address in i3c_device_do_priv_xfers(), the target may win bus arbitration. In such cases, it is imperative to notify the I3C client driver and retry i3c_device_do_priv_xfers() after some delay. Signed-off-by: Frank Li Reviewed-by: Miquel Raynal --- Notes: Change from v1 to v2 - new patch drivers/i3c/device.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/drivers/i3c/device.c b/drivers/i3c/device.c index 1a6a8703dbc3a..b04a55a1337d4 100644 --- a/drivers/i3c/device.c +++ b/drivers/i3c/device.c @@ -27,6 +27,10 @@ * This function can sleep and thus cannot be called in atomic context. * * Return: 0 in case of success, a negative error core otherwise. + * -EAGAIN: controller lost address arbitration. Target + * (IBI, HJ or controller role request) win the bus. Client + * driver need resend this 'xfers' some time later. + * See I3C spec ver 1.1.1 09-Jun-2021. Section: 5.1.2.2.3. */ int i3c_device_do_priv_xfers(struct i3c_device *dev, struct i3c_priv_xfer *xfers,