From: richard.gong@linux.intel.com
To: gregkh@linuxfoundation.org, catalin.marinas@arm.com,
will.deacon@arm.com, dinguyen@kernel.org, robh+dt@kernel.org,
mark.rutland@arm.com, atull@kernel.org, mdf@kernel.org,
arnd@arndb.de, corbet@lwn.net
Cc: linux-arm-kernel@lists.infradead.org,
linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
linux-fpga@vger.kernel.org, linux-doc@vger.kernel.org,
yves.vandervennet@linux.intel.com, richard.gong@intel.com
Subject: [PATCHv7 8/9] Documentation: driver-api: add stratix10 service layer
Date: Wed, 18 Jul 2018 11:18:43 -0500 [thread overview]
Message-ID: <1531930724-22061-9-git-send-email-richard.gong@linux.intel.com> (raw)
In-Reply-To: <1531930724-22061-1-git-send-email-richard.gong@linux.intel.com>
From: Richard Gong <richard.gong@intel.com>
Add new file stratix10-svc.rst
Add stratix10-svc.rst to driver-api/index.rst
Signed-off-by: Richard Gong <richard.gong@intel.com>
Signed-off-by: Alan Tull <atull@kernel.org>
---
v5: this patch is added in patch set version 5
v6: no change
v7: no change
---
Documentation/driver-api/index.rst | 1 +
Documentation/driver-api/stratix10-svc.rst | 32 ++++++++++++++++++++++++++++++
2 files changed, 33 insertions(+)
create mode 100644 Documentation/driver-api/stratix10-svc.rst
diff --git a/Documentation/driver-api/index.rst b/Documentation/driver-api/index.rst
index 6d9f2f9..d4d2671 100644
--- a/Documentation/driver-api/index.rst
+++ b/Documentation/driver-api/index.rst
@@ -53,6 +53,7 @@ available subsections can be seen below.
slimbus
soundwire/index
fpga/index
+ stratix10-svc
.. only:: subproject and html
diff --git a/Documentation/driver-api/stratix10-svc.rst b/Documentation/driver-api/stratix10-svc.rst
new file mode 100644
index 0000000..ed361d8
--- /dev/null
+++ b/Documentation/driver-api/stratix10-svc.rst
@@ -0,0 +1,32 @@
+
+Intel Stratix10 SoC Service Layer
+=================================
+
+Some features of the Intel Stratix10 SoC require a level of privilege
+higher than the kernel is granted. Such secure features include
+FPGA programming. In terms of the ARMv8 architecture, the kernel runs
+at Exception Level 1 (EL1), access to the features requires
+Exception Level 3 (EL3).
+
+The Intel Stratix10 SoC service layer provides an in kernel API for
+drivers to request access to the secure features. The requests are queued
+and processed one by one. ARM’s SMCCC is used to pass the execution
+of the requests on to a secure monitor (EL3).
+
+.. kernel-doc:: include/linux/stratix10-svc-client.h
+ :functions: stratix10_svc_command_code
+
+.. kernel-doc:: include/linux/stratix10-svc-client.h
+ :functions: stratix10_svc_client_msg
+
+.. kernel-doc:: include/linux/stratix10-svc-client.h
+ :functions: stratix10_svc_command_reconfig_payload
+
+.. kernel-doc:: include/linux/stratix10-svc-client.h
+ :functions: stratix10_svc_cb_data
+
+.. kernel-doc:: include/linux/stratix10-svc-client.h
+ :functions: stratix10_svc_client
+
+.. kernel-doc:: drivers/misc/stratix10-svc.c
+ :export:
--
2.7.4
next prev parent reply other threads:[~2018-07-18 16:17 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-18 16:18 [PATCHv7 0/9] Add Intel Stratix10 FPGA manager and service layer richard.gong
2018-07-18 16:18 ` [PATCHv7 1/9] dt-bindings, firmware: add Intel Stratix10 service layer binding richard.gong
2018-07-18 16:18 ` [PATCHv7 2/9] arm64: dts: stratix10: add stratix10 service driver binding to base dtsi richard.gong
2018-07-18 16:18 ` [PATCHv7 3/9] misc: add Intel Stratix10 service layer driver richard.gong
2018-07-18 16:18 ` [PATCHv7 4/9] dt-bindings: fpga: add Stratix10 SoC FPGA manager binding richard.gong
2018-07-18 16:18 ` [PATCHv7 5/9] arm64: dts: stratix10: add fpga manager and region richard.gong
2018-07-18 16:18 ` [PATCHv7 6/9] fpga: add intel stratix10 soc fpga manager driver richard.gong
2018-07-23 16:38 ` Moritz Fischer
2018-07-18 16:18 ` [PATCHv7 7/9] defconfig: enable fpga and service layer richard.gong
2018-07-18 16:18 ` richard.gong [this message]
2018-07-18 16:18 ` [PATCHv7 9/9] misc: add remote status update client support richard.gong
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=1531930724-22061-9-git-send-email-richard.gong@linux.intel.com \
--to=richard.gong@linux.intel.com \
--cc=arnd@arndb.de \
--cc=atull@kernel.org \
--cc=catalin.marinas@arm.com \
--cc=corbet@lwn.net \
--cc=devicetree@vger.kernel.org \
--cc=dinguyen@kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fpga@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=mdf@kernel.org \
--cc=richard.gong@intel.com \
--cc=robh+dt@kernel.org \
--cc=will.deacon@arm.com \
--cc=yves.vandervennet@linux.intel.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;
as well as URLs for NNTP newsgroup(s).