# USB 3.2 5Gbps Wired Base-T Ethernet Adapter

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2Fo08Wm5RZFkk04B9jHsS7%2F%E5%AE%A3%E4%BC%A0%E5%9B%BE_%E7%94%BB%E6%9D%BF%201-01.jpg?alt=media&#x26;token=d33da1bf-5213-46da-9310-06f7758369b9" alt=""><figcaption></figcaption></figure>

## Features

* Chip: Realtek RTL8157. All support 10/100/1000/2500/5000 Mbps links and consumes under 1.5 watts, against 0.7W for 2.5 GbE networking.
* Hyper Fast 5Gbps Networking– provides stable connection to save you from weak network trouble.
* Easily portable, ideal for working, traveling and business – WP-UT5 is so compact and lightweight that makes it perfect for working, traveling and business.\
  Wide compatibility for USB 3.2 port – Compatible with Windows, Mac OSX, and Linux. Conveniently upgrade your NAS, laptop or desktop to hyper fast 5G transfer speed
* No more smudge or corrosion – The stylish aluminum case provide premium protection of corrosion, and no more worry about tearing or fraying from everyday use with the high quality nylon-braided cable.
* Split cable design, provides A-C and C-C cable backup, compatible with all USB 3.2 Gen2 data ports

## Hardware

* Supports USB 3.2 Gen1/2 and USB2.0
* Supports 5G Lite (2.5G data rate) mode, 2.5G Lite (1G data rate) and GlGA Lite (500M data rate) mode
* Auto-Negotiation with Extended Next Page capability (XNP)
* Compatible with NBASE-T TM Alliance PHY Specification
* Supports pair swap/polarity/skew correction
* Crossover Detection & Auto-Correction
* Supports CDC-ECM & CDC-NCM
* Supports hardware CRC (Cyclic Redundancy Check) function
* Supports ECMA-393 ProxZzzy Standard for sleeping hosts

## IEEEE

* Compatible with IEEE 802.3, IEEE 802.3u, IEEE802.3ab
* Supports lEEE 802.1P Layer 2 Priority Encoding
* Supports IEEE 802.1Q VLAN tagging
* Supports lEEE 802.3az (Energy Efficient Ethernet)
* Supports IEEE 802.3bz (5G Base-T)
* Supports Full Duplex flow control (802.3x)

## Software Offload:

* Microsoft NDIS5, NDIS6 Checksum Offload (IPv4, IPv6, TCP, UDP) and Segmentation Task
* offload (Large send v1 and Large send v2)support
* Supports jumbo frame to 16k bytes
* Supports Protocol Offload (ARP & NS)
* Microsoft AOAC (Always On Always Connected)/Modern Standby
* Supports 32-set 128-byte Wake-Up Frame pattemn exact matching
* Supports link change wake up

## Supports Microsoft WPD (Wake Packet Detection)

* Intel CPPM (Converged Platform Power Management)
* Supports L1 with 3ms BESL (USB 2.0)
* Dynamic LTM messaging (USB 3.2Gen1/2)
* Supports U1/U2/U3 (USB 3.2 Gen1/2)
* Supports selective suspendo

## Temp

* Ambient Operating Temperature TA: 70°C
* Storage Temperature:-55\~+125°C

## System Supported

* [Windows](#windows-11)
* [Linux](#linux-kernel-up-to-5.17)
* Mac OS 10.7 or later
* [Synology DSM](#synology-dsm-support)
* [Proxmox VE (PVE)](#articlecontentid)

## Package Contents

* 1 x USB 3.2 5G Base-T Ethernet Adapter <br>
* 1 x 15cm USB 3.2 C-C
* 1 x 15cm USB 3.2 A-C
* 1 x User Manual

## Driver Download

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

### Windows 11：&#x20;

{% file src="<https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FtymOqEGdtaPYijPNoqVI%2FInstall_USB_Win11_11015_20_05132024_08202024.zip?alt=media&token=23b6050a-16c3-43e8-8d6a-16c5cd0f6b72>" %}

### Linux (kernel up to 5.17):

{% file src="<https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FrEMzuRTApZVyFk4f4Q5a%2Fr8152-2.18.1.tar.bz2?alt=media&token=41afa4d8-f50f-47da-88fb-f0d2aedf7b11>" %}

## Synology DSM support

{% hint style="info" %}
Tutorials are from a third party github(<https://github.com/bb-qq/r8152>), wisdpi does not make any guarantees
{% endhint %}

### 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?](https://kb.synology.com/en-us/DSM/tutorial/What_kind_of_CPU_does_my_NAS_have)

### How to install ?

#### Preparation

1. Download drive package form <https://github.com/bb-qq/r8152/releases>
2. [Enable SSH](https://www.synology.com/en-us/knowledgebase/DSM/tutorial/General_Setup/How_to_login_to_DSM_with_root_permission_via_SSH_Telnet) 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:&#x20;

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

5. \[DSM7] Retry installation. You don't need the above DSM7-specific steps at the next time.&#x20;
6. Reboot your NAS. This procedure is not usually necessary, but many have reported that a reboot was necessary, so please reboot just in case.&#x20;
7. Open the driver package from the Package Center and start the driver manually.

{% hint style="info" %}
*Warning*: Do not use Safari for this operation.
{% endhint %}

#### 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.

{% hint style="info" %}
Option: Recommend setting MTU to 9000 and SMB protocol version to v3 for better performance.
{% endhint %}

## Ubuntu support  <a href="#articlecontentid" id="articlecontentid"></a>

{% hint style="info" %}
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.
  {% endhint %}

### 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`

2. Clone the code

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

3. Change to the directory

`cd wp-ut5_linux/`

4. Build

```
sudo depmod -a
sudo make all
```

5. Config system

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

6. Reboot:

`sudo reboot`

7. You can check whether the driver is loaded by using following commands.

```
lsmod | grep r8152
ifconfig -a2
```

## Proxmox VE (PVE) support <a href="#articlecontentid" id="articlecontentid"></a>

{% hint style="info" %}
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.
{% endhint %}

### Supported platform

| Release | Status     | Result    |
| ------- | ---------- | --------- |
| 7.x     | Not tested |           |
| 8.0     | Tested     | Supported |
| 8.2     | Not tested |           |
|         |            |           |

### PVE 9.0

### PVE 8.0

### How to install ?

#### Add APT repsitories no-subscription (Web-UI or shell)

Web-UI:

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

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FV2rsRssAQF7hwuSbbjr7%2Fimage.png?alt=media&#x26;token=d8d7f6f5-481f-4e97-84e4-e53f57b0bbcd" alt=""><figcaption></figcaption></figure>

You will get this result.

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FQY89y2vHAYZeFf57Pwud%2Fimage.png?alt=media&#x26;token=5af0ab4f-c5e6-47a0-a175-5e46c6a62d26" alt=""><figcaption></figcaption></figure>

shell:

edit sources.list

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

Add this repositories&#x20;

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

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FttND75A7nY4CkVTklBSC%2Fimage.png?alt=media&#x26;token=c8706b76-3269-4ff8-899c-8fde15c8baa9" alt=""><figcaption></figcaption></figure>

#### Clone the driver files.

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

#### Check the kernel version

<pre><code><strong>// Check kernel version
</strong>pveversion -v | grep proxmox-ve
</code></pre>

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FLooRbP10Hl4PPHx6VBmn%2Fimage.png?alt=media&#x26;token=be78f881-ee1b-46f4-af92-2c81a5165bd4" alt=""><figcaption></figcaption></figure>

#### Install kernel headers file

<pre><code><strong>// install the kernel headers file
</strong>apt install pve-headers-6.2.16-3-pve
</code></pre>

#### Build and install the driver

```
depmod -a && make all
```

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FzVxXFnt9o58koPaADAEa%2Fimage.png?alt=media&#x26;token=89d597b7-e088-444a-9086-7c77654dc102" alt=""><figcaption></figcaption></figure>

#### # config system

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

#### Reboot PVE

```
// reboot pve system
reboot
```

#### Check the driver

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

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FhhNlJlCbO2XxlUUa9OnG%2Fimage.png?alt=media&#x26;token=b5b38f06-d0f9-4083-beb3-38f51360ba91" alt=""><figcaption></figcaption></figure>

#### Che the the ethernet name

```
// check the wp-ut5 name
ifconfig -a
```

<figure><img src="https://389921961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjPowryxiQvRDiYHC9qWy%2Fuploads%2FQWqK3nN7okgjqjeCk1ZO%2Fimage.png?alt=media&#x26;token=de0a6617-6497-4416-96b8-6c39d724e263" alt=""><figcaption></figcaption></figure>