linux-kernel - [PATCH 6/6] Documentation: ABI: Document rzv2h

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20260121150137.3364865-7-prabhakar.mahadev-lad.rj@bp.renesas.com>
Date: Wed, 21 Jan 2026 15:01:37 +0000
From: Prabhakar <prabhakar.csengg@...il.com>
To: Thomas Gleixner <tglx@...nel.org>,
	Philipp Zabel <p.zabel@...gutronix.de>,
	Geert Uytterhoeven <geert+renesas@...der.be>,
	Magnus Damm <magnus.damm@...il.com>
Cc: linux-kernel@...r.kernel.org,
	linux-renesas-soc@...r.kernel.org,
	Prabhakar <prabhakar.csengg@...il.com>,
	Biju Das <biju.das.jz@...renesas.com>,
	Fabrizio Castro <fabrizio.castro.jz@...esas.com>,
	Lad Prabhakar <prabhakar.mahadev-lad.rj@...renesas.com>
Subject: [PATCH 6/6] Documentation: ABI: Document rzv2h_icu debugfs triggers

From: Lad Prabhakar <prabhakar.mahadev-lad.rj@...renesas.com>

Document the debugfs interface exported by the Renesas RZ/V2H ICU
driver to aid bring-up and debugging.

Describe the write-only swint and swpe files used to trigger software
and pseudo error interrupts.

Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@...renesas.com>
---
 .../ABI/testing/debugfs-renesas-rzv2h-icu     | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 Documentation/ABI/testing/debugfs-renesas-rzv2h-icu

diff --git a/Documentation/ABI/testing/debugfs-renesas-rzv2h-icu b/Documentation/ABI/testing/debugfs-renesas-rzv2h-icu
new file mode 100644
index 000000000000..8e97f35c3fea
--- /dev/null
+++ b/Documentation/ABI/testing/debugfs-renesas-rzv2h-icu
@@ -0,0 +1,24 @@
+What:		/sys/kernel/debug/rzv2h_icu/swint
+Date:		Jan 2026
+KernelVersion:	6.20
+Contact:	Lad Prabhakar <prabhakar.mahadev-lad.rj@...renesas.com>
+Description:	Write-only debugfs file to trigger ICU software interrupts
+		(ICU_SWINT) targeting CA55 cores.
+		Writing an integer CPU index 'N' causes the driver to write
+		BIT(N) to the ICU_SWINT register, which triggers the hardware
+		software interrupt routed to CA55 core N via the GIC.
+		Valid values:
+		  0..3  - trigger SWINT for CA55 core0..core3
+		The driver validates that the requested CPU is online before
+		triggering the interrupt. Writes for offline CPUs fail.
+
+What:		/sys/kernel/debug/rzv2h_icu/swpe
+Date:		Jan 2026
+KernelVersion:	6.20
+Contact:	Lad Prabhakar <prabhakar.mahadev-lad.rj@...renesas.com>
+Description:	Write-only debugfs file to trigger ICU software peripheral
+		events (ICU_SWPE).
+		Writing an integer index 'N' causes the driver to write BIT(N)
+		to the ICU_SWPE register.
+		Valid values:
+		  0..15 - assert SWPE bit 0..15
-- 
2.52.0