[PATCH RFC v2 11/13] ARM: at550: add SiRF AT550 platform support
From: Yuugo Yoneda via B4 Relay
Date: Sat Nov 21 2026 - 07:43:49 EST
From: Yuugo Yoneda <yogo.0917.sabu@xxxxxxxxx>
Add minimal Devicetree machine support for the SiRF AT550 SoC, selecting
CPU_ARM1136R1 (matching MIDR 0x4117b365) alongside ARM_ERRATA_411920,
AT550_IRQ, and CLKSRC_AT550.
Document the RAM-boot firmware handoff contract and initial platform
limits in Documentation/arch/arm/at550.rst.
Signed-off-by: Yuugo Yoneda <yogo.0917.sabu@xxxxxxxxx>
---
Documentation/arch/arm/at550.rst | 56 ++++++++++++++++++++++++++++++++++++++++
Documentation/arch/arm/index.rst | 1 +
MAINTAINERS | 2 ++
arch/arm/Kconfig | 1 +
arch/arm/Makefile | 1 +
arch/arm/mach-at550/Kconfig | 13 ++++++++++
arch/arm/mach-at550/Makefile | 2 ++
arch/arm/mach-at550/at550.c | 11 ++++++++
8 files changed, 87 insertions(+)
diff --git a/Documentation/arch/arm/at550.rst b/Documentation/arch/arm/at550.rst
new file mode 100644
index 000000000..3d1d8a77c
--- /dev/null
+++ b/Documentation/arch/arm/at550.rst
@@ -0,0 +1,56 @@
+.. SPDX-License-Identifier: GPL-2.0-only
+
+SiRF AT550 and Yupiteru YPL514si
+================================
+
+The initial AT550 port supports the ARM1136 CPU, the 64-source interrupt
+controller, the low 32 bits of the system counter and match channel zero,
+polled resistive touch input, and SDHCI programmed I/O. The YPL514si board
+can use a firmware-configured 480 by 272 RGB565 simple framebuffer.
+
+Firmware handoff
+----------------
+
+Use the standard ARM boot protocol and a flattened device tree. Firmware must
+initialize SDRAM, peripheral clocks, and pin multiplexing before entering the
+kernel. No firmware-specific virtual mappings or page-table inspection are
+used by the Linux drivers.
+
+The bootloader must update the following parts of the board device tree:
+
+* Supply the actual Linux-owned region in the memory node. The zero size in
+ the source DTS is a placeholder, not a description of all installed memory.
+ RAM still owned by another operating system must not be advertised to Linux.
+* Set the fixed counter clock frequency to the rate after the programmed
+ hardware divider. The driver deliberately does not reset the counter or
+ change the divider. A zero rate is rejected.
+* Disable the timer watchdog before handing the timer block to Linux.
+* Enable the simple framebuffer only when its physical address, dimensions,
+ stride, and format have been verified. Reserve its memory with a no-map
+ reserved-memory node so simplefb does not alias the ARM linear mapping.
+* Enable the touch and SD nodes only for peripherals actually handed to Linux.
+ The touchscreen driver rejects an active streaming/AUX configuration.
+
+A Windows CE RAM loader is one possible bootloader. Its allocation checks,
+volatile driver registration, MMU transition, and DT fixups are outside the
+kernel port. The Linux Image and all its runtime memory must fit inside the
+region returned to the kernel; a static firmware RAM mapping is insufficient
+proof that memory is available.
+
+Initial limits
+--------------
+
+The port depends on firmware clock and pin setup; cold reset initialization
+and clock-tree programming are not implemented. Board suspend is disabled in
+the defconfig because firmware state restoration has not been established.
+
+DMA address translation has not been validated, so the SDHCI driver uses PIO.
+The YPL514si DT disables MMC and SDIO discovery and limits SD to 25 MHz and
+3.3 V. Filesystem write support, card removal, and suspend/resume require
+separate hardware validation. No flash or bootloader update is required to
+use the RAM boot path.
+
+The touchscreen exports raw coordinates. Initial five-point affine calibration
+is performed in userspace, rather than placing a board-specific transform in
+the input driver. GPS/baseband, USB, UART, and native LCD modesetting are not
+part of the initial support.
diff --git a/Documentation/arch/arm/index.rst b/Documentation/arch/arm/index.rst
index b15621093..9cf1fb834 100644
--- a/Documentation/arch/arm/index.rst
+++ b/Documentation/arch/arm/index.rst
@@ -62,6 +62,7 @@ SoC-specific documents
stm32/stm32mp157-overview
stm32/stm32-dma-mdma-chaining
+ at550
sunxi
samsung/index
diff --git a/MAINTAINERS b/MAINTAINERS
index 9d02a79a2..1f9c8c08b 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -25850,11 +25850,13 @@ F: include/trace/events/siox.h
SIRF AT550 PLATFORM
M: Yuugo Yoneda <yogo.0917.sabu@xxxxxxxxx>
S: Odd Fixes
+F: Documentation/arch/arm/at550.rst
F: Documentation/devicetree/bindings/arm/sirf,at550.yaml
F: Documentation/devicetree/bindings/input/touchscreen/sirf,at550-ts.yaml
F: Documentation/devicetree/bindings/interrupt-controller/sirf,at550-intc.yaml
F: Documentation/devicetree/bindings/mmc/sirf,at550-sdhci.yaml
F: Documentation/devicetree/bindings/timer/sirf,at550-timer.yaml
+F: arch/arm/mach-at550/
F: drivers/clocksource/timer-at550.c
F: drivers/input/touchscreen/at550-ts.c
F: drivers/irqchip/irq-at550.c
diff --git a/arch/arm/Kconfig b/arch/arm/Kconfig
index 0cc289a71..7fcf2a28f 100644
--- a/arch/arm/Kconfig
+++ b/arch/arm/Kconfig
@@ -367,6 +367,7 @@ source "arch/arm/mach-artpec/Kconfig"
source "arch/arm/mach-aspeed/Kconfig"
+source "arch/arm/mach-at550/Kconfig"
source "arch/arm/mach-at91/Kconfig"
source "arch/arm/mach-axxia/Kconfig"
diff --git a/arch/arm/Makefile b/arch/arm/Makefile
index 573813ef5..508cbad8b 100644
--- a/arch/arm/Makefile
+++ b/arch/arm/Makefile
@@ -176,6 +176,7 @@ machine-$(CONFIG_ARCH_ACTIONS) += actions
machine-$(CONFIG_ARCH_ALPINE) += alpine
machine-$(CONFIG_ARCH_ARTPEC) += artpec
machine-$(CONFIG_ARCH_ASPEED) += aspeed
+machine-$(CONFIG_ARCH_AT550) += at550
machine-$(CONFIG_ARCH_AT91) += at91
machine-$(CONFIG_ARCH_AXXIA) += axxia
machine-$(CONFIG_ARCH_BCM) += bcm
diff --git a/arch/arm/mach-at550/Kconfig b/arch/arm/mach-at550/Kconfig
new file mode 100644
index 000000000..b3a0c1874
--- /dev/null
+++ b/arch/arm/mach-at550/Kconfig
@@ -0,0 +1,13 @@
+# SPDX-License-Identifier: GPL-2.0-only
+config ARCH_AT550
+ bool "SiRF AT550 platforms"
+ depends on ARCH_MULTI_V6
+ select ARM_ERRATA_411920
+ select AT550_IRQ
+ select CLKSRC_AT550
+ select CPU_ARM1136R1
+ help
+ Support SiRF AT550 systems, including the Yupiteru YPL514si.
+ The initial support uses firmware-configured peripheral clocks,
+ pin multiplexing and SDRAM. A bootloader-supplied device tree must
+ describe the usable RAM region and the divided counter clock rate.
diff --git a/arch/arm/mach-at550/Makefile b/arch/arm/mach-at550/Makefile
new file mode 100644
index 000000000..98a51d234
--- /dev/null
+++ b/arch/arm/mach-at550/Makefile
@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: GPL-2.0-only
+obj-y += at550.o
diff --git a/arch/arm/mach-at550/at550.c b/arch/arm/mach-at550/at550.c
new file mode 100644
index 000000000..affcc9eb3
--- /dev/null
+++ b/arch/arm/mach-at550/at550.c
@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: GPL-2.0-only
+#include <asm/mach/arch.h>
+
+static const char *const at550_dt_compat[] __initconst = {
+ "sirf,at550",
+ NULL,
+};
+
+DT_MACHINE_START(AT550_DT, "SiRF AT550")
+ .dt_compat = at550_dt_compat,
+MACHINE_END
--
2.56.0