Zephyr API Documentation  3.6.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
PCIe Host Interface

PCIe Host Interface. More...

Modules

 PCIe Capabilities
 
 PCIe Host MSI Interface
 PCIe Host MSI Interface.
 
 PCIe Host PTM Interface
 PCIe Host PTM Interface.
 
 PCIe Virtual Channel Host Interface
 PCIe Virtual Channel Host Interface.
 

Data Structures

struct  pcie_dev
 
struct  pcie_bar
 
struct  pcie_scan_opt
 Options for performing a scan for PCI devices. More...
 

Macros

#define PCIE_ID_IS_VALID(id)
 
#define PCIE_DT_ID(node_id)
 Get the PCIe Vendor and Device ID for a node.
 
#define PCIE_DT_INST_ID(inst)   PCIE_DT_ID(DT_DRV_INST(inst))
 Get the PCIe Vendor and Device ID for a node.
 
#define DEVICE_PCIE_DECLARE(node_id)
 Declare a PCIe context variable for a DTS node.
 
#define DEVICE_PCIE_INST_DECLARE(inst)   DEVICE_PCIE_DECLARE(DT_DRV_INST(inst))
 Declare a PCIe context variable for a DTS node.
 
#define DEVICE_PCIE_INIT(node_id, name)   .name = &Z_DEVICE_PCIE_NAME(node_id)
 Initialize a named struct member to point at a PCIe context.
 
#define DEVICE_PCIE_INST_INIT(inst, name)    DEVICE_PCIE_INIT(DT_DRV_INST(inst), name)
 Initialize a named struct member to point at a PCIe context.
 
#define PCIE_HOST_CONTROLLER(n)   PCIE_BDF(0, 0, n)
 Get the BDF for a given PCI host controller.
 
#define PCIE_CONF_CAPPTR   13U /* capabilities pointer */
 
#define PCIE_CONF_CAPPTR_FIRST(w)   (((w) >> 2) & 0x3FU)
 
#define PCIE_CONF_CAP_ID(w)   ((w) & 0xFFU)
 
#define PCIE_CONF_CAP_NEXT(w)   (((w) >> 10) & 0x3FU)
 
#define PCIE_CONF_EXT_CAPPTR   64U
 
#define PCIE_CONF_EXT_CAP_ID(w)   ((w) & 0xFFFFU)
 
#define PCIE_CONF_EXT_CAP_VER(w)   (((w) >> 16) & 0xFU)
 
#define PCIE_CONF_EXT_CAP_NEXT(w)   (((w) >> 20) & 0xFFFU)
 
#define PCIE_CONF_ID   0U
 
#define PCIE_CONF_CMDSTAT   1U /* command/status register */
 
#define PCIE_CONF_CMDSTAT_IO   0x00000001U /* I/O access enable */
 
#define PCIE_CONF_CMDSTAT_MEM   0x00000002U /* mem access enable */
 
#define PCIE_CONF_CMDSTAT_MASTER   0x00000004U /* bus master enable */
 
#define PCIE_CONF_CMDSTAT_INTERRUPT   0x00080000U /* interrupt status */
 
#define PCIE_CONF_CMDSTAT_CAPS   0x00100000U /* capabilities list */
 
#define PCIE_CONF_CLASSREV   2U /* class/revision register */
 
#define PCIE_CONF_CLASSREV_CLASS(w)   (((w) >> 24) & 0xFFU)
 
#define PCIE_CONF_CLASSREV_SUBCLASS(w)   (((w) >> 16) & 0xFFU)
 
#define PCIE_CONF_CLASSREV_PROGIF(w)   (((w) >> 8) & 0xFFU)
 
#define PCIE_CONF_CLASSREV_REV(w)   ((w) & 0xFFU)
 
#define PCIE_CONF_TYPE   3U
 
#define PCIE_CONF_MULTIFUNCTION(w)   (((w) & 0x00800000U) != 0U)
 
#define PCIE_CONF_TYPE_BRIDGE(w)   (((w) & 0x007F0000U) != 0U)
 
#define PCIE_CONF_TYPE_GET(w)   (((w) >> 16) & 0x7F)
 
#define PCIE_CONF_TYPE_STANDARD   0x0U
 
#define PCIE_CONF_TYPE_PCI_BRIDGE   0x1U
 
#define PCIE_CONF_TYPE_CARDBUS_BRIDGE   0x2U
 
#define PCIE_CONF_BAR0   4U
 
#define PCIE_CONF_BAR1   5U
 
#define PCIE_CONF_BAR2   6U
 
#define PCIE_CONF_BAR3   7U
 
#define PCIE_CONF_BAR4   8U
 
#define PCIE_CONF_BAR5   9U
 
#define PCIE_CONF_BAR_IO(w)   (((w) & 0x00000001U) == 0x00000001U)
 
#define PCIE_CONF_BAR_MEM(w)   (((w) & 0x00000001U) != 0x00000001U)
 
#define PCIE_CONF_BAR_64(w)   (((w) & 0x00000006U) == 0x00000004U)
 
#define PCIE_CONF_BAR_ADDR(w)   ((w) & ~0xfUL)
 
#define PCIE_CONF_BAR_IO_ADDR(w)   ((w) & ~0x3UL)
 
#define PCIE_CONF_BAR_FLAGS(w)   ((w) & 0xfUL)
 
#define PCIE_CONF_BAR_NONE   0U
 
#define PCIE_CONF_BAR_INVAL   0xFFFFFFF0U
 
#define PCIE_CONF_BAR_INVAL64   0xFFFFFFFFFFFFFFF0UL
 
#define PCIE_CONF_BAR_INVAL_FLAGS(w)
 
#define PCIE_BUS_NUMBER   6U
 
#define PCIE_BUS_PRIMARY_NUMBER(w)   ((w) & 0xffUL)
 
#define PCIE_BUS_SECONDARY_NUMBER(w)   (((w) >> 8) & 0xffUL)
 
#define PCIE_BUS_SUBORDINATE_NUMBER(w)   (((w) >> 16) & 0xffUL)
 
#define PCIE_SECONDARY_LATENCY_TIMER(w)   (((w) >> 24) & 0xffUL)
 
#define PCIE_BUS_NUMBER_VAL(prim, sec, sub, lat)
 
#define PCIE_IO_SEC_STATUS   7U
 
#define PCIE_IO_BASE(w)   ((w) & 0xffUL)
 
#define PCIE_IO_LIMIT(w)   (((w) >> 8) & 0xffUL)
 
#define PCIE_SEC_STATUS(w)   (((w) >> 16) & 0xffffUL)
 
#define PCIE_IO_SEC_STATUS_VAL(iob, iol, sec_status)
 
#define PCIE_MEM_BASE_LIMIT   8U
 
#define PCIE_MEM_BASE(w)   ((w) & 0xffffUL)
 
#define PCIE_MEM_LIMIT(w)   (((w) >> 16) & 0xffffUL)
 
#define PCIE_MEM_BASE_LIMIT_VAL(memb, meml)
 
#define PCIE_PREFETCH_BASE_LIMIT   9U
 
#define PCIE_PREFETCH_BASE(w)   ((w) & 0xffffUL)
 
#define PCIE_PREFETCH_LIMIT(w)   (((w) >> 16) & 0xffffUL)
 
#define PCIE_PREFETCH_BASE_LIMIT_VAL(pmemb, pmeml)
 
#define PCIE_PREFETCH_BASE_UPPER   10U
 
#define PCIE_PREFETCH_LIMIT_UPPER   11U
 
#define PCIE_IO_BASE_LIMIT_UPPER   12U
 
#define PCIE_IO_BASE_UPPER(w)   ((w) & 0xffffUL)
 
#define PCIE_IO_LIMIT_UPPER(w)   (((w) >> 16) & 0xffffUL)
 
#define PCIE_IO_BASE_LIMIT_UPPER_VAL(iobu, iolu)
 
#define PCIE_CONF_INTR   15U
 
#define PCIE_CONF_INTR_IRQ(w)   ((w) & 0xFFU)
 
#define PCIE_CONF_INTR_IRQ_NONE   0xFFU /* no interrupt routed */
 
#define PCIE_MAX_BUS   (0xFFFFFFFFU & PCIE_BDF_BUS_MASK)
 
#define PCIE_MAX_DEV   (0xFFFFFFFFU & PCIE_BDF_DEV_MASK)
 
#define PCIE_MAX_FUNC   (0xFFFFFFFFU & PCIE_BDF_FUNC_MASK)
 
#define PCIE_IRQ_CONNECT(bdf_p, irq_p, priority_p, isr_p, isr_param_p, flags_p)
 Initialize an interrupt handler for a PCIe endpoint IRQ.
 

Typedefs

typedef uint32_t pcie_bdf_t
 A unique PCI(e) endpoint (bus, device, function).
 
typedef uint32_t pcie_id_t
 A unique PCI(e) identifier (vendor ID, device ID).
 
typedef bool(* pcie_scan_cb_t) (pcie_bdf_t bdf, pcie_id_t id, void *cb_data)
 Callback type used for scanning for PCI endpoints.
 

Enumerations

enum  { PCIE_SCAN_RECURSIVE = BIT(0) , PCIE_SCAN_CB_ALL = BIT(1) }
 

Functions

uint32_t pcie_conf_read (pcie_bdf_t bdf, unsigned int reg)
 Read a 32-bit word from an endpoint's configuration space.
 
void pcie_conf_write (pcie_bdf_t bdf, unsigned int reg, uint32_t data)
 Write a 32-bit word to an endpoint's configuration space.
 
int pcie_scan (const struct pcie_scan_opt *opt)
 Scan for PCIe devices.
 
bool pcie_get_mbar (pcie_bdf_t bdf, unsigned int bar_index, struct pcie_bar *mbar)
 Get the MBAR at a specific BAR index.
 
bool pcie_probe_mbar (pcie_bdf_t bdf, unsigned int index, struct pcie_bar *mbar)
 Probe the nth MMIO address assigned to an endpoint.
 
bool pcie_get_iobar (pcie_bdf_t bdf, unsigned int bar_index, struct pcie_bar *iobar)
 Get the I/O BAR at a specific BAR index.
 
bool pcie_probe_iobar (pcie_bdf_t bdf, unsigned int index, struct pcie_bar *iobar)
 Probe the nth I/O BAR address assigned to an endpoint.
 
void pcie_set_cmd (pcie_bdf_t bdf, uint32_t bits, bool on)
 Set or reset bits in the endpoint command/status register.
 
unsigned int pcie_alloc_irq (pcie_bdf_t bdf)
 Allocate an IRQ for an endpoint.
 
unsigned int pcie_get_irq (pcie_bdf_t bdf)
 Return the IRQ assigned by the firmware/board to an endpoint.
 
void pcie_irq_enable (pcie_bdf_t bdf, unsigned int irq)
 Enable the PCI(e) endpoint to generate the specified IRQ.
 
uint32_t pcie_get_cap (pcie_bdf_t bdf, uint32_t cap_id)
 Find a PCI(e) capability in an endpoint's configuration space.
 
uint32_t pcie_get_ext_cap (pcie_bdf_t bdf, uint32_t cap_id)
 Find an Extended PCI(e) capability in an endpoint's configuration space.
 
bool pcie_connect_dynamic_irq (pcie_bdf_t bdf, unsigned int irq, unsigned int priority, void(*routine)(const void *parameter), const void *parameter, uint32_t flags)
 Dynamically connect a PCIe endpoint IRQ to an ISR handler.
 

Detailed Description

PCIe Host Interface.

Macro Definition Documentation

◆ DEVICE_PCIE_DECLARE

#define DEVICE_PCIE_DECLARE (   node_id)

#include <zephyr/drivers/pcie/pcie.h>

Value:
STRUCT_SECTION_ITERABLE(pcie_dev, Z_DEVICE_PCIE_NAME(node_id)) = { \
.bdf = PCIE_BDF_NONE, \
.id = PCIE_DT_ID(node_id), \
.class_rev = DT_PROP_OR(node_id, class_rev, 0), \
.class_rev_mask = DT_PROP_OR(node_id, class_rev_mask, 0), \
}
#define PCIE_BDF_NONE
Definition: pcie.h:44
#define DT_PROP_OR(node_id, prop, default_value)
Like DT_PROP(), but with a fallback to default_value.
Definition: devicetree.h:798
#define STRUCT_SECTION_ITERABLE(struct_type, varname)
Defines a new element for an iterable section.
Definition: iterable_sections.h:216
#define PCIE_DT_ID(node_id)
Get the PCIe Vendor and Device ID for a node.
Definition: pcie.h:74
Definition: pcie.h:59

Declare a PCIe context variable for a DTS node.

Declares a PCIe context for a DTS node. This must be done before using the DEVICE_PCIE_INIT() macro for the same node.

Parameters
node_idDTS node identifier

◆ DEVICE_PCIE_INIT

#define DEVICE_PCIE_INIT (   node_id,
  name 
)    .name = &Z_DEVICE_PCIE_NAME(node_id)

#include <zephyr/drivers/pcie/pcie.h>

Initialize a named struct member to point at a PCIe context.

Initialize PCIe-related information within a specific instance of a device config struct, using information from DTS. Using the macro requires having first created PCIe context struct using the DEVICE_PCIE_DECLARE() macro.

Example for an instance of a driver belonging to the "foo" subsystem

struct foo_config { struct pcie_dev *pcie; ... };

DEVICE_PCIE_ID_DECLARE(DT_DRV_INST(...)); struct foo_config my_config = { DEVICE_PCIE_INIT(pcie, DT_DRV_INST(...)), ... };

Parameters
node_idDTS node identifier
nameMember name within config for the MMIO region

◆ DEVICE_PCIE_INST_DECLARE

#define DEVICE_PCIE_INST_DECLARE (   inst)    DEVICE_PCIE_DECLARE(DT_DRV_INST(inst))

#include <zephyr/drivers/pcie/pcie.h>

Declare a PCIe context variable for a DTS node.

This is equivalent to DEVICE_PCIE_DECLARE(DT_DRV_INST(inst))

Parameters
instDevicetree instance number

◆ DEVICE_PCIE_INST_INIT

#define DEVICE_PCIE_INST_INIT (   inst,
  name 
)     DEVICE_PCIE_INIT(DT_DRV_INST(inst), name)

#include <zephyr/drivers/pcie/pcie.h>

Initialize a named struct member to point at a PCIe context.

This is equivalent to DEVICE_PCIE_INIT(DT_DRV_INST(inst), name)

Parameters
instDevicetree instance number
nameName of the struct member (of type struct pcie_dev *)

◆ PCIE_BUS_NUMBER

#define PCIE_BUS_NUMBER   6U

◆ PCIE_BUS_NUMBER_VAL

#define PCIE_BUS_NUMBER_VAL (   prim,
  sec,
  sub,
  lat 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
(((prim) & 0xffUL) | \
(((sec) & 0xffUL) << 8) | \
(((sub) & 0xffUL) << 16) | \
(((lat) & 0xffUL) << 24))

◆ PCIE_BUS_PRIMARY_NUMBER

#define PCIE_BUS_PRIMARY_NUMBER (   w)    ((w) & 0xffUL)

◆ PCIE_BUS_SECONDARY_NUMBER

#define PCIE_BUS_SECONDARY_NUMBER (   w)    (((w) >> 8) & 0xffUL)

◆ PCIE_BUS_SUBORDINATE_NUMBER

#define PCIE_BUS_SUBORDINATE_NUMBER (   w)    (((w) >> 16) & 0xffUL)

◆ PCIE_CONF_BAR0

#define PCIE_CONF_BAR0   4U

◆ PCIE_CONF_BAR1

#define PCIE_CONF_BAR1   5U

◆ PCIE_CONF_BAR2

#define PCIE_CONF_BAR2   6U

◆ PCIE_CONF_BAR3

#define PCIE_CONF_BAR3   7U

◆ PCIE_CONF_BAR4

#define PCIE_CONF_BAR4   8U

◆ PCIE_CONF_BAR5

#define PCIE_CONF_BAR5   9U

◆ PCIE_CONF_BAR_64

#define PCIE_CONF_BAR_64 (   w)    (((w) & 0x00000006U) == 0x00000004U)

◆ PCIE_CONF_BAR_ADDR

#define PCIE_CONF_BAR_ADDR (   w)    ((w) & ~0xfUL)

◆ PCIE_CONF_BAR_FLAGS

#define PCIE_CONF_BAR_FLAGS (   w)    ((w) & 0xfUL)

◆ PCIE_CONF_BAR_INVAL

#define PCIE_CONF_BAR_INVAL   0xFFFFFFF0U

◆ PCIE_CONF_BAR_INVAL64

#define PCIE_CONF_BAR_INVAL64   0xFFFFFFFFFFFFFFF0UL

◆ PCIE_CONF_BAR_INVAL_FLAGS

#define PCIE_CONF_BAR_INVAL_FLAGS (   w)

#include <zephyr/drivers/pcie/pcie.h>

Value:
((((w) & 0x00000006U) == 0x00000006U) || \
(((w) & 0x00000006U) == 0x00000002U))

◆ PCIE_CONF_BAR_IO

#define PCIE_CONF_BAR_IO (   w)    (((w) & 0x00000001U) == 0x00000001U)

◆ PCIE_CONF_BAR_IO_ADDR

#define PCIE_CONF_BAR_IO_ADDR (   w)    ((w) & ~0x3UL)

◆ PCIE_CONF_BAR_MEM

#define PCIE_CONF_BAR_MEM (   w)    (((w) & 0x00000001U) != 0x00000001U)

◆ PCIE_CONF_BAR_NONE

#define PCIE_CONF_BAR_NONE   0U

◆ PCIE_CONF_CAP_ID

#define PCIE_CONF_CAP_ID (   w)    ((w) & 0xFFU)

◆ PCIE_CONF_CAP_NEXT

#define PCIE_CONF_CAP_NEXT (   w)    (((w) >> 10) & 0x3FU)

◆ PCIE_CONF_CAPPTR

#define PCIE_CONF_CAPPTR   13U /* capabilities pointer */

◆ PCIE_CONF_CAPPTR_FIRST

#define PCIE_CONF_CAPPTR_FIRST (   w)    (((w) >> 2) & 0x3FU)

◆ PCIE_CONF_CLASSREV

#define PCIE_CONF_CLASSREV   2U /* class/revision register */

◆ PCIE_CONF_CLASSREV_CLASS

#define PCIE_CONF_CLASSREV_CLASS (   w)    (((w) >> 24) & 0xFFU)

◆ PCIE_CONF_CLASSREV_PROGIF

#define PCIE_CONF_CLASSREV_PROGIF (   w)    (((w) >> 8) & 0xFFU)

◆ PCIE_CONF_CLASSREV_REV

#define PCIE_CONF_CLASSREV_REV (   w)    ((w) & 0xFFU)

◆ PCIE_CONF_CLASSREV_SUBCLASS

#define PCIE_CONF_CLASSREV_SUBCLASS (   w)    (((w) >> 16) & 0xFFU)

◆ PCIE_CONF_CMDSTAT

#define PCIE_CONF_CMDSTAT   1U /* command/status register */

◆ PCIE_CONF_CMDSTAT_CAPS

#define PCIE_CONF_CMDSTAT_CAPS   0x00100000U /* capabilities list */

◆ PCIE_CONF_CMDSTAT_INTERRUPT

#define PCIE_CONF_CMDSTAT_INTERRUPT   0x00080000U /* interrupt status */

◆ PCIE_CONF_CMDSTAT_IO

#define PCIE_CONF_CMDSTAT_IO   0x00000001U /* I/O access enable */

◆ PCIE_CONF_CMDSTAT_MASTER

#define PCIE_CONF_CMDSTAT_MASTER   0x00000004U /* bus master enable */

◆ PCIE_CONF_CMDSTAT_MEM

#define PCIE_CONF_CMDSTAT_MEM   0x00000002U /* mem access enable */

◆ PCIE_CONF_EXT_CAP_ID

#define PCIE_CONF_EXT_CAP_ID (   w)    ((w) & 0xFFFFU)

◆ PCIE_CONF_EXT_CAP_NEXT

#define PCIE_CONF_EXT_CAP_NEXT (   w)    (((w) >> 20) & 0xFFFU)

◆ PCIE_CONF_EXT_CAP_VER

#define PCIE_CONF_EXT_CAP_VER (   w)    (((w) >> 16) & 0xFU)

◆ PCIE_CONF_EXT_CAPPTR

#define PCIE_CONF_EXT_CAPPTR   64U

◆ PCIE_CONF_ID

#define PCIE_CONF_ID   0U

◆ PCIE_CONF_INTR

#define PCIE_CONF_INTR   15U

◆ PCIE_CONF_INTR_IRQ

#define PCIE_CONF_INTR_IRQ (   w)    ((w) & 0xFFU)

◆ PCIE_CONF_INTR_IRQ_NONE

#define PCIE_CONF_INTR_IRQ_NONE   0xFFU /* no interrupt routed */

◆ PCIE_CONF_MULTIFUNCTION

#define PCIE_CONF_MULTIFUNCTION (   w)    (((w) & 0x00800000U) != 0U)

◆ PCIE_CONF_TYPE

#define PCIE_CONF_TYPE   3U

◆ PCIE_CONF_TYPE_BRIDGE

#define PCIE_CONF_TYPE_BRIDGE (   w)    (((w) & 0x007F0000U) != 0U)

◆ PCIE_CONF_TYPE_CARDBUS_BRIDGE

#define PCIE_CONF_TYPE_CARDBUS_BRIDGE   0x2U

◆ PCIE_CONF_TYPE_GET

#define PCIE_CONF_TYPE_GET (   w)    (((w) >> 16) & 0x7F)

◆ PCIE_CONF_TYPE_PCI_BRIDGE

#define PCIE_CONF_TYPE_PCI_BRIDGE   0x1U

◆ PCIE_CONF_TYPE_STANDARD

#define PCIE_CONF_TYPE_STANDARD   0x0U

◆ PCIE_DT_ID

#define PCIE_DT_ID (   node_id)

#include <zephyr/drivers/pcie/pcie.h>

Value:
PCIE_ID(DT_PROP_OR(node_id, vendor_id, 0xffff), \
DT_PROP_OR(node_id, device_id, 0xffff))
#define PCIE_ID(vend, dev)
Definition: pcie.h:35

Get the PCIe Vendor and Device ID for a node.

Parameters
node_idDTS node identifier
Returns
The VID/DID combination as pcie_id_t

◆ PCIE_DT_INST_ID

#define PCIE_DT_INST_ID (   inst)    PCIE_DT_ID(DT_DRV_INST(inst))

#include <zephyr/drivers/pcie/pcie.h>

Get the PCIe Vendor and Device ID for a node.

This is equivalent to PCIE_DT_ID(DT_DRV_INST(inst))

Parameters
instDevicetree instance number
Returns
The VID/DID combination as pcie_id_t

◆ PCIE_HOST_CONTROLLER

#define PCIE_HOST_CONTROLLER (   n)    PCIE_BDF(0, 0, n)

#include <zephyr/drivers/pcie/pcie.h>

Get the BDF for a given PCI host controller.

This macro is useful when the PCI host controller behind PCIE_BDF(0, 0, 0) indicates a multifunction device. In such a case each function of this endpoint is a potential host controller itself.

Parameters
nBus number
Returns
BDF value of the given host controller

◆ PCIE_ID_IS_VALID

#define PCIE_ID_IS_VALID (   id)

#include <zephyr/drivers/pcie/pcie.h>

Value:
((id != PCIE_ID_NONE) && \
(id != PCIE_ID(0x0000, 0x0000)) && \
(id != PCIE_ID(0xFFFF, 0x0000)) && \
(id != PCIE_ID(0x0000, 0xFFFF)))
#define PCIE_ID_NONE
Definition: pcie.h:42

◆ PCIE_IO_BASE

#define PCIE_IO_BASE (   w)    ((w) & 0xffUL)

◆ PCIE_IO_BASE_LIMIT_UPPER

#define PCIE_IO_BASE_LIMIT_UPPER   12U

◆ PCIE_IO_BASE_LIMIT_UPPER_VAL

#define PCIE_IO_BASE_LIMIT_UPPER_VAL (   iobu,
  iolu 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
(((iobu) & 0xffffUL) | \
(((iolu) & 0xffffUL) << 16))

◆ PCIE_IO_BASE_UPPER

#define PCIE_IO_BASE_UPPER (   w)    ((w) & 0xffffUL)

◆ PCIE_IO_LIMIT

#define PCIE_IO_LIMIT (   w)    (((w) >> 8) & 0xffUL)

◆ PCIE_IO_LIMIT_UPPER

#define PCIE_IO_LIMIT_UPPER (   w)    (((w) >> 16) & 0xffffUL)

◆ PCIE_IO_SEC_STATUS

#define PCIE_IO_SEC_STATUS   7U

◆ PCIE_IO_SEC_STATUS_VAL

#define PCIE_IO_SEC_STATUS_VAL (   iob,
  iol,
  sec_status 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
(((iob) & 0xffUL) | \
(((iol) & 0xffUL) << 8) | \
(((sec_status) & 0xffffUL) << 16))

◆ PCIE_IRQ_CONNECT

#define PCIE_IRQ_CONNECT (   bdf_p,
  irq_p,
  priority_p,
  isr_p,
  isr_param_p,
  flags_p 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
ARCH_PCIE_IRQ_CONNECT(bdf_p, irq_p, priority_p, \
isr_p, isr_param_p, flags_p)

Initialize an interrupt handler for a PCIe endpoint IRQ.

This routine is only meant to be used by drivers using PCIe bus and having fixed or MSI based IRQ (so no runtime detection of the IRQ). In case of runtime detection see pcie_connect_dynamic_irq()

Parameters
bdf_pPCIe endpoint BDF
irq_pIRQ line number.
priority_pInterrupt priority.
isr_pAddress of interrupt service routine.
isr_param_pParameter passed to interrupt service routine.
flags_pArchitecture-specific IRQ configuration flags..

◆ PCIE_MAX_BUS

#define PCIE_MAX_BUS   (0xFFFFFFFFU & PCIE_BDF_BUS_MASK)

◆ PCIE_MAX_DEV

#define PCIE_MAX_DEV   (0xFFFFFFFFU & PCIE_BDF_DEV_MASK)

◆ PCIE_MAX_FUNC

#define PCIE_MAX_FUNC   (0xFFFFFFFFU & PCIE_BDF_FUNC_MASK)

◆ PCIE_MEM_BASE

#define PCIE_MEM_BASE (   w)    ((w) & 0xffffUL)

◆ PCIE_MEM_BASE_LIMIT

#define PCIE_MEM_BASE_LIMIT   8U

◆ PCIE_MEM_BASE_LIMIT_VAL

#define PCIE_MEM_BASE_LIMIT_VAL (   memb,
  meml 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
(((memb) & 0xffffUL) | \
(((meml) & 0xffffUL) << 16))

◆ PCIE_MEM_LIMIT

#define PCIE_MEM_LIMIT (   w)    (((w) >> 16) & 0xffffUL)

◆ PCIE_PREFETCH_BASE

#define PCIE_PREFETCH_BASE (   w)    ((w) & 0xffffUL)

◆ PCIE_PREFETCH_BASE_LIMIT

#define PCIE_PREFETCH_BASE_LIMIT   9U

◆ PCIE_PREFETCH_BASE_LIMIT_VAL

#define PCIE_PREFETCH_BASE_LIMIT_VAL (   pmemb,
  pmeml 
)

#include <zephyr/drivers/pcie/pcie.h>

Value:
(((pmemb) & 0xffffUL) | \
(((pmeml) & 0xffffUL) << 16))

◆ PCIE_PREFETCH_BASE_UPPER

#define PCIE_PREFETCH_BASE_UPPER   10U

◆ PCIE_PREFETCH_LIMIT

#define PCIE_PREFETCH_LIMIT (   w)    (((w) >> 16) & 0xffffUL)

◆ PCIE_PREFETCH_LIMIT_UPPER

#define PCIE_PREFETCH_LIMIT_UPPER   11U

◆ PCIE_SEC_STATUS

#define PCIE_SEC_STATUS (   w)    (((w) >> 16) & 0xffffUL)

◆ PCIE_SECONDARY_LATENCY_TIMER

#define PCIE_SECONDARY_LATENCY_TIMER (   w)    (((w) >> 24) & 0xffUL)

Typedef Documentation

◆ pcie_bdf_t

#include <zephyr/drivers/pcie/pcie.h>

A unique PCI(e) endpoint (bus, device, function).

A PCI(e) endpoint is uniquely identified topologically using a (bus, device, function) tuple. The internal structure is documented in include/dt-bindings/pcie/pcie.h: see PCIE_BDF() and friends, since these tuples are referenced from devicetree.

◆ pcie_id_t

#include <zephyr/drivers/pcie/pcie.h>

A unique PCI(e) identifier (vendor ID, device ID).

The PCIE_CONF_ID register for each endpoint is a (vendor ID, device ID) pair, which is meant to tell the system what the PCI(e) endpoint is. Again, look to PCIE_ID_* macros in include/dt-bindings/pcie/pcie.h for more.

◆ pcie_scan_cb_t

typedef bool(* pcie_scan_cb_t) (pcie_bdf_t bdf, pcie_id_t id, void *cb_data)

#include <zephyr/drivers/pcie/pcie.h>

Callback type used for scanning for PCI endpoints.

Parameters
bdfBDF value for a found endpoint.
idVendor & Device ID for the found endpoint.
cb_dataCustom, use case specific data.
Returns
true to continue scanning, false to stop scanning.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

#include <zephyr/drivers/pcie/pcie.h>

Enumerator
PCIE_SCAN_RECURSIVE 

Scan all available PCI host controllers and sub-busses.

PCIE_SCAN_CB_ALL 

Do the callback for all endpoint types, including bridges.

Function Documentation

◆ pcie_alloc_irq()

unsigned int pcie_alloc_irq ( pcie_bdf_t  bdf)

#include <zephyr/drivers/pcie/pcie.h>

Allocate an IRQ for an endpoint.

This function first checks the IRQ register and if it contains a valid value this is returned. If the register does not contain a valid value allocation of a new one is attempted. Such function is only exposed if CONFIG_PCIE_CONTROLLER is unset. It is thus available where architecture tied dynamic IRQ allocation for PCIe device makes sense.

Parameters
bdfthe PCI(e) endpoint
Returns
the IRQ number, or PCIE_CONF_INTR_IRQ_NONE if allocation failed.

◆ pcie_conf_read()

uint32_t pcie_conf_read ( pcie_bdf_t  bdf,
unsigned int  reg 
)

#include <zephyr/drivers/pcie/pcie.h>

Read a 32-bit word from an endpoint's configuration space.

This function is exported by the arch/SoC/board code.

Parameters
bdfPCI(e) endpoint
regthe configuration word index (not address)
Returns
the word read (0xFFFFFFFFU if nonexistent endpoint or word)

◆ pcie_conf_write()

void pcie_conf_write ( pcie_bdf_t  bdf,
unsigned int  reg,
uint32_t  data 
)

#include <zephyr/drivers/pcie/pcie.h>

Write a 32-bit word to an endpoint's configuration space.

This function is exported by the arch/SoC/board code.

Parameters
bdfPCI(e) endpoint
regthe configuration word index (not address)
datathe value to write

◆ pcie_connect_dynamic_irq()

bool pcie_connect_dynamic_irq ( pcie_bdf_t  bdf,
unsigned int  irq,
unsigned int  priority,
void(*)(const void *parameter)  routine,
const void *  parameter,
uint32_t  flags 
)

#include <zephyr/drivers/pcie/pcie.h>

Dynamically connect a PCIe endpoint IRQ to an ISR handler.

Parameters
bdfthe PCI endpoint to examine
irqthe IRQ to connect (see pcie_alloc_irq())
prioritypriority of the IRQ
routinethe ISR handler to connect to the IRQ
parameterthe parameter to provide to the handler
flagsIRQ connection flags
Returns
true if connected, false otherwise

◆ pcie_get_cap()

uint32_t pcie_get_cap ( pcie_bdf_t  bdf,
uint32_t  cap_id 
)

#include <zephyr/drivers/pcie/pcie.h>

Find a PCI(e) capability in an endpoint's configuration space.

Parameters
bdfthe PCI endpoint to examine
cap_idthe capability ID of interest
Returns
the index of the configuration word, or 0 if no capability.

◆ pcie_get_ext_cap()

uint32_t pcie_get_ext_cap ( pcie_bdf_t  bdf,
uint32_t  cap_id 
)

#include <zephyr/drivers/pcie/pcie.h>

Find an Extended PCI(e) capability in an endpoint's configuration space.

Parameters
bdfthe PCI endpoint to examine
cap_idthe capability ID of interest
Returns
the index of the configuration word, or 0 if no capability.

◆ pcie_get_iobar()

bool pcie_get_iobar ( pcie_bdf_t  bdf,
unsigned int  bar_index,
struct pcie_bar iobar 
)

#include <zephyr/drivers/pcie/pcie.h>

Get the I/O BAR at a specific BAR index.

Parameters
bdfthe PCI(e) endpoint
bar_index0-based BAR index
iobarPointer to struct pcie_bar
Returns
true if the I/O BAR was found and is valid, false otherwise

◆ pcie_get_irq()

unsigned int pcie_get_irq ( pcie_bdf_t  bdf)

#include <zephyr/drivers/pcie/pcie.h>

Return the IRQ assigned by the firmware/board to an endpoint.

Parameters
bdfthe PCI(e) endpoint
Returns
the IRQ number, or PCIE_CONF_INTR_IRQ_NONE if unknown.

◆ pcie_get_mbar()

bool pcie_get_mbar ( pcie_bdf_t  bdf,
unsigned int  bar_index,
struct pcie_bar mbar 
)

#include <zephyr/drivers/pcie/pcie.h>

Get the MBAR at a specific BAR index.

Parameters
bdfthe PCI(e) endpoint
bar_index0-based BAR index
mbarPointer to struct pcie_bar
Returns
true if the mbar was found and is valid, false otherwise

◆ pcie_irq_enable()

void pcie_irq_enable ( pcie_bdf_t  bdf,
unsigned int  irq 
)

#include <zephyr/drivers/pcie/pcie.h>

Enable the PCI(e) endpoint to generate the specified IRQ.

Parameters
bdfthe PCI(e) endpoint
irqthe IRQ to generate

If MSI is enabled and the endpoint supports it, the endpoint will be configured to generate the specified IRQ via MSI. Otherwise, it is assumed that the IRQ has been routed by the boot firmware to the specified IRQ, and the IRQ is enabled (at the I/O APIC, or wherever appropriate).

◆ pcie_probe_iobar()

bool pcie_probe_iobar ( pcie_bdf_t  bdf,
unsigned int  index,
struct pcie_bar iobar 
)

#include <zephyr/drivers/pcie/pcie.h>

Probe the nth I/O BAR address assigned to an endpoint.

Parameters
bdfthe PCI(e) endpoint
index(0-based) index
iobarPointer to struct pcie_bar
Returns
true if the I/O BAR was found and is valid, false otherwise

A PCI(e) endpoint has 0 or more I/O regions. This function allows the caller to enumerate them by calling with index=0..n. Value of n has to be below 6, as there is a maximum of 6 BARs. The indices are order-preserving with respect to the endpoint BARs: e.g., index 0 will return the lowest-numbered I/O BAR on the endpoint.

◆ pcie_probe_mbar()

bool pcie_probe_mbar ( pcie_bdf_t  bdf,
unsigned int  index,
struct pcie_bar mbar 
)

#include <zephyr/drivers/pcie/pcie.h>

Probe the nth MMIO address assigned to an endpoint.

Parameters
bdfthe PCI(e) endpoint
index(0-based) index
mbarPointer to struct pcie_bar
Returns
true if the mbar was found and is valid, false otherwise

A PCI(e) endpoint has 0 or more memory-mapped regions. This function allows the caller to enumerate them by calling with index=0..n. Value of n has to be below 6, as there is a maximum of 6 BARs. The indices are order-preserving with respect to the endpoint BARs: e.g., index 0 will return the lowest-numbered memory BAR on the endpoint.

◆ pcie_scan()

int pcie_scan ( const struct pcie_scan_opt opt)

#include <zephyr/drivers/pcie/pcie.h>

Scan for PCIe devices.

Scan the PCI bus (or busses) for available endpoints.

Parameters
optOptions determining how to perform the scan.
Returns
0 on success, negative POSIX error number on failure.

◆ pcie_set_cmd()

void pcie_set_cmd ( pcie_bdf_t  bdf,
uint32_t  bits,
bool  on 
)

#include <zephyr/drivers/pcie/pcie.h>

Set or reset bits in the endpoint command/status register.

Parameters
bdfthe PCI(e) endpoint
bitsthe powerset of bits of interest
onuse true to set bits, false to reset them