aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHaren Myneni <haren@linux.vnet.ibm.com>2019-10-26 01:47:35 -0700
committerOliver O'Halloran <oohall@gmail.com>2019-11-05 19:39:16 +1100
commitad8cdd0f83bf55e9717326afb7af6eeedb33e031 (patch)
treec1751e19b530eb692712c6ab6db2ebef2aa2f322 /doc
parentc3bfa320955967c943348dc526828de3d278fdbc (diff)
downloadskiboot-ad8cdd0f83bf55e9717326afb7af6eeedb33e031.zip
skiboot-ad8cdd0f83bf55e9717326afb7af6eeedb33e031.tar.gz
skiboot-ad8cdd0f83bf55e9717326afb7af6eeedb33e031.tar.bz2
VAS: Alloc IRQ and port address for each VAS instance
Setup IRQ and trigger port for each VAS instance. Export these values through device-tree with 'interrupts' and 'ibm,vas-port' properties in each VAS device node. Kernel setup IRQ and register port address for each send window. Enable 'vas-user-space' NVRAM config to allocate IRQ sources and provide 'interrupts' property. nvram -p ibm,skiboot --update-config vas-user-space=enable Signed-off-by: Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com> Signed-off-by: Haren Myneni <haren@us.ibm.com> Signed-off-by: Oliver O'Halloran <oohall@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/device-tree/vas.rst6
-rw-r--r--doc/vas.rst15
2 files changed, 21 insertions, 0 deletions
diff --git a/doc/device-tree/vas.rst b/doc/device-tree/vas.rst
index 438e45f..7c11c78 100644
--- a/doc/device-tree/vas.rst
+++ b/doc/device-tree/vas.rst
@@ -18,6 +18,12 @@ Each VAS node contains: ::
ibm,vas-id: unique identifier for each instance of VAS in the system.
+ ibm,vas-port: Port address for the interrupt.
+
+ interrupts: <IRQ# level> for this VAS instance.
+
+ interrupt-parent: Interrupt controller phandle.
+
reg: contains 8 64-bit fields.
Fields [0] and [1] represent the Hypervisor window context BAR
diff --git a/doc/vas.rst b/doc/vas.rst
new file mode 100644
index 0000000..5ec6593
--- /dev/null
+++ b/doc/vas.rst
@@ -0,0 +1,15 @@
+Virtual Accelerator Switchboard (VAS)
+
+This document provides information about using VAS from user space.
+Applications send NX requests using COPY/PASTE instructions. NX raises
+an interrupt when it sees fault on the request buffer. Kernel handles
+the interrupt and process the fault.
+
+Skiboot allocates the IRQ and exports it with interrupts property. To
+provide backward compatibility for older kernels, enable VAS user space
+support with NVRAM command.
+
+ nvram -p ibm,skiboot --update-config vas-user-space=enable
+
+This nvram config update is temporary and can be removed in future if
+not needed.