qualcommbe: ipq53xx: add support for Ubiquiti UniFi 7 Pro XGS - #25185

Some PCIe ath12k platforms report an unusable board ID from OTP or
QMI, which makes board-2.bin lookup fall back to the wrong entry.

Allow DTS to override the board ID in both the MHI and QMI paths so
boards can provide a stable value for firmware board-data selection
while keeping the current fallback logic for existing targets.

Signed-off-by: Til Kaiser <[email protected]>

Disable missing kernel symbols that were prompted while
building all kernel modules.

Signed-off-by: Til Kaiser <[email protected]>

Add the missing IPQ5332 DTS nodes for the PWM block used by
front-panel LEDs and for the MDIO bus used by external Ethernet PHYs.

Signed-off-by: Til Kaiser <[email protected]>

Add the IPQ5332 NSSCC bindings, clock definitions,
interconnect updates, clock controller driver, and DTS nodes
from the v5 mailing-list series.

The series is imported with a deliberate deviation: a dedicated
ftbl_nss_cc_ppe_clk_src is added so the PPE clock can reach 300 MHz
instead of being capped at the CE table's 200 MHz.

Link: https://lore.kernel.org/all/[email protected]/
Signed-off-by: Til Kaiser <[email protected]>

Add the IPQ5332 specific PCS, PPE, and NSS clock changes needed
to bring up the integrated Ethernet datapath on IPQ5332 based boards.

Signed-off-by: Til Kaiser <[email protected]>

Add the IPQ5332 specific changes required to use the second PCIe
controller, including the shared reset and mux handling in the UNIPHY
driver and the corresponding DTS nodes.

Signed-off-by: Til Kaiser <[email protected]>

Add the IPQ53xx subtarget to qualcommbe together with the
default kernel configuration needed by IPQ5332 based boards.

This also includes the ipq53xx image recipe using fit-inline-rootfs,
which builds a Flattened Image Tree (FIT) with an inline SquashFS
root filesystem aligned to a 4KB boundary.

Signed-off-by: Til Kaiser <[email protected]>

Add support for the Ubiquiti UniFi U7 Pro XGS ceiling-mounted
access point.

Device specification
--------------------

SoC:                    Qualcomm IPQ5332, quad-core Cortex-A53, 1.5 GHz
RAM:                    2 GB
Flash:                  MT3204 eMMC, 4 GB
Flash:                  MX25U6435F SPI-NOR, 8 MB
Ethernet:               1x 10GbE RJ45
WiFi:                   WiFi 7, 8 spatial streams
                        2.4 GHz 2x2, 5 GHz 4x4, 6 GHz 2x2
Power:                  PoE++, 29 W max.
LEDs:                   1x white status, 1x blue WLAN
Buttons:                1x reset
Console:                ttyMSM0 at 115200 8n1
Bootloader:             U-Boot

Installing OpenWrt
------------------

1. Boot the device into the vendor firmware.

   The factory firmware should be reachable via SSH at 192.168.1.20
   with user ubnt and password ubnt. If the device has already been
   adopted, the SSH credentials can be found in the UniFi WebUI under
   Devices -> Device Updates and Settings -> Device SSH Settings.

2. Check the vendor firmware and U-Boot versions.

   The firmware version can be checked in the SSH banner or via:

     cat /usr/lib/semver

   The U-Boot version can be checked via:

     strings /dev/mtd8 | grep '^U-Boot '

3. If the device runs firmware newer than 8.0.23 or U-Boot newer than
   2024.01 v1.0.51.63, downgrade first to 8.0.23.

   Newer U-Boot versions enforce a signature check while loading the
   image, which prevents booting OpenWrt.

   Download:
   https://dl.ui.com/unifi/firmware/U7PRO/8.0.23.16670/BZ.ipq53xx_8.0.23+16670.250316.0909.bin

   Downgrade via SSH by copying the image to /tmp/fwupdate.bin and
   running:

     fwupdate -c
     syswrapper.sh upgrade2

   Or use the UniFi WebUI:
   Devices -> <select AP> -> Manage -> Manual Firmware Update

   After the AP reboots, log in again and repeat the checks from step 2.
   Continue only once the device reports firmware 8.0.23 and U-Boot
   2024.01 v1.0.51.63 or older.

4. Copy the initramfs image to /tmp via SCP.

5. Check which kernel slot the device is set to boot from:

     hexdump -n1 -e '1/1 "%u\n"' /dev/mmcblk0p4

   If the command prints 1, switch the boot slot to kernel0:

     printf '\0' | dd of=/dev/mmcblk0p4 bs=1 conv=fsync

   Then run the check again and make sure it now prints 0.

   If the command already printed 0, back up kernel0 to kernel1:

     dd if=/dev/mmcblk0p1 of=/dev/mmcblk0p2 bs=1M conv=fsync

6. Flash the initramfs FIT image to mmcblk0p1:

     dd if=/tmp/openwrt-qualcommbe-ipq53xx-ubnt_u7-pro-xgs-initramfs.itb of=/dev/mmcblk0p1 bs=1M conv=fsync

7. Reboot the device. The stock bootloader loads kernel0 and boots the
   OpenWrt initramfs image. The AP has the default IP 192.168.1.1 now.

8. Copy the sysupgrade image to /tmp via SCP and install it from the
   initramfs system:

     sysupgrade -n /tmp/openwrt-qualcommbe-ipq53xx-ubnt_u7-pro-xgs-squashfs-sysupgrade.itb

Recovery
--------

1. Connect your computer to the AP network or directly to the data port
   on the PoE adapter.
2. Press and hold the Reset button until the LED flashes white, blue,
   off.
3. Use TFTP to upload the downgrade image to 192.168.1.20:

     tftp 192.168.1.20
     binary
     rexmt 1
     timeout 60
     put /path/to/BZ.ipq53xx_8.0.23+16670.250316.0909.bin

4. Wait for the AP to upgrade and reboot automatically.

Reference:
https://help.ui.com/hc/en-us/articles/360043360253-UniFi-Recovery-Mode

MAC address layout:
The all-zero local-mac-address is a placeholder that stock
U-Boot fills in via the ethernet1 alias.

Signed-off-by: Til Kaiser <[email protected]>