OpenWrt 25.12.2 - Service Release

Fri Mar 27 06:51:51 PDT 2026

Hi,

The OpenWrt community is proud to announce the second service release of 
the OpenWrt 25.12 stable series.

Download firmware images using the OpenWrt Firmware Selector:
   * https://firmware-selector.openwrt.org/?version=25.12.2

Download firmware images directly from our download servers:
   * https://downloads.openwrt.org/releases/25.12.2/targets/

Main changes between OpenWrt 25.12.1 and OpenWrt 25.12.2
=========================================================

Only the main changes are listed below. See the [full 
changelog](https://openwrt.org/releases/25.12/changelog-25.12.2) for 
details.

Device support
==============

   * airoha: rename kernel module `kmod-pwm-an7581` to `kmod-pwm-airoha` 
— users with this module explicitly installed need to reinstall under 
the new name
   * apm821xx: fix U-Boot environment definitions for NETGEAR WNDR4700, 
Western Digital MyBookLive, Meraki MR24 and Meraki MX60; fix PCIe boot 
failure on Meraki MX60
   * ath79: fix initramfs boot for Huawei AP5030DN and AP6010DN
   * ath79: fix VLAN CPU port tagging on 2-CPU-port devices (affects 
several dual-CPU switch configurations)
   * ath79: remove incorrectly included WiFi packages from Mikrotik 
RB750r2 (device has no WiFi hardware)
   * ipq40xx: fix ART partition name for Linksys Velop WHW03 V1 — 
restores correct WiFi calibration data access
   * ipq40xx: fix MAC address reading for Linksys devices using 
eMMC-based NVMEM
   * lantiq: xrx200: fix failsafe mode on BT HomeHub 5A — LAN ports 1 & 
2 now work correctly in failsafe 
(https://github.com/openwrt/openwrt/issues/22480)
   * mediatek: Bananapi BPI-R4: fix SFP+ electric module support — 
modules that stopped working after a snapshot upgrade are now functional 
again (https://github.com/openwrt/openwrt/issues/19878)
   * ramips: fix kernel decompress error that bricked ELECOM WRC-X1800GS 
on 25.12.0 (https://github.com/openwrt/openwrt/issues/22270)
   * ramips: fix initramfs kernel load address for TP-Link EAP615-Wall v1
   * ramips: fix MAC address assignment for Xiaomi Mi AC2100
   * realtek: fix D-Link fan control script

WiFi fixes and improvements
============================

   * wifi-scripts: fix 160 MHz channel width configuration — hostapd was 
not correctly configured for 160 MHz, preventing its use 
(https://github.com/openwrt/openwrt/issues/22481)
   * wifi-scripts: fix SU beamformee antenna count — incorrect count was 
passed to the driver
   * hostapd: fix memory leak in Radio Resource Management (RRM) ubus 
interface
   * mac80211: ath12k: add thermal sensor support for QCA/IPQ devices
   * mac80211: ath9k: fix GPIO mask handling from device tree
   * mt76: fix severe WiFi latency regression (up to multiple seconds) 
on 2.4 GHz introduced in 25.12.1 — affected many MediaTek devices 
including OpenWrt One, Zyxel EX5601, ASUS RT-AX53U, Xiaomi 
AX3000T/AX6000, Cudy WR3000/X6, GL Flint 2 and others 
(https://github.com/openwrt/openwrt/issues/22491)
   * mt76: multiple further stability fixes for MediaTek WiFi chipsets 
(MT7615/MT7915/MT7996/MT7992/MT792x):
     * add per-link beacon monitoring for MLO (Multi-Link Operation)
     * fix MT7996/MT7992 link handling during MLO station add/remove
     * fix scan work requeue race with spinlock

Upgrading to 25.12.2
=====================

Upgrading from 24.10 to 25.12 should be transparent on most devices, as 
most configuration data has either remained the same or will be 
translated correctly on first boot by the package init scripts.
For upgrades within the OpenWrt 25.12 stable series, [Attended 
Sysupgrade](https://openwrt.org/docs/guide-user/installation/attended.sysupgrade) 
is also supported, which allows preserving the installed packages.

  * Sysupgrade from 23.05 or earlier to 25.12 is not officially supported.

  * Cron log level was fixed in busybox. 
`system. at system[0].cronloglevel` should be set to `7` for normal 
logging. `7` is the default now. If this option is not set, the default 
is used and no manual action is needed. 
https://github.com/openwrt/openwrt/commit/fc0c518a88e68d3deef04bec73b33d35186d6546

  * Bananapi BPI-R4: Interface `eth1` was renamed to `sfp-lan` or 
`lan4`, and interface `eth2` was renamed to `sfp-wan` to match the 
labels. You have to upgrade without saving the configuration. 
https://github.com/openwrt/openwrt/commit/cd8dcfef378044a1687adfa3738f01f9a9622baf

  * **TP-Link RE355 v1, RE450 v1 and RE450 v2:** The partition layout 
and block size changed in this release to fix configuration loss on 
sysupgrade. Users upgrading from OpenWrt 25.12.0 or earlier must use 
`sysupgrade -F` to force the upgrade. The image must not exceed 5.875 MB 
(6016 KiB).

  * **Meraki MX60:** Direct sysupgrade to 25.12.2 is not possible 
without manual preparation — `meraki_loadaddr` must be changed before 
upgrading, as the default value is insufficient to boot OpenWrt 25.12+. 
See the device wiki page for instructions.

Known issues
============

   * Zyxel EX5601-T0: the WAN interface was renamed from `eth1` to `wan` 
— check and update your network configuration after upgrading.
   * Pixel 10 phones have problems connecting to WPA3-protected WiFi 6 
APs. https://github.com/openwrt/openwrt/issues/21486
   * 802.11r Fast Transition (FT) causes connection problems with some 
WiFi clients when WPA3 is used. 
https://github.com/openwrt/openwrt/issues/22200
   * SQM CAKE MQ (`cake_mq`): throughput may be unexpectedly low on some 
configurations after the scheduler fixes in this release. 
https://github.com/openwrt/openwrt/issues/22344

-----------------

Full release notes and upgrade instructions are available at
  https://openwrt.org/releases/25.12/notes-25.12.2

In particular, make sure to read the known issues before upgrading:
  https://openwrt.org/releases/25.12/notes-25.12.2#known_issues

For a detailed list of all changes, refer to
  https://openwrt.org/releases/25.12/changelog-25.12.2

To download the 25.12.2 images, navigate to:
  https://downloads.openwrt.org/releases/25.12.2/targets/
Use OpenWrt Firmware Selector to download:
  https://firmware-selector.openwrt.org?version=25.12.2

As always, a big thank you goes to all our active package maintainers, 
testers, documenters and supporters.

Have fun!

The OpenWrt Community

---

To stay informed of new OpenWrt releases and security advisories, there
are new channels available:

   * a low-volume mailing list for important announcements:
https://lists.openwrt.org/mailman/listinfo/openwrt-announce

   * a dedicated "announcements" section in the forum:
https://forum.openwrt.org/c/announcements/14

   * other announcement channels (such as RSS feeds) might be added in the
     future, they will be listed at https://openwrt.org/contact