From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 4B1BE45BC5; Thu, 24 Oct 2024 17:59:18 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 15A2440265; Thu, 24 Oct 2024 17:59:18 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by mails.dpdk.org (Postfix) with ESMTP id B3C674025F for ; Thu, 24 Oct 2024 17:59:16 +0200 (CEST) Received: from pps.filterd (m0431383.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 49OAofof000402; Thu, 24 Oct 2024 08:59:14 -0700 Received: from nam04-mw2-obe.outbound.protection.outlook.com (mail-mw2nam04lp2169.outbound.protection.outlook.com [104.47.73.169]) by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 42fkrf0sj6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 24 Oct 2024 08:59:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=UqTdM6Q4XbrfEK+OPAWYq1O+y2tufWhcDyDnWhJdiYd2rjtBEOz+mqY/FcskLiTfH8qzv1Z0o2h6umGWcOiVcz3ej4qqiL6aRGVTenL1/c05+TPtfhxD8F0Va1dRPfFCakYugp/fSTuWpdVFcZYWxqy66qxF0t7SqlPMTxQ0tf16VG70VXzDbXoAO4si8YZn7yYHZBuHSRiQ6wGyzi5leHup1AgL68QvFe9q3FkRgKirMkswyhbadvKFsuiaNCZoX0vGiq4M6N+kViFwNq1QVX5B/EHnnmETp+2N1yBbKkDgWPrh43HaYLtD8+vNARTxfIfrF+MOV9lN0/NzdOWpfA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=Aw+W2TYrwZf7V2GrbR7M0AsVFRbQ2FKvGxixVqry65k=; b=y5w/jaKF0ElaJU6Anh6Q4cATm3bfSNZ1/hcnP+X6M4WoiWJQE7F7rpj27ptQ9pUJkD1hOR+uLNPbahG5xcRa3IsflL/P6+ELMldAhbIf3nSX6TqLkpk+8EL/iUPujnj3zScUVIKYfJ+DR58P/HsAW0SUQ0uOrNpHcJKXmjmzkNN0w1ZggwVduu1N63T0wpMHucXf5pPFbHfx91VIIhDg6Q6Wyz81YqvI0LpaEogHHKSJAHwGQOF7kXT+uv8etdRLjJg/fLt2idCIRqsm+g6D8uFh0HCCgAy9/glhw7t3n2vdkceDDj1DPn/ykqtvsCwIZyQ25Bun5d/gb4baD0m0sQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=marvell.com; dmarc=pass action=none header.from=marvell.com; dkim=pass header.d=marvell.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Aw+W2TYrwZf7V2GrbR7M0AsVFRbQ2FKvGxixVqry65k=; b=MwTE0HVMkw7PsSodPVJmq+uWvb4neUYnvxoS3cgLKkpdLqqoQUvTvo7gZBCE34ZCNLjqGYsiNcq8KgGWqy1wqEKEoNDcq3zijeEjxzQsnKlbCSB3ConSoprx4BoJLz2zUR7Dufa70iIPGzFZ2reojDfaK0QKy1CJMsXh/hN0GnQ= Received: from BY3PR18MB4785.namprd18.prod.outlook.com (2603:10b6:a03:3cc::18) by PH7PR18MB5826.namprd18.prod.outlook.com (2603:10b6:510:15c::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.28; Thu, 24 Oct 2024 15:59:08 +0000 Received: from BY3PR18MB4785.namprd18.prod.outlook.com ([fe80::4f9f:e101:dad7:c576]) by BY3PR18MB4785.namprd18.prod.outlook.com ([fe80::4f9f:e101:dad7:c576%6]) with mapi id 15.20.8093.018; Thu, 24 Oct 2024 15:59:08 +0000 From: Jerin Jacob To: Akhil Goyal , "dev@dpdk.org" CC: "thomas@monjalon.net" , "david.marchand@redhat.com" , "hemant.agrawal@nxp.com" , Harman Kalra , "stephen@networkplumber.org" , "sachin.saxena@oss.nxp.com" , "ferruh.yigit@amd.com" , Akhil Goyal Subject: RE: [PATCH v5 1/9] drivers/raw: introduce cnxk rvu lf device driver Thread-Topic: [PATCH v5 1/9] drivers/raw: introduce cnxk rvu lf device driver Thread-Index: AQHbJhcu5Gxdk9qyHU6NZ61pS4aRS7KWDUBw Date: Thu, 24 Oct 2024 15:59:08 +0000 Message-ID: References: <20241024130130.3330978-1-gakhil@marvell.com> <20241024131759.3337333-1-gakhil@marvell.com> <20241024131759.3337333-2-gakhil@marvell.com> In-Reply-To: <20241024131759.3337333-2-gakhil@marvell.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: BY3PR18MB4785:EE_|PH7PR18MB5826:EE_ x-ms-office365-filtering-correlation-id: 387c81eb-9193-4703-e999-08dcf444cb54 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; ARA:13230040|376014|366016|1800799024|38070700018; x-microsoft-antispam-message-info: =?us-ascii?Q?2lS9lotS0dbwt40Z8aVtS6CCWr0DWULsTxoh8O7xXKmVEJ49IlAXpounyw1P?= =?us-ascii?Q?DIsO8L5q3YQ7UEvttFXGcXngcR40ZzBx7NymkDD/GE9ywPhxxr++XY7gCp3/?= =?us-ascii?Q?I9Rgn50mBQkO/MEVbkC4sx2ZHAx+oOl4q7UiQ9TXFgd32+RBULZEAg7mSyBD?= =?us-ascii?Q?JAkEyfKyeAy9cmd+IIeKW3rGq/Fz6x6CkUY//Hz+VrrCWhxGYF2OTee0BckP?= =?us-ascii?Q?GbioW0y4E95njaqbNHgdAPSmaWIEmZREd/c5g1XNkW3uQapjRO8mBSZt6yqK?= =?us-ascii?Q?ibFVb0IpOC+eR1jcLK+FLKAxfZrBekTITO/mwXGoIdDDRjAf5muTYTYcBjo7?= =?us-ascii?Q?v8A7/eTdqcvkM5Pmwj0M8bgkyBsLp1inFfluHVBPvk/jDBqm221oh8bUFr3Y?= =?us-ascii?Q?Hu3EhM2Jwukt2Vz8ZpAQSZgYWIFbX5PPouekD45QL/UFNzZrMr5q+/LlhC1v?= =?us-ascii?Q?UFXfMLMIbqihVjwGQXE6tlkvEIVJPgw+nWptudMZCBi3xB3BV1818tySG6bq?= =?us-ascii?Q?LOgdAUt+fEv5/mNeIVCB94SZh3xtVVgIgTV82gdGQzHWiJDD+U1DImKWNexn?= =?us-ascii?Q?L9NAeFsMqK1epspzGWdsQXSY3wbWvZ68TcP/HqTzSF6r2NHWhiZjObwJuAc5?= =?us-ascii?Q?0E08Ax/89BGSFENaAWRVTxPaTZsgty4jJ0yynQd2TxBbymlxC4Ndng8+Wj5f?= =?us-ascii?Q?TUyyPYmBZ4BrX+qmAiuLLLNxH5yWFSLQ4mPub+IhVZX1yOmYhaBq6+MaQ8qP?= =?us-ascii?Q?DmubBat7K2HlRpIeguXkruch0pGY4RQRG7uR1n+v0kcT5CxC4sLfUDL2YPJE?= =?us-ascii?Q?rYqYVp0yq6T0rAsdgM41k1YnAnqx7rWg3YBNM9ms2ih8sdnuOouCWg7YI/gH?= =?us-ascii?Q?WZ17PxQnWQm5Q6t5QTvRlkdJEozdFGIhVy02YcfFEV1Y7CBkQFApxHFQ8CPK?= =?us-ascii?Q?rV8jOXWCVrBQR5XVTvQo32Lm6A3/ZSJdAMecIeBC2ui2YCaR5TenIPSHl8wv?= =?us-ascii?Q?Gv3nez/WgY4pBOkR9zDHXxcOfNNXvsUuNnTny09k//CN+1OerDwL4LjFYzFe?= =?us-ascii?Q?9dts/XlUV0eVmZUtUCN2PtUJB7nsRgBeHNmdMMigELefTgj3Ig75MFP0VyAC?= =?us-ascii?Q?2Qcz9RRRIrxcXz7XxlURHqxOQZIsYmp5E96Zd58dVdKiBWGXYEU/U8TGlBf5?= =?us-ascii?Q?3b40KDA8Wyj2XdbYWGwrOagcQc+Onzu1dktsLjA/4d0keu2P7jnbkLfgD59p?= =?us-ascii?Q?/mHWzY50LKUyimAq0dOyRLO3tHRZoWguwhmY2STQqf4T5x96YbBvtmfOA/RU?= =?us-ascii?Q?YSQs4tTh6z9fNYTCXAGqDzqsocaEK1n/tJr+ib7gmuHSTohgGwLyd2Q9jJ/q?= =?us-ascii?Q?QYDKmS4=3D?= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BY3PR18MB4785.namprd18.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230040)(376014)(366016)(1800799024)(38070700018); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?+v57rvR+sG7Nop5vU09/Nq8+/JKj/FyBaPI9MwwS+28vFg250hgvknZjlLLc?= =?us-ascii?Q?0lp7I49kasrrGOGrxEoNLsrEQEeXi7l4vNSEuS9CUcs522QB0kklP7sOT18f?= =?us-ascii?Q?mRvurNi1wvAKpaKNuwNXdYW1SGtiKoRynOYe1ZbBW/Av4ALI+GBlSx7yWIX9?= =?us-ascii?Q?vHs+oawb4BNqwcUDlJi5bAGtV4gtvFdVZaJ3HEr/rtBXWMlREgbtNyIFcPJl?= =?us-ascii?Q?JSVCECzcwIsOYQYPulkyeFhbh9nw3rPuSdJD2IPQH10zxhbuH5BMuOrB0pxR?= =?us-ascii?Q?XOkrtRvb9la59wwgo7YzEr1EFe38ih4/0kJhX3SIyQQrBpgM/sSbWs6XQvpH?= =?us-ascii?Q?2DFH5yFaCvwyzcO9z7mPChv/sRwrcIwca8CoaxBsil1XSbCMl4y1oeeYasfP?= =?us-ascii?Q?XWo30PaV9NzijZ5FVq+w8rgmXiXCk4an5jsq3C3WM9jeyBW3Rv+CLxsWb+5R?= =?us-ascii?Q?cG5AGi7DYLWc/HtwP38hfTsLoRNn5c2I6B2RLSgJJyKkLfbAPeR0KXY9IChK?= =?us-ascii?Q?KgLH7HiAnU3Nj3OSew/m1rOi/2ugAKEapjec8HDBNGOYpL7C542463anEz32?= =?us-ascii?Q?6ftFwS6zELAfkLDaDZDdwkESt4urxY+I9F6G5NtUHh0hmcU36EmEWimmZHDn?= =?us-ascii?Q?tvZ7PmakLn4sLGGabPunN7Ym1yfeUt/mB+heTc+tOCQJQ4b1nQuZpsd2OFA5?= =?us-ascii?Q?zhW3em8QHBWPSF9A0m+9uC6+hz3YR4/O+53gQpzOdDWriFDnoeDemfnoBx7Z?= =?us-ascii?Q?y8igExvgvhhyr1M+p+s3puM2r9ZyDtyknEWl4BvKmqVwnPhCaEXPQK2IzB9K?= =?us-ascii?Q?5Xbiuc6diOwDpgnJiLdyR9iK4rpxZwMjux69TrpJFUugYQJ7qtqJ3uQJlLuf?= =?us-ascii?Q?e1VAQFpGLSOS/3TfyZjr/Ji2D+xefve/k/avrZCjyt4q4yDaNUzzC6lRy/G2?= =?us-ascii?Q?zzNNcgIoSnsC2ASrjHS9IR8tmF5DeNg2TB2Qdbj/eW41vBFf3MObmq2jtpr1?= =?us-ascii?Q?PadHrnxU/GZHmblILwziU4K3EvG326jsUmHdIXo/A5tGIOwKHfLatHTcxdVL?= =?us-ascii?Q?wDX8pHGYwn19F9D3+wiLExzFWNdMBh+/o0DIY4Wr5Js8Y1NU2AJd1qM8MMBq?= =?us-ascii?Q?2zxB3k2/uoCgN8u+FRQVKq7mHZlDiVWwrvo5cffMAHgGEUDHucQC/G91obym?= =?us-ascii?Q?m8M9mwCUHliLLzFz0Sfm9pdEWqlHefuPMKYhaKa8W85YgN12PgvjDgfwtbz/?= =?us-ascii?Q?9AYgAz+74HkxtRvwfhoz2s8ABU5eMnMKqDthB5xWtJuPz6qC3afUrGcgzas+?= =?us-ascii?Q?N0P7BoEobeHb/CeeP3p7wlpKYpSOoncnVFdQiMlS1eBi0RxVzqlxkKU3hxEI?= =?us-ascii?Q?AwWUT9KbI2HDGKeQImxDrOHzn5MBDllf7EPLOiCKbny1g0TaoDO4X8AGcvDw?= =?us-ascii?Q?HunlMvE+sw0AXF6Y7TqzgkR1DacDqoNTHOB8EjRBBy4G/Zhy/JtaGGWzsqrz?= =?us-ascii?Q?IL1EbN6BYf/LKIHNfLgvZE6ZJxrNUoItHuqfcBVA7k6oVjtBpJbVnlZoYsH2?= =?us-ascii?Q?LRoGFdLmQVfckZ9FoeY=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: marvell.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: BY3PR18MB4785.namprd18.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 387c81eb-9193-4703-e999-08dcf444cb54 X-MS-Exchange-CrossTenant-originalarrivaltime: 24 Oct 2024 15:59:08.5651 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: pBFe2itN4fFNr7luY5Wtle9d2R/+ciK6WP9h8gMxnHfQiNcPYArTVy69HMB6uyE5L9ToXkl34pGVfBVQIjriMA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR18MB5826 X-Proofpoint-ORIG-GUID: f_i2KmNG6ibJzu96oMMpMtYSUyfH3ldX X-Proofpoint-GUID: f_i2KmNG6ibJzu96oMMpMtYSUyfH3ldX X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.687,Hydra:6.0.235,FMLib:17.0.607.475 definitions=2020-10-13_15,2020-10-13_02,2020-04-07_01 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org > -----Original Message----- > From: Akhil Goyal > Sent: Thursday, October 24, 2024 6:48 PM > To: dev@dpdk.org > Cc: thomas@monjalon.net; david.marchand@redhat.com; > hemant.agrawal@nxp.com; Jerin Jacob ; Harman Kalra > ; stephen@networkplumber.org; > sachin.saxena@oss.nxp.com; ferruh.yigit@amd.com; Akhil Goyal > > Subject: [PATCH v5 1/9] drivers/raw: introduce cnxk rvu lf device driver >=20 > CNXK product families can have a use case to allow PF and VF applications= to > communicate using mailboxes and also get notified of any interrupt that m= ay > occur on the device. > Hence, a new raw device driver is added for such RVU LF devices. > These devices can map to a PF or a VF which can send mailboxes to each ot= her. >=20 > Signed-off-by: Akhil Goyal > --- _> + > NTB > M: Jingjing Wu > F: drivers/raw/ntb/ > diff --git a/doc/guides/rawdevs/cnxk_rvu_lf.rst > b/doc/guides/rawdevs/cnxk_rvu_lf.rst > new file mode 100644 > index 0000000000..8a0bc22dd5 > --- /dev/null > +++ b/doc/guides/rawdevs/cnxk_rvu_lf.rst > @@ -0,0 +1,40 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2024 Marvell. > + > +Marvell CNXK RVU LF Driver > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D > + > +CNXK product families can have a use case to allow PF and VF PF and VF -> RVU PF and RVU VF > +applications to communicate using mailboxes and also get notified of Applications-> driver > +any interrupt that may occur on the device. > +Hence, a new raw device driver is added for such RVU LF devices. > +These devices can map to a PF or a VF which can send mailboxes to each > +other. > + > +Features > +-------- > + > +The RVU LF device implements following features in the rawdev API: > + > +- Register mailbox callbacks for the other side to process mailboxes. > +- Register interrupt handler callbacks. > +- Process mailbox. > +- Set range of message IDs allowed for communication. Please update each lines in the respective patch. Also, please wire this file to doc/guides/platform/cnxk.rst like other cnx= k drivers > + > +Limitations > +----------- > + > +In multiprocess mode user-space application must ensure no resources > +sharing takes place. > +Otherwise, user-space application should ensure synchronization. > + > +Device Setup > +------------ > + > +The RVU LF devices will need to be bound to a user-space IO driver for u= se. > +The script ``dpdk-devbind.py`` included with DPDK can be used to view > +the state of the devices and to bind them to a suitable DPDK-supported > +kernel driver. When querying the status of the devices, they will > +appear under the category of "Misc (rawdev) devices", i.e. the command > +``dpdk-devbind.py --status-dev misc`` can be used to see the state of > +those devices alone.