Enet CPSW Loopback Example

Table of Contents

• Introduction
• Supported Combinations
• Steps to Run the Example
  • Build the example
  • Sample output for MAC Loopback
• See Also

Introduction

This example exercises the MAC loopback functionality of the hardware. The CPSW hardware is opened with default initialization parameters and either the MAC loopback is enabled based on the user input.

On AM275X, we can do ethernet based communication using CPSW as HW mechanism

• CPSW is a standard ethernet switch + port HW
• It uses ethernet driver underneath with LwIP TCP/IP networking stack

The examples do below

• A Tx channel and a Rx flow are opened to enable data transfers. Packets are transmitted from the Switch R5F (R5F0_0) to the host port using the Tx channel. These packets are routed back to the host port by the switch hardware as the internal loopback feature is enabled. These packets are then transmitted to the Switch R5F by the Rx flow and the application is notified.
• The Tx and Rx functions in the example are set to transmit and receive 5000 packets. After reaching the count of 5000, the application closes the Tx channel, Rx flow, CPSW and restarts the application for a configurable number of times. Restarting the loopback test application ensures that there aren’t any memory leaks, and the hardware is closed properly and can be reopened any time.

Supported Combinations

Parameter	Value
CPU + OS	mcu-r5fss0-0_freertos
Toolchain	ti-arm-clang
Boards	am275x-evm
Example folder	source/networking/enet/core/examples/enet_loopback/enet_cpsw_loopback

Steps to Run the Example

Build the example

• When using CCS projects to build, import the CCS project for the required combination and build it using the CCS project menu (see Using SDK with CCS Projects).
• When using makefiles to build, note the required combination and build using make command (see Using SDK with Makefiles)

Sample output for MAC Loopback

Create periodic tick task
=============================
 Enet Loopback: Iteration 1
=============================
CPSW_3G Test
initQs() txFreePktInfoQ initialized with 16 pkts
Host MAC address: 70:ff:76:1d:ec:f2
PHY 0 is alive
Received 5000 packets
Delete EnetLpbk_rxTask() and exit..
Transmitted 5000 packets
Delete EnetLpbk_txTask() and exit..
 
 Port 0 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
 
 
 Port 1 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
  txPri[0]                = 5000
  txPriBcnt[0]            = 2590000
 
Cpsw_handleLinkDown: Port 1: Link down
Test complete: PASS
Delete EnetLpbk_tickTask() and exit..
Create periodic tick task
=============================
 Enet Loopback: Iteration 2
=============================
CPSW_3G Test
initQs() txFreePktInfoQ initialized with 16 pkts
Host MAC address: 70:ff:76:1d:ec:f2
PHY 0 is alive
Received 5000 packets
Delete EnetLpbk_rxTask() and exit..
Transmitted 5000 packets
Delete EnetLpbk_txTask() and exit..
 
 Port 0 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
 
 
 Port 1 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
  txPri[0]                = 5000
  txPriBcnt[0]            = 2590000
 
Cpsw_handleLinkDown: Port 1: Link down
Test complete: PASS
Delete EnetLpbk_tickTask() and exit..
Create periodic tick task
=============================
 Enet Loopback: Iteration 3
=============================
CPSW_3G Test
initQs() txFreePktInfoQ initialized with 16 pkts
Host MAC address: 70:ff:76:1d:ec:f2
PHY 0 is alive
Received 5000 packets
Delete EnetLpbk_rxTask() and exit..
Transmitted 5000 packets
Delete EnetLpbk_txTask() and exit..
 
 Port 0 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
 
 
 Port 1 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
  txPri[0]                = 5000
  txPriBcnt[0]            = 2590000
 
Cpsw_handleLinkDown: Port 1: Link down
Test complete: PASS
Delete EnetLpbk_tickTask() and exit..
Create periodic tick task
=============================
 Enet Loopback: Iteration 4
=============================
CPSW_3G Test
initQs() txFreePktInfoQ initialized with 16 pkts
Host MAC address: 70:ff:76:1d:ec:f2
PHY 0 is alive
Received 5000 packets
Delete EnetLpbk_rxTask() and exit..
Transmitted 5000 packets
Delete EnetLpbk_txTask() and exit..
 
 Port 0 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
 
 
 Port 1 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
  txPri[0]                = 5000
  txPriBcnt[0]            = 2590000
 
Cpsw_handleLinkDown: Port 1: Link down
Test complete: PASS
Delete EnetLpbk_tickTask() and exit..
Create periodic tick task
=============================
 Enet Loopback: Iteration 5
=============================
CPSW_3G Test
initQs() txFreePktInfoQ initialized with 16 pkts
Host MAC address: 70:ff:76:1d:ec:f2
PHY 0 is alive
Received 5000 packets
Delete EnetLpbk_rxTask() and exit..
Transmitted 5000 packets
Delete EnetLpbk_txTask() and exit..
 
 Port 0 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
 
 
 Port 1 Statistics
-----------------------------------------
  rxGoodFrames            = 5000
  rxBcastFrames           = 5000
  rxOctets                = 2590000
  txGoodFrames            = 5000
  txBcastFrames           = 5000
  txOctets                = 2590000
  octetsFrames512to1023   = 10000
  netOctets               = 5180000
  txPri[0]                = 5000
  txPriBcnt[0]            = 2590000
 
Cpsw_handleLinkDown: Port 1: Link down
Test complete: PASS
Delete EnetLpbk_tickTask() and exit..
Loopback application completed

See Also

Ethernet And Networking