Getting Started with iperf test
These sections will guide you through a series of steps from configuring development environment to running iperf examples using the WIZnet's ethernet products.
Development environment configuration
To test the iperf example, the development environment must be configured to use Raspberry Pi Pico, W5100S-EVB-Pico or W5500-EVB-Pico.
The this example were tested by configuring the development environment for Windows. Please refer to the '9.2. Building on MS Windows' section of 'Getting started with Raspberry Pi Pico' document below and configure accordingly.
Visual Studio Code was used during development and testing of this examples, the guide document in each directory was prepared also base on development with Visual Studio Code. Please refer to corresponding document.
Hardware requirements
The examples use Raspberry Pi Pico and WIZnet Ethernet HAT - ethernet I/O module built on WIZnet's W5100S ethernet chip, W5100S-EVB-Pico - ethernet I/O module built on RP2040 and WIZnet's W5100S ethernet chip or W5500-EVB-Pico - ethernet I/O module built on RP2040 and WIZnet's W5500 ethernet chip.
iperf testing
- Download
If the iperf examples are cloned, the library set as a submodule is an empty directory. Therefore, if you want to download the library set as a submodule together, clone the iperf examples with the following Git command.
/* Change directory */
// change to the directory to clone
cd [user path]
// e.g.
cd D:/RP2040
/* Clone */
git clone --recurse-submodules https://github.com/wiznet-mason/RP2040-HAT-IPERF-C
/* build */
cd RP2040-HAT-IPERF-C
mkdir build
cd build
cmake -G "NMake Makefiles" ..
nmake
With Visual Studio Code, the library set as a submodule is automatically downloaded, so it doesn't matter whether the library set as a submodule is an empty directory or not, so refer to it.
- Setup ethetnet chip
Setup the ethernet chip in 'CMakeLists.txt' in 'RP2040-HAT-IPERF-C/' directory according to the evaluation board to be used referring to the following.
- WIZnet Ethernet HAT : W5100S
- W5100S-EVB-Pico : W5100S
- W5500-EVB-Pico : W5500
For example, when using WIZnet Ethernet HAT or W5100S-EVB-Pico :
# Set ethernet chip
set(WIZNET_CHIP W5100S)When using W5500-EVB-Pico :
# Set ethernet chip
set(WIZNET_CHIP W5500)- Test
Please refer to 'README.md' in each example directory to find detail guide for testing iperf examples.