ZP591 PCIe to 2.5G Ethernet Network Port HAT Expansion Board

Overview

Introduction

This expansion board adds one 2.5G network port for Raspberry Pi 5, which can meet your various needs for those who need to use Raspberry Pi 5 as a Router, Gateway, Firewall, Robot, Smart Home, NAS, VOIP, Industrial Equipment, Telecommunications Equipment and other network devices that need more than one network port.

Features

• Through the PCIe interface with PCIe Switch chip to expand into two PCIe interfaces and then through the RTL8125 chip to achieve the expansion of 2.5Gbps Ethernet.

• After power on, the board can be automatically recognised as eth1 without installing driver under Raspberry Pi official OS system. When you use OpenWrt, you need to compile the RTL8125 driver into the firmware. When you use ubuntu system, you need to install the RTL8125 driver and then you can use it.

• PCIe to 2.5G Ethernet Port HAT expansion board, able to achieve high-speed reading/writing.

• Specially designed for Raspberry Pi 5, compatible with Raspberry Pi 5 2GB/4GB/8GB/16GB pc computer (NOT include Raspberry Pi 5).

Installation Guide

Installation of PCIe FPC Cable

Pay attention to the direction of the cable and connect it as shown in the figure:

Installation of adapter board

How to Use Ethernet Ports

Raspberry Pi OS

Open Terminal and use the following command:

ifconfig -a

If eth1 appears, it means that our ZP591 hardware is connected successfully and the network device eth1 appears. Otherwise, check whether the FPC cable is installed normally.

At this time, we can connect network cable to this network port, and then it can communicate normally.

Ubuntu

Use ifconfig -a command to see that there is no eth1.

ifconfig -a

Use the following command to install:

sudo apt-get update

sudo apt install net-tools

sudo apt-get install --reinstall linux-headers-$(uname -r) linux-headers-generic build-essential dkms -y

sudo apt-get install r8125-dkms

sudo modprobe r8125

ifconfig -a

Use ifconfig -a command to see that there is an extra network device as shown below:

OpenWrt

OpenWRT is a highly modular and automated embedded Linux system with powerful networking components and extensibility, commonly used in industrial control devices, telephones, robots, smart homes, routers, gateways, firewalls, NAS and VOIP devices. The OpenWrt SDK is a great convenience for software developers who benefit from it, simplifying the work of developing software.

The following introduces the process of compiling the RTL8125 driver to OpenWrt, please customise it yourself if you have other needs.

1. Install required tools for compilation

Install required tools on the operating system of Ubuntu, Debian, Raspberry Pi OS; for most Linux-based systems, the following commands can be used:

sudo apt-get update

sudo apt-get install build-essential libncurses5-dev zlib1g-dev gawk git wget

2. Clone OpenWrt source code

git clone https://git.openwrt.org/openwrt/openwrt.git

3. Use the following command configuration to operate the system

cd openwrt

./scripts/feeds update -a

./scripts/feeds install -a

make menuconfig

Select the configuration corresponding to Raspberry Pi 5, select System Boardcom BCM27xx for Target, BCM2712 for subtarget and Raspberry Pi 5/500/CM5 for Target Profile.