€•½C      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/translations/zh_CN/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/zh_TW/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/it_IT/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ja_JP/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ko_KR/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/sp_SP/tee/qtee”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ6/var/lib/git/docbuild/linux/Documentation/tee/qtee.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ-QTEE (Qualcomm Trusted Execution Environment)”h]”hŒ-QTEE (Qualcomm Trusted Execution Environment)”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒ<The QTEE driver handles communication with Qualcomm TEE [1].”h]”hŒ<The QTEE driver handles communication with Qualcomm TEE [1].”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒÄThe lowest level of communication with QTEE builds on the ARM SMC Calling
Convention (SMCCC) [2], which is the foundation for QTEE's Secure Channel
Manager (SCM) [3] used internally by the driver.”h]”hŒÆThe lowest level of communication with QTEE builds on the ARM SMC Calling
Convention (SMCCC) [2], which is the foundation for QTEEâ€™s Secure Channel
Manager (SCM) [3] used internally by the driver.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K	hh¶hžhubhÊ)”}”(hŒ—In a QTEE-based system, services are represented as objects with a series of
operations that can be called to produce results, including other objects.”h]”hŒ—In a QTEE-based system, services are represented as objects with a series of
operations that can be called to produce results, including other objects.”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒÍWhen an object is hosted within QTEE, executing its operations is referred
to as "direct invocation". QTEE can also invoke objects hosted in the non-secure
world using a method known as "callback request".”h]”hŒÕWhen an object is hosted within QTEE, executing its operations is referred
to as â€œdirect invocationâ€. QTEE can also invoke objects hosted in the non-secure
world using a method known as â€œcallback requestâ€.”…””}”(hhõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒRThe SCM provides two functions to support direct invocation and callback requests:”h]”hŒRThe SCM provides two functions to support direct invocation and callback requests:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒtQCOM_SCM_SMCINVOKE_INVOKE: Used for direct invocation. It can return either
a result or initiate a callback request.”h]”hÊ)”}”(hŒtQCOM_SCM_SMCINVOKE_INVOKE: Used for direct invocation. It can return either
a result or initiate a callback request.”h]”hŒtQCOM_SCM_SMCINVOKE_INVOKE: Used for direct invocation. It can return either
a result or initiate a callback request.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubj  )”}”(hŒvQCOM_SCM_SMCINVOKE_CB_RSP: Used to submit a response to a callback request
triggered by a previous direct invocation.
”h]”hÊ)”}”(hŒuQCOM_SCM_SMCINVOKE_CB_RSP: Used to submit a response to a callback request
triggered by a previous direct invocation.”h]”hŒuQCOM_SCM_SMCINVOKE_CB_RSP: Used to submit a response to a callback request
triggered by a previous direct invocation.”…””}”(hj4  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j  hŸh³h Khh¶hžhubhÊ)”}”(hŒMThe QTEE Transport Message [4] is stacked on top of the SCM driver functions.”h]”hŒMThe QTEE Transport Message [4] is stacked on top of the SCM driver functions.”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒüA message consists of two buffers shared with QTEE: inbound and outbound
buffers. The inbound buffer is used for direct invocation, and the outbound
buffer is used to make callback requests. This picture shows the contents of
a QTEE transport message::”h]”hŒûA message consists of two buffers shared with QTEE: inbound and outbound
buffers. The inbound buffer is used for direct invocation, and the outbound
buffer is used to make callback requests. This picture shows the contents of
a QTEE transport message:”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒliteral_block”“”)”}”(hX]                                    +---------------------+
                                  |                     v
+-----------------+-------+-------+------+--------------------------+
| qcomtee_msg_    |object | buffer       |                          |
|  object_invoke  |  id   | offset, size |                          | (inbound buffer)
+-----------------+-------+--------------+--------------------------+
<---- header -----><---- arguments ------><- in/out buffer payload ->

                                  +-----------+
                                  |           v
+-----------------+-------+-------+------+----------------------+
| qcomtee_msg_    |object | buffer       |                      |
|  callback       |  id   | offset, size |                      | (outbound buffer)
+-----------------+-------+--------------+----------------------+”h]”hX]                                    +---------------------+
                                  |                     v
+-----------------+-------+-------+------+--------------------------+
| qcomtee_msg_    |object | buffer       |                          |
|  object_invoke  |  id   | offset, size |                          | (inbound buffer)
+-----------------+-------+--------------+--------------------------+
<---- header -----><---- arguments ------><- in/out buffer payload ->

                                  +-----------+
                                  |           v
+-----------------+-------+-------+------+----------------------+
| qcomtee_msg_    |object | buffer       |                      |
|  callback       |  id   | offset, size |                      | (outbound buffer)
+-----------------+-------+--------------+----------------------+”…””}”hjn  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jl  hŸh³h K"hh¶hžhubhÊ)”}”(hŒ<Each buffer is started with a header and array of arguments.”h]”hŒ<Each buffer is started with a header and array of arguments.”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K1hh¶hžhubhÊ)”}”(hŒ8QTEE Transport Message supports four types of arguments:”h]”hŒ8QTEE Transport Message supports four types of arguments:”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K3hh¶hžhubj  )”}”(hhh]”(j  )”}”(hŒWInput Object (IO) is an object parameter to the current invocation
or callback request.”h]”hÊ)”}”(hŒWInput Object (IO) is an object parameter to the current invocation
or callback request.”h]”hŒWInput Object (IO) is an object parameter to the current invocation
or callback request.”…””}”(hjŸ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K5hj›  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj˜  hžhhŸh³h Nubj  )”}”(hŒZOutput Object (OO) is an object parameter from the current invocation
or callback request.”h]”hÊ)”}”(hŒZOutput Object (OO) is an object parameter from the current invocation
or callback request.”h]”hŒZOutput Object (OO) is an object parameter from the current invocation
or callback request.”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K7hj³  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj˜  hžhhŸh³h Nubj  )”}”(hŒŒInput Buffer (IB) is (offset, size) pair to the inbound or outbound region
to store parameter to the current invocation or callback request.”h]”hÊ)”}”(hŒŒInput Buffer (IB) is (offset, size) pair to the inbound or outbound region
to store parameter to the current invocation or callback request.”h]”hŒŒInput Buffer (IB) is (offset, size) pair to the inbound or outbound region
to store parameter to the current invocation or callback request.”…””}”(hjÏ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K9hjË  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj˜  hžhhŸh³h Nubj  )”}”(hŒOutput Buffer (OB) is (offset, size) pair to the inbound or outbound region
to store parameter from the current invocation or callback request.
”h]”hÊ)”}”(hŒOutput Buffer (OB) is (offset, size) pair to the inbound or outbound region
to store parameter from the current invocation or callback request.”h]”hŒOutput Buffer (OB) is (offset, size) pair to the inbound or outbound region
to store parameter from the current invocation or callback request.”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K;hjã  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj˜  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”jN  jO  uh1j  hŸh³h K5hh¶hžhubhÊ)”}”(hŒWPicture of the relationship between the different components in the QTEE
architecture::”h]”hŒVPicture of the relationship between the different components in the QTEE
architecture:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K>hh¶hžhubjm  )”}”(hXb        User space               Kernel                     Secure world
      ~~~~~~~~~~               ~~~~~~                     ~~~~~~~~~~~~
+--------+   +----------+                                +--------------+
| Client |   |callback  |                                | Trusted      |
+--------+   |server    |                                | Application  |
   /\        +----------+                                +--------------+
   ||  +----------+ /\                                          /\
   ||  |callback  | ||                                          ||
   ||  |server    | ||                                          \/
   ||  +----------+ ||                                   +--------------+
   ||       /\      ||                                   | TEE Internal |
   ||       ||      ||                                   | API          |
   \/       \/      \/   +--------+--------+             +--------------+
+---------------------+  | TEE    | QTEE   |             | QTEE         |
|   libqcomtee [5]    |  | subsys | driver |             | Trusted OS   |
+-------+-------------+--+----+-------+----+-------------+--------------+
|      Generic TEE API        |       |   QTEE MSG                      |
|      IOCTL (TEE_IOC_*)      |       |   SMCCC (QCOM_SCM_SMCINVOKE_*)  |
+-----------------------------+       +---------------------------------+”h]”hXb        User space               Kernel                     Secure world
      ~~~~~~~~~~               ~~~~~~                     ~~~~~~~~~~~~
+--------+   +----------+                                +--------------+
| Client |   |callback  |                                | Trusted      |
+--------+   |server    |                                | Application  |
   /\        +----------+                                +--------------+
   ||  +----------+ /\                                          /\
   ||  |callback  | ||                                          ||
   ||  |server    | ||                                          \/
   ||  +----------+ ||                                   +--------------+
   ||       /\      ||                                   | TEE Internal |
   ||       ||      ||                                   | API          |
   \/       \/      \/   +--------+--------+             +--------------+
+---------------------+  | TEE    | QTEE   |             | QTEE         |
|   libqcomtee [5]    |  | subsys | driver |             | Trusted OS   |
+-------+-------------+--+----+-------+----+-------------+--------------+
|      Generic TEE API        |       |   QTEE MSG                      |
|      IOCTL (TEE_IOC_*)      |       |   SMCCC (QCOM_SCM_SMCINVOKE_*)  |
+-----------------------------+       +---------------------------------+”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jl  hŸh³h KAhh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒ
References”h]”hŒ
References”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h KVubhÊ)”}”(hŒr[1] https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-11/qualcomm-trusted-execution-environment.html”h]”(hŒ[1] ”…””}”(hj.  hžhhŸNh NubhŒ	reference”“”)”}”(hŒnhttps://docs.qualcomm.com/bundle/publicresource/topics/80-70015-11/qualcomm-trusted-execution-environment.html”h]”hŒnhttps://docs.qualcomm.com/bundle/publicresource/topics/80-70015-11/qualcomm-trusted-execution-environment.html”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j:  uh1j6  hj.  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KXhj  hžhubhÊ)”}”(hŒH[2] http://infocenter.arm.com/help/topic/com.arm.doc.den0028a/index.html”h]”(hŒ[2] ”…””}”(hjM  hžhhŸNh Nubj7  )”}”(hŒDhttp://infocenter.arm.com/help/topic/com.arm.doc.den0028a/index.html”h]”hŒDhttp://infocenter.arm.com/help/topic/com.arm.doc.den0028a/index.html”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jW  uh1j6  hjM  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KZhj  hžhubhÊ)”}”(hŒ$[3] drivers/firmware/qcom/qcom_scm.c”h]”hŒ$[3] drivers/firmware/qcom/qcom_scm.c”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K\hj  hžhubhÊ)”}”(hŒ%[4] drivers/tee/qcomtee/qcomtee_msg.h”h]”hŒ%[4] drivers/tee/qcomtee/qcomtee_msg.h”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K^hj  hžhubhÊ)”}”(hŒ%[5] https://github.com/quic/quic-teec”h]”(hŒ[5] ”…””}”(hj†  hžhhŸNh Nubj7  )”}”(hŒ!https://github.com/quic/quic-teec”h]”hŒ!https://github.com/quic/quic-teec”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1j6  hj†  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K`hj  hžhubeh}”(h]”Œ
references”ah ]”h"]”Œ
references”ah$]”h&]”uh1h´hh¶hžhhŸh³h KVubeh}”(h]”Œ+qtee-qualcomm-trusted-execution-environment”ah ]”h"]”Œ-qtee (qualcomm trusted execution environment)”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÖ  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j°  j­  j¨  j¥  uŒ	nametypes”}”(j°  ‰j¨  ‰uh}”(j­  h¶j¥  j  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.