Skip to content

+49 1626571232

info@openelab.io

🚀 Free Shipping from 50€ in EU / 80€ Worldwide

Which platform is supported by the WisdPi 5Gbps Wired Base-T Ethernet Adapter?

22 Nov 2024 0 Comments

As the demand for networking solutions continues to grow, the WisdPi 5Gbps USB 3.2 Wired Base-T Ethernet Adapter, which utilizes the Realtek RTL8157 chip, has emerged as an optimal choice for users seeking to enhance their networking capabilities. This device is distinguished by its high performance and extensive compatibility. The purpose of this article is to provide an overview of the platforms supported by this Network Interface Controller (NIC), thereby elucidating its range of applications. 

WisdPi 5Gbps USB3.2 Wired Base-T Ethernet Adapter

WisdPi 5Gbps USB3.2 Wired Base-T Ethernet Adapter

View Product

Driver Download

Realtek RTL8157 official link: https://www.realtek.com/Download/List?cate_id=585

 

System Requirements

  • Windows

  • Linux

  • MacOS 10.7 or later

  • Synology DSM / QNAP QTS*

  • Proxmox VE (PVE)*

 

Support Windows 11

  • Compatible Version: Windows 10、Windows 11、Windows 7

Attention: After testing, the drivers provided by Realtek for Windows 7 & 10 are not stable, and we do not recommend using them. Windows only recommends Windows 11.

Download

 

Support Linux (kernel up to 5.17):

  • Compatible distributions: Ubuntu, Fedora, Debian, Arch Linux, etc.

  • Features: The kernel comes with driver support, which can be further configured by technical users through community resources to ensure broad compatibility.

Download

 

Synology DSM support

Reference Article: https://github.com/bb-qq/r8152

 

supported platform

  • Synology DSM 7.x and 6.2

  • Architecture:

    • Alpine

    • Alpine4k

    • Apollolake

    • Armada37xx

    • Armada38x

    • Avoton

    • Braswell

    • Broadwell

    • Broadwellnk

    • Bromolow

    • Cedarview

    • Denverton

    • Epyc7002

    • Geminilake

    • Monaco

    • R1000

    • RTD1296

    • V1000

  • What kind of CPU does my Synology NAS have?

 

How to install it?

Preparation

  1. Download drive package form https://github.com/bb-qq/r8152/releases

  2. Enable SSH and login to your NAS.

Installation

  1. Go to "Package Center"

  2. Press "Manual Install"

  3. Choose a driver package downloaded

  4. [DSM7] The installation will fail the first time. After that, run the following command from the SSH terminal:

// Some code
sudo install -m 4755 -o root -D /var/packages/r8152/target/r8152/spk_su /opt/sbin/spk_su

✔ Copied!

 

  1. [DSM7] Retry installation. You don't need the above DSM7-specific steps next time.

  2. Reboot your NAS. This procedure is not usually necessary, but many have reported that a reboot was necessary, so please reboot just in case.

  3. Open the driver package from the Package Center and start the driver manually.

Warning: Do not use Safari for this operation.

  

How to configure

You can configure the IP addresses and MTU of the added NICs from the DSM UI in the same way as the built-in NICs.

Option: Recommend setting MTU to 9000 and SMB protocol version to v3 for better performance.

 

Ubuntu support

Note:

  • The driver is a clone of Realtek linux driver r8152-2.18.1.

  • We have tested the driver on Ubuntu 24.04.1.

  • In theory, it supports all Linux distribution versions after kernel version 4.10. If it works correctly on other versions during testing, please let me know, and we will add them to the compatibility list.

 

Compatibility(Tested)

  • Ubuntu 24.04

 

Requirements

  • Ubuntu 24.04.01

  • Kernel: WP-UT5

 

Quick install

  1. Prepare

sudo apt update -y && sudo apt install git gcc make -y

✔ Copied!
  1. Clone the code

git clone https://github.com/wisdpi/wp-ut5_linux.git

✔ Copied!
  1. Change to the directory

cd wp-ut5_linux/

✔ Copied!
  1. Build

sudo depmod -a
sudo make all

✔ Copied!
  1. Config system

sudo update-initramfs -u
sudo cp 50-wput5.rules /etc/udev/rules.d/

✔ Copied!
  1. Reboot:

sudo reboot

✔ Copied!
  1. You can check whether the driver is loaded by using following commands.

lsmod | grep r8152
ifconfig -a2

✔ Copied!

  

Proxmox VE (PVE) support

With reference to the example of PVE 8.0.3, the operating procedures should be similar for other versions such as PVE 6.x, 7.x, and 8.x. If you encounter any issues during use, please contact us, and we will conduct relevant tests.

Proxmox Virtual Environment (PVE) is based on Debian, and the tutorial for it is very similar to the previous one for Ubuntu.

 

Supported platform

Release Status Result
7.x Not tested
8 Tested Supported
8.2 Not tested
 

How to install it?

Add APT repositories no-subscription (Web-UI or shell)

Web-UI:

Click the PVE node -> Updates -> Repositories -> No-Subscription -> Add

You will get this result

 

shell:

edit sources.list

// edit sources.list
nano /etc/apt/sources.list

✔ Copied!

 

Add this repositories

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription


✔ Copied!

 

Clone the driver files

// download the driver
git clone https://github.com/wisdpi/wp-ut5_linux.git


✔ Copied!

 

Check the kernel version

// Check kernel version
pveversion -v | grep proxmox-ve


✔ Copied!

 

   
Install kernel headers file
// install the kernel headers file
apt install pve-headers-6.2.16-3-pve


✔ Copied!

 

Build and install the driver

depmod -a && make all


✔ Copied!

 

config system
update-initramfs -u
cp 50-wput5.rules /etc/udev/rules.d/


✔ Copied!

 

Reboot PVE
// reboot pve system
reboot

✔ Copied!

 
Check the driver
// check the driver
lsmod | grep 8152

✔ Copied!

 

 

Check the ethernet name 

// check the wp-ut5 name
ifconfig -a

✔ Copied!

 

 

Prev Post
Next Post

Leave a comment

All blog comments are checked prior to publishing

Someone recently bought a

Thanks for subscribing!

This email has been registered!

Shop the look

Choose Options

Edit Option
Back In Stock Notification
this is just a warning
Login
Shopping Cart
0 items
RuffRuff App RuffRuff App by Tsun