From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 171CBA055F;
Fri, 27 May 2022 10:26:53 +0200 (CEST)
Received: from [217.70.189.124] (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 89DF1410DC;
Fri, 27 May 2022 10:26:50 +0200 (CEST)
Received: from mga09.intel.com (mga09.intel.com [134.134.136.24])
by mails.dpdk.org (Postfix) with ESMTP id B00EC410DC;
Fri, 27 May 2022 10:26:47 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple;
d=intel.com; i=@intel.com; q=dns/txt; s=Intel;
t=1653640008; x=1685176008;
h=from:to:cc:subject:date:message-id:in-reply-to: references;
bh=EWzgrhVavLZfqlTAPYIpdrdqixZMzpYt8WQecPLmkIE=;
b=MXBP1SCGaciiNc2m+VIeNtRwEV0qMs+qe56pYzNlKQo2CejUNhVFIkPd
P0U4UdhqDttrsTkeRU2YBkJCzxyp0vzO9lGV/LYt/vH41iEgKFPebNPcH
hHao8i26neRkPH1OVgMobh6A869yPhYpsXxkYcx3gR1WJIGmiD16Z1U5T
U7bzIhHpa4DkgB1ZuBV8WFY6v/b6YdxPZKsOCnOobkAYwhA6l3qb4nBFn
WecR49udc4vkwqskUV9674LVnDN8EgvXu5T0QpcaiUC4YgPfddbQRdn1w
6DeJlVGsliXwQfbvDLeLekRlfzDv16r2hS3B4pljLUACaNUYEKMrYTS86 g==;
X-IronPort-AV: E=McAfee;i="6400,9594,10359"; a="274147319"
X-IronPort-AV: E=Sophos;i="5.91,254,1647327600"; d="scan'208";a="274147319"
Received: from orsmga001.jf.intel.com ([10.7.209.18])
by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;
27 May 2022 01:26:47 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.91,254,1647327600"; d="scan'208";a="610129519"
Received: from unknown (HELO zj-fpga-amt.sh.intel.com) ([10.238.175.102])
by orsmga001.jf.intel.com with ESMTP; 27 May 2022 01:26:44 -0700
From: Wei Huang <wei.huang@intel.com>
To: dev@dpdk.org, thomas@monjalon.net, nipun.gupta@nxp.com,
hemant.agrawal@nxp.com
Cc: stable@dpdk.org, rosen.xu@intel.com, tianfei.zhang@intel.com,
qi.z.zhang@intel.com, Wei Huang <wei.huang@intel.com>
Subject: [PATCH v4 1/5] raw/ifpga: remove experimental tag from ifpga APIs
Date: Fri, 27 May 2022 04:33:49 -0400
Message-Id: <1653640433-5066-2-git-send-email-wei.huang@intel.com>
X-Mailer: git-send-email 1.8.3.1
In-Reply-To: <1653640433-5066-1-git-send-email-wei.huang@intel.com>
References: <1653535974-1379-1-git-send-email-wei.huang@intel.com>
<1653640433-5066-1-git-send-email-wei.huang@intel.com>
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
These APIs are introduced in DPDK 21.05 and have been tested in several
release, experimental tag can be formally removed.
Signed-off-by: Wei Huang <wei.huang@intel.com>
Acked-by: Tianfei Zhang <tianfei.zhang@intel.com>
Reviewed-by: Rosen Xu <rosen.xu@intel.com>
---
drivers/raw/ifpga/rte_pmd_ifpga.h | 48 ---------------------------------------
drivers/raw/ifpga/version.map | 7 ++----
2 files changed, 2 insertions(+), 53 deletions(-)
diff --git a/drivers/raw/ifpga/rte_pmd_ifpga.h b/drivers/raw/ifpga/rte_pmd_ifpga.h
index 47d66ba..3fa5d34 100644
--- a/drivers/raw/ifpga/rte_pmd_ifpga.h
+++ b/drivers/raw/ifpga/rte_pmd_ifpga.h
@@ -68,9 +68,6 @@
} rte_pmd_ifpga_phy_info;
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get raw device ID from PCI address string like 'Domain:Bus:Dev.Func'
*
* @param pci_addr
@@ -82,14 +79,10 @@
* - (-EINVAL) if bad parameter.
* - (-ENODEV) if FPGA is not probed by ifpga driver.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_dev_id(const char *pci_addr, uint16_t *dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get current RSU status of the specified Intel FPGA device
*
* @param dev_id
@@ -103,14 +96,10 @@
* - (-ENODEV) if dev_id is invalid.
* - (-ENOMEM) if share data is not initialized.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_rsu_status(uint16_t dev_id, uint32_t *stat, uint32_t *prog);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Set current RSU status of the specified Intel FPGA device
*
* @param dev_id
@@ -124,14 +113,10 @@
* - (-ENODEV) if dev_id is invalid.
* - (-ENOMEM) if share data is not initialized.
*/
-__rte_experimental
int
rte_pmd_ifpga_set_rsu_status(uint16_t dev_id, uint32_t stat, uint32_t prog);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get FPGA property of specified Intel FPGA device
*
* @param dev_id
@@ -144,14 +129,10 @@
* - (-EBUSY) if FPGA is rebooting.
* - (-EIO) if failed to access hardware.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_property(uint16_t dev_id, rte_pmd_ifpga_prop *prop);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get PHY information of specified Intel FPGA device
*
* @param dev_id
@@ -164,14 +145,10 @@
* - (-EBUSY) if FPGA is rebooting.
* - (-EIO) if failed to access hardware.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_phy_info(uint16_t dev_id, rte_pmd_ifpga_phy_info *info);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Update image flash of specified Intel FPGA device
*
* @param dev_id
@@ -187,15 +164,11 @@
* - (-EBUSY) if FPGA is updating or rebooting.
* - (-EIO) if failed to open image file.
*/
-__rte_experimental
int
rte_pmd_ifpga_update_flash(uint16_t dev_id, const char *image,
uint64_t *status);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Stop flash update of specified Intel FPGA device
*
* @param dev_id
@@ -208,14 +181,10 @@
* - (-EINVAL) if bad parameter.
* - (-EAGAIN) if failed with force.
*/
-__rte_experimental
int
rte_pmd_ifpga_stop_update(uint16_t dev_id, int force);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Check current Intel FPGA status and change it to reboot status if it is idle
*
* @param dev_id
@@ -226,14 +195,10 @@
* - (-ENOMEM) if share data is not initialized.
* - (-EBUSY) if FPGA is updating or rebooting.
*/
-__rte_experimental
int
rte_pmd_ifpga_reboot_try(uint16_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Trigger full reconfiguration of specified Intel FPGA device
*
* @param dev_id
@@ -252,28 +217,20 @@
* - (-EINVAL) if bad parameter.
* - (-EBUSY) if failed to access BMC register.
*/
-__rte_experimental
int
rte_pmd_ifpga_reload(uint16_t dev_id, int type, int page);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get PCI bus the Intel FPGA driver register to
*
* @return
* - (valid pointer) if successful.
* - (NULL) if the Intel FPGA driver is not registered to any PCI bus.
*/
-__rte_experimental
const struct rte_pci_bus *
rte_pmd_ifpga_get_pci_bus(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Perform PR (partial reconfiguration) on specified Intel FPGA device
*
* @param dev_id
@@ -287,17 +244,12 @@
* - (-EINVAL) if bad parameter or operation failed.
* - (-ENOMEM) if failed to allocate memory.
*/
-__rte_experimental
int
rte_pmd_ifpga_partial_reconfigure(uint16_t dev_id, int port, const char *file);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Free software resources allocated by Intel FPGA PMD
*/
-__rte_experimental
void
rte_pmd_ifpga_cleanup(void);
diff --git a/drivers/raw/ifpga/version.map b/drivers/raw/ifpga/version.map
index a1a6be2..ff71a45 100644
--- a/drivers/raw/ifpga/version.map
+++ b/drivers/raw/ifpga/version.map
@@ -1,11 +1,6 @@
DPDK_22 {
- local: *;
-};
-
-EXPERIMENTAL {
global:
- # added in 21.05
rte_pmd_ifpga_get_dev_id;
rte_pmd_ifpga_get_rsu_status;
rte_pmd_ifpga_set_rsu_status;
@@ -18,4 +13,6 @@ EXPERIMENTAL {
rte_pmd_ifpga_get_pci_bus;
rte_pmd_ifpga_partial_reconfigure;
rte_pmd_ifpga_cleanup;
+
+ local: *;
};
--
1.8.3.1