Ethernet TSN EST Example

Table of Contents

• Introduction
• Supported Combinations
• Packet pool configuration
• Constraints
• Configuration Parameters
• Expected Behavior
• Application Integration Guide
• Yang Configuration for 802.1Qbv
• Build Enet TSN EST Example
• HW Setup
• Running Enet TSN EST example
• Note

Introduction

This example application demonstrates how to configure the IEEE 802.1 Qbv (EST) through our TSN yang interface.

The yang interface in the TSN is governed by a module called uniconf which runs as a daemon. Any application which interacts with the uniconf is called as a uniconf client. The uniconf client configures 802.1 Qbv by opening yang database (DB), write config yang parameters to DB and triggers the uniconf for reading parameters from DB and writing to HW. The uniconf reads or writes parameters from or to HW by calling Enet LLD driver.

Please note that the file system support is not yet integrated in ethernet examples.

In this example, we configure the talker DUT to send out traffic as per the EST schedule and the listener DUT or device can verify the time-slots of the received packets.

Please note, The receive packet time stamping of non-ptp traffic is currently not supported on AM263x. User needs to use other time-stamping device to capture the receive time-stamps. The receive packet time-stamping support is available on AM243x and AM64x. If AM243x or AM64x is available, you can connect to them and configure them as listener.

See also : Enet CPSW EST Example, Ethernet TSN and gPTP Stack - API and Integration Guide

Supported Combinations

Parameter	Value
CPU + OS	r5fss0-0_freertos
Toolchain	ti-arm-clang
Boards	am263x-cc, am263x-lp
Example folder	source/networking/enet/core/examples/tsn/est_cpsw_app

Packet pool configuration

To change packet pool configuration from syscfg, please refer to Ethernet Packet Pool Allocation Guidelines

Constraints

• This application only enables one MAC port which has the interface name tilld0. This interface is mapped MAC port 1 for all MCU devices. To change the default MAC port for this example, please change the macro DEFAULT_INTERFACE_INDEX from qosapp_misc.h from 0 another value (1, 2, 3).
• The application can only be run as talker. Please input character "t" from the UART terminal.
• Number of streams on talker is 2 with traffic priorities 0 and 2 mapped to HW queue 0 and 2 respectively. Number of streams and priority can be changed by modifying the gEnetEstAppTestLists from the est_init.c.
• The EST schedule should be applied and talker starts sending test traffic after PTP synchronization is in good condition to have accurate test results.
• The talker sends dummy data which is encapsulated in an AVTP packet. Packet sent with VLAN ID 110.

Configuration Parameters

• Default MAC port can be changed by modifying the DEFAULT_INTERFACE_INDEX from the qosapp_misc.h.

• EST Schedule (Input parameters)

  Gate control list

  Gate Control	Time Interval
  oCCCCCCo	62 usecs
  oCooCoCC	62 usecs
  oCCCCCCo	62 usecs
  oCCCCoCC	62 usecs

Each of the 8 gates (one per priority) can be in one of two states:

• Open: Frames in the corresponding queue can be selected for transmission. This is represented by 'o' in the Gate Control column of previous table.

• Closed: Frames in the corresponding queue are not selected for transmission. This is represented by 'C' in the Gate Control column.

  The priority being referred to in the EST schedule described above corresponds to the CPSW destination port hardware switch priority. For VLAN tagged packets that ingress through CPSW host port, the hardware switch priority can be determined by either the CPPI channel number (P0_RX_REMAP_VLAN = 0) or the packet priority value from the VLAN tag (P0_RX_REMAP_VLAN = 1).

• The EST schedule is 248us long and it is composed of 4 intervals, each with a gate mask that enables transmission of 2 priorities. PTP traffic can be sent on any non-zero priority. Here we are using the priority 7 for PTP traffic. The gate of this priority is always opened to make sure there is no interruption of the PTP packet which keeps the PTP in good synchronization status. The remaining priorities are for test traffic (avtp packets).

Parameters	TimeValue
baseTime	((Current PTP Time + delayOffset)/delayOffset)*delayOffset
cycleTime	248us

Where

• baseTime: PTP time rounded-off to the delayOffset to have the same baseTime on both talker and listener to apply the EST schedule that the same time in the future.
• delayOffset: added time to current PTP time for baseTime to apply the schedule in the future. It should be a multiple of the cycleTime and large enough so that user can have enough time to start talker and listener by entering a character to UART terminal.
  The current delayOffset is 100000*cycleTime = 24800000us (24.8 seconds).
  The factor '100000' is chosen to have delayOffset above 20secs.

Expected Behavior

• Below is the expected behavior on the listener side. If you have AM243x or AM64x, you can configure them to perform this verification process.
• With the schedule configured above, the expectation is that
  • all priority 0 packets arrive on listener inside the time windows

    0–62us

    124us–186us

  • all priority 2 packets arrive on listener inside the time windows

    62us–124us

    186us–248us

  • To check whether packets are received within a time window, the rx timestamp, called rxts (PTP time) of each received packet, is captured by host port on the listener's side.
    Then the timeSlot of each packet is calculated using the following formula:

timeSlot = (rxts - BaseTime)%CycleTime

The timeSlot is compared with the time windows above for each packet to check whether the packet received inside or outside the expected time windows.
The EST works when percentage of packets received outside of expected time windows less than or equal 1%.

Application Integration Guide

The EST application needs to run with the gPTP and yang configuration daemon. Therefore, the gPTP and uniconf must be run during initializing the application. To register the EST application to the initializer of the TSN App for running after the gPTP and uniconf, add the following line to the EnetApp_initTsnByCfg of the tsninit.c

#ifdef EST_APP_ENABLED
if (res == 0)
{
    res = EnetApp_addEstAppModCtx(gModCtxTable);
}
#endif //EST_APP_ENABLED

Then the EST application will be started when the EnetApp_startTsn is called.

Yang Configuration for 802.1Qbv

• Yang file for the 802.1Qbv is defined at standard/ieee/draft/802.1/Qcw/ieee802-dot1q-sched-bridge.yang and standard/ieee/draft/802.1/Qcw/ieee802-dot1q-sched.yang from the https://github.com/YangModels/yang.git
• Enet-lld supports configuration of the admin-control-list, baseTime (admin-base-time) and cycleTime (admin-cycle-time), this section describes the parameters of the admin-control-list Here are parameters of the admin-control-list after converting parameters from yang to to xml

<?xml version='1.0' encoding='UTF-8'?>
<data xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <interfaces xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
    <interface>
      <name/>
      <bridge-port xmlns="urn:ieee:std:802.1Q:yang:ieee802-dot1q-bridge">
        <traffic-class>
          <traffic-class-table>
            <number-of-traffic-classes/>
            <priority0/>
            ...
            <priority7/>
          </traffic-class-table>
          <tc-data>
            <tc/>
            <lqueue/>
            ...
          </tc-data>
          <number-of-pqueues/>
          <pqueue-map>
            <pqueue/>
            <lqueue/>
          </pqueue-map>
        </traffic-class>
        <gate-parameter-table xmlns="urn:ieee:std:802.1Q:yang:ieee802-dot1q-sched-bridge">
          <gate-enabled></gate-enabled>
          <admin-control-list>
            <gate-control-entry>
              <index/>
              <operation-name/>
              <time-interval-value/>
              <gate-states-value/>
            </gate-control-entry>
          </admin-control-list>
          <admin-cycle-time>
            <numerator/>
            <denominator/>
          </admin-cycle-time>
          <admin-base-time>
            <seconds/>
            <nanoseconds/>
          </admin-base-time>
        </gate-parameter-table>
      </bridge-port>
    </interface>
  </interfaces>
</data>

• All the supported parameters for 802.1Qbv are from yang standard except the mechanism for mapping traffic class and HW queue are augmented. To configure all parameters of 802.1Qbv above, application calls the yang_db_runtime_put_oneline to write data to DB. After all required parameters written to the DB, application trigger the uniconf by writing the /ietf-interfaces/interfaces/interface|name:tilld0/bridge-port/gate-parameter-table/gate-enabled so that the uniconf writes parameters to HW. See EnetEstApp_setAdminControlList of the est_init.c for yang configuration.

  Note

  The network interface tilld0 is the default network interface name, name of network interface can be changed by changing the default MAC port configured for the example.

Build Enet TSN EST Example

Refer Ethernet TSN gPTP Examples to build the enet_cpsw_tsn_est_example

HW Setup

Make sure you have setup the EVM with cable connections as shown in EVM Setup. In addition, follow the steps in the next section.

Note

Ethernet cable must be connected and link must be up in order for the example application to continue execution.

Running Enet TSN EST example

• HW devices configuration

  Connect AM263x SOC to any gPTP capable device, PC or AM243x or AM64x.

[MCU#1 (talker)]<---------------->[PC or MCU#2 (Listener)]

• Please note that if you want to perform verification on listener side, listener device should be capable of time-stamping all receive packets.
• Launch a CCS debug session, load and run the example executable, see CCS Launch, Load and Run

IFV:gptp:domainIndex=0, clock_master_sync_receive:the master clock rate to -14648ppb, GMdiff=-24nsec
IFV:gptp:domainIndex=0, clock_master_sync_receive:the master clock rate to -14666ppb, GMdiff=-30nsec
IFV:gptp:domainIndex=0, clock_master_sync_receive:the master clock rate to -14645ppb, GMdiff=-15nsec

• When the abs(GMdiff) is below 1000ns, it is a good time to start the EST usecase.

• Start the talker right after the listener.

  On the slave device, press t to start a talker, It will show log on UART terminal as follows

GateMask[7..0]=oCCCCCCo (0x81), start=0 ns, end=61999 ns, dur=62000 ns
GateMask[7..0]=oCCCCoCC (0x84), start=62000 ns, end=123999 ns, dur=62000 ns
GateMask[7..0]=oCCCCCCo (0x81), start=124000 ns, end=185999 ns, dur=62000 ns
GateMask[7..0]=oCCCCoCC (0x84), start=186000 ns, end=247999 ns, dur=62000 ns
Base time=74400000000ns,Cycle time=248000ns
INF:cbase:Successfully configure TAS

• After starting the talker, it will start sending traffic after the EST schedule takes effect (around 20 seconds).

Note

• The gPTP log will help to identify which HW device is a slave device. In case that log is not needed or noisy, please suppress them by changing the gptp:66 to gptp:55 in the enet_tsn/enet_tsn_est_example/makefile.
• If the percentage of bad packets is greater than 1%, please check the GMdiff from the gPTP log of the slave device mentioned above, the expected GMdiff less than 1000ns. The EST use case only works when PTP synchronization is in good condition.