immortalwrt/target/linux
Michael Pratt 6de9287abd ath79: add support for Senao Engenius EAP1750H
FCC ID: A8J-EAP1750H

Engenius EAP1750H is an indoor wireless access point with
1 Gb ethernet port, dual-band wireless,
internal antenna plates, and 802.3at PoE+

**Specification:**

  - QCA9558 SOC
  - QCA9880 WLAN	PCI card, 5 GHz, 3x3, 26dBm
  - AR8035-A PHY	RGMII GbE with PoE+ IN
  - 40 MHz clock
  - 16 MB FLASH		MX25L12845EMI-10G
  - 2x 64 MB RAM	NT5TU32M16FG
  - UART at J10		populated
  - 4 internal antenna plates (5 dbi, omni-directional)
  - 5 LEDs, 1 button (power, eth0, 2G, 5G, WPS) (reset)

**MAC addresses:**

  MAC addresses are labeled as ETH, 2.4G, and 5GHz
  Only one Vendor MAC address in flash

  eth0 ETH  *:fb art 0x0
  phy1 2.4G *:fc ---
  phy0 5GHz *:fd ---

**Serial Access:**

  the RX line on the board for UART is shorted to ground by resistor R176
  therefore it must be removed to use the console
  but it is not necessary to remove to view boot log

  optionally, R175 can be replaced with a solder bridge short

  the resistors R175 and R176 are next to the UART RX pin at J10

**Installation:**

  2 ways to flash factory.bin from OEM:

  Method 1: Firmware upgrade page:

    OEM webpage at 192.168.1.1
    username and password "admin"
    Navigate to "Firmware Upgrade" 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

  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:**

  Requires serial console, reset button does nothing

  rename initramfs to 'vmlinux-art-ramdisk'
  make available on TFTP server at 192.168.1.101
  power board, interrupt boot
  execute tftpboot and bootm 0x81000000

  NOTE: TFTP is not reliable due to bugged bootloader
  set MTU to 600 and try many times
  if your TFTP server supports setting block size
  higher block size is better.

**Format of OEM firmware image:**

  The OEM software of EAP1750H is a heavily modified version
  of Openwrt Kamikaze. 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-generic-eap1750h-uImage-lzma.bin
    openwrt-ar71xx-generic-eap1750h-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 AR8035 switch between
  the SOC and the ethernet port.

  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`.

  The clock delay required for RGMII can be applied
  at the PHY side, using the at803x driver `phy-mode`.
  Therefore the PLL registers for GMAC0
  do not need the bits for delay on the MAC side.
  This is possible due to fixes in at803x driver
  since Linux 5.1 and 5.3

Signed-off-by: Michael Pratt <mcpratt@pm.me>
2022-11-27 13:18:29 +01:00
..
airoha airoha: fix imagebuilder generation by introducing generic target 2022-10-13 17:38:59 +02:00
apm821xx kernel: bump 5.10 to 5.10.154 2022-11-12 17:05:13 +01:00
archs38 kernel: remove target specific CONFIG_IKCONFIG lines 2022-10-14 13:15:47 +02:00
armvirt kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
at91 at91: Remove CONFIG_PINCTRL_MCP23S08 configuration option 2022-10-31 00:46:15 +01:00
ath25 kernel: bump 5.10 to 5.10.137 2022-08-23 10:37:04 +02:00
ath79 ath79: add support for Senao Engenius EAP1750H 2022-11-27 13:18:29 +01:00
bcm27xx kernel: bump 5.15 to 5.15.80 2022-11-27 13:18:29 +01:00
bcm47xx mac80211: remove old legacy legacy drivers 2022-11-09 20:44:28 +01:00
bcm53xx bcm53xx: update DTS files with the latest changes 2022-11-10 09:51:25 +01:00
bcm63xx kernel: bump 5.15 to 5.15.62 2022-08-23 10:37:04 +02:00
bcm4908 treewide: uniform vendor name for ASUS 2022-11-16 23:30:11 +01:00
bmips kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
gemini kernel: Activate CONFIG_GPIOLIB in generic configuration 2022-08-10 21:36:17 +02:00
generic kernel: bump 5.10 to 5.10.156 2022-11-27 13:18:29 +01:00
imx cypress-nvram: consolidate NVRAM packages 2022-11-16 20:14:13 +01:00
ipq40xx ipq40xx: remove '-fit' string from kernel filenames 2022-11-24 16:46:28 +00:00
ipq806x ipq806x: disable cache and fabric devfreq driver to improve stability 2022-11-26 00:38:31 +01:00
kirkwood kernel: remove hack patch, move kirkwood specific kmods to target modules.mk 2022-09-30 12:59:19 +02:00
lantiq lantiq: xway: kernel: enable SMP support 2022-11-18 20:27:52 +01:00
layerscape layerscape: armv8_64b: add CONFIG_ARM64_ERRATUM_1742098 2022-10-30 17:54:59 +01:00
malta kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
mediatek kernel: bump 5.15 to 5.15.80 2022-11-27 13:18:29 +01:00
mpc85xx mpc85xx: fix missing kernel config symbol 2022-11-16 23:30:11 +01:00
mvebu mvebu: cortexa72: add CONFIG_ARM64_ERRATUM_1742098 2022-10-30 17:55:00 +01:00
mxs target/mxs: replace gpio-mcp23s08 with pinctrl-mcp23s08 2022-10-30 23:14:45 +01:00
octeon kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
octeontx kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
omap kernel: remove target specific CONFIG_IKCONFIG lines 2022-10-14 13:15:47 +02:00
oxnas kernel: bump 5.15 to 5.15.75 2022-10-30 17:54:59 +01:00
pistachio kernel: backport support for "linux,rootfs" in DT 2022-11-08 09:12:16 +01:00
qoriq kernel: add missing symbol in generic config 2022-11-16 20:23:34 +02:00
ramips kernel: fix mtk_eth_soc issue when using secondary GMAC on MT7621/MT7622 2022-11-25 01:56:53 +01:00
realtek realtek: fix typo in debug message 2022-11-05 16:27:21 +01:00
rockchip rockchip: use LZMA FIT for kernel image 2022-11-14 22:50:21 +08:00
sunxi kernel: disable CONFIG_CPU_LITTLE_ENDIAN in generic config 2022-10-21 13:47:01 +02:00
tegra kernel: Move some IOMMU options to generic 2022-09-24 13:49:47 +02:00
uml kernel: bump 5.10 to 5.10.146 2022-10-02 20:21:55 +02:00
x86 kernel: bump 5.10 to 5.10.156 2022-11-27 13:18:29 +01:00
zynq kernel: remove target specific CONFIG_IKCONFIG lines 2022-10-14 13:15:47 +02:00
Makefile build: fix issues with targets installed via feeds 2022-09-27 13:41:12 +02:00