pcie: Deprecate pcie_probe() and pcie_bdf_lookup()
These functions are no longer needed with the centralized framework for
scanning for available PCIe devices and discovering their BDF value
through it.
Signed-off-by: Johan Hedberg <johan.hedberg@intel.com>
diff --git a/doc/releases/release-notes-3.3.rst b/doc/releases/release-notes-3.3.rst
index b89034f..7575551 100644
--- a/doc/releases/release-notes-3.3.rst
+++ b/doc/releases/release-notes-3.3.rst
@@ -116,6 +116,9 @@
:kconfig:option:`CONFIG_SETTINGS_FS_MAX_LINES` in favor of :kconfig:option:`CONFIG_SETTINGS_FILE_MAX_LINES`
+* PCIe APIs :c:func:`pcie_probe` and :c:func:`pcie_bdf_lookup` have been
+ deprecated in favor of a centralized scan of available PCIe devices.
+
Stable API changes in this release
==================================
diff --git a/include/zephyr/drivers/pcie/pcie.h b/include/zephyr/drivers/pcie/pcie.h
index d85cd9b..307f410 100644
--- a/include/zephyr/drivers/pcie/pcie.h
+++ b/include/zephyr/drivers/pcie/pcie.h
@@ -11,6 +11,7 @@
#include <zephyr/devicetree.h>
#include <zephyr/dt-bindings/pcie/pcie.h>
#include <zephyr/types.h>
+#include <zephyr/kernel.h>
#ifdef __cplusplus
extern "C" {
@@ -151,10 +152,13 @@
* This function is used to look up the BDF for a device given its
* vendor and device ID.
*
+ * @deprecated
+ * @see DEVICE_PCIE_DECLARE
+ *
* @param id PCI(e) vendor & device ID encoded using PCIE_ID()
* @return The BDF for the device, or PCIE_BDF_NONE if it was not found
*/
-extern pcie_bdf_t pcie_bdf_lookup(pcie_id_t id);
+__deprecated extern pcie_bdf_t pcie_bdf_lookup(pcie_id_t id);
/**
* @brief Read a 32-bit word from an endpoint's configuration space.
@@ -222,11 +226,14 @@
/**
* @brief Probe for the presence of a PCI(e) endpoint.
*
+ * @deprecated
+ * @see DEVICE_PCIE_DECLARE
+ *
* @param bdf the endpoint to probe
* @param id the endpoint ID to expect, or PCIE_ID_NONE for "any device"
* @return true if the device is present, false otherwise
*/
-extern bool pcie_probe(pcie_bdf_t bdf, pcie_id_t id);
+__deprecated extern bool pcie_probe(pcie_bdf_t bdf, pcie_id_t id);
/**
* @brief Get the MBAR at a specific BAR index
