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 0FF0DA0503;
Wed, 18 May 2022 10:22:28 +0200 (CEST)
Received: from [217.70.189.124] (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 1C7FB42B79;
Wed, 18 May 2022 10:22:24 +0200 (CEST)
Received: from mga07.intel.com (mga07.intel.com [134.134.136.100])
by mails.dpdk.org (Postfix) with ESMTP id 3BF9C42B70;
Wed, 18 May 2022 10:22:22 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple;
d=intel.com; i=@intel.com; q=dns/txt; s=Intel;
t=1652862142; x=1684398142;
h=from:to:cc:subject:date:message-id:in-reply-to: references;
bh=rX1xlBF8Bj4zKSKnkXIubPsQUVo2gPXA1xeg3ZSTmiQ=;
b=dVp11rd00ElfoWqe3+yIKIPbPbbU8QVea84rj7h9X5JF8ozWoARIdjlR
ZzZk0LbKANgrUL2Xqg4Y/K4/OnPgo6yeyufdq3I40LnkoXNdyQsR7gIeP
878JHjDP8LIikaoK30q9gSZmStTHXV4NFLsEneSlcZ7HXoqkr0ZEwZh4X
71kkngmoMqa5Dh4VTxNor2TVxh98CwiIAXeRFC5SWpUL61Yl3hSAsEH0C
ChyZxMj4PC8qTmBViJ1nwptkMEK8J2r0G1zSVZbiQ0zIVEuji4pA9nYog
j3cMJnAEwIX2K5pGeGgCnBA0UfLb3Id3SGUWK12HVyR8MumgTA4tq7UYv g==;
X-IronPort-AV: E=McAfee;i="6400,9594,10350"; a="334599416"
X-IronPort-AV: E=Sophos;i="5.91,234,1647327600"; d="scan'208";a="334599416"
Received: from orsmga005.jf.intel.com ([10.7.209.41])
by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;
18 May 2022 01:22:21 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.91,234,1647327600"; d="scan'208";a="742209865"
Received: from zj-fpga-amt.sh.intel.com ([10.238.175.102])
by orsmga005.jf.intel.com with ESMTP; 18 May 2022 01:22:19 -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 v2 1/4] raw/ifpga: remove experimental tag from ifpga APIs
Date: Wed, 18 May 2022 04:29:06 -0400
Message-Id: <1652862549-13131-2-git-send-email-wei.huang@intel.com>
X-Mailer: git-send-email 1.8.3.1
In-Reply-To: <1652862549-13131-1-git-send-email-wei.huang@intel.com>
References: <20220517062854.1161727-5-wei.huang@intel.com>
<1652862549-13131-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>
---
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