[PATCH v12 07/15] net/enetc: support registers dump
Gagandeep Singh
g.singh at nxp.com
Fri Aug 21 07:56:35 CEST 2026
Implement the .get_reg operation for the ENETC4 PF and VF PMDs to dump
the device registers via rte_eth_dev_get_reg_info.
The VF dumps the registers reachable by a virtual station interface
(VSI): the station interface and per-ring BD ring registers. Port
registers are not accessible by a VF.
The PF additionally dumps the port registers, which are only
accessible by the physical station interface (PSI).
Signed-off-by: Gagandeep Singh <g.singh at nxp.com>
Acked-by: Hemant Agrawal <hemant.agrawal at nxp.com>
---
doc/guides/nics/enetc4.rst | 1 +
doc/guides/nics/features/enetc4.ini | 1 +
doc/guides/nics/features/enetc4_vf.ini | 1 +
doc/guides/rel_notes/release_26_11.rst | 1 +
drivers/net/enetc/enetc.h | 4 ++
drivers/net/enetc/enetc4_ethdev.c | 88 ++++++++++++++++++++++++++
drivers/net/enetc/enetc4_vf.c | 62 ++++++++++++++++++
7 files changed, 158 insertions(+)
diff --git a/doc/guides/nics/enetc4.rst b/doc/guides/nics/enetc4.rst
index 9ca36c6a17..9e32c525f5 100644
--- a/doc/guides/nics/enetc4.rst
+++ b/doc/guides/nics/enetc4.rst
@@ -62,6 +62,7 @@ Key functionality includes:
(coalesced frames span multiple buffers) and is not supported with the
``nc=1`` non-cacheable descriptor ring mode.
- Firmware version: The NETC IP version is reported via ``rte_eth_dev_fw_version_get``.
+- Registers dump: The station interface, port (PF only) and BD ring registers are dumped via ``rte_eth_dev_get_reg_info``.
Prerequisites
diff --git a/doc/guides/nics/features/enetc4.ini b/doc/guides/nics/features/enetc4.ini
index aae398e210..a427c68344 100644
--- a/doc/guides/nics/features/enetc4.ini
+++ b/doc/guides/nics/features/enetc4.ini
@@ -16,6 +16,7 @@ VLAN filter = Y
RSS hash = Y
Packet type parsing = Y
Basic stats = Y
+Registers dump = Y
L3 checksum offload = Y
L4 checksum offload = Y
CRC offload = Y
diff --git a/doc/guides/nics/features/enetc4_vf.ini b/doc/guides/nics/features/enetc4_vf.ini
index 45d2827e98..edbdb48eb2 100644
--- a/doc/guides/nics/features/enetc4_vf.ini
+++ b/doc/guides/nics/features/enetc4_vf.ini
@@ -16,6 +16,7 @@ RSS hash = Y
Packet type parsing = Y
Basic stats = Y
FW version = Y
+Registers dump = Y
L3 checksum offload = Y
L4 checksum offload = Y
CRC offload = Y
diff --git a/doc/guides/rel_notes/release_26_11.rst b/doc/guides/rel_notes/release_26_11.rst
index d212cce000..6fece98f28 100644
--- a/doc/guides/rel_notes/release_26_11.rst
+++ b/doc/guides/rel_notes/release_26_11.rst
@@ -67,6 +67,7 @@ New Features
Users running a PF kernel older than 6.18.37 must pass ``vf_link_legacy=1``
as a device argument, otherwise link speed reporting will be incorrect.
* Added firmware version reporting for the ENETC4 VF.
+ * Added register dump support for ENETC4 PF and VF.
Removed Items
-------------
diff --git a/drivers/net/enetc/enetc.h b/drivers/net/enetc/enetc.h
index 46804a05ba..02b935ad8e 100644
--- a/drivers/net/enetc/enetc.h
+++ b/drivers/net/enetc/enetc.h
@@ -393,6 +393,10 @@ enetc_bd_unused(struct enetc_bdr *bdr)
return bdr->bd_count + bdr->next_to_clean - bdr->next_to_use - 1;
}
+/* Per-ring BDR registers dumped by .get_reg (shared by PF and VF) */
+extern const uint32_t enetc4_txbdr_regs[6];
+extern const uint32_t enetc4_rxbdr_regs[8];
+
/* CBDR prototypes */
int enetc4_setup_cbdr(struct rte_eth_dev *dev, struct enetc_hw *hw,
int bd_count, struct netc_cbdr *cbdr);
diff --git a/drivers/net/enetc/enetc4_ethdev.c b/drivers/net/enetc/enetc4_ethdev.c
index 04aaaa427e..919400b170 100644
--- a/drivers/net/enetc/enetc4_ethdev.c
+++ b/drivers/net/enetc/enetc4_ethdev.c
@@ -11,6 +11,24 @@
#include "enetc_logs.h"
#include "enetc.h"
+/*
+ * Per-ring Tx/Rx BDR registers dumped by .get_reg (shared by PF and VF).
+ * The array sizes here must match the extern declarations in enetc.h, which
+ * carry explicit dimensions so RTE_DIM() works at the use sites in enetc4_vf.c
+ * (a separate translation unit). The explicit dimensions below turn any drift
+ * between the initializer and the declared size into a compile error instead
+ * of a silent mismatch.
+ */
+const uint32_t enetc4_txbdr_regs[6] = {
+ ENETC_TBMR, ENETC_TBSR, ENETC_TBBAR0, ENETC_TBBAR1,
+ ENETC_TBCIR, ENETC_TBLENR,
+};
+
+const uint32_t enetc4_rxbdr_regs[8] = {
+ ENETC_RBMR, ENETC_RBSR, ENETC_RBBSR, ENETC_RBCIR,
+ ENETC_RBBAR0, ENETC_RBBAR1, ENETC_RBPIR, ENETC_RBLENR,
+};
+
/* Supported Rx offloads */
static uint64_t dev_rx_offloads_sup =
RTE_ETH_RX_OFFLOAD_IPV4_CKSUM |
@@ -1198,6 +1216,75 @@ enetc4_supported_ptypes_get(struct rte_eth_dev *dev __rte_unused,
return ptypes;
}
+/* Station interface registers dumped by .get_reg */
+static const uint32_t enetc4_pf_si_regs[] = {
+ ENETC_SIMR, ENETC_SICAPR0, ENETC_SIPMAR0, ENETC_SIPMAR1,
+ ENETC4_SIROCT0, ENETC4_SIRFRM0, ENETC4_SITOCT0, ENETC4_SITFRM0,
+ ENETC4_SITDFCR,
+};
+
+/* Port registers dumped by .get_reg (accessible only by the PF) */
+static const uint32_t enetc4_pf_port_regs[] = {
+ ENETC4_PMR, ENETC4_PSIPMMR, ENETC4_PMAR0, ENETC4_PMAR1,
+ ENETC4_PM_CMD_CFG(0), ENETC4_PM_MAXFRM(0), ENETC4_PM_IF_MODE(0),
+ ENETC4_PM_IF_STATUS(0),
+};
+
+/*
+ * Dump the PF-accessible registers: station interface, port and per-ring
+ * BD ring registers. When info->data is NULL, only the register count and
+ * width are reported so the caller can size its buffer.
+ */
+static int
+enetc4_get_regs(struct rte_eth_dev *dev, struct rte_dev_reg_info *regs)
+{
+ struct enetc_eth_hw *hw = ENETC_DEV_PRIVATE_TO_HW(dev->data->dev_private);
+ struct enetc_hw *enetc_hw = &hw->hw;
+ uint32_t count, addr;
+ uint32_t *buf;
+ uint16_t i, j;
+
+ count = RTE_DIM(enetc4_pf_si_regs);
+ count += RTE_DIM(enetc4_pf_port_regs);
+ count += RTE_DIM(enetc4_txbdr_regs) * dev->data->nb_tx_queues;
+ count += RTE_DIM(enetc4_rxbdr_regs) * dev->data->nb_rx_queues;
+
+ if (regs->data == NULL) {
+ regs->length = count;
+ regs->width = sizeof(uint32_t);
+ return 0;
+ }
+
+ if (regs->length && regs->length < count)
+ return -ENOTSUP;
+
+ buf = regs->data;
+
+ for (i = 0; i < RTE_DIM(enetc4_pf_si_regs); i++)
+ *buf++ = enetc4_rd(enetc_hw, enetc4_pf_si_regs[i]);
+
+ for (i = 0; i < RTE_DIM(enetc4_pf_port_regs); i++)
+ *buf++ = enetc4_port_rd(enetc_hw, enetc4_pf_port_regs[i]);
+
+ for (i = 0; i < dev->data->nb_tx_queues; i++) {
+ for (j = 0; j < RTE_DIM(enetc4_txbdr_regs); j++) {
+ addr = ENETC_BDR(TX, i, enetc4_txbdr_regs[j]);
+ *buf++ = enetc4_rd(enetc_hw, addr);
+ }
+ }
+
+ for (i = 0; i < dev->data->nb_rx_queues; i++) {
+ for (j = 0; j < RTE_DIM(enetc4_rxbdr_regs); j++) {
+ addr = ENETC_BDR(RX, i, enetc4_rxbdr_regs[j]);
+ *buf++ = enetc4_rd(enetc_hw, addr);
+ }
+ }
+
+ regs->version = (uint32_t)hw->device_id << 16 | hw->revision_id;
+
+ return 0;
+}
+
/*
* The set of PCI devices this driver supports
*/
@@ -1216,6 +1303,7 @@ static const struct eth_dev_ops enetc4_ops = {
.link_update = enetc4_link_update,
.stats_get = enetc4_stats_get,
.stats_reset = enetc4_stats_reset,
+ .get_reg = enetc4_get_regs,
.promiscuous_enable = enetc4_promiscuous_enable,
.promiscuous_disable = enetc4_promiscuous_disable,
.rx_queue_setup = enetc4_rx_queue_setup,
diff --git a/drivers/net/enetc/enetc4_vf.c b/drivers/net/enetc/enetc4_vf.c
index 41f915be18..ec9a2e2bf8 100644
--- a/drivers/net/enetc/enetc4_vf.c
+++ b/drivers/net/enetc/enetc4_vf.c
@@ -934,6 +934,66 @@ enetc4_vf_fw_version_get(struct rte_eth_dev *dev, char *fw_version, size_t fw_si
return 0;
}
+/* VF station interface registers dumped by .get_reg */
+static const uint32_t enetc4_vf_si_regs[] = {
+ ENETC_SIMR, ENETC_SICAPR0, ENETC_SIPMAR0, ENETC_SIPMAR1,
+ ENETC4_SIROCT0, ENETC4_SIRFRM0, ENETC4_SITOCT0, ENETC4_SITFRM0,
+ ENETC4_SITDFCR, ENETC4_SIMSIVR, ENETC4_VSIIER, ENETC4_VSIIDR,
+ ENETC4_VSIMSGSR, ENETC4_VSIMSGRR,
+};
+
+/*
+ * Dump the VF-accessible registers. Only station interface and per-ring
+ * BD ring registers are reachable by a VF; port registers are not.
+ * When info->data is NULL, only the register count and width are
+ * reported so the caller can size its buffer.
+ */
+static int
+enetc4_vf_get_regs(struct rte_eth_dev *dev, struct rte_dev_reg_info *regs)
+{
+ struct enetc_eth_hw *hw = ENETC_DEV_PRIVATE_TO_HW(dev->data->dev_private);
+ struct enetc_hw *enetc_hw = &hw->hw;
+ uint32_t count, addr;
+ uint32_t *buf;
+ uint16_t i, j;
+
+ count = RTE_DIM(enetc4_vf_si_regs);
+ count += RTE_DIM(enetc4_txbdr_regs) * dev->data->nb_tx_queues;
+ count += RTE_DIM(enetc4_rxbdr_regs) * dev->data->nb_rx_queues;
+
+ if (regs->data == NULL) {
+ regs->length = count;
+ regs->width = sizeof(uint32_t);
+ return 0;
+ }
+
+ if (regs->length && regs->length < count)
+ return -ENOTSUP;
+
+ buf = regs->data;
+
+ for (i = 0; i < RTE_DIM(enetc4_vf_si_regs); i++)
+ *buf++ = enetc_rd(enetc_hw, enetc4_vf_si_regs[i]);
+
+ for (i = 0; i < dev->data->nb_tx_queues; i++) {
+ for (j = 0; j < RTE_DIM(enetc4_txbdr_regs); j++) {
+ addr = ENETC_BDR(TX, i, enetc4_txbdr_regs[j]);
+ *buf++ = enetc_rd(enetc_hw, addr);
+ }
+ }
+
+ for (i = 0; i < dev->data->nb_rx_queues; i++) {
+ for (j = 0; j < RTE_DIM(enetc4_rxbdr_regs); j++) {
+ addr = ENETC_BDR(RX, i, enetc4_rxbdr_regs[j]);
+ *buf++ = enetc_rd(enetc_hw, addr);
+ }
+ }
+
+ regs->version = (uint32_t)hw->device_id << 16 | hw->revision_id;
+
+ return 0;
+}
+
static int
enetc4_vf_link_update_dummy(struct rte_eth_dev *dev __rte_unused,
int wait_to_complete __rte_unused)
@@ -1472,6 +1532,7 @@ static const struct eth_dev_ops enetc4_vf_ops_no_vsi_m = {
.dev_close = enetc4_dev_close,
.stats_get = enetc4_vf_stats_get,
.dev_infos_get = enetc4_vf_dev_infos_get,
+ .get_reg = enetc4_vf_get_regs,
.mtu_set = enetc4_vf_mtu_set,
.link_update = enetc4_vf_link_update_dummy,
.rx_queue_setup = enetc4_rx_queue_setup,
@@ -1493,6 +1554,7 @@ static const struct eth_dev_ops enetc4_vf_ops = {
.stats_get = enetc4_vf_stats_get,
.dev_infos_get = enetc4_vf_dev_infos_get,
.fw_version_get = enetc4_vf_fw_version_get,
+ .get_reg = enetc4_vf_get_regs,
.mtu_set = enetc4_vf_mtu_set,
.mac_addr_set = enetc4_vf_set_mac_addr,
.mac_addr_add = enetc4_vf_mac_addr_add,
--
2.25.1
More information about the dev
mailing list