* [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).