Open main menu

DAVE Developer's Wiki β

Changes

Pre-built binaries
{{InfoBoxTop}}
{{Applies To Bora}}
{{Applies To BoraX}}
{{Applies To BoraLite}}
{{AppliesToBORA_AN}}
{{AppliesToBORA_Xpress_AN}}
{{AppliesToBORA Lite AN}}
 
{{InfoBoxBottom}}
{{WarningMessage|text=This application note was validated against specific versions of the kit only. It may not work with other versions. Supported versions are listed in the ''History'' section.}}
 
{{ImportantMessage|text=It is assumed to use ZYNQ SOC with <b><i>speed grade -1</i></b> (even using command line script or GUI). In any case, there are no issues using <b><i>speed grade -3</i></b> SOC provided with BELK kit}}
 
 
==History==
{| class="wikitable" border="1"
!Version
!Date
!BELK /BXELK version
!Notes
|-
|1.0.0
|September 2015
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0]]
|First release
|-
|1.1.0
|January 2016
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0, 3.0.0]]
|Added support for BoraX/BoraXEVB platform
|-
|{{oldid|8290|1.1.1}}
|September 2016
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0, 3.0.0]]
|Added more information about MII buses organization
|-
|2.0.0
|January 2020
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|4.1.0 / 2.1.0]]
|AN migration to BELK 4.1.0 / BXELK 2.1.0
|-
|}
==Introduction==
Thanks to the migration to linux kernel 3.10.17, [[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|BELK 2.2.0]] and [[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|BELK 3.0.0]] allows to cleanly support dual Gigabit Ethernet configuration on BoraEVBand BoraXEVB. This application note describes how to implement such configuration, providing a reference design for Vivado 2014.4 and linux kernel configuration instructions.
==Block diagram==
[[File:An-belk-006-bd.png|thumb|center|600px]]
[[File:an-belk-006-boralite-01.png|thumb|center|600px]]
First Ethernet port refers to J8 connector of BoraEVB and BoraXEVB carrier board and is based on Zynq's Gigabit Ethernet Controller 0 (Gem0). This controller is mapped at physical address 0xE000B000.
Second Ethernet port refers to J9 connector of BoraEVB and BoraXEVB carrier board and is based on Zynq's Gigabit Ethernet Controller 1 (Gem1). This controller is mapped at physical address 0xE000C000.
The fundamental difference between the two interfaces is the PHY interfacing. In case of Gem0, PHY is mounted on Bora and BoraX SoM and it is interfaced directly to Processor Subsystem (PS) via MIO pads. In case of Gem1 instead, PHY is populated on BoraEVB and BoraXEVB (U9) and it is interfaced to Programmable Logic (PL) pads that belong to bank #34. Thus it is necessary to enable EMIO routing and to instantiate a GMII to RGMII bridge in PL as per PHY's interface requirement. Since bank #34 About MII bus (MDIO, MDC), two different busses are used:*Bora PHY is powered connected to the signals <code>ETH_MDC</code> and <code>ETH_MDIO</code> (available on BoraEVB at 3JP18.7 and JP18.3V (High Range I/O mode9 respectively), RGMII duty cycle distortion specification **this MII bus is not matched. In case of carrier board designed for production environments, it associated to <code>gem0</code>*BoraEVB PHY is recommended connected to use a lower voltage levels and thus a different PL bank. For more details please see section ''Is <code>IO_L9N_T1_DQS_34</code> (<code>ETH1_MDC</O Standard code>) and Placement'' of [http:<code>IO_L9P_T1_DQS_34</code> (<code>ETH1_MDIO</xgooglecode>); these signals are available on BoraEVB at JP18.xilinx8 and JP18.com10 respectively**this MII bus is associated to <code>gem1</search?output=xml_no_dtd&ie=UTF-8&oe=UTF-8&getfields=code>**&filter=0&site=EntireSite&num=200&client=xilinx&proxystylesheet=xilinx&show_dynamic_navigation=0&allVersions=1&sort=meta:Last%2520Modified%2520Date%3AD%3AED&q=+inmeta:Document%2520Class%3DDocument+inmeta:Product%2520Type%3DIP%2520Cores+inmeta:IP%3DGMII%2520to%2520RGMII ''PG160 GMII it is worth to RGMII LogiCORE IP Product Guide''] and [[Power_remember that a virtual PHY (Borawhose address is 8)|is connected to this page]]bus as well; this PHY is implemented in the GMII/RGMII bridge and it is used to configure the bridge at runtime, depending on operating parameters such as the Ethernet physical link speed.
==Vivado design==
[[File:An-belk-006-01.png|800px]]
==Enabling dual Ethernet configuration in linux kernel=Bora + BoraEVB===To enable dual Ethernet user need On BoraEVB PHY1 is interfaced toProgrammable Logic (PL) pads that belong to bank #34. '''WARNING:''' due to a restraint introduced, from Vivado version 2017.1 onwards, the signal ETH1_TXCK can be routed only to a pad that is MRCC or SRCC input. As result from BELK 4.0.0 an hardware rework is needed on the BoraEVB board:* Remove R183* Remove R232* get Connect R183.2 with R232.1 This rework prevents the use of the PL SDRAM onboard of the preBoraEVB (by default this ram is not mounted). Here is the pinout assignment for the PHY1 on BoraEVB:{| class="wikitable" | | align="center" style="background:#f0f0f0;"|'''PHY1 Signal'''| align="center" style="background:#f0f0f0;"|'''BORA SOM Signal'''|-| ETH1_TXD0||IO_L24P_T3_34|-| ETH1_TXD1||IO_L24N_T3_34|-| ETH1_TXD2||IO_L23P_T3_34|-| ETH1_TXD3||IO_L23N_T3_34|-| ETH1_TXCK||IO_L20P_T3_34|-| ETH1_TXCTL||IO_L20N_T3_34|-built binaries from this | ETH1_RXD0||IO_L5N_T0_34|-| ETH1_RXD1||IO_L5P_T0_34|-| ETH1_RXD2||IO_L7N_T1_34|-| ETH1_RXD3||IO_L7P_T1_34|-| ETH1_RXCK||<span style="text-decoration: line-through;">IO_L4N_T0_34</span> IO_L13P_T1_MRCC_34|-| ETH1_RXCTL||IO_L4P_T0_34|-| ETH1_MDC||IO_L9N_T1_DQS_34|-| ETH1_MDIO||IO_L9P_T1_DQS_34|-|} Since bank #34 is powered at 3.3V (High Range I/O mode), RGMII duty cycle distortion specification is not matched. In case of carrier board designed for production environments, <u>it is recommended to use a lower voltage levels and thus a different PL bank</u>. For more details please see section ''I/O Standard and Placement'' of [httphttps://wwwdocs.davexilinx.eucom/systemr/filesen-US/areapg160-gmii-to-riservatargmii/ANGMII-to-RGMII-v4.1-LogiCORE-IP-Product-Guide ''PG160 GMII to RGMII LogiCORE IP Product Guide''] and [[Power_(Bora)|this page]]. The Vivado project can also be build with the procedure explained [[Creating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]]. ===BoraLite + Adapter + BoraXEVB===On BoraXEVB PHY1 is interfaced to Programmable Logic (PL) pads that belong to bank #13. The BoraLite Adapter take care of rerouting the ETH1_RXCK to meet the Vivado requirements. Here is the pinout assignment for the PHY1 on BoraXEVB:{| class="wikitable" | | align="center" style="background:#f0f0f0;"|'''PHY1 Signal'''| align="center" style="background:#f0f0f0;"|'''BORAX SOM Signal'''|-| ETH1_TXD0||IO_L19P_T3_13|-| ETH1_TXD1||IO_L19N_T3_VREF_13|-| ETH1_TXD2||IO_L20P_T3_13|-| ETH1_TXD3||IO_L20N_T3_13|-| ETH1_TXCK||IO_L16P_T2_13|-| ETH1_TXCTL||IO_L16N_T2_13|-| ETH1_RXD0||IO_L17P_T2_13|-| ETH1_RXD1||IO_L17N_T2_13|-006| ETH1_RXD2||IO_L18P_T2_13|-sw| ETH1_RXD3||IO_L18N_T2_13|-| ETH1_RXCK||IO_L14P_T2_SRCC_13|-| ETH1_RXCTL||IO_L14N_T2_SRCC_13|-| ETH1_MDC||IO_L21N_T3_DQS_13|-| ETH1_MDIO||IO_L21P_T3_DQS_13|-|} I/O voltage of bank 13 must be set to 2.zip link5V by configuring [[BoraXEVB#BANK13_VDDIO_selector_-_JP25|JP25 ]]as shown in the following table.{| class="wikitable" border="1"!Pins!Setting|-|1-2|closed|-|3-4|open|-|5-6|closed|-|7-8|open|-|9-10|open|-|11-12|open|-|}
Kernel and device tree The Vivado project can also be built build with the following procedure:* update Bora kernel repository (as described explained [[Bora_Embedded_Linux_Kit_Creating_and_building_example_Vivado_project_(BELK/BXELK)#Updating_the_repositories_from_BELK_2.1.0_to_BELK_2.2.0Command_line_based_procedure|here]])* apply the patch ''0001-dts-bora-add-ETH1-phy-support.patch'' included in the pre-build binaries package* build the updated kernel source as usual
Here ===Borax + BoraXEVB===On BoraXEVB PHY1 is the patch interfaced to enable dual Ethernet:<pre>From 8807f6acb794acafbe0f08efbacf4b7cfd2c18f5 Mon Sep 17 00:00:00 2001From: Matteo Geromin <matteoProgrammable Logic (PL) pads that belong to bank #13.geromin@dave.eu>Date: Fri, 11 Sep 2015 17:48:46 +0200Subject: [PATCH] dts: bora: add ETH1 phy support
---'''WARNING:''' due to a restraint introduced, from Vivado version 2017.1 onwards, the signal ETH1_TXCK can be routed only to a pad that is MRCC or SRCC input. As result from BXELK 2.0.0 an hardware rework is needed on the BoraXEVB board:* Remove RP84* Remove R232 arch/arm/boot/dts/bora* Connect RP84.2 with R232.dts | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+)
diff --git a/arch/arm/boot/dts/boraThis rework prevents the use of the LVDS connector on BoraXEVB (J26).dts b/arch/arm/boot/dts/bora.dtsindex 654770e..35697cd 100644--- a/arch/arm/boot/dts/bora.dts+++ b/arch/arm/boot/dts/bora.dts@@ -59,6 +59,25 @@ }; };
+&gem1 Here is the pinout assignment for the PHY1 on BoraXEVB:{| class="wikitable" | + status | align= "okaycenter" style="background:#f0f0f0;"|'''PHY1 Signal'''+ phy-mode | align= "rgmii-idcenter" style="background:#f0f0f0;"|'''BORAX SOM Signal'''+ phy|-handle = <&phy1>;+ gmii2rgmii| ETH1_TXD0||IO_L19P_T3_13|-phy| ETH1_TXD1||IO_L19N_T3_VREF_13|-handle = <&phy2>;+| ETH1_TXD2||IO_L20P_T3_13+ phy1: phy@6 {|-+ compatible = "micrel,ksz9031";| ETH1_TXD3||IO_L20N_T3_13+ device_type = "ethernet|-phy";+ rxc| ETH1_TXCK||IO_L16P_T2_13|-skew| ETH1_TXCTL||IO_L16N_T2_13|-ps = <1860>;+ txc| ETH1_RXD0||IO_L17P_T2_13|-skew| ETH1_RXD1||IO_L17N_T2_13|-ps = <1860>;+ reg = <6>;| ETH1_RXD2||IO_L18P_T2_13+ };|-+| ETH1_RXD3||IO_L18N_T2_13+ phy2: phy@8 {|-+ reg | ETH1_RXCK||<span style= "text-decoration: line-through;">IO_L15P_T2_DQS_13<8/span>;IO_L12P_T1_MRCC_13+ };|-+};| ETH1_RXCTL||IO_L15N_T2_DQS_13+|- &sdhci0 {| ETH1_MDC||IO_L21N_T3_DQS_13 status = "okay";|- broken-cd = <0x1>;| ETH1_MDIO||IO_L21P_T3_DQS_13-|-1.7.9.5|}
I/O voltage of bank 13 must be set to 2.5V by configuring [[BoraXEVB#BANK13_VDDIO_selector_-_JP25|JP25 ]] as shown in the following table.{| class="wikitable" border="1"!Pins!Setting|-|1-2|closed|-|3-4|open|-|5-6|closed|-|7-8|open|-|9-10|open|-|11-12|open|-|} The Vivado project can also be build with the procedure explained [[Creating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]]. ==Enabling dual Ethernet configuration in linux kernel==To enable dual Ethernet user needs to get the pre-built binaries [[BELK-AN-006:_Enabling_dual_Gigabit_Ethernet_support_on_BoraEVB/BoraXEVB#Pre-built_binaries |here]] Alternatively kernel and device tree can be built from sources with the following procedure:* update Bora kernel repository (as described [[BELK/BXELK_software_components#Updating_git_repositories|here]])* build the <code>bora-an006.dtb</precode>devicetree* build the updated kernel source as usual.
Put the binaries on the first (FAT32) partition of your BELK 2.2.0 SD card, overwriting the original one if needed. Please note that you need the following files:* <code>boot.bin</code>* <code>bora.dtb</code>* <code>uImage</code>* <code>fpga.bin</code>* <code>u-boot.img</code>* <code>uEnv.txt</code>
Insert the SD card into BoraEVB or BoraXEVB and turn on the board.
During kernel boot, user can check if the second ethernet interface has been loaded succesfully:
RX bytes:788 (788.0 B) TX bytes:788 (788.0 B)
root@bora:~#
root@bora:~# ifconfig eth1 192.168.12.209
root@bora:~#
root@bora:~# [ 228.492886] xemacps e000c000.ethernet: Set clk to 0 Hz
[ 228.498079] xemacps e000c000.ethernet: link up (1000/FULL)
 
root@bora:~#
</pre>
===Performance testPre-built binaries ===
To test the performances of the second Ethernet interface an Iperf test has been executed* For Bora SoM use:** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_bora_mmc_an006_boot.bin u-boot (SPL)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_bora_mmc_an006_u-boot.img u-boot (img)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_uImage uImage]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_bora-an006.dtb dtb]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_bora_ETH1_fpga.bit fpga]* For BoraLite SoM use:** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_bora_mmc_an006_boot.bin u-boot (SPL)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_bora_mmc_an006_u-boot.img u-boot (img)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_uImage uImage]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_bora-an006.dtb dtb]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_boralite_ETH1_fpga.bit fpga]* For BoraX SoM use:** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_borax_mmc_an006_boot.bin u-boot (SPL)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.1_borax_mmc_an006_u-boot.img u-boot (img)]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_uImage uImage]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_bora-an006.dtb dtb]** [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_borax_ETH1_fpga.bit fpga]
The ===Performance tests===To test the performances of the second Ethernet interface <code>iperf</code> based tests have been executed.====Test #1====In this test bed the two Ethernet interfaces are connected on the same host machine (a PC running linux) via a Gigabit switch but are associated on to two differnet different subnets:* ETH0 : 192.168.0.xxx* ETH1 : 192.168.12.xxx
On the Linux Host linux host machine run <code>iperf </code> application is run in server mode, with pretty the same performance:
<pre>
bash# iperf -s
</pre>
Here is are the results of the test on the two Ethernet interfaces launched sequentially:
<pre>
root@bora:~# iperf -c 192.168.0.210 && iperf -c 192.168.12.210
</pre>
Here is the Iperf test executed In case two <code>iperf</code> clients are run simultaneously on the two Ethernet interfaces. Here the bandwidth on target, each interface instance's bandwitdh is half the bandwidth because on the host side there is a single Ethernet interface with two different subnets associated.roughly halved:
<pre>
root@bora:~# iperf -c 192.168.0.210
[ 3] 0.0-10.0 sec 385 MBytes 323 Mbits/sec
root@bora:~#
</pre>
 
====Test #2====
ETH0 set up is the same used in previous test. ETH1 is point-to-point connected to a second linux host machine instead.
 
This configuration allows to achieve better performance on the single ETH1 <code>iperf</code> test (780-820 Mb/s):
<pre>
root@bora:~# iperf -c 192.168.12.208 -i 1 -t 6000
------------------------------------------------------------
Client connecting to 192.168.12.208, TCP port 5001
TCP window size: 43.8 KByte (default)
------------------------------------------------------------
[ 3] local 192.168.12.209 port 50715 connected with 192.168.12.208 port 5001
[ ID] Interval Transfer Bandwidth
....
[ 3] 368.0-369.0 sec 94.6 MBytes 794 Mbits/sec
[ 3] 369.0-370.0 sec 92.4 MBytes 775 Mbits/sec
[ 3] 370.0-371.0 sec 97.1 MBytes 815 Mbits/sec
[ 3] 371.0-372.0 sec 97.1 MBytes 815 Mbits/sec
[ 3] 372.0-373.0 sec 96.1 MBytes 806 Mbits/sec
[ 3] 373.0-374.0 sec 94.1 MBytes 790 Mbits/sec
[ 3] 374.0-375.0 sec 96.6 MBytes 811 Mbits/sec
[ 3] 375.0-376.0 sec 96.8 MBytes 812 Mbits/sec
[ 3] 376.0-377.0 sec 97.8 MBytes 820 Mbits/sec
[ 3] 377.0-378.0 sec 93.9 MBytes 787 Mbits/sec
[ 3] 378.0-379.0 sec 95.9 MBytes 804 Mbits/sec
[ 3] 379.0-380.0 sec 98.2 MBytes 824 Mbits/sec
[ 3] 380.0-381.0 sec 93.2 MBytes 782 Mbits/sec
[ 3] 381.0-382.0 sec 96.9 MBytes 813 Mbits/sec
[ 3] 382.0-383.0 sec 92.0 MBytes 772 Mbits/sec
</pre>
In case of simultaneous <code>iperf</code> instances on ETH0 and ETH1 ports, ETH1 bandwidth drops down to 330-350 Mb/s:
<pre>
[ 3] 383.0-384.0 sec 42.6 MBytes 358 Mbits/sec
[ 3] 384.0-385.0 sec 41.4 MBytes 347 Mbits/sec
[ 3] 385.0-386.0 sec 40.9 MBytes 343 Mbits/sec
[ 3] 386.0-387.0 sec 40.9 MBytes 343 Mbits/sec
[ 3] 387.0-388.0 sec 40.9 MBytes 343 Mbits/sec
[ 3] 388.0-389.0 sec 41.2 MBytes 346 Mbits/sec
[ 3] 389.0-390.0 sec 41.4 MBytes 347 Mbits/sec
[ 3] 390.0-391.0 sec 39.8 MBytes 333 Mbits/sec
[ 3] 391.0-392.0 sec 40.8 MBytes 342 Mbits/sec
[ 3] 392.0-393.0 sec 39.9 MBytes 334 Mbits/sec
[ 3] 393.0-394.0 sec 42.2 MBytes 354 Mbits/sec
</pre>
8,226
edits