Demo

Example 1: Network Throughput Measurement

This design example will use iperf as example network measurement tool. Iperf is a tool to measure maximum TCP bandwidth, allowing the tuning of various parameters and UDP characteristics. More information about iperf can get from iperf.

Iperf has a server and client functionality and can measure the throughput between the two ends. It allows the user to set various parameters that can be used for testing or optimizing a network. Iperf application is included in the root filesystem in SD card.

Installing Iperf On Host Machine

The following steps are for CentOS 6 and it assumes user have root access or sudo privileges to execute the commands below:

Download and install iperf tool:

$ yum install iperf

Using Iperf

Start the server before any clients connect to it. Execute ‘iperf --help’ for the complete list of the arguments.

On the server side:

$ iperf -s

On the client side:

$ iperf -c <server-ip>

Example output from iperf client:

root@socfpga:~# iperf -c 137.57.103.66

------------------------------------------------------------
Client connecting to 137.57.103.66, TCP port 5001
TCP window size: 43.8 KByte (default)
------------------------------------------------------------
local 137.57.162.93 port 58852 connected with 137.57.103.66 port 5001
Interval          Transfer         Bandwidth
0.0-10.0 sec     112 MBytes      94.3 Mbits/sec

Example 2: Mounting NFS Filesystem

Network File System (NFS) allows user on a client computer to access files over a network much like local storage is accessed. In this design example, we will use Cyclone V SoC devkit as NFS client and host machine as NFS server.

NFS Server Configuration

The following steps are for CentOS 6 and it assumes user have root access or sudo privileges to execute the commands below:

Download and install NFS utilities:

$ yum install nfs-utils nfs-utils-lib

Start NFS server:

$ chkconfig nfs on
$ service rpcbind start
$ service nfs start

Edit and add the following line to /etc/exports file to export a NFS:

$ /<directory-to-export> <host1>(<options>) <hostN)(<options>)

Example:
$ /home/nfs 192.168.0.0/255.255.255.0(rw,sync,no_root_squash)

Run exportfs after update /etc/exports.

$ exportfs -a

NFS Client Configuration:

The mount command mounts NFS on the client side:

$ mount -t nfs -o options host:/remote/export /local/directory

Example:
mkdir -p /nfs
mount -t nfs 192.168.0.60:/home/nfs /nfs

Configure Ethernet MAC Address

By default the kernel will starts up with a random and dynamic MAC address each time user reboot the dev kit. This section illustrates how to set a fixed MAC address for the kernel in U-boot stage.

U-boot has a parameter containing the Ethernet MAC address. The parameters are ethaddr (eth0 in Linux), eth1addr (eth1 in Linux) and eth2addr (eth2 in Linux).

Enter the following command in U-boot command prompt. "XX:XX:XX:XX:XX:XX" is MAC address and each MAC address must be unique.

$ setenv eth1addr XX:XX:XX:XX:XX:XX
$ setenv eth2addr XX:XX:XX:XX:XX:XX
$ saveenv