Setting up a USB Wi-Fi adapter on Enigma2-based set-top boxes, such as the VU+ Solo / Vu+Duo2 / Vu+Solo2 running OpenPLi 8.3, can be surprisingly complex. Many users encounter persistent problems, especially when using Realtek-based adapters like the RTL8188EU. This article outlines a real-world troubleshooting process, explores the challenges that may occur, and provides step-by-step solutions for getting your Wi-Fi working smoothly.
Common Problem: Wi-Fi Disconnects or Not Detected
Many users using VU+ Solo with OpenPLi 8.x (from 8.0, 8.1, 8.2, 8.3) report that their USB Wi-Fi adapters either don’t connect reliably or aren’t detected at all. The issue typically manifests as follows:
- The Wi-Fi interface appears and disappears
- The connection drops when using a mobile hotspot
- No WLAN interface is visible
- „dmesg | grep wlan” shows no output
In our case, the USB Wi-Fi adapter based on the Realtek RTL8188EU chipset failed to maintain a stable connection when paired with a mobile phone acting as a hotspot.
Despite trying multiple adapters and even updating OpenPLi to the latest version (8.3), the issue persisted. In each scenario, the system either failed to detect the adapter or dropped the connection intermittently.
Step-by-Step Debugging Process VU+ SoloSE / Vu+Duo2 / Vu+Solo2 with OpenPLi
1. Verify USB Detection (Eingma, OpenPLi)
First, we confirmed that the system recognizes the USB device:
lsusb
Output:
Bus 002 Device 002: ID 0bda:818b Realtek Semiconductor Corp. RTL8188EUS
This confirmed that the adapter was physically recognized. However, the driver was either missing or not properly installed.
2. Check Network Interfaces
ifconfig -a
Initially, no wlan0
interface appeared, indicating the driver wasn’t loaded.
3. Look for Kernel Messages
dmesg | grep wlan
If nothing appears, the kernel has not attempted to load a driver for the Wi-Fi adapter.
4. Attempt to Install Driver via opkg
OpenPLi uses the opkg
package manager. The obvious first step was:
opkg update
opkg install rtl8188eu
However, this returned the error:
* opkg_prepare_url_for_install: Couldn't find anything to satisfy 'rtl8188eu'
This means the required driver is not available in the OpenPLi 8.3 feed for our hardware/kernel combination.
Manual Installation of the rtl8188eu Driver VU+ SoloSE / Vu+Duo2 / Vu+Solo2 with OpenPLi
Given that opkg
could not locate the driver in the repository, we chose to manually install a compatible .ipk
package.
1. Download the IPK Package
We did a compatible file named rtl8188eu_git-r2-bh4_ from bh3:
Download driver for OpenPli Vu+ SoloSE
Download driver for OpenPli Vu+ Zero
Download driver for OpenPli Vu+ Solo
Download driver for OpenPli Vu+ Solo2
Download driver for OpenPli Vu+ Duo
Download driver for OpenPli Vu+ Ultimo
Download driver for OpenPli Vu+ Uno
rtl8188eu_git-r2-bh4_vusolose.ipk
This file was placed onto a FAT32-formatted USB stick and inserted into the VU+ Solo.
2. Install Using opkg
opkg install /media/usb/rtl8188eu_git-r2-bh3_vusolose.ipk
3. Encountered Dependency Issue
Installation failed with:
nothing provides update-modules needed by kernel-module-r8188eu
This indicates a missing dependency: update-modules
, which is not included in OpenPLi 8.x (OpenPli 8.1, OpenPli 8.2, OpenPli 8.3).
Modifying the .ipk File to Remove Dependency Openpli
To work around this, we modified the .ipk
file to remove the dependency:
- Extract the IPK (it’s an ar archive):
ar x rtl8188eu_git-r2-bh3_vusolose.ipk
- Unpack the control archive:
tar -xzf control.tar.gz
- Edit
control
file to remove the line:
Depends: update-modules
- Repack the archive:
tar -czf control.tar.gz control postinst postrm
ar r rtl8188eu_fixed.ipk debian-binary control.tar.gz data.tar.gz
- Attempt to install the modified file:
opkg install /media/usb/rtl8188eu_fixed.ipk
This too resulted in:
Refusing to load file as it matches the installed version.
Final Fix: Change Version to Trick opkg (Vu+ Zero / VU+ SoloSE / Vu+Duo2 / Vu+Solo2 with OpenPLi)
To bypass opkg
’s version check, we edited the control
file again and changed:
Version: git-r2-bh3
to
Version: git-r2-bh4
After rebuilding the package:
opkg install /media/usb/rtl8188eu_bh4.ipk
The driver installed successfully, but showed a warning:
update-modules: command not found
This was harmless. We simply ran:
depmod -a
modprobe 8188eu
Finally, wlan0
appeared in ifconfig
.
If you haven’t already restarted the decoder after installation:
reboot
Connecting to Wi-Fi (VU+ SoloSE / Vu+Duo2 / Vu+Solo2 with OpenPLi)
Once wlan0
was available, we proceeded to the GUI:
Menu → Setup → System → Network → Adapter Settings
From there, we selected wlan0
, scanned for networks, entered the Wi-Fi password, and connected successfully.
Extra Tips for Mobile Hotspot Users
If you’re using a mobile hotspot (like Wi-Fi from a phone), note these tips:
- Ensure your phone uses 2.4 GHz only (not 5 GHz)
- Disable battery-saving features
- Set the SSID broadcast to always visible
- Use a fixed channel (e.g., channel 6 or 11)
These settings help maintain a stable connection.
Conclusion (VU+ Zero, VU+ SoloSE / VU+ Duo2 / VU+ Solo2 / VU+ Solo / VU+ Ultimo with OpenPLi)
Installing and configuring a Realtek RTL8188EU-based Wi-Fi adapter on a VU+ Solo with OpenPLi 8.x is not straightforward due to missing drivers and dependencies in the official feed. However, with a bit of manual work — extracting, modifying, and rebuilding the .ipk
package — it is absolutely possible to get the adapter working.
If you face similar issues, this guide should help you work through the most common obstacles. As an alternative, switching to a system like OpenATV is also a viable option, as it includes broader Wi-Fi support by default.
Package OpenPli 8.1, OpenPli 8.2, OpenPli 8.3