1
Copyright (C) 2020 Reserved by ASIX Electronics Corporation, All Rights Reserved.
AXM57104
TSN Ethernet Switch PCIe Card User Guide
Reference Design User Guide
Revision 1.00
August 10
th
, 2020
TSN Ethernet Switch PCIe Card
User Guide
Страница 1: ...Reserved by ASIX Electronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Revision 1 00 August 10th 2020 AXM57104 TSN Ethernet Switch P...
Страница 2: ...20 Reserved by ASIX Electronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Revision History Revision Date Description 1 00 2020 08 10...
Страница 3: ...5 AXM57104 Qav Config 19 3 6 AXM57104 Qbv Config 19 3 7 AXM57104 Boot Up Service 20 3 8 AXM57104 Ptp4l 21 3 9 AXM57104 RSTP 22 3 10 AXM57104 FPGA Upgrade 23 3 11 Netconf 23 4 PTP4L 24 4 1 Example PTP...
Страница 4: ...3 Environment Setup 37 8 3 1 Sysrepo 37 8 3 2 Netopeer2 toolset 45 8 3 3 Datastore_Handler 47 8 4 Execution 48 8 5 IETF Interface File Description 53 9 RSTP 54 9 1 Status of Bridge or Port 55 9 2 Simp...
Страница 5: ...3 4 20 Figure 3 5 21 Figure 3 6 22 Figure 4 1 24 Figure 4 2 25 Figure 4 3 26 Figure 4 4 26 Figure 4 5 27 Figure 5 1 28 Figure 5 2 29 Figure 5 3 29 Figure 5 4 30 Figure 5 5 30 Figure 6 1 31 Figure 6 2...
Страница 6: ...9 1 54 Figure 9 2 54 Figure 9 3 55 Figure 9 4 55 Figure 9 5 56 Figure 9 6 56 Figure 9 7 57 Figure 9 8 57 Figure 9 9 58 Figure 9 10 58 Figure 9 11 59 Figure 9 12 59 Figure 9 13 60 Figure 9 14 60 Figur...
Страница 7: ...Reserved by ASIX Electronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide List of Table Table 1 1 9 Table 8 1 53 Table 12 1 68 Table 12...
Страница 8: ...up each software components and provides a demonstration for ASIX AXM57104 PCIE Switch and run it The AXM57104 is an x86 PC based PCIe network adapter with TSN feature All related software developed b...
Страница 9: ...104 Service Middleware of AXM57104 AXM57104 Config Reg AXM57104 register configuration tool AXM57104 Qbv Config 802 1 Qbv configuration tool AXM57104 Qav Config 802 1 Qav configuration tool AXM57104 P...
Страница 10: ...hould prepare some software platform and board Of course they are all running based on general desktop PC with Linux OS 2 1 Operation System Linux Ubuntu 16 04 5 kernel version 4 15 0 operation system...
Страница 11: ...020 Reserved by ASIX Electronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Figure 2 2 PIN definition of J1 field the function is syn...
Страница 12: ...ctronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide PIN definition of J2 field the function is JTAG Figure 2 4 PIN definition of J3 f...
Страница 13: ...Guide PIN definition of J4 field the function is sync_io Figure 2 6 The LED field is reserved function for use The SW1 field is reserved function for use The SW2 field is reserved function for use Th...
Страница 14: ...thernet Switch PCIe Card User Guide Reference Design User Guide Figure 2 7 The definition of Ethernet port LED indicator as following Figure 2 8 Note The default PHY speed mode is 10 100 1000M auto ne...
Страница 15: ...Note Where BSP Board Supported Package XXX version like 100 for example Decompress and enter the BSP tar jxvf AXM57104_BSP_vXXX tar bz2 cd AXM57104_BSP_vXXX 3 2 AXM57104 Linux Driver Enter the driver...
Страница 16: ...C 2020 Reserved by ASIX Electronics Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Figure 3 1 Check out network interface by typing comma...
Страница 17: ...gure 3 2 The enpXs0 is newer format of network interface name of Ubuntu where X indicates order of network adapters The ethX is original format of network interface name of Linux and the ethX Y is for...
Страница 18: ...development files Ubuntu package libzmqpp dev Make sure your system already connect to Internet type below command in console sudo apt get update sudo apt get install libsystemd dev sudo apt get insta...
Страница 19: ...tall 3 5 AXM57104 Qav Config In the Application AXM57104_Qav_Config folder decompress the AXM57104_Qav_Config_vX X X tar bz2 enter the package clean old objects build code and install the application...
Страница 20: ...p3s0 0 enp3s0 1 enp3s0 2 enp3s0 3 so that we prepare an AXM57104 boot up service to rename the network interface name of DSA port Before install this boot up service you must install AXM57104_Service...
Страница 21: ...older decompress the AXM57104_Ptp4l_vX X X tar bz2 and enter the package tar jxvf AXM57104_Ptp4l_vX X X tar bz2 cd AXM57104_Ptp4l_vX X X Note Where X X X version like 1 0 0 for example Before install...
Страница 22: ...gPTP Figure 3 6 If the gPTP service active failed please restart the service by type below command systemctl restart gPTP 3 9 AXM57104 RSTP In the Application AXM57104_RSTP folder decompress the AXM57...
Страница 23: ...he AXM57104_FPGA_Upgrade_vX X X tar bz2 enter the folder clean old objects build code and install the application Note Where X X X version like 1 0 0 for example tar jxvf AXM57104_FPGA_Upgrade_vX X X...
Страница 24: ...To End Transparent for time synchronization The IEEE 802 1AS is used for time synchronization between network devices under Time Sensitivity Network The Boundary model is used for met bridge structure...
Страница 25: ...PPS signal through Scope for confirm synchronization We prepare two PCs as below figure SWITCH 1 setup on PC1 and SWITCH 2 on PC2 The AXM57104 MAC of PC1 00 0E C6 00 39 0A The AXM57104 MAC of PC2 00 0...
Страница 26: ...t 0 port 3 of AXM57104 The selected best master clock 000ec6 fffe 003905 means that port0 of PC1 select outside entity with mac address 00 0E C6 00 39 05 as best master clock Figure 4 3 In PC2 we also...
Страница 27: ...Switch PCIe Card User Guide Reference Design User Guide We observe the PPS signal of PC1 and PC2 through Scope The result as following Figure 4 5 The waveform with cyan blue color C3 is PC1 and the g...
Страница 28: ...ess SWITCH TSN related hardware register User can execute the programs in console independently or call the program by other software process Here we will describe how to operate this program simply T...
Страница 29: ...dicates base address of the register map name The red_high_light_3 indicates bit width of the register map name The red_high_light_4 indicates bit offset of the register map name Figure 5 3 5 2 Read V...
Страница 30: ...7104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Figure 5 4 5 3 Write Value to Register Type below command is an example for write value into mac_addr_lo Don t forget add 0x i...
Страница 31: ...t Qbv configurations by external configuration file with JSON format User can execute the programs in console independently or call the program by other software process Type below command in console...
Страница 32: ...of port 0 by JSON file axm57104_qbv_config c SWITCH n 0 w configs qbv_config_file json The path of below JSON file is only an example and you should specify a correct path in your environment The refe...
Страница 33: ...The high_light_4 index indicates to set which slot The high_light_5 gate_states_value indicates to set what VLAN priorities can pass through in this slot For example Decimal 65 0x41 indicates only BIT...
Страница 34: ...v_config h It will show all operations Figure 7 1 7 1 Read Configuration Below command is an example for read Qav configuration of priority queue 0 of port 0 axm57104_qav_config c SWITCH n 0 p 0 r Fig...
Страница 35: ...uide Reference Design User Guide 7 3 Qav JSON file Below figure is an example JSON file for Qbv setting Figure 7 4 The high_light_1 cbs_enable indicates to enable disable the Qav for specified priorit...
Страница 36: ...onfiguration data information can be retrieved and new configuration data can be uploaded and manipulated CESNET build the toolset of Netopeer2 contain the client server communication under Netconf pr...
Страница 37: ...re_handler Example_configurations README txt RelyPackets Service Yang Certificates the certificate which using for Netconf data transfer between Netconf server and Netconf client Configuration the con...
Страница 38: ...uld be 4 8 4 but if you install Ubuntu 16 04 the Gcc compiler version already on suitable version 5 4 0 Input command by following step gcc version Figure 8 2 8 3 1 2 Clang The Clang version should be...
Страница 39: ...mocka 1 1 5 mkdir build cd build cmake DCMAKE_INSTALL_PREFIX usr DCMAKE_BUILD_TYPE Debug make sudo make install Figure 8 5 8 3 1 5 Libpcre The PCRE library is a set of functions that implement regular...
Страница 40: ...e libssh is the most important library all of Netconf server and Netconf client communication each other always under SSH protect to ensure data security On Ubuntu 16 04 x64 the libssh already install...
Страница 41: ...de 8 3 1 8 Libyang Libyang is a library implementing processing of the YANG schemas and data modeled by the YANG language This library is implemented in C for GNU Linux and provides C API Please follo...
Страница 42: ...8 3 1 9 Libnetconf2 The libnetconf2 is a NETCONF library in C handling NETCONF authentication and all NETCONF RPC communication both server and client side please following below step to install cd Yo...
Страница 43: ...en sh you may need run it as root permission configure you may need run it as root permission Note after you run over configure it s should not show any error message make make check Below figure show...
Страница 44: ...thm Please following below step to install cd Your BSP location Application Netconf RelyPackets libredblack configure make sudo make install Figure 8 13 So the require libraries already install we sta...
Страница 45: ...conf2 The Netopeer2 server uses sysrepo as a NETCONF datastore implementation To build the Netpeer2 please following below step to install First install kerstore cd Your BSP location Application Netco...
Страница 46: ...Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Figure 8 16 Install Netconf client cd Your BSP location Application Netconf RelyPackets netopeer2 0 7 r1 c...
Страница 47: ...t1q bridge Detects when a change is performed in the ietf interfaces module and configure ieee802 do1q sched changes with remote local command Then we can build the datastore_handler now cd Your BSP l...
Страница 48: ...r and when the config already modify save it into sysrepo to exchange it from sysrepo to datastore_handler and pass configure to AXM57104_service we need start many applications by below sequence On s...
Страница 49: ...rver you must generate the ssh key yourself please reference below link the create own ssk key https confluence atlassian com bitbucketserver creating ssh keys 776639788 html Success connect with serv...
Страница 50: ...er Guide Figure 8 23 If we want to edit config which save in remote server for example edit ietf interfaces config you can following below step Step 1 download config file get config source running fi...
Страница 51: ...Step 3 using edit config command to restore to Netconf server the file path should add after config parameter edit config target running config home axm57104 BSP Application Netconf ietf interfaces xm...
Страница 52: ...new parameter already write into sysrepo or not we can use get config again given the config file which from sysrepo named ietf interfaces2 xml by following command get config source running filter xp...
Страница 53: ...min Base Time second 0xA44 fractional seconds 0 4294967295 Admin Base Time ns 0xA48 config change true or false Configuration Change 0xA58 Table 8 1 The gate enabled indicates enable or disable Qbv co...
Страница 54: ...slave interfaces for the bridge and their state Also daemon translates CIST states to the kernel bridge slaves so mstpd in RSTP mode can be used as replacement for the current rstpd If you already ins...
Страница 55: ...rt Type below command for check network interfaces that are used by mstpd ifconfig The br0 indicates bridge 0 of mstpd The rstp0 rstp3 indicates 4 rstp ports of the bridge 0 Below figure is an example...
Страница 56: ...Type below command for check out status of rstp port of bridge 0 mstpctl showportdetail br0 rstp0 Figure 9 5 9 2 Simple Test for RSTP We setup 2 switches in 2 PCs and connect them with port 0 as foll...
Страница 57: ...d User Guide Reference Design User Guide Below figure is PC1 screen the rstp0 of SWITCH 1 seems root port of this topology and enter forwarding state the rstp1 is disabled Figure 9 7 Below figure is P...
Страница 58: ...e We connect 2 switches with port 0 and port 1 as following Figure 9 9 If we don t setup RSTP for this topology the broadcast storm will start immediately base on experience Upper layer application of...
Страница 59: ...he rstp0 still forwarding state and the rstp1 enter forwarding state with Designated role Don t worry about this this is due to designate port still needs to listen bridge frames comes from root switc...
Страница 60: ...TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Observe the PC1 screen The rstp0 be disabled and rstp1 enter forwarding state with Root role Figure 9 13 Observe the PC2 screen The...
Страница 61: ...le with MCS format Flash size of AXM57104 is 64 Mbytes 512 Kbits The axm57104_FPGA_upgrade always upgrade lower half part blue area of the flash AXM57104 hardware load lower half part of the flash whi...
Страница 62: ..._FPGA_upgrade upgradeFPGA 0604_simple mcs The program will confirm you again type Yes here and press Enter Figure 10 3 The program will erase the lower half part of flash now please wait a minute Figu...
Страница 63: ...PHP components Make sure your host already connected to internet Type below commands in console sudo apt get update sudo apt get install lighttpd sudo apt get install php7 0 fpm sudo apt get install p...
Страница 64: ...Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide Type admin in User Name field and asix in Password field Figure 11 2 You will see the main page as following The...
Страница 65: ...gs you can setup static IP address Network mask and Hostname If you have any changes please don t forget to click Apply changes at upper right corner Figure 11 4 In Advanced Network default page is TA...
Страница 66: ...extension is used for setting extension time behind of cycle time The Base time seconds is used for setting base time of 802 1Qbv The Base time seconds nanoseconds is used for setting nanosecond part...
Страница 67: ...ou select PORT_0 PORT_3 for the Qav configuration The Priority queue field let you select which priority needs to be configured The CBS enabled field is used for enable disable Qav configuration under...
Страница 68: ...interference video streams in general Ethernet network But the Time aware Sensitivity Network can transmit specific data with different VLAN priority by specified time slot 802 1Qbv or self credit 802...
Страница 69: ...stall curl curl sL https deb nodesource com setup_10 x sudo E bash sudo apt install nodejs In console of PC1 PC2 type below command for install VLC package sudo apt get install vlc In console of PC1 t...
Страница 70: ...el I210 enp5s0 and connect the Ethernet port of IF_PKTGEN to port 1 of AXM57104 After finish modification type below command in PC1 PC2 PC3 for install related boot up service make install reboot Afte...
Страница 71: ...d together Go to the ASIX_Demo folder under AXM57104 BSP working directory in PC1 Decompress the package opera 12 16 1860 x86_64 linux tar bz2 tar jxvf opera 12 16 1860 x86_64 linux tar bz2 Enter the...
Страница 72: ...ick and will see below screen In this page we turn on the Qbv and prepare 2 slots Generic packet and gPTP frame in slot 0 2 videos and noise in slot 1 However there are two videos playing in the scree...
Страница 73: ...User Guide Reference Design User Guide The Packet Time diagram as following The noise effect Video 1 Video 2 Figure 12 8 Click Go back button and enter AXM57104 Time Aware Shaper Test page In this pa...
Страница 74: ...does not be effect The packets of right hand side video with priority 4 are transmitted in same slot to the noise This is due to the packet of left hand side video with priority 2 be transmitted in di...
Страница 75: ...page we turn on the Qav by default There are two videos be playing They should also be playing smoothly Figure 12 12 Click Start Traffic Generator button and then you will see both 2 videos be not ef...
Страница 76: ...cs Corporation All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide The Packet Time diagram as following Due to we inhibit the bandwidth of the Noise the N...
Страница 77: ...me without notice ASIX provides this document as is without warranty of any kind either expressed or implied including without limitation warranties of merchantability fitness for a particular purpose...
Страница 78: ...ration All Rights Reserved AXM57104 TSN Ethernet Switch PCIe Card User Guide Reference Design User Guide 4F No 8 Hsin Ann Rd Hsinchu Science Park Hsinchu Taiwan R O C TEL 886 3 5799500 FAX 886 3 57995...
