You are currently viewing Troubleshooting ZBT Z8102AX Router

Troubleshooting ZBT Z8102AX Router

Fixing the ZBT Z8102AX router problems is not that difficult. A good router for little money! And this is how the router runs!

⚠️ ZBT Z8102AX – The serious issues and OpenWrt installation notes

The ZBT Z8102AX is a powerful WiFi 6 router based on the MediaTek MT7981B (Filogic 820) chipset. However, there are some serious issues that you absolutely need to know before installing OpenWrt.

📊 ZBT Z8102AX performance overview

ComponentDetails
Processor (CPU)MediaTek MT7981B, ARM Cortex-A53 Dual-Core, 1.3 GHz
Memory (RAM)1 GB DDR4
Flash storage (variable)V1: SPI-NAND 128 MBV2: eMMC 8 GB (optional)Additional: NOR Flash 16 MB (optional)
WiFi chipsetMediaTek MT7976CN
WiFi standardWi-Fi 6 (IEEE 802.11ax)
WiFi speed (2.4 GHz)Up to 600 Mbps
WiFi speed (5 GHz)Up to 2400 Mbps
Total WiFi bandwidth3000 Mbps (2.4 GHz + 5 GHz)
LAN ports4× Gigabit (10/100/1000 Mbps)
WAN port1× Gigabit (10/100/1000 Mbps)
Antennas8 external antennas
LTE/5G2× M.2 slots for 5G modems2× SIM card slots
USB1× USB 3.0 port
Power supplyV1: DC 12V 1AV2: DC 12V 2.5A
Special featuresVPN, QoS, Firewall

☝️ Disclaimer – please note!

The processes described here are not standard solutions. They are alternative ways of extending, updating or changing something.

I accept no liability for damage of any kind! Furthermore, this procedure does not necessarily have to work for you – there are simply too many factors that can influence the result.


Video: Troubleshooting ZBT Z8102AX Router

Language: 🇩🇪|🇬🇧
☝️ Use YouTube subtitles for all languages.

🔥 The two hardware versions – The biggest trap!

The main problem: there are two incompatible hardware revisions that look identical from the outside but require different OpenWrt images.

FeatureV1 (SPI-NAND)V2 (eMMC)
Storage mediumSPI-NAND Flash (128 MiB)eMMC (8 GB)
BootloaderStandard U-BootCustom bootloader with web recovery interface
OpenWrt status✅ Officially supported⚠️ Newly added (since OpenWrt 24.10.3/25.xx)
Power supply12V / 1A12V / 2.5A
IdentificationNo web recovery during bootWeb recovery available at 192.168.1.1

The consequence

If you flash the wrong image, the router will no longer boot – you will end up in a boot loop. In the worst case, recovery is only possible through a serial console (UART).

🔌 The power supply – An underestimated problem

The power supply is a critical point:

  • According to the specifications, the V1 requires a 12V / 1A power supply
  • -> Recommended: 12V / 1.5A power supply
  • The V2 (with eMMC and a more powerful modem) requires 12V / 2.5A
  • -> Recommended: 12V / 3A

Using an undersized power supply can cause:

  • Voltage drops
  • Unexplained reboots
  • Connection drops
  • Instability under load

🌡️ Heat generation – Passive cooling has limits

  • Under high load (WiFi 6, 5G modem, CPU), the device can become very hot.
  • Without sufficient ventilation or when exposed to direct sunlight, thermal throttling and long-term damage may occur.
  • There is no active fan – cooling is completely passive.

📦 OpenWrt – The correct image for the MediaTek MT7981B

Since the ZBT Z8102AX is based on the MediaTek MT7981B (Filogic 820), you must choose the correct image for your hardware version.

🔍 How to determine your hardware version

MethodProcedureResult
Reset buttonHold the reset button while powering on the router.If you can access 192.168.1.1 in the browser → V2 (eMMC)
UART consoleConnect through a serial console (USB-UART adapter) and observe the boot process.Bootloader shows SPI-NAND → V1; shows eMMC → V2
Open the caseOpen the enclosure and read the flash chip label.SPI-NAND chip → V1; eMMC chip → V2

📥 The correct OpenWrt images

For V1 (SPI-NAND) – Official support – Official Support

  • Status: Fully integrated into OpenWrt (since commit d9246902b047254ae5006215ccafbc9ccc87f5fd).
  • Image name: zbtlink_zbt-z8102ax-… (pay attention to the SPI-NAND designation).
  • Source: Download from the official OpenWrt download page for the ZBT Z8102AX.

For V2 (eMMC) – New support

  • Status: Officially included since OpenWrt 24.10.3 and current snapshots (pull request has been merged).
  • Image Name: Includes the eMMC identifier (e.g., …-emmc-…).
  • Source: Use the OpenWrt snapshot or a current version starting with 24.10.3—DO NOT use the stable 22.03 or 23.05 versions for V2!

⚠️ Important: Never use the image for the wrong version! A V1 image on V2 hardware (or vice versa) will result in a boot loop.

🔧 Additional pitfalls during OpenWrt installation

1. SIM detection (5G version only)

  • On V2 hardware, SIM detection problems may occur after installing OpenWrt.
  • Reason: Incorrect GPIO pins configured for SIM selection.
  • Solution: The GPIOs must be configured correctly in the Device Tree Source (DTS). This has been fixed in newer OpenWrt versions.

2. High CPU load after installation

  • Some forums report unusually high CPU usage.
  • Cause: Often an unused WAN interface continuously trying to establish a connection.
  • Solution: Disable unused interfaces in LuCI or via uci:
uci set network.wan.auto='0'
uci set network.wan6.auto='0'
uci commit network
/etc/init.d/network restart

3. Bootloader access

  • V2 has a web recovery interface, making flashing easier.
  • V1 requires a USB serial adapter (UART) for emergency recovery because it has no web recovery.

💡 Recommendations for a stable installation

StepRecommendation
Check hardwareDetermine whether you have V1 or V2 first – this is mandatory!
Check power supplyUse a 12V / 2.5A power supply for V2 – 12V / 1A is sufficient for V1.
CoolingEnsure the router has adequate ventilation (not inside closed cabinets).
OpenWrt versionFor V2: use an OpenWrt snapshot or 24.10.3+ – older versions will not boot!
BackupBack up the original firmware before flashing (if possible).

🔥 Summary of the critical points

ProblemDetailsSolution
Two hardware versionsV1 (SPI-NAND) vs. V2 (eMMC) – incompatible imagesDetermine hardware version before flashing
Wrong imageCauses a boot loopUse only the correct image for V1 or V2
Power supplyV2 requires 12V / 2.5A, V1 only 12V / 1AUse an adequately rated power supply
HeatPassive cooling may be overwhelmed under heavy loadEnsure good ventilation
SIM detectionGPIO configuration can cause issuesUse the latest OpenWrt version (24.10.3+)
CPU loadUnused interfaces may consume CPU resourcesDisable unused WAN interfaces


Donate Bild

Support / Donation Link for the Channel
If my posts have been helpful or supported you in any way, I’d truly appreciate your support 🙏

PayPal Link
Bank transfer, Bitcoin and Lightning


#OpenWrt #Z8102AX #MediaTek #WiFi6 #Router #ZBT

Leave a Reply