mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Yuugo Yoneda via B4 Relay <devnull+yogo.0917.sabu.gmail.com@kernel.org>
To: linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org
Cc: Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	 Conor Dooley <conor+dt@kernel.org>,
	Thomas Gleixner <tglx@kernel.org>,  Radu Rendec <radu@rendec.net>,
	Daniel Lezcano <daniel.lezcano@kernel.org>,
	 Dmitry Torokhov <dmitry.torokhov@gmail.com>,
	Ulf Hansson <ulfh@kernel.org>,
	 Adrian Hunter <adrian.hunter@intel.com>,
	Jonathan Corbet <corbet@lwn.net>,
	 Shuah Khan <skhan@linuxfoundation.org>,
	 Randy Dunlap <rdunlap@infradead.org>,
	Russell King <linux@armlinux.org.uk>,
	 Arnd Bergmann <arnd@arndb.de>,
	 Alexandre Belloni <alexandre.belloni@bootlin.com>,
	 Linus Walleij <linusw@kernel.org>,
	Drew Fustini <fustini@kernel.org>,
	 linux-kernel@vger.kernel.org, linux-input@vger.kernel.org,
	 linux-mmc@vger.kernel.org, linux-doc@vger.kernel.org,
	soc@lists.linux.dev
Subject: [PATCH RFC v2 11/13] ARM: at550: add SiRF AT550 platform support
Date: Sat, 21 Nov 2026 21:43:21 +0900	[thread overview]
Message-ID: <20261121-at550-rfc-v1-v2-11-b0309d0789b2@gmail.com> (raw)
In-Reply-To: <20261121-at550-rfc-v1-v2-0-b0309d0789b2@gmail.com>

From: Yuugo Yoneda <yogo.0917.sabu@gmail.com>

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@gmail.com>
---
 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@gmail.com>
 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



  parent reply	other threads:[~2026-11-21 12:43 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-11-21 12:43 [PATCH RFC v2 00/13] SiRF AT550 / YPL514si initial RAM-boot " Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 01/13] dt-bindings: vendor-prefixes: add Yupiteru Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 02/13] dt-bindings: arm: add SiRF AT550 and Yupiteru YPL514si Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 03/13] dt-bindings: interrupt-controller: add SiRF AT550 interrupt controller Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 04/13] irqchip: add SiRF AT550 interrupt controller driver Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 05/13] dt-bindings: timer: add SiRF AT550 system timer Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 06/13] clocksource/drivers/timer-at550: add SiRF AT550 counter and match timer Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 07/13] dt-bindings: input: touchscreen: add SiRF AT550 touchscreen Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 08/13] Input: add polled SiRF AT550 resistive touchscreen driver Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 09/13] dt-bindings: mmc: add SiRF AT550 SDHCI host controller Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 10/13] mmc: sdhci-at550: add SiRF AT550 programmed-I/O host driver Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` Yuugo Yoneda via B4 Relay [this message]
2026-11-21 12:43 ` [PATCH RFC v2 12/13] ARM: dts: sirf: add SiRF AT550 SoC and Yupiteru YPL514si board Yuugo Yoneda via B4 Relay
2026-11-21 12:43 ` [PATCH RFC v2 13/13] ARM: configs: add at550_defconfig Yuugo Yoneda via B4 Relay

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20261121-at550-rfc-v1-v2-11-b0309d0789b2@gmail.com \
    --to=devnull+yogo.0917.sabu.gmail.com@kernel.org \
    --cc=adrian.hunter@intel.com \
    --cc=alexandre.belloni@bootlin.com \
    --cc=arnd@arndb.de \
    --cc=conor+dt@kernel.org \
    --cc=corbet@lwn.net \
    --cc=daniel.lezcano@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=dmitry.torokhov@gmail.com \
    --cc=fustini@kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=linusw@kernel.org \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-input@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-mmc@vger.kernel.org \
    --cc=linux@armlinux.org.uk \
    --cc=radu@rendec.net \
    --cc=rdunlap@infradead.org \
    --cc=robh@kernel.org \
    --cc=skhan@linuxfoundation.org \
    --cc=soc@lists.linux.dev \
    --cc=tglx@kernel.org \
    --cc=ulfh@kernel.org \
    --cc=yogo.0917.sabu@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®