ramips: add support for ipTIME AX2002MESH
authorMyoung Ha, Ji <[email protected]>
Wed, 29 Oct 2025 07:29:48 +0000 (16:29 +0900)
committerHauke Mehrtens <[email protected]>
Fri, 21 Nov 2025 00:49:58 +0000 (01:49 +0100)
ipTIME AX2002MESH is an 802.11ax (Wi-Fi 6) router based on
MediaTek MT7621 SoC.

Specifications:
- SoC: MediaTek MT7621, MIPS 1004Kc, 880 MHz
- RAM: 128 MiB
- Flash: NAND 128 MiB (ESMT PSU1GA30DT)
- WLAN: MediaTek MT7915E
  - 2.4 GHz: ax/b/g/n
  - 5 GHz: ac/ax/n
- Ethernet:
  - LAN: MediaTek MT7530, 2x 1GbE
  - WAN: MediaTek SoC built-in, 1x 1GbE
- UART: J4 header, 115200 8N1
  - Pinout: [3V3] [TX] [RX] [GND]
- Button: Reset
- LEDs: 6 LEDs
  - 1x CPU (Amber)
  - 1x WLAN 5GHz (Amber)
  - 1x WLAN 2.4GHz (Amber)
  - 2x LAN (Amber)
  - 1x WAN (Amber)
- Power: DC 12V/1A

MAC addresses:
| Interface | MAC               | Algorithm                 |
|:----------|:-----------------:|:--------------------------|
| WLAN 2.4G | 58:86:94:XX:XX:34 | label                     |
| WAN       | 58:86:94:XX:XX:35 | label + 1                 |
| LAN       | 58:86:94:XX:XX:37 | label + 3                 |
| WLAN 5G   | 5A:86:94:XX:XX:37 | label + 3 with LA bit set |
- The WLAN 2.4G MAC address (label) is stored in factory partition, 0x4

Installation:
- Stock web interface:
  1. Flash the **initramfs-factory** image through the web page.
  2. Boot into OpenWrt and perform sysupgrade with **sysupgrade** image.
- Recovery mode:
  1. Turn on the device and press the Reset button more than 10 seconds
     to enter recovery mode.
  2. Access the recovery web interface at 192.168.0.1/24 and flash the
     **initramfs-factory** image.
  3. Boot into OpenWrt and perform sysupgrade with **sysupgrade** image.

Signed-off-by: Myoung Ha, Ji <[email protected]>
Link: https://github.com/openwrt/openwrt/pull/20584
Signed-off-by: Hauke Mehrtens <[email protected]>
package/boot/uboot-tools/uboot-envtools/files/ramips
target/linux/ramips/dts/mt7621_iptime_ax2002m.dts [new file with mode: 0644]
target/linux/ramips/image/mt7621.mk
target/linux/ramips/mt7621/base-files/etc/board.d/02_network
target/linux/ramips/mt7621/base-files/etc/board.d/05_compat-version
target/linux/ramips/mt7621/base-files/etc/hotplug.d/ieee80211/10_fix_wifi_mac
target/linux/ramips/mt7621/base-files/lib/upgrade/platform.sh

index 5d6cbe39369b175f6ad50544de37d3337b1e1318..4b080b6baacbb1c81e7d7e8dbded9cc3ef81121d 100644 (file)
@@ -78,6 +78,7 @@ elecom,wrc-x1800gs|\
 h3c,tx1800-plus|\
 h3c,tx1801-plus|\
 h3c,tx1806|\
+iptime,ax2002m|\
 iptime,ax2004m|\
 jcg,q20|\
 linksys,e7350|\
diff --git a/target/linux/ramips/dts/mt7621_iptime_ax2002m.dts b/target/linux/ramips/dts/mt7621_iptime_ax2002m.dts
new file mode 100644 (file)
index 0000000..df7707e
--- /dev/null
@@ -0,0 +1,182 @@
+// SPDX-License-Identifier: GPL-2.0-or-later OR MIT
+
+#include "mt7621.dtsi"
+
+#include <dt-bindings/gpio/gpio.h>
+#include <dt-bindings/input/input.h>
+#include <dt-bindings/leds/common.h>
+
+/ {
+       compatible = "iptime,ax2002m", "mediatek,mt7621-soc";
+       model = "ipTIME AX2002MESH";
+
+       aliases {
+               led-boot = &led_cpu;
+               led-failsafe = &led_cpu;
+               led-running = &led_cpu;
+               led-upgrade = &led_cpu;
+       };
+
+       chosen {
+               bootargs = "console=ttyS0,115200";
+       };
+
+       leds {
+               compatible = "gpio-leds";
+
+               led_cpu: led-0 {
+                       color = <LED_COLOR_ID_AMBER>;
+                       function = LED_FUNCTION_CPU;
+                       gpios = <&gpio 18 GPIO_ACTIVE_LOW>;
+               };
+
+               led-1 {
+                       color = <LED_COLOR_ID_AMBER>;
+                       function = LED_FUNCTION_WLAN_2GHZ;
+                       gpios = <&gpio 17 GPIO_ACTIVE_LOW>;
+                       linux,default-trigger = "phy0radio";
+               };
+
+               led-2 {
+                       color = <LED_COLOR_ID_AMBER>;
+                       function = LED_FUNCTION_WLAN_5GHZ;
+                       gpios = <&gpio 14 GPIO_ACTIVE_LOW>;
+                       linux,default-trigger = "phy1radio";
+               };
+       };
+
+       keys {
+               compatible = "gpio-keys";
+
+               reset {
+                       label = "reset";
+                       gpios = <&gpio 4 GPIO_ACTIVE_LOW>;
+                       linux,code = <KEY_RESTART>;
+               };
+       };
+};
+
+&nand {
+       status = "okay";
+
+       mediatek,nmbm;
+       mediatek,bmt-max-ratio = <1>;
+       mediatek,bmt-max-reserved-blocks = <64>;
+       mediatek,bmt-remap-range = <0x000000 0x580000>;
+
+       partitions {
+               compatible = "fixed-partitions";
+               #address-cells = <1>;
+               #size-cells = <1>;
+
+               partition@0 {
+                       label = "u-boot";
+                       reg = <0x0 0x80000>;
+                       read-only;
+               };
+
+               partition@80000 {
+                       label = "u-boot-env";
+                       reg = <0x80000 0x80000>;
+               };
+
+               partition@100000 {
+                       label = "factory";
+                       reg = <0x100000 0x80000>;
+                       read-only;
+
+                       nvmem-layout {
+                               compatible = "fixed-layout";
+                               #address-cells = <1>;
+                               #size-cells = <1>;
+
+                               eeprom_factory_0: eeprom@0 {
+                                       reg = <0x0 0xe00>;
+                               };
+
+                               macaddr_factory_4: macaddr@4 {
+                                       compatible = "mac-base";
+                                       reg = <0x4 0x6>;
+                                       #nvmem-cell-cells = <1>;
+                               };
+
+                               precal_factory_e10: precal@e10 {
+                                       reg = <0xe10 0x19c10>;
+                               };
+                       };
+               };
+
+               partition@180000 {
+                       label = "firmware";
+                       reg = <0x180000 0x7680000>;
+
+                       compatible = "fixed-partitions";
+                       #address-cells = <1>;
+                       #size-cells = <1>;
+
+                       partition@0 {
+                               label = "kernel";
+                               reg = <0x0 0x400000>;
+                       };
+
+                       partition@400000 {
+                               label = "ubi";
+                               reg = <0x400000 0x7280000>;
+                       };
+               };
+
+               /* last 8 MiB is reserved for NMBM bad block table */
+       };
+};
+
+&state_default {
+       gpio {
+               groups = "i2c", "jtag", "wdt";
+               function = "gpio";
+       };
+};
+
+&gmac0 {
+       nvmem-cells = <&macaddr_factory_4 3>;
+       nvmem-cell-names = "mac-address";
+};
+
+&gmac1 {
+       status = "okay";
+       label = "wan";
+       phy-handle = <&ethphy0>;
+
+       nvmem-cells = <&macaddr_factory_4 1>;
+       nvmem-cell-names = "mac-address";
+};
+
+&ethphy0 {
+       /delete-property/ interrupts;
+};
+
+&switch0 {
+       ports {
+               port@1 {
+                       status = "okay";
+                       label = "lan2";
+               };
+
+               port@2 {
+                       status = "okay";
+                       label = "lan1";
+               };
+       };
+};
+
+&pcie {
+       status = "okay";
+};
+
+&pcie1 {
+       wifi@0,0 {
+               compatible = "mediatek,mt76";
+               reg = <0x0000 0 0 0 0>;
+               nvmem-cells = <&eeprom_factory_0>, <&precal_factory_e10>;
+               nvmem-cell-names = "eeprom", "precal";
+       };
+};
index 6b4dd01a28d965e545e9044cdcc2591cb5a1e15d..bb4ffa8adb2e208ef680272f90d90e6ef916ac3c 100644 (file)
@@ -1864,6 +1864,27 @@ define Device/iptime_a8004t
 endef
 TARGET_DEVICES += iptime_a8004t
 
+define Device/iptime_ax2002m
+  $(Device/nand)
+  IMAGE_SIZE := 121344k
+  KERNEL_LOADADDR := 0x82000000
+  KERNEL := kernel-bin | relocate-kernel $(loadaddr-y) | lzma | \
+       fit lzma $$(KDIR)/image-$$(firstword $$(DEVICE_DTS)).dtb
+ifeq ($(IB),)
+  ARTIFACTS := initramfs-factory.bin
+  ARTIFACT/initramfs-factory.bin := append-image-stage initramfs-kernel.bin | \
+       check-size | iptime-crc32 ax2002m
+endif
+  DEVICE_VENDOR := ipTIME
+  DEVICE_MODEL := AX2002MESH
+  DEVICE_PACKAGES := kmod-mt7915-firmware
+  DEVICE_COMPAT_VERSION := 2.0
+  DEVICE_COMPAT_MESSAGE := NMBM has been newly enabled, and its flash block \
+       mapping might be incompatible with existing installation. \
+       New installation with factory image via recovery mode is recommended.
+endef
+TARGET_DEVICES += iptime_ax2002m
+
 define Device/iptime_ax2004m
   $(Device/nand)
   IMAGE_SIZE := 121344k
index eb5a64ab34a073ed66125f50fee3b2c179ac0ca2..2c66ffb6523c441b620784e881e5af42af184470 100644 (file)
@@ -101,6 +101,7 @@ ramips_setup_interfaces()
        glinet,gl-mt1300|\
        iodata,wn-deax1800gr|\
        iptime,a3002mesh|\
+       iptime,ax2002m|\
        jcg,q20|\
        jdcloud,re-sp-01b|\
        lenovo,newifi-d1|\
index 156fb1735e318e000f7d95412fecfdfed9ad730e..f3000b83c7fcf15c43496ca20ed48e1810a4f6f0 100644 (file)
@@ -10,6 +10,7 @@ board_config_update
 case "$(board_name)" in
        ubnt,edgerouter-x|\
        ubnt,edgerouter-x-sfp|\
+       iptime,ax2002m|\
        iptime,ax2004m)
                ucidef_set_compat_version "2.0"
                ;;
index 175dcf20f86e674ba6a523d973d7ed32ce9d71a3..19e76b146c6eedd6581fe274e288f28aefea69d7 100644 (file)
@@ -97,6 +97,7 @@ case "$board" in
                        macaddr_setbit_la "$(macaddr_add $hw_mac_addr 3)" > /sys${DEVPATH}/macaddress
                [ "$PHYNBR" = "1" ] && echo -n "$hw_mac_addr" > /sys${DEVPATH}/macaddress
                ;;
+       iptime,ax2002m|\
        iptime,ax2004m)
                if [ "$PHYNBR" = "1" ]; then
                        hw_mac_addr="$(mtd_get_mac_binary factory 0x4)"
index cc33885423e24bf21d97da866cbe0079e055c63f..360dc261a451aa4d494e6a9607cce68839e3fdc7 100644 (file)
@@ -45,6 +45,7 @@ platform_do_upgrade() {
                        fw_setenv --lock / bootImage 0 || exit 1
                fi
                ;;
+       iptime,ax2002m|\
        iptime,ax2004m)
                if [ "$(fw_printenv -n boot_from 2>/dev/null)" != "firmware1" ]; then
                        fw_setenv boot_from firmware1 || exit 1
@@ -105,6 +106,7 @@ platform_do_upgrade() {
        gemtek,wvrtm-127acn|\
        gemtek,wvrtm-130acn|\
        iptime,a3004t|\
+       iptime,ax2002m|\
        iptime,ax2004m|\
        iptime,t5004|\
        jcg,q20|\