openwrt/target/linux
Michael Pratt fe2f53f21c ath79: add support for Senao Engenius EnStationAC v1
FCC ID: A8J-ENSTAC

Engenius EnStationAC v1 is an outdoor wireless access point/bridge with
2 gigabit ethernet ports on 2 external ethernet switches,
5 GHz only wireless, internal antenna plates, and proprietery PoE.

Specification:

  - QCA9557 SOC
  - QCA9882 WLAN		(PCI card, 5 GHz, 2x2, 26dBm)
  - AR8035-A switch		(RGMII GbE with PoE+ IN)
  - AR8031 switch		(SGMII GbE with PoE OUT)
  - 40 MHz reference clock
  - 16 MB FLASH			MX25L12845EMI-10G
  - 2x 64 MB RAM		NT5TU32M16FG
  - UART at J10			(unpopulated)
  - internal antenna plates	(19 dbi, directional)
  - 7 LEDs, 1 button		(power, eth, wlan, RSSI) (reset)

MAC addresses:

  MAC addresses are labeled as ETH and 5GHz
  Vendor MAC addresses in flash are duplicate

  eth0	ETH	*:d3	art 0x0/0x6
  eth1	----	*:d4	---
  phy0	5GHz	*:d5	---

Installation:

  2 ways to flash factory.bin from OEM:

  - if you get Failsafe Mode from failed flash:
      only use it to flash Original firmware from Engenius
      or risk kernel loop or halt which requires serial cable

  Method 1: Firmware upgrade page:

    OEM webpage at 192.168.1.1
    username and password "admin"
    Navigate to "Firmware" page from left pane
    Click Browse and select the factory.bin image
    Upload and verify checksum
    Click Continue to confirm and wait 3 minutes

  Method 2: Serial to load Failsafe webpage:

    After connecting to serial console and rebooting...
    Interrupt uboot with any key pressed rapidly
    execute `run failsafe_boot` OR `bootm 0x9fd70000`
    wait a minute
    connect to ethernet and navigate to
    "192.168.1.1/index.htm"
    Select the factory.bin image and upload
    wait about 3 minutes

Return to OEM:

  If you have a serial cable, see Serial Failsafe instructions
  otherwise, uboot-env can be used to make uboot load the failsafe image

  *DISCLAIMER*
  The Failsafe image is unique to Engenius boards.
  If the failsafe image is missing or damaged this will not work
  DO NOT downgrade to ar71xx this way, it can cause kernel loop or halt

  ssh into openwrt and run
  `fw_setenv rootfs_checksum 0`
  reboot, wait 3 minutes
  connect to ethernet and navigate to 192.168.1.1/index.htm
  select OEM firmware image from Engenius and click upgrade

TFTP recovery:

  rename initramfs to 'vmlinux-art-ramdisk'
  make available on TFTP server at 192.168.1.101
  power board
  hold or press reset button repeatedly

  NOTE: for some Engenius boards TFTP is not reliable
  try setting MTU to 600 and try many times

Format of OEM firmware image:

  The OEM software of EnStationAC is a heavily modified version
  of Openwrt Altitude Adjustment 12.09. One of the many modifications
  is to the sysupgrade program. Image verification is performed
  simply by the successful ungzip and untar of the supplied file
  and name check and header verification of the resulting contents.
  To form a factory.bin that is accepted by OEM Openwrt build,
  the kernel and rootfs must have specific names...

    openwrt-ar71xx-enstationac-uImage-lzma.bin
    openwrt-ar71xx-enstationac-root.squashfs

  and begin with the respective headers (uImage, squashfs).
  Then the files must be tarballed and gzipped.
  The resulting binary is actually a tar.gz file in disguise.
  This can be verified by using binwalk on the OEM firmware images,
  ungzipping then untaring.

  Newer EnGenius software requires more checks but their script
  includes a way to skip them, otherwise the tar must include
  a text file with the version and md5sums in a deprecated format.

  The OEM upgrade script is at /etc/fwupgrade.sh.

  OKLI kernel loader is required because the OEM software
  expects the kernel to be no greater than 1536k
  and the factory.bin upgrade procedure would otherwise
  overwrite part of the kernel when writing rootfs.

Note on PLL-data cells:

  The default PLL register values will not work
  because of the external AR8033 switch between
  the SOC and the ethernet PHY chips.

  For QCA955x series, the PLL registers for eth0 and eth1
  can be see in the DTSI as 0x28 and 0x48 respectively.
  Therefore the PLL registers can be read from uboot
  for each link speed after attempting tftpboot
  or another network action using that link speed
  with `md 0x18050028 1` and `md 0x18050048 1`.

  For eth0 at 1000 speed, the value returned was
  ae000000 but that didn't work, so following
  the logical pattern from the rest of the values,
  the guessed value of a3000000 works better.

  later discovered that delay can be placed on the PHY end only
  with phy-mode as 'rgmii-id' and set register to 0x82...

Tested from master, all link speeds functional

Signed-off-by: Michael Pratt <mcpratt@pm.me>
[fixed SoB to match From:]
Signed-off-by: Petr Štetiar <ynezz@true.cz>
2020-12-22 19:11:50 +01:00
..
apm821xx apm821xx: Netgear WNDR4700 limit kernel lzma dictionary 2020-12-22 19:11:50 +01:00
arc770 arc770: drop support for kernel 4.14 2020-09-02 16:29:22 +02:00
archs38 treewide: use wpad-basic-wolfssl as default 2020-08-20 14:19:39 +02:00
armvirt armvirt: README: rename it from LEDE to OpenWrt 2020-12-14 21:38:10 +00:00
at91 kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
ath25 ath25: fix preinit Ethernet port configuration 2020-09-10 18:52:15 +02:00
ath79 ath79: add support for Senao Engenius EnStationAC v1 2020-12-22 19:11:50 +01:00
bcm27xx kernel: bump 5.4 to 5.4.85 2020-12-22 19:11:50 +01:00
bcm47xx kernel: bump 5.4 to 5.4.80 2020-11-26 11:17:55 +01:00
bcm53xx kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
bcm63xx kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
gemini kernel: remove support for kernel 4.19 2020-10-30 19:29:59 +01:00
generic kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
imx6 kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
ipq40xx ipq40xx: add support for Plasma Cloud PA2200 2020-12-22 19:11:50 +01:00
ipq806x ipq806x: disable SPC of IPQ8064 on NEC WG2600HP to fix boot issue 2020-12-22 19:11:50 +01:00
ipq807x kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
kirkwood kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
lantiq kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
layerscape kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
malta kernel: remove support for kernel 4.19 2020-10-30 19:29:59 +01:00
mediatek kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
mpc85xx kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
mvebu kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
mxs treewide: make dependency on kmod-usb-net selective 2020-08-10 12:54:30 +02:00
octeon kernel: bump 5.4 to 5.4.75 2020-11-10 13:11:32 +01:00
octeontx kernel: move F2FS_FS_XATTR and F2FS_STAT_FS symbols to generic 2020-10-09 23:20:19 +01:00
omap kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
oxnas kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
pistachio kernel: move some disabled symbols to generic 2020-12-22 19:11:50 +01:00
ramips ramips: add support for D-Link DIR-882 R1 2020-12-22 19:11:50 +01:00
realtek realtek: use kernel defined halt 2020-12-22 19:11:50 +01:00
rockchip kernel: bump 5.4 to 5.4.85 2020-12-22 19:11:50 +01:00
sunxi sunxi: add support for Libre Computer ALL-H3-CC H5 2020-11-12 18:21:17 +01:00
tegra tegra: image: remove unnecessary assumptions from bootscript 2020-12-22 18:59:10 +01:00
uml kernel: bump 5.4 to 5.4.71 2020-10-15 17:46:54 +02:00
x86 x86: enable CONFIG_MMC_SDHCI_ACPI for x86_64 2020-12-03 23:51:07 -10:00
zynq kernel: remove support for kernel 4.19 2020-10-30 19:29:59 +01:00
Makefile build: add 'make kernel_xconfig' command 2020-07-08 16:07:05 +02:00