[RFC PATCH v2 0/7] Add support for ZTE zx297520v3
Stefan Dösinger
stefandoesinger at gmail.com
Wed Jan 28 12:34:48 PST 2026
Hi,
In the past few weeks I worked on booting my own kernel on ZTE/Sanechip's
zx297520v3 SoC. This SoC is a relative of the zx296718 that was once
supported by the kernel. It is in use in a lot of LTE to WiFi routers in
Africa, China and Eastern Europe, although some devices were sold or
distributed by ISPs in the EU too. My goal is to make OpenWRT run on these
devices.
I would like to ask for comments on these 7 patches to make sure they are
going in the right direction. They are the bare minimum to get the kernel
to start and run an interactive busybox on the UART.
Here are a few questions that I couldn't answer myself:
1) The GIC is a GICv3, but there are some extra registers (probably on a
different chip) to switch PPIs and SPIs between level high/level low or
rising edge/falling edge. The only device where this matters appears to
the timer. It uses level low IRQs, but the GIC has PPIs configured to
level-high by default. By setting some non-standard registers, I can get
the PPIs to level-low and the timer works OK. Is there any precedence on
how to handle this? I am tempted to make a zte,zx29-gic-v3 .compatible
glue that sets the PPIs to level-low on init.
2) The boot loader doesn't set up the secure/non-secure world properly and
doesn't enable register access to the GIC CPU interface. I found the
Raspberry Pi 3 boot stub as a good guidance and put sample code in
Documentation/arch/arm/zte/zx297520v3.rst . An e.g. OpenWRT build for this
device would have to include a similar setup sequence that it runs from
U-Boot before jumping to the kernel. Did I miss any alternatives here?
3) The SoC has clock and reset controls in the same MMIO space, even the
same 32 bit registers. What is the preferred way to handle this? Two
separate clk and reset drivers that write into the same place? One
multifunction driver that exposes clock and resets? One syscon that
contains the reg values and two separate clk and reset drivers that
consume the syscon?
4) The CPU is a Cortex A53 running in arm32 mode (in the shipped firmware
too). It doesn't appear to have an FPU. Reading FPSID results in an
exception (so vfpmodule.c/vfp_init says VFP is not available). I tried
enabling p10 and p11 in NSACR, but without success. NSACR seems to always
read 0 too. Is this really a Cortex A53 without FPU or did I miss
something?
5) Relatedly, are there any advantages to running in arm64 mode? The
devices are relatively memory constrained (64mb), so the larger binary
size from 64 bit pointers is probably a negative, while the larger
register set might be a positive. I doubt switching to arm64 mode is
possible at all, but I'm nevertheless curious.
6) The old removed zx29 code used "zte," as the vendor for the
compatibles. Sanechips is a subsidiary of ZTE that designed these chips.
Are there any preferences for either "zte," or "sanechips,"?
As for the rest of the hardware, my entire patchset can be found here:
https://gitlab.com/stefandoesinger/zx297520-kernel/ . So far 3 people from
the OpenWRT community are helping with testing on different routers (Tecno
TR118, ZTE K10, ZLT S10 in addition to my D-Link DWR932 and HGSD R310).
USB: Standard dwc2 WiFi: rtl8192, but in the SDIO version. I hacked sdio
into rtl8xxxu but it'll need major cleanup. ethernet: STMicro stmmac. ZTE
wrote their own driver for it. I spent a week re-implementing it before I
was able to match the HW to stmmac. SDIO: standard dw-mshc NAND: A 128 MB
SPI NAND chip connected to a homebrew QSPI controller. The driver is
copypasta from stm32-qspi, but the hardware registers seem incompatible
LTE: A Cortex M0 is doing the heavy lifting and talks to the main CPU via
RPMsg. I hope to be able to handle this in userspace, but I haven't looked
into it yet. clk, pinctrl, pmdomain: My own code based on the zx2967xx
code.
Patch changelog v2: checkpatch.pl fixes.
Stefan Dösinger (7):
ARM: zte: Add zx297520v3 platform support.
dt-bindings: arm: Add zx297520v3 board binding.
ARM: dts: Add D-Link DWR-932M support.
ARM: zte: Add support for zx29 low level debug.
ARM: dts: Add an armv7 timer for zx297520v3.
ARM: zte: Bring back ZX29 UART support.
ARM: dts: Declare UART1 on zx297520v3 boards.
Documentation/arch/arm/zte/zx297520v3.rst | 106 ++++++++++++++++++
.../devicetree/bindings/arm/zx29.yaml | 20 ++++
MAINTAINERS | 6 +
arch/arm/Kconfig | 2 +
arch/arm/Kconfig.debug | 12 ++
arch/arm/Makefile | 1 +
arch/arm/boot/dts/Makefile | 1 +
arch/arm/boot/dts/zte/Makefile | 3 +
arch/arm/boot/dts/zte/dlink-dwr-932m.dts | 21 ++++
arch/arm/boot/dts/zte/zx297520v3.dtsi | 83 ++++++++++++++
arch/arm/include/debug/pl01x.S | 7 ++
arch/arm/mach-zte/Kconfig | 23 ++++
arch/arm/mach-zte/Makefile | 2 +
arch/arm/mach-zte/zx297520v3.c | 19 ++++
drivers/tty/serial/amba-pl011.c | 37 ++++++
include/linux/amba/bus.h | 6 +
16 files changed, 349 insertions(+)
create mode 100644 Documentation/arch/arm/zte/zx297520v3.rst
create mode 100644 Documentation/devicetree/bindings/arm/zx29.yaml
create mode 100644 arch/arm/boot/dts/zte/Makefile
create mode 100644 arch/arm/boot/dts/zte/dlink-dwr-932m.dts
create mode 100644 arch/arm/boot/dts/zte/zx297520v3.dtsi
create mode 100644 arch/arm/mach-zte/Kconfig
create mode 100644 arch/arm/mach-zte/Makefile
create mode 100644 arch/arm/mach-zte/zx297520v3.c
base-commit: 7d0a66e4bb9081d75c82ec4957c50034cb0ea449
--
2.52.0
More information about the linux-arm-kernel
mailing list