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: [PATCHv8 8/9] Documentation: driver-api: add stratix10 service layer Date: Tue, 28 Aug 2018 08:50:44 -0500 [thread overview] Message-ID: <1535464245-11638-9-git-send-email-richard.gong@linux.intel.com> (raw) In-Reply-To: <1535464245-11638-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 v8: 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
WARNING: multiple messages have this Message-ID (diff)
From: richard.gong@linux.intel.com (richard.gong at linux.intel.com) To: linux-arm-kernel@lists.infradead.org Subject: [PATCHv8 8/9] Documentation: driver-api: add stratix10 service layer Date: Tue, 28 Aug 2018 08:50:44 -0500 [thread overview] Message-ID: <1535464245-11638-9-git-send-email-richard.gong@linux.intel.com> (raw) In-Reply-To: <1535464245-11638-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 v8: 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-08-28 13:48 UTC|newest] Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top 2018-08-28 13:50 [PATCHv8 0/9] Add Intel Stratix10 FPGA manager and service layer richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 1/9] dt-bindings, firmware: add Intel Stratix10 service layer binding richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 2/9] arm64: dts: stratix10: add stratix10 service driver binding to base dtsi richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 3/9] misc: add Intel Stratix10 service layer driver richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 4/9] dt-bindings: fpga: add Stratix10 SoC FPGA manager binding richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 5/9] arm64: dts: stratix10: add fpga manager and region richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 6/9] fpga: add intel stratix10 soc fpga manager driver richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 7/9] defconfig: enable fpga and service layer richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com 2018-08-28 14:11 ` Dinh Nguyen 2018-08-28 14:11 ` Dinh Nguyen 2018-08-30 14:05 ` Richard Gong 2018-08-30 14:05 ` Richard Gong 2018-08-28 13:50 ` richard.gong [this message] 2018-08-28 13:50 ` [PATCHv8 8/9] Documentation: driver-api: add stratix10 " richard.gong at linux.intel.com 2018-08-28 13:50 ` [PATCHv8 9/9] misc: add remote status update client support richard.gong 2018-08-28 13:50 ` richard.gong at linux.intel.com -- strict thread matches above, loose matches on Subject: below -- 2018-07-26 16:27 [PATCHv8 0/9] Add Intel Stratix10 FPGA manager and service layer richard.gong 2018-07-26 16:27 ` [PATCHv8 8/9] Documentation: driver-api: add stratix10 " richard.gong 2018-07-26 16:27 ` richard.gong at linux.intel.com 2018-07-26 16:27 ` 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=1535464245-11638-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: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.