ZTE MF283V
The ZTE MF283V is an LTE router based on the Qualcomm MDM9607 SoC. It has one ARM Cortex-A7 application CPU, 256 MiB RAM, 512 MiB SLC NAND, four Gigabit Ethernet ports through a QCA8337 switch, and a 2.4 GHz 802.11n 2T2R RTL8192ES WLAN device connected over SDIO. The LTE modem runs on the MDM9607 Hexagon MSS and uses the retained factory MBA/MPSS firmware.
OpenWrt support
Highly experimental — not supported by official OpenWrt releases or snapshots.
The initial port is under review in OpenWrt PR #24731. There are no official images, no standard first-install image and no supported sysupgrade path. The current developer installation writes separate authenticated boot.bin and system.ubi images through Qualcomm EDL. Do not attempt installation unless you can make complete partition backups and recover the device through EDL.
Supporting activities
The PR provides the baseline MDM9607 target and MF283V support. Additional sysupgrade, native mobile-data, LEDs, buttons, thermal and watchdog work is being developed separately and must not be treated as part of the submitted baseline.
Experimental firmware
No public firmware images are available. Images must currently be built from the PR source. The tested factory LK authenticates the boot image, so a matching signing key must be supplied at build time.
Current development status
| Function | Status |
|---|---|
| Linux boot and root filesystem | Tested with Linux 6.18 and persistent SquashFS/UBIFS overlay. |
| NAND | QPIC NAND read/write tested; all 18 factory MIBIB partitions are described. |
| Ethernet | Four external Gigabit Ethernet ports tested. |
| WLAN | RTL8192ES SDIO AP, association, WPA2, DHCP, factory MAC and RF calibration tested. Country changes, regulatory transmit-power enforcement and WPA3 still need work. |
| USB | USB 2.0 peripheral mode tested with CDC ACM console and CDC ECM management. Host/OTG and socket VBUS control are unknown and must not be enabled based only on controller capability. |
| LTE modem | Factory MSS firmware starts through remoteproc; two AT ports and BAM-DMUX wwan0 are present. Complete native packet-data setup requires separate experimental ModemManager integration. PPP over AT remains possible. |
| Sysupgrade | Not available in the PR. Current images are a matched boot.bin + system.ubi installation pair. |
| LEDs | Ten AW9523-controlled color channels have been mapped and tested in a separate development branch; the power LED is hardware-controlled. This work is not part of PR #24731. |
| Buttons | WPS and Reset GPIOs are known from the factory DTB, but OpenWrt press/release behavior and polarity are not yet hardware-qualified. |
| RJ11 / voice | Not investigated. |
| Thermal sensor | Mainline driver exists; runtime readings are not yet qualified. |
| Watchdog | Not enabled or expiry-tested. |
Hardware highlights
| CPU | RAM | Flash | Network | WLAN | USB | Serial | JTAG |
|---|---|---|---|---|---|---|---|
| Qualcomm MDM9607, 1x Cortex-A7 | 256 MiB | 512 MiB SLC NAND | 4x Gigabit Ethernet | RTL8192ES, 2.4 GHz 802.11b/g/n, 2T2R | USB 2.0 peripheral mode | 115200 8N1, 1.8 V | Unknown |
Installation
This is a developer-only EDL installation. It overwrites the boot and system partitions. Back up every original partition before writing anything. Use the partition names and verified offsets; do not infer targets from Linux mtdN numbering. A power loss, wrong signing key, wrong port or wrong partition range can make normal boot and recovery unavailable.
Build
From the OpenWrt source tree containing PR #24731:
cp target/linux/mdm9607/production.config .config make defconfig make -j"$(nproc)" \ MF283V_SIGNING_KEY=/absolute/path/to/qcom.key \ MF283V_STRICT_KEY_FINGERPRINT=1
Qualcomm test signing key is known to work with some firmware variants.
Expected files under bin/targets/mdm9607/generic/:
openwrt-mdm9607-generic-zte_mf283v-boot.bin openwrt-mdm9607-generic-zte_mf283v-squashfs-system.ubi sha256sums
boot.bin is a complete Android v0/QCDT image sized for the factory boot partition and authenticated by LK. system.ubi contains the SquashFS root and UBIFS overlay seed. They must be installed as a matched pair.
Entering EDL mode
EDL can be forced with the marked test point on the rear side of the PCB, opposite the side with the external connectors. The test point is below a metal shielding cover. To reach it, remove the cover. It is held by an adhesive layer resembling double-sided tape, so warm the cover with hot air while removing it.
- With power disconnected, short the marked test point to ground.
- While keeping the test point grounded, apply power.
- Wait a couple of seconds, then release the test point.
This procedure does not enter EDL reliably on every attempt. If the device does not appear in EDL mode, disconnect power completely and repeat the sequence.
EDL installation
Use qtools and resolve the current Qualcomm EDL serial device instead of assuming that it is always /dev/ttyUSB1.
cd qtools-maks EDL_PORT=/dev/ttyUSB1 ./qdload -t -p "$EDL_PORT" -k 11 -i # system: erase blocks 0x616..0xfff and write the compact UBI seed ./qwdirect -p "$EDL_PORT" -k 11 -b 616 -c 9ea ./qwdirect -p "$EDL_PORT" -k 11 -b 616 -f o \ -s ../openwrt/bin/targets/mdm9607/generic/openwrt-mdm9607-generic-zte_mf283v-squashfs-system.ubi # boot: write the complete authenticated boot-partition image ./qwdirect -p "$EDL_PORT" -k 11 -b 132 -f o \ -s ../openwrt/bin/targets/mdm9607/generic/openwrt-mdm9607-generic-zte_mf283v-boot.bin
The compact UBI image contains only programmed PEBs. After the full erase, qwdirect can stop advancing its page indicator after the last non-0xff page; it must still report success.
First boot
The current development image provides:
- LSUART console at 115200 8N1;
- USB CDC ACM console;
- USB CDC ECM management at device
192.168.7.1/24and host192.168.7.2/24; - four DSA Ethernet ports using the chassis mapping below;
- RTL8192ES using the factory MAC address and calibration data;
- running MSS with
/dev/wwan0at0,/dev/wwan0at1andwwan0.
Standard sysupgrade is not available. Updating only system can leave the kernel and modules inconsistent with boot.
Specific configuration
Ethernet socket mapping
Viewed from outside at the rear panel:
| Chassis marking | QCA8337 switch port / PHY | OpenWrt name |
|---|---|---|
leftmost LAN1/WAN | port 5 / PHY 4 | wan |
LAN2 | port 3 / PHY 2 | lan2 |
LAN3 | port 2 / PHY 1 | lan3 |
LAN4 | port 1 / PHY 0 | lan4 |
The LAN1/WAN socket changes role through VLAN configuration; it is not a physical PHY mux.
Mobile data
PR #24731 starts the retained factory modem firmware and exposes two AT ports plus the BAM-DMUX network device. A complete native LTE data connection is not part of the PR. Experimental follow-up work uses ModemManager and board-specific BAM-DMUX DPM endpoint setup. No APN, SIM PIN or paid bearer is configured by default.
Hardware
Photos
Info
| Architecture | ARMv7, Cortex-A7 |
|---|---|
| Vendor | Qualcomm / ZTE |
| Bootloader | Qualcomm Little Kernel (aboot) |
| System-On-Chip | Qualcomm MDM9607 |
| CPU | One Cortex-A7; stock firmware exposes 400 MHz and 1305.6 MHz OPPs |
| Flash chip | Micron SLC NAND, ID 2c:ac; exact part number unknown |
| Flash size | 512 MiB |
| RAM | 256 MiB |
| Wireless | Realtek RTL8192ES over SDIO, 2.4 GHz 802.11b/g/n, 2T2R |
| Ethernet | Qualcomm EMAC/SGMII, 4x Gigabit Ethernet |
| Switch | Qualcomm Atheros QCA8337 |
| USB | USB 2.0 controller, currently forced to peripheral mode |
| Modem | Qualcomm Hexagon MSS using retained factory MBA/MPSS firmware |
| Serial | Yes, 115200 8N1 at 1.8 V |
| JTAG | Unknown |
| LEDs | 10 AW9523-controlled colour channels plus one hardware-controlled power LED |
| Buttons | WPS and Reset; OpenWrt runtime qualification pending |
| Power supply | 12 V, 1.5 A |
Flash layout
All offsets and sizes are bytes. Ordinary installation must write only boot and system.
| Name | Offset | Size |
|---|---|---|
| SBL | 0x00000000 | 0x00140000 |
| MIBIB | 0x00140000 | 0x00140000 |
| EFS2 | 0x00280000 | 0x00b00000 |
| TZ | 0x00d80000 | 0x00360000 |
| RPM | 0x010e0000 | 0x00340000 |
| ZTEFLAG | 0x01420000 | 0x00640000 |
| ZTEFOTA | 0x01a60000 | 0x005a0000 |
| EFSBAK | 0x02000000 | 0x00560000 |
| aboot | 0x02560000 | 0x000e0000 |
| boot | 0x02640000 | 0x00a40000 |
| SCRUB | 0x03080000 | 0x00040000 |
| modem | 0x030c0000 | 0x046e0000 |
| misc | 0x077a0000 | 0x00180000 |
| recovery | 0x07920000 | 0x00a60000 |
| fota | 0x08380000 | 0x00180000 |
| recoveryfs | 0x08500000 | 0x02820000 |
| ZTEFILE | 0x0ad20000 | 0x015a0000 |
| system | 0x0c2c0000 | 0x13d40000 |
boot and recovery use the QPIC boot-codeword layout. system, modem and the factory recovery filesystems are UBI containers.
Serial
The debug UART is exposed on three horizontal round test pads on the PCB side opposite the external connectors. Pad order is GND, RX, TX. The electrical level is 1.8 V, not 3.3 V.
| Serial connection parameters for ZTE MF283V | 115200 / 8N1 / 1.8 V |
|---|
Use a level shifter. Driving the router RX pad from a 3.3 V adapter may damage the device.
Recovery
Qualcomm EDL is the final recovery path. Keep complete, verified factory partition dumps off the device. If OpenWrt still boots, mf283v-reboot recovery requests the factory LK recovery path and mf283v-reboot bootloader requests LK/fastboot.
Known gaps
- PR #24731 is not merged and no official snapshot contains this target.
- No standard first-install image or accepted sysupgrade image exists.
- Native LTE packet data requires separate experimental integration.
- USB host/OTG and external socket VBUS control are unknown.
- RJ11/voice support is not investigated.
- Button polarity and runtime events are not yet qualified.
- Thermal readings and watchdog expiry are not yet qualified.
- JTAG location and availability are unknown.


