* [PATCH v3 6/6] net/macb: add necessary docs and update related files
@ 2024-12-10 7:10 Wencheng Li
2025-04-02 7:11 ` [PATCH v4 4/4] " liwencheng
0 siblings, 1 reply; 6+ messages in thread
From: Wencheng Li @ 2024-12-10 7:10 UTC (permalink / raw)
To: stephen; +Cc: dev
Added missing documentation in doc/guides/nics,
mailmap entry, and updated MAINTAINERS file.
Signed-off-by: Wencheng Li <liwencheng@phytium.com.cn>
---
.mailmap | 1 +
MAINTAINERS | 6 ++++++
doc/guides/nics/features/macb.ini | 27 +++++++++++++++++++++++++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/macb.rst | 26 ++++++++++++++++++++++++++
doc/guides/rel_notes/release_24_11.rst | 5 +++++
6 files changed, 66 insertions(+)
create mode 100644 doc/guides/nics/features/macb.ini
create mode 100644 doc/guides/nics/macb.rst
diff --git a/.mailmap b/.mailmap
index 8187982..2674a82 100644
--- a/.mailmap
+++ b/.mailmap
@@ -1654,6 +1654,7 @@ Wen Chiu <wchiu@brocade.com>
Wen-Chi Yang <wolkayang@gmail.com>
Wenfeng Liu <liuwf@arraynetworks.com.cn>
Wenjie Li <wenjiex.a.li@intel.com>
+Wencheng Li <liwencheng@phytium.com.cn>
Wenjie Sun <findtheonlyway@gmail.com>
Wenjing Qiao <wenjing.qiao@intel.com>
Wenjun Wu <wenjun1.wu@intel.com>
diff --git a/MAINTAINERS b/MAINTAINERS
index 60bdcce..8fdcc66 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -921,6 +921,12 @@ F: doc/guides/platform/bluefield.rst
F: doc/guides/nics/mlx5.rst
F: doc/guides/nics/features/mlx5.ini
+Phytium macb
+M: Wencheng Li <liwencheng@phytium.com.cn>
+F: drivers/net/macb
+F: doc/guides/nics/macb.rst
+F: doc/guides/nics/features/macb.ini
+
Microsoft mana
M: Long Li <longli@microsoft.com>
M: Wei Hu <weh@microsoft.com>
diff --git a/doc/guides/nics/features/macb.ini b/doc/guides/nics/features/macb.ini
new file mode 100644
index 0000000..cefc282
--- /dev/null
+++ b/doc/guides/nics/features/macb.ini
@@ -0,0 +1,27 @@
+;
+; Supported features of the 'macb' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+
+[Features]
+Speed capabilities = Y
+Link status = Y
+Queue start/stop = Y
+MTU update = Y
+Allmulticast mode = Y
+CRC offload = Y
+L3 checksum offload = Y
+L4 checksum offload = Y
+Scattered Rx = Y
+Rx descriptor status = Y
+Basic stats = Y
+Linux = Y
+
+[rte_flow items]
+eth = Y
+ipv4 = Y
+ipv6 = Y
+raw = Y
+tcp = Y
+udp = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 50688d9..6e0c87b 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -43,6 +43,7 @@ Network Interface Controller Drivers
ionic
ipn3ke
ixgbe
+ macb
mana
memif
mlx4
diff --git a/doc/guides/nics/macb.rst b/doc/guides/nics/macb.rst
new file mode 100644
index 0000000..5614a63
--- /dev/null
+++ b/doc/guides/nics/macb.rst
@@ -0,0 +1,26 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2022~2023 Phytium Technology Co., Ltd.
+
+MACB Poll Mode Driver
+=====================
+
+The MACB PMD provides poll mode driver support
+for the Ethernet interface MAC 1/2.5/10 Gbps adapter.
+
+Supported Chipsets and NICs
+---------------------------
+
+Phytium Ethernet interface cdns,phytium-gem-1.0
+Phytium Ethernet interface cdns,phytium-gem-2.0
+
+Features
+--------
+
+Features of the MACB PMD are:
+
+* Speed capabilities
+* Link status
+* Tx Queue start/stop
+* Multiple queues for TX and RX
+* CRC offload
+* Jumbo frames supported
diff --git a/doc/guides/rel_notes/release_24_11.rst b/doc/guides/rel_notes/release_24_11.rst
index 8486cd9..962291a 100644
--- a/doc/guides/rel_notes/release_24_11.rst
+++ b/doc/guides/rel_notes/release_24_11.rst
@@ -167,6 +167,11 @@ New Features
Added a new network PMD which supports Realtek 2.5 and 5 Gigabit
Ethernet NICs.
+* **Added Phytium macb net driver.**
+
+ Added a new network PMD which supports Phytium 1 and 10 Gigabit
+ Ethernet NICs.
+
* **Added ZTE zxdh net driver [EXPERIMENTAL].**
Added ethdev driver support for the zxdh NX Series Ethernet Controller.
--
2.7.4
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH v4 4/4] net/macb: add necessary docs and update related files
2024-12-10 7:10 [PATCH v3 6/6] net/macb: add necessary docs and update related files Wencheng Li
@ 2025-04-02 7:11 ` liwencheng
2025-04-07 6:40 ` [PATCH v5 " liwencheng
0 siblings, 1 reply; 6+ messages in thread
From: liwencheng @ 2025-04-02 7:11 UTC (permalink / raw)
To: dev
Added missing documentation in doc/guides/nics,
mailmap entry, and updated MAINTAINERS file.
Signed-off-by: liwencheng <liwencheng@phytium.com.cn>
---
.mailmap | 1 +
MAINTAINERS | 6 ++++++
doc/guides/nics/features/macb.ini | 27 +++++++++++++++++++++++++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/macb.rst | 26 ++++++++++++++++++++++++++
doc/guides/rel_notes/release_25_03.rst | 5 +++++
6 files changed, 66 insertions(+)
create mode 100644 doc/guides/nics/features/macb.ini
create mode 100644 doc/guides/nics/macb.rst
diff --git a/.mailmap b/.mailmap
index d8439b7..001d7b2 100644
--- a/.mailmap
+++ b/.mailmap
@@ -1675,6 +1675,7 @@ Wen Chiu <wchiu@brocade.com>
Wen-Chi Yang <wolkayang@gmail.com>
Wenfeng Liu <liuwf@arraynetworks.com.cn>
Wenjie Li <wenjiex.a.li@intel.com>
+Wencheng Li <liwencheng@phytium.com.cn>
Wenjie Sun <findtheonlyway@gmail.com>
Wenjing Qiao <wenjing.qiao@intel.com>
Wenjun Wu <wenjun1.wu@intel.com>
diff --git a/MAINTAINERS b/MAINTAINERS
index 4b01103..379645d 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -920,6 +920,12 @@ F: doc/guides/platform/bluefield.rst
F: doc/guides/nics/mlx5.rst
F: doc/guides/nics/features/mlx5.ini
+Phytium macb
+M: Wencheng Li <liwencheng@phytium.com.cn>
+F: drivers/net/macb
+F: doc/guides/nics/macb.rst
+F: doc/guides/nics/features/macb.ini
+
Microsoft mana
M: Long Li <longli@microsoft.com>
M: Wei Hu <weh@microsoft.com>
diff --git a/doc/guides/nics/features/macb.ini b/doc/guides/nics/features/macb.ini
new file mode 100644
index 0000000..cefc282
--- /dev/null
+++ b/doc/guides/nics/features/macb.ini
@@ -0,0 +1,27 @@
+;
+; Supported features of the 'macb' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+
+[Features]
+Speed capabilities = Y
+Link status = Y
+Queue start/stop = Y
+MTU update = Y
+Allmulticast mode = Y
+CRC offload = Y
+L3 checksum offload = Y
+L4 checksum offload = Y
+Scattered Rx = Y
+Rx descriptor status = Y
+Basic stats = Y
+Linux = Y
+
+[rte_flow items]
+eth = Y
+ipv4 = Y
+ipv6 = Y
+raw = Y
+tcp = Y
+udp = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 10a2eca..8ae1950 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -43,6 +43,7 @@ Network Interface Controller Drivers
ionic
ipn3ke
ixgbe
+ macb
mana
memif
mlx4
diff --git a/doc/guides/nics/macb.rst b/doc/guides/nics/macb.rst
new file mode 100644
index 0000000..5614a63
--- /dev/null
+++ b/doc/guides/nics/macb.rst
@@ -0,0 +1,26 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2022~2023 Phytium Technology Co., Ltd.
+
+MACB Poll Mode Driver
+=====================
+
+The MACB PMD provides poll mode driver support
+for the Ethernet interface MAC 1/2.5/10 Gbps adapter.
+
+Supported Chipsets and NICs
+---------------------------
+
+Phytium Ethernet interface cdns,phytium-gem-1.0
+Phytium Ethernet interface cdns,phytium-gem-2.0
+
+Features
+--------
+
+Features of the MACB PMD are:
+
+* Speed capabilities
+* Link status
+* Tx Queue start/stop
+* Multiple queues for TX and RX
+* CRC offload
+* Jumbo frames supported
diff --git a/doc/guides/rel_notes/release_25_03.rst b/doc/guides/rel_notes/release_25_03.rst
index 652562a..f53ccc9 100644
--- a/doc/guides/rel_notes/release_25_03.rst
+++ b/doc/guides/rel_notes/release_25_03.rst
@@ -127,6 +127,11 @@ New Features
See the :doc:`../compressdevs/zsda` guide for more details on the new driver.
+* **Added Phytium macb net driver.**
+
+ Added a new network PMD which supports Phytium 1 and 10 Gigabit
+ Ethernet NICs.
+
* **Added atomic tests to the eventdev test application.**
Added two atomic tests: ``atomic_queue`` and ``atomic_atq``.
--
2.7.4
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH v5 4/4] net/macb: add necessary docs and update related files
2025-04-02 7:11 ` [PATCH v4 4/4] " liwencheng
@ 2025-04-07 6:40 ` liwencheng
2025-04-07 18:23 ` Stephen Hemminger
2025-04-08 6:22 ` [PATCH v6 3/3] " liwencheng
0 siblings, 2 replies; 6+ messages in thread
From: liwencheng @ 2025-04-07 6:40 UTC (permalink / raw)
To: dev
Added missing documentation in doc/guides/nics,
mailmap entry, and updated MAINTAINERS file.
v5:
* Add driver based on 25.07.
Signed-off-by: liwencheng <liwencheng@phytium.com.cn>
---
MAINTAINERS | 6 ++++++
doc/guides/nics/features/macb.ini | 27 +++++++++++++++++++++++++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/macb.rst | 26 ++++++++++++++++++++++++++
doc/guides/rel_notes/release_25_07.rst | 4 ++++
5 files changed, 64 insertions(+)
create mode 100644 doc/guides/nics/features/macb.ini
create mode 100644 doc/guides/nics/macb.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 4b01103..379645d 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -920,6 +920,12 @@ F: doc/guides/platform/bluefield.rst
F: doc/guides/nics/mlx5.rst
F: doc/guides/nics/features/mlx5.ini
+Phytium macb
+M: Wencheng Li <liwencheng@phytium.com.cn>
+F: drivers/net/macb
+F: doc/guides/nics/macb.rst
+F: doc/guides/nics/features/macb.ini
+
Microsoft mana
M: Long Li <longli@microsoft.com>
M: Wei Hu <weh@microsoft.com>
diff --git a/doc/guides/nics/features/macb.ini b/doc/guides/nics/features/macb.ini
new file mode 100644
index 0000000..cefc282
--- /dev/null
+++ b/doc/guides/nics/features/macb.ini
@@ -0,0 +1,27 @@
+;
+; Supported features of the 'macb' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+
+[Features]
+Speed capabilities = Y
+Link status = Y
+Queue start/stop = Y
+MTU update = Y
+Allmulticast mode = Y
+CRC offload = Y
+L3 checksum offload = Y
+L4 checksum offload = Y
+Scattered Rx = Y
+Rx descriptor status = Y
+Basic stats = Y
+Linux = Y
+
+[rte_flow items]
+eth = Y
+ipv4 = Y
+ipv6 = Y
+raw = Y
+tcp = Y
+udp = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 10a2eca..8ae1950 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -43,6 +43,7 @@ Network Interface Controller Drivers
ionic
ipn3ke
ixgbe
+ macb
mana
memif
mlx4
diff --git a/doc/guides/nics/macb.rst b/doc/guides/nics/macb.rst
new file mode 100644
index 0000000..5614a63
--- /dev/null
+++ b/doc/guides/nics/macb.rst
@@ -0,0 +1,26 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2022~2023 Phytium Technology Co., Ltd.
+
+MACB Poll Mode Driver
+=====================
+
+The MACB PMD provides poll mode driver support
+for the Ethernet interface MAC 1/2.5/10 Gbps adapter.
+
+Supported Chipsets and NICs
+---------------------------
+
+Phytium Ethernet interface cdns,phytium-gem-1.0
+Phytium Ethernet interface cdns,phytium-gem-2.0
+
+Features
+--------
+
+Features of the MACB PMD are:
+
+* Speed capabilities
+* Link status
+* Tx Queue start/stop
+* Multiple queues for TX and RX
+* CRC offload
+* Jumbo frames supported
diff --git a/doc/guides/rel_notes/release_25_07.rst b/doc/guides/rel_notes/release_25_07.rst
index cd1025a..9298dc1 100644
--- a/doc/guides/rel_notes/release_25_07.rst
+++ b/doc/guides/rel_notes/release_25_07.rst
@@ -55,6 +55,10 @@ New Features
Also, make sure to start the actual text at the margin.
=======================================================
+* **Added Phytium macb net driver.**
+
+ Added a new network PMD which supports Phytium 1 and 10 Gigabit
+ Ethernet NICs.
Removed Items
-------------
--
2.7.4
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH v5 4/4] net/macb: add necessary docs and update related files
2025-04-07 6:40 ` [PATCH v5 " liwencheng
@ 2025-04-07 18:23 ` Stephen Hemminger
2025-04-08 6:22 ` [PATCH v6 3/3] " liwencheng
1 sibling, 0 replies; 6+ messages in thread
From: Stephen Hemminger @ 2025-04-07 18:23 UTC (permalink / raw)
To: liwencheng; +Cc: dev
On Mon, 7 Apr 2025 06:40:35 +0000
liwencheng <liwencheng@phytium.com.cn> wrote:
> Added missing documentation in doc/guides/nics,
> mailmap entry, and updated MAINTAINERS file.
>
> v5:
> * Add driver based on 25.07.
>
> Signed-off-by: liwencheng <liwencheng@phytium.com.cn>
There are multiple build failures reported in the CI system
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH v6 3/3] net/macb: add necessary docs and update related files
2025-04-07 6:40 ` [PATCH v5 " liwencheng
2025-04-07 18:23 ` Stephen Hemminger
@ 2025-04-08 6:22 ` liwencheng
2025-04-18 3:27 ` [PATCH v7 " Wencheng Li
1 sibling, 1 reply; 6+ messages in thread
From: liwencheng @ 2025-04-08 6:22 UTC (permalink / raw)
To: dev
Added missing documentation in doc/guides/nics,
mailmap entry, and updated MAINTAINERS file.
Signed-off-by: liwencheng <liwencheng@phytium.com.cn>
---
MAINTAINERS | 6 ++++++
doc/guides/nics/features/macb.ini | 27 +++++++++++++++++++++++++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/macb.rst | 26 ++++++++++++++++++++++++++
doc/guides/rel_notes/release_25_07.rst | 4 ++++
5 files changed, 64 insertions(+)
create mode 100644 doc/guides/nics/features/macb.ini
create mode 100644 doc/guides/nics/macb.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 167cc74..8b725ce 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -916,6 +916,12 @@ F: doc/guides/platform/bluefield.rst
F: doc/guides/nics/mlx5.rst
F: doc/guides/nics/features/mlx5.ini
+Phytium macb
+M: Wencheng Li <liwencheng@phytium.com.cn>
+F: drivers/net/macb
+F: doc/guides/nics/macb.rst
+F: doc/guides/nics/features/macb.ini
+
Microsoft mana
M: Long Li <longli@microsoft.com>
M: Wei Hu <weh@microsoft.com>
diff --git a/doc/guides/nics/features/macb.ini b/doc/guides/nics/features/macb.ini
new file mode 100644
index 0000000..cefc282
--- /dev/null
+++ b/doc/guides/nics/features/macb.ini
@@ -0,0 +1,27 @@
+;
+; Supported features of the 'macb' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+
+[Features]
+Speed capabilities = Y
+Link status = Y
+Queue start/stop = Y
+MTU update = Y
+Allmulticast mode = Y
+CRC offload = Y
+L3 checksum offload = Y
+L4 checksum offload = Y
+Scattered Rx = Y
+Rx descriptor status = Y
+Basic stats = Y
+Linux = Y
+
+[rte_flow items]
+eth = Y
+ipv4 = Y
+ipv6 = Y
+raw = Y
+tcp = Y
+udp = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 10a2eca..8ae1950 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -43,6 +43,7 @@ Network Interface Controller Drivers
ionic
ipn3ke
ixgbe
+ macb
mana
memif
mlx4
diff --git a/doc/guides/nics/macb.rst b/doc/guides/nics/macb.rst
new file mode 100644
index 0000000..5614a63
--- /dev/null
+++ b/doc/guides/nics/macb.rst
@@ -0,0 +1,26 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2022~2023 Phytium Technology Co., Ltd.
+
+MACB Poll Mode Driver
+=====================
+
+The MACB PMD provides poll mode driver support
+for the Ethernet interface MAC 1/2.5/10 Gbps adapter.
+
+Supported Chipsets and NICs
+---------------------------
+
+Phytium Ethernet interface cdns,phytium-gem-1.0
+Phytium Ethernet interface cdns,phytium-gem-2.0
+
+Features
+--------
+
+Features of the MACB PMD are:
+
+* Speed capabilities
+* Link status
+* Tx Queue start/stop
+* Multiple queues for TX and RX
+* CRC offload
+* Jumbo frames supported
diff --git a/doc/guides/rel_notes/release_25_07.rst b/doc/guides/rel_notes/release_25_07.rst
index 093b85d..5530bfc 100644
--- a/doc/guides/rel_notes/release_25_07.rst
+++ b/doc/guides/rel_notes/release_25_07.rst
@@ -55,6 +55,10 @@ New Features
Also, make sure to start the actual text at the margin.
=======================================================
+* **Added Phytium macb net driver.**
+
+ Added a new network PMD which supports Phytium 1 and 10 Gigabit
+ Ethernet NICs.
Removed Items
-------------
--
2.7.4
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH v7 3/3] net/macb: add necessary docs and update related files
2025-04-08 6:22 ` [PATCH v6 3/3] " liwencheng
@ 2025-04-18 3:27 ` Wencheng Li
0 siblings, 0 replies; 6+ messages in thread
From: Wencheng Li @ 2025-04-18 3:27 UTC (permalink / raw)
To: dev
Added missing documentation in doc/guides/nics,
mailmap entry, and updated MAINTAINERS file.
v7:
* Describe the devargs used by the driver in the documentation.
* Update macb.ini.
Signed-off-by: Wencheng Li <liwencheng@phytium.com.cn>
---
MAINTAINERS | 6 ++
doc/guides/nics/features/macb.ini | 19 ++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/macb.rst | 180 +++++++++++++++++++++++++++++++++
doc/guides/rel_notes/release_25_07.rst | 4 +
5 files changed, 210 insertions(+)
create mode 100644 doc/guides/nics/features/macb.ini
create mode 100644 doc/guides/nics/macb.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 167cc74..8b725ce 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -916,6 +916,12 @@ F: doc/guides/platform/bluefield.rst
F: doc/guides/nics/mlx5.rst
F: doc/guides/nics/features/mlx5.ini
+Phytium macb
+M: Wencheng Li <liwencheng@phytium.com.cn>
+F: drivers/net/macb
+F: doc/guides/nics/macb.rst
+F: doc/guides/nics/features/macb.ini
+
Microsoft mana
M: Long Li <longli@microsoft.com>
M: Wei Hu <weh@microsoft.com>
diff --git a/doc/guides/nics/features/macb.ini b/doc/guides/nics/features/macb.ini
new file mode 100644
index 0000000..5e291e3
--- /dev/null
+++ b/doc/guides/nics/features/macb.ini
@@ -0,0 +1,19 @@
+;
+; Supported features of the 'macb' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+
+[Features]
+Speed capabilities = Y
+Link status = Y
+Link status event = Y
+MTU update = Y
+Promiscuous mode = Y
+Allmulticast mode = Y
+CRC offload = Y
+L3 checksum offload = Y
+L4 checksum offload = Y
+Scattered Rx = Y
+Basic stats = Y
+Linux = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 10a2eca..8ae1950 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -43,6 +43,7 @@ Network Interface Controller Drivers
ionic
ipn3ke
ixgbe
+ macb
mana
memif
mlx4
diff --git a/doc/guides/nics/macb.rst b/doc/guides/nics/macb.rst
new file mode 100644
index 0000000..9dbdbec
--- /dev/null
+++ b/doc/guides/nics/macb.rst
@@ -0,0 +1,180 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2022~2023 Phytium Technology Co., Ltd.
+
+MACB Poll Mode Driver
+=====================
+
+The MACB PMD provides poll mode driver support
+for the Ethernet interface MAC 1/2.5/10 Gbps adapter.
+
+
+Supported Chipsets and NICs
+---------------------------
+
+Phytium Ethernet interface cdns,phytium-gem-1.0
+Phytium Ethernet interface cdns,phytium-gem-2.0
+
+
+Features
+--------
+
+Features of the MACB PMD are:
+
+- Speed capabilities
+- Link status
+- Set link down or up
+- MTU update
+- Multiple queues for TX and RX
+- CRC offload
+- Scatter and gather for Tx and Rx
+- Jumbo frames supported
+- Promiscuous mode
+- Allmulticast mode
+- Basic stats
+
+
+Runtime Configuration
+---------------------
+
+The following ``devargs`` options can be enabled at runtime. They can
+be passed as part of EAL arguments. For example,
+
+Run the command in non-vector mode:
+
+.. code-block:: console
+
+ ./dpdk-testpmd -l 0,3 --vdev=net_macb0,device=3200c000.ethernet,usephydrv=0 \
+ --vdev=net_macb1,device=3200e000.ethernet,usephydrv=0 --iova-mode=pa -- -i \
+ -a --rxq=1 --txq=1 --rxd=128 --txd=128
+
+- ``device`` (mandatory, with no default value)
+
+ The name of port (owned by Phytium) that should be enabled in DPDK.
+ This options can be repeated resulting in a list of ports to be
+ enabled. For instance below will enable ``eth0`` and ``eth1`` ports.
+
+- ``--vdev=net_macb0, device=3200c000.ethernet, usephydrv=0`` (no default value)
+
+ --vdev specifies the MACB driver, and device specifies the virtual device to be used. The options
+ --vdev=net_macb0,device=3200c000.ethernet and --vdev=net_macb1,device=3200e000.ethernet
+ can also be written as: --vdev=net_macb,device=3200c000.ethernet,device=3200e000.ethernet.
+
+- ``usephydrv`` (Default value: true)
+ The specified macb device does not have an external phy chip.
+ If there is indeed a device with phy, this parameter is not added.
+
+- ``--rxq`` (Default value: 1)
+ Specify the number of dpdk-testpmd receiving queues.
+
+- ``--txq`` (Default value: 1)
+ Specify the number of dpdk-testpmd sending queues.
+
+- ``--rxd`` (Default value: 512)
+ Receive the queue descriptor.
+
+- ``--txd`` (Default value: 512)
+ Send the queue descriptor.
+
+Run the command in vector mode:
+
+.. code-block:: console
+
+ ./dpdk-testpmd -l 0,3 --vdev=net_macb0,device=3200c000.ethernet,usephydrv=0 \
+ --vdev=net_macb1,device=3200e000.ethernet,usephydrv=0 --iova-mode=pa -- -i \
+ -a --rxq=1 --txq=1 --rxd=128 --txd=128 --rxfreet=32 --txrst=32
+
+- ``--rxfreet`` (Default value: 16)
+ Enable the optimization of sending vector instructions.
+
+- ``--txrst`` (Default value: 16)
+ Enable the optimization of receiving vector instructions.
+
+
+Usage Example
+-------------
+
+MACB PMD requires extra out of tree kernel modules to function properly.
+`macb_uio` sources are part of the MACB.
+
+.. code-block:: console
+
+ insmod macb_uio.ko
+
+In order to run testpmd example application following command can be used:
+
+.. code-block:: console
+
+ ./app/dpdk-testpmd -l 0,3 --vdev=net_macb0,device=3200c000.ethernet \
+ --vdev=net_macb1,device=3200e000.ethernet --iova-mode=pa -- -i -a
+
+Example output:
+
+.. code-block:: console
+
+ [...]
+ EAL: Detected CPU lcores: 4
+ EAL: Detected NUMA nodes: 1
+ EAL: Detected static linkage of DPDK
+ EAL: Multi-process socket /var/run/dpdk/rte/mp_socket
+ EAL: Selected IOVA mode 'PA'
+ MACB: Phytium mac driver v5.8
+ MACB: macb_get_fixed_link_speed_info(): speed info is unknown.
+ MACB: Phytium mac driver v5.8
+ MACB: macb_get_fixed_link_speed_info(): speed info is unknown.
+ Interactive-mode selected
+ Auto-start selected
+ testpmd: create a new mbuf pool <mb_pool_0>: n=155456, size=2176, socket=0
+ testpmd: preferred mempool ops selected: ring_mp_mc
+ Configuring Port 0 (socket 0)
+ MACB: Rx Burst Bulk Alloc Preconditions: rxq->rx_free_thresh=16, MACB_MAX_RX_BURST=32
+ MACB: queue[0] doesn't meet Rx Bulk Alloc preconditions - canceling the feature for port[0]
+ MACB: Port[0] doesn't meet Vector Rx preconditions
+ Port 0: 24:DC:0F:54:E5:D0
+ Configuring Port 1 (socket 0)
+ MACB: Rx Burst Bulk Alloc Preconditions: rxq->rx_free_thresh=16, MACB_MAX_RX_BURST=32
+ MACB: queue[0] doesn't meet Rx Bulk Alloc preconditions - canceling the feature for port[1]
+ MACB: Port[1] doesn't meet Vector Rx preconditions
+ Port 1: 24:DC:0F:54:E5:D1
+ Checking link statuses...
+ MACB: Port 0: Link up at 10 Gbps FDX Autoneg
+
+ Port 0: link state change event
+ MACB: Port 1: Link up at 10 Gbps FDX Autoneg
+
+ Port 1: link state change event
+ Done
+ Start automatic packet forwarding
+ io packet forwarding - ports=2 - cores=1 - streams=2 - NUMA support enabled, MP allocation mode: native
+ Logical Core 3 (socket 0) forwards packets on 2 streams:
+ RX P=0/Q=0 (socket 0) -> TX P=1/Q=0 (socket 0) peer=02:00:00:00:00:01
+ RX P=1/Q=0 (socket 0) -> TX P=0/Q=0 (socket 0) peer=02:00:00:00:00:00
+
+ io packet forwarding packets/burst=32
+ nb forwarding cores=1 - nb forwarding ports=2
+ port 0: RX queue number: 1 Tx queue number: 1
+ Rx offloads=0xe Tx offloads=0x0
+ RX queue: 0
+ RX desc=512 - RX free threshold=16
+ RX threshold registers: pthresh=0 hthresh=0 wthresh=0
+ RX Offloads=0xe
+ TX queue: 0
+ TX desc=512 - TX free threshold=32
+ TX threshold registers: pthresh=0 hthresh=0 wthresh=0
+ TX offloads=0x0 - TX RS bit threshold=0
+ port 1: RX queue number: 1 Tx queue number: 1
+ Rx offloads=0xe Tx offloads=0x0
+ RX queue: 0
+ RX desc=512 - RX free threshold=16
+ RX threshold registers: pthresh=0 hthresh=0 wthresh=0
+ RX Offloads=0xe
+ TX queue: 0
+ TX desc=512 - TX free threshold=32
+ TX threshold registers: pthresh=0 hthresh=0 wthresh=0
+ TX offloads=0x0 - TX RS bit threshold=0
+ testpmd>
+
+
+Limitations
+-----------
+
+The driver is only available on the ARM64 architecture.
diff --git a/doc/guides/rel_notes/release_25_07.rst b/doc/guides/rel_notes/release_25_07.rst
index 093b85d..5530bfc 100644
--- a/doc/guides/rel_notes/release_25_07.rst
+++ b/doc/guides/rel_notes/release_25_07.rst
@@ -55,6 +55,10 @@ New Features
Also, make sure to start the actual text at the margin.
=======================================================
+* **Added Phytium macb net driver.**
+
+ Added a new network PMD which supports Phytium 1 and 10 Gigabit
+ Ethernet NICs.
Removed Items
-------------
--
2.7.4
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2025-04-18 3:28 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-12-10 7:10 [PATCH v3 6/6] net/macb: add necessary docs and update related files Wencheng Li
2025-04-02 7:11 ` [PATCH v4 4/4] " liwencheng
2025-04-07 6:40 ` [PATCH v5 " liwencheng
2025-04-07 18:23 ` Stephen Hemminger
2025-04-08 6:22 ` [PATCH v6 3/3] " liwencheng
2025-04-18 3:27 ` [PATCH v7 " Wencheng Li
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).