From: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.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@bp.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@bp.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@bp.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