ZTE MF289F
It's a 4G Cat.20 router used by Vodafone Italy (called Vodafone FWA) and Vodafone DE\T-Mobile PL (called GigaCube).
Modem is a MiniPCIe-to-USB based on Snapdragon X24, it supports 4CA aggregation.
There are currently two hardware revisions, which differ on the 5Ghz radio:
AT1 = QCA9984 5Ghz Radio on PCI-E bus 4×4 MIMO
AT2 = IPQ4019 5Ghz Radio inside IPQ4019 2×2 MIMO like 2.4G
Getting started with a new Device Page
- This is an empty template that suggests the information that should be present on a well-constructed Device Page. This means, that you have to fill it with life and information.
- There are several “fixme” tags with text on a light background (like this text) throughout this template. As you fill in the page, remove those tags so that people can judge its completeness.
- When there are no more “fixme” tags left, delete this one too, along with the
<WRAP>
that encloses it.
Keep the articles modular
- Please include only model specific information, omit bla,bla and put everything generic into separate articles
- If you have no time to write certain stuff, link to docs
- base-system should lead the way, do not explain this again
- DO NOT provide a complete howto here! Instead groom the general documentation.
Supported Versions
- The tables below are automatically generated, once the correct filters for Brand and Model are set.
- If the tables below show information for
ZTE MF289F
, everything is OK and you can delete this text and the<WRAP>
that encloses it. - If the tables below contain “Nothing found”, it means that either
- the dataentry page for ZTE MF289F is missing. Please create a new dataentry page first, then reload this page. The tables should then contain $something. If they do, delete this text and the
<WRAP>
that encloses it. - filters are not set correctly. Most common reason for “Nothing found”: The dataentry does not contain a Version, but we are filtering here for version → Please edit this section and adjust the filters with the proper Brand, Model and Version. In case the dataentry does not contain a version, delete the line
filter : Versions~
. Just try, it's easy. The tables should then contain $something. If they do, delete this text and the<WRAP>
that encloses it.
- If the tables still contain “Nothing found”: Don't panic, calm down, take a deep breath and contact a wiki admin (tmomas) for help.
Experimental Versions
None at this time.
Hardware Highlights
Installation
1. Place OpenWrt initramfs image for the device on a TFTP in the server's root. (This example uses Server IP: 192.168.0.2)
2. Connect serial console (115200,8n1) to serial connector GND (which is right next to the thing with MF289F MIMO-V1.0), RX, TX (refer to this image: https://ibb.co/31Gngpr).
Solder the pin-header into the 3 holes we are interested in and then proceed to connect them as follows:
GND = ground (will go directly to the same PIN of the TTL 2 USB adapter)
RX = will go to the TX PIN of the TTL 2 USB adapter
TX = will go to the RX PIN of the TTL 2 USB adapter
Once everything is connected, I recommend connecting the serial port FIRST and then the router power supply, open PuTTY program and configure the COM port installed by the TTL 2 USB adapter (you can find it via Device Manager\COM Ports ) and set speed to 115200.
3. Connect TFTP server to RJ-45 port (WAN/LAN1).
4. Stop in u-Boot (using ESC button) and run u-Boot commands:
setenv serverip 192.168.0.2 setenv ipaddr 192.168.0.1 set fdt_high 0x85000000 tftp openwrt-ipq40xx-generic-zte_mf289f-initramfs-fit-zImage.itb bootm $loadaddr
(Please keep in mind that openwrt configures the WAN/LAN port as Wan by default so you might need to switch ports, I had been stuck on this step in the past)
5. Please make backup of original partitions in your computer, just in case you want to revert to stock, specially mtd16 (Web UI) and mtd17 (rootFS). Use /tmp as temporary storage and do:
WEB PARITION BACKUP
cat /dev/mtd16 > /tmp/mtd16.bin scp /tmp/mtd16.bin root@YOURSERVERIP:/ rm /tmp/mtd16.bin
ROOT PARITION BACKUP
cat /dev/mtd17 > /tmp/mtd17.bin scp /tmp/mtd17.bin root@YOURSERVERIP:/ rm /tmp/mtd17.bin
6. Login via ssh or serial and remove stock partitions (default IP 192.168.0.1):
ubiattach -m 17
(This can return an error, if ubi was attached before or rootfs part was erased before.
ubirmvol /dev/ubi0 -N ubi_rootfs
(It could return error if rootfs part was erased before ubirmvol /dev/ubi0 -N ubi_rootfs_data (Some devices do not have it)
7. Download and install image via sysupgrade -n (either use wget/scp to copy the mf289f squashfs-sysupgrade.bin to the device's /tmp directory)
sysupgrade -n /tmp/openwrt-...-zte_mf289f-squashfs-sysupgrade.bin
(Sometimes it could print ubi attach error, but please ignore it if process goes forward.)
Flash Layout
NAND: | Start | End | Label |
mtd8: | 00020000 | 000a0000 | fota-flag |
---|---|---|---|
mtd9: | 00020000 | 00080000 | 0:ART |
mtd10: | 00020000 | 00080000 | mac |
mtd11: | 00020000 | 000c0000 | reserved2 |
mtd12: | 00020000 | 00400000 | cfg-param |
mtd13: | 00020000 | 00400000 | log |
mtd14: | 00020000 | 000a0000 | oops |
mtd15: | 00020000 | 00500000 | reserved3 |
mtd16: | 00020000 | 00800000 | web |
mtd17: | 00020000 | 01d00000 | rootfs |
mtd18: | 00020000 | 01900000 | data |
mtd19: | 00020000 | 03200000 | fota |
mtd20: | 0001f000 | 0041e000 | kernel |
mtd21: | 0001f000 | 0101b000 | ubi_rootfs |
SPI: | Start | End | Label |
mtd0: | 00010000 | 00040000 | 0:SBL1 |
---|---|---|---|
mtd1: | 00010000 | 00020000 | 0:MIBIB |
mtd2: | 00010000 | 00060000 | 0:QSEE |
mtd3: | 00010000 | 00010000 | 0:CDT |
mtd4: | 00010000 | 00010000 | 0:DDRPARAMS |
mtd5: | 00010000 | 00010000 | 0:APPSBLENV |
mtd6: | 00010000 | 000c0000 | 0:APPSBL |
mtd7: | 00010000 | 00050000 | 0:reserved1 |
Restore original firmware (you need original dump taken from initramfs)
1. Place mtd16.bin and mtd17.bin initramfs image for the device on a TFTP in the server's root directory. (This example uses Server IP: 192.168.0.2)
2. Connect serial console (115200,8n1) to serial console connector (refer to the pin-out from above).
3. Connect TFTP server to RJ-45 port (WAN/LAN1).
4. rename mtd16.bin to web.img and mtd17.bin to root_uImage_s
5. Stop in u-Boot (using ESC button) and run u-Boot commands:
This will erase RootFS+Web:
nand erase 0x1000000 0x800000 nand erase 0x1800000 0x1D00000
This will restore RootFS:
tftpboot 0x84000000 ${dir}root_uImage_s nand erase 0x1800000 0x1D00000 nand write $fileaddr 0x1800000 $filesize
This will restore Web Interface:
tftpboot 0x84000000 ${dir}web.img nand erase 0x1000000 0x800000 nand write $fileaddr 0x1000000 $filesize
After first boot on stock firwmare, do a factory reset. Push reset button for 5 seconds so all parameters will be reverted to the one printed on label on bottom of the router
Upgrading OpenWrt
These are generic instructions. Update with your router's specifics.
LuCI Web Upgrade Process
- Browse to
http://192.168.1.1/cgi-bin/luci/mini/system/upgrade/
LuCI Upgrade URL - Upload image file for sysupgrade to LuCI
- Wait for reboot
Terminal Upgrade Process
If you don't have a GUI (LuCI) available, you can alternatively upgrade via the command line. There are two command line methods for upgrading:
sysupgrade
mtd
Note: It is important that you put the firmware image into the ramdisk (/tmp) before you start flashing.
sysupgrade
- Login as root via SSH on 192.168.1.1, then enter the following commands:
cd /tmp wget http://downloads.openwrt.org/snapshots/trunk/XXX/xxx.abc sysupgrade /tmp/xxx.abc
mtd
If sysupgrade
does not support this router, use mtd
.
- Login as root via SSH on 192.168.1.1, then enter the following commands:
cd /tmp wget http://downloads.openwrt.org/snapshots/trunk/XXX/xxx.abc mtd write /tmp/xxx.abc linux && reboot
Debricking
Like stated on → generic.debrick you could simply follow the installation instructions of flashing and upgrading openwrt (no need to touch the partitions if they are already correct for openwrt, so follow only step 1, 2, 3, 4 & 7)
Failsafe mode
Basic configuration
→ Basic configuration After flashing, proceed with this.
Set up your Internet connection, configure wireless, configure USB port, etc.
Specific Configuration
Network interfaces
The default network configuration is:
Interface Name | Description | Default configuration |
---|---|---|
br-lan | LAN 2 & WiFi | 192.168.1.1/24 |
WAN | WAN/LAN 1 port | Wan |
WiFi | Disabled | Openwrt ssid no security |
RJ11 | VoIP or Voice (CSFB/VoLTE) | VoIP |
Switch Ports (for VLANs)
Please fill in real values for this device, then remove the EXAMPLEs
Numbers 0-3 are Ports 1-4 as labeled on the unit, number 4 is the Internet (WAN) on the unit, 5 is the internal connection to the router itself. Don't be fooled: Port 1 on the unit is number 3 when configuring VLANs. vlan0 = eth0.0, vlan1 = eth0.1 and so on.
Port | Switch port |
---|---|
Internet (WAN) | EXAMPLE 4 |
LAN 1 | EXAMPLE 3 |
LAN 2 | EXAMPLE 2 |
LAN 3 | EXAMPLE 1 |
LAN 4 | EXAMPLE 0 |
Buttons
The ZTE MF289F has the following buttons:
BUTTON | Event |
---|---|
RESET | Resets the device on the default configuration |
WPS | Allows clients connecting on Wi-Fi without typing the password |
Hardware
Info
- This table is automatically generated, once the correct filters for Brand and Model are set.
- If you see “Nothing.” instead of a table, please edit this section and adjust the filters with the proper Brand and Model. Just try, it's easy.
- If you still don't see a table here, or a table filled with '¿': Is there already a Techdata page available for ZTE MF289F ? If not: Create one.
- If you see a table with the desired device data, everything is OK and you can delete this text and the
<WRAP>
that encloses it. - If it still doesn't work: Don't panic, calm down, take a deep breath and contact a wiki admin (tmomas) for help.
---- datatemplatelist dttpllist ---- template: meta:template_datatemplatelist cols : Brand, Model, Versions, Device Type, Availability, Supported Since Commit_git, Supported since Rel, Supported current Rel, Unsupported, Bootloader, CPU, Target, CPU MHz, Flash MBs, RAM MB, Switch, Ethernet 100M ports_, Ethernet Gbit ports_, Comments network ports_, Modem, VLAN, WLAN 2.4GHz, WLAN 5.0GHz, WLAN Hardwares, WLAN Comments_, Detachable Antennas_, USB ports_, SATA ports_, Comments USB SATA ports_, Serial, JTAG, LED count, Button count, Power supply, Device Techdata_pageid, Forum topic URL_url, wikidevi URL_url, OEM Device Homepage URL_url, Firmware OEM Stock URL_url, Firmware OpenWrt Install URL_url, Firmware OpenWrt Upgrade URL_url, Comments_ filter : Brand=ZTE filter : Model=MF289F filter : Supported since Rel=22.03.3
Photos
Front:
Insert photo of front of the casing
Back:
Insert photo of back of the casing
Backside label:
Insert photo of backside label
Opening the case
Note: This will void your warranty!
Describe what needs to be done to open the device, e.g. remove rubber feet, adhesive labels, screws, ...
- To remove the cover and open the device, do a/b/c
Main PCB:
Insert photo of PCB
Bootloader mods
Hardware mods
None so far.
Bootlogs
OEM bootlog
COPY HERE THE BOOTLOG WITH THE ORIGINAL FIRMWARE
OpenWrt bootlog
COPY HERE THE BOOTLOG ONCE OPENWRT IS INSTALLED AND RUNNING
Notes
Space for additional notes, links to forum threads or other resources.
- ...
Tags
Add tags below, then remove this fixme.