openwrt/target/linux/mediatek/dts
Pietro Ameruoso 1c05388ab0 mediatek: add support for Zyxel EX5601-T0 router
Zyxel EX5601-T0 specifics
--------------
The operator specific firmware running on the Zyxel branded
EX5601-T0 includes  U-Boot modifications affecting the OpenWrt
installation.

Partition Table
| dev  | size     | erasesize | name          |
| ---- | -------- | --------- | ------------- |
| mtd0 | 20000000 | 00040000  | "spi0.1"      |
| mtd1 | 00100000 | 00040000  | "BL2"         |
| mtd2 | 00080000 | 00040000  | "u-boot-env"  |
| mtd3 | 00200000 | 00040000  | "Factory"     |
| mtd4 | 001c0000 | 00040000  | "FIP"         |
| mtd5 | 00040000 | 00040000  | "zloader"     |
| mtd6 | 04000000 | 00040000  | "ubi"         |
| mtd7 | 04000000 | 00040000  | "ubi2"        |
| mtd8 | 15a80000 | 00040000  | "zyubi"       |

The router boots BL2 which than loads FIP (u-boot).
U-boot has hardcoded a command to always launch Zloader "mtd read zloader 0x46000000" and than "bootm". Bootargs are deactivated.
Zloader is the zyxel booloader which allow to dual-boot ubi or ubi2, by default access to zloader is blocked.
Too zloader checks that the firmware contains a particolar file called zyfwinfo.
Additional details regarding Zloader can be found here:
https://hack-gpon.github.io/zyxel/
https://forum.openwrt.org/t/adding-openwrt-support-for-zyxel-ex5601-t0/155914

Hardware
--------
SOC: MediaTek MT7986a
CPU: 4 core cortex-a53 (2000MHz)
RAM: 1GB DDR4
FLASH: 512MB SPI-NAND (Micron xxx)
WIFI: Wifi6 Mediatek MT7976 802.11ax 5 GHz 4x4 + 2.4GHZ 4x4
ETH: MediaTek MT7531 Switch + SoC
3 x builtin 1G phy (lan1, lan2, lan3)
1 x MaxLinear GPY211B 2.5 N-Base-T phy5 (lan4)
1 x MaxLinear GPY211B 2.5Gbit xor SFP/N-Base-T phy6 (wan)
USB: 1 x USB 3.2 Enhanced SuperSpeed port
UART: 3V3 115200 8N1 (Pinout: GND KEY RX TX VCC)
VOIP: 2 FXS ports for analog phones

MAC Address Table
-----------------
eth0/lan    Factory 0x002a
eth1/wan    Factory 0x0024
wifi 2.4Ghz Factory 0x0004
wifi 5Ghz   Factory 0x0004 + 1

Serial console (UART)
---------------------
+-------+-------+-------+-------+-------+
| +3.3V |  RX   |  TX   |  KEY  |  GND  |
+---+---+-------+-------+-------+-------+
    |
    +--- Don't connect

Installation
------------
Keep in mind that openwrt can only run on the UBI partition, the openwrt firmware is not able to understand the zloader bootargs.
The procedure allows restoring the UBI partition with the Zyxel firmware and retains all the OEM functionalities.

1. Unlock Zloader (this will allow to swap manually between partitions UBI and UBI2):
- Attach a usb-ttl adapter to your computer and boot the router.
- While the router is booting at some point you will read the following: `Please press Enter to activate this console.`
- As soon as you read that press enter, type root and than press enter again (just do it, don't care about the logs scrolling).
- Most likely the router is still printing the boot log, leave it boot until it stops.
- If everything went ok you should have full root access "root@EX5601-T0:/#".
- Type the following command and press enter: "fw_setenv EngDebugFlag 0x1".
- Reboot the router.
- As soon as you read `Hit any key to stop autoboot:` press Enter.
- If everything went ok you should have the following prompt: "ZHAL>".
- You have successfully unlocked zloader access, this procedure must be done only once.

2. Check the current active partition:
- Boot the router and repeat the steps above to gain root access.
- Type the following command to check the current active image: "cat /proc/cmdline".
- If `rootubi=ubi` it means that the active partition is `mtd6`
- If `rootubi=ubi2` it means that the active partition is `mtd7`
- As mentioned earlier we need to flash openwrt into ubi/mtd6 and never overwrite ubi2/mtd7 to be able to fully roll-back.
- To activate and boot from mtd7 (ubi2) enter into ZHAL> command prompt and type the following commands:
atbt 1  # unlock write
atsw    # swap boot partition
atsr    # reboot the router
- After rebooting check again with "cat /proc/cmdline" that you are correctly booting from mtd7/ubi2
- If yes proceed with the installation guide. If not probably you don't have a firmware into ubi2 or you did something wrong.

3. Flashing:
- Download the sysupgrade file for the router from openwrt, than we need to add the zyfwinfo file into the sysupgrade tar.
Zloader only checks for the magic (which is a fixed value 'EXYZ') and the crc of the file itself (256bytes).
I created a script to create a valid zyfwinfo file but you can use anything that does exactly the same:
https://raw.githubusercontent.com/pameruoso/OpenWRT-Zyxel-EX5601-T0/main/gen_zyfwinfo.sh
- Add the zyfwinfo file into the sysupgrade tar.
- Enter via telnet or ssh into the router with admin credentials
- Enter the following commands to disable the firmware and model checks
"zycli fwidcheck off" and "zycli modelcheck off"
- Open the router web interface and in the update firmware page select the "restore default settings option"
- Select the sysupgrade file and click on upload.
- The router will flash and reboot itself into openwrt from UBI

4. Restoring and going back to Zyxel firmware.
- Use the ZHAL> command line to manually swap the boot parition to UBI2 with the following:
atbt 1  # unlock write
atsw    # swap boot partition
atsr    # reboot the router
- You will boot again the Zyxel firmware you have into UBI2 and you can flash the zyxel firmware to overwrite the UBI partition and openwrt.

Working features
----------------
3 gbit lan ports
Wifi
Zyxel partitioning for coexistance with Zloader and dual boot.
WAN SFP port (only after exporting pins 57 and 10. gpiobase411)
leds
reset button
serial interface
usb port
lan ethernet 2.5 gbit port (autosense)
wan ethernet 2.5 gbit port (autosense)

Not working
----------------
voip (missing drivers or proper zyxel platform software)

Swapping the wan ethernet/sfp xor port
----------------
The way to swap the wan port between sfp and ethernet is the following:
export the pins 57 and 10.
Pin 57 is used to probe if an sfp is present.
If pin 57 value is 0 it means that an sfp is present into the cage (cat /sys/class/gpio/gpio468/value).
If pin 57 value is 1 it means that no sfp is inserted into the cage.
In conclusion by default both 57 an 10 pins are by default 1, which means that the active port is the ethernet one.
After inserting an SFP pin 57 will become 0 and you have to manually change the value of pin 10 to 0 too.
This is totally scriptable of course.

Leds description
------------
All the leds are working out of the box but the leds managed by the 2 maxlinear phy (phy 5 lan, phy6 wan).
To activate the phy5 led (rj45 ethernet port led on the back of the router) you have to use mdio-tools.
To activate the phy6 led (led on the front of the router for 2.5gbit link) you have to use mdio-tools.
Example:
Set lan5 led to fast blink on 2500/1000, slow blink on 10/100:
mdio mdio-bus mmd 5:30 raw 0x0001 0x33FC

Set wan 2.5gbit led to constant on when wan is 2.5gbit:
mdio mdio-bus mmd 6:30 raw 0x0001 0x0080

Signed-off-by: Pietro Ameruoso <p.ameruoso@live.it>
2023-05-22 17:58:59 +02:00
..
mt7622-buffalo-wsr-2533dhp2.dts mediatek: convert mtd-mac-address to nvmem implementation 2021-07-19 14:51:22 +02:00
mt7622-elecom-wrc-2533gent.dts mediatek: add an upstreamed spi-nand driver 2022-04-28 18:06:00 +08:00
mt7622-elecom-wrc-x3200gst3.dts treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7622-linksys-e8450-ubi.dts mediatek: convert mtd-mac-address to nvmem implementation 2021-07-19 14:51:22 +02:00
mt7622-linksys-e8450.dts mediatek: convert mtd-mac-address to nvmem implementation 2021-07-19 14:51:22 +02:00
mt7622-linksys-e8450.dtsi treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7622-netgear-wax206.dts mediatek: no longer hard-code WAN PHY of Netgear WAX206 2023-04-30 17:27:00 +01:00
mt7622-reyee-ax3200-e5.dts mediatek: also move &slot0 from dtsi down to board dts 2022-12-07 01:45:14 +00:00
mt7622-rfb1-ubi.dts mediatek: add an upstreamed spi-nand driver 2022-04-28 18:06:00 +08:00
mt7622-ruijie-rg-ew3200.dtsi treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7622-ruijie-rg-ew3200gx-pro.dts mediatek: also move &slot0 from dtsi down to board dts 2022-12-07 01:45:14 +00:00
mt7622-totolink-a8000ru.dts mediatek: mt7622: add missing vbus regulator node to totolink-a8000ru dts 2022-07-07 00:22:23 +01:00
mt7622-ubnt-unifi-6-lr-v1-ubootmod.dts mediatek: mt7622: fix DTS compatible of UniFi 6 LR variants 2022-09-03 02:27:59 +01:00
mt7622-ubnt-unifi-6-lr-v1.dts mediatek: mt7622: fix DTS compatible of UniFi 6 LR variants 2022-09-03 02:27:59 +01:00
mt7622-ubnt-unifi-6-lr-v1.dtsi mediatek: fix ledbar of UniFi 6 LR when running custom U-Boot 2022-09-11 20:26:42 +01:00
mt7622-ubnt-unifi-6-lr-v2-ubootmod.dts mediatek: mt7622: fix DTS compatible of UniFi 6 LR variants 2022-09-03 02:27:59 +01:00
mt7622-ubnt-unifi-6-lr-v2.dts mediatek: add Ubiquiti UniFi 6 LR v2 targets 2022-06-11 19:51:33 +01:00
mt7622-ubnt-unifi-6-lr-v2.dtsi mediatek: mt7622: fix white dome LED of UniFi 6 LR 2022-07-04 19:19:52 +01:00
mt7622-ubnt-unifi-6-lr.dtsi mediatek: UniFi 6 LR: disable RTC 2022-06-18 17:32:07 +01:00
mt7622-xiaomi-redmi-router-ax6s.dts treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7623a-unielec-u7623-02-emmc-512m.dts mediatek: u7623-02: enable early console also in legacy image 2022-01-31 00:10:38 +00:00
mt7623a-unielec-u7623-02.dts mediatek: mt7623: rework images for U7623-02 board 2022-01-23 20:20:37 +00:00
mt7623a-unielec-u7623-02.dtsi treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7629-iptime-a6004mx.dts treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7981b-cudy-wr3000-v1.dts mediatek: add support for Cudy WR3000 v1 2023-05-18 01:46:13 +02:00
mt7981b-glinet-gl-mt3000.dts mediatek: add support for the GL.iNet GL-MT3000 2023-05-18 02:41:49 +01:00
mt7986a-asus-tuf-ax4200.dts mediatek: apply stock configuration for WAN-LED 2023-05-11 23:09:04 +02:00
mt7986a-bananapi-bpi-r3-emmc-nor.dts mediatek: add support for Bananapi BPi-R3 2022-08-30 13:36:28 +01:00
mt7986a-bananapi-bpi-r3-emmc-snand.dts mediatek: add support for Bananapi BPi-R3 2022-08-30 13:36:28 +01:00
mt7986a-bananapi-bpi-r3-nor.dts mediatek: add support for Bananapi BPi-R3 2022-08-30 13:36:28 +01:00
mt7986a-bananapi-bpi-r3-snand.dts mediatek: add support for Bananapi BPi-R3 2022-08-30 13:36:28 +01:00
mt7986a-bananapi-bpi-r3.dts mediatek: bpi-r3: allow up to 3W per SFP module 2023-04-20 01:03:56 +01:00
mt7986a-tplink-tl-xdr4288.dts mediatek: add support for TP-Link TL-XDR4288/608x 2023-04-22 04:10:19 +01:00
mt7986a-tplink-tl-xdr6086.dts mediatek: add support for TP-Link TL-XDR4288/608x 2023-04-22 04:10:19 +01:00
mt7986a-tplink-tl-xdr6088.dts mediatek: add support for TP-Link TL-XDR4288/608x 2023-04-22 04:10:19 +01:00
mt7986a-tplink-tl-xdr-common.dtsi mediatek: add support for TP-Link TL-XDR4288/608x 2023-04-22 04:10:19 +01:00
mt7986a-xiaomi-redmi-router-ax6000-stock.dts mediatek: add new layout for Xiaomi Redmi Router AX6000 for OpenWrt U-Boot 2022-12-29 03:00:31 +00:00
mt7986a-xiaomi-redmi-router-ax6000-ubootmod.dts mediatek: add new layout for Xiaomi Redmi Router AX6000 for OpenWrt U-Boot 2022-12-29 03:00:31 +00:00
mt7986a-xiaomi-redmi-router-ax6000.dtsi treewide: remove label = "cpu" from DSA dt-binding 2023-02-26 22:22:48 +01:00
mt7986a-zyxel-ex5601-t0-stock.dts mediatek: add support for Zyxel EX5601-T0 router 2023-05-22 17:58:59 +02:00