€•ˆD      Œ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ŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/pt_BR/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j	  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j0  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jH  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjD  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jd  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jr  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j‚  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j€  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&]”jb  jc  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²hubj  )”}”(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Æuh1j€  h³hÇh´KAhhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒ
References”h]”hŒ
References”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj1  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jB  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jL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jN  uh1jJ  hjB  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KXhj1  h²hubhÞ)”}”(hŒH[2] http://infocenter.arm.com/help/topic/com.arm.doc.den0028a/index.html”h]”(hŒ[2] ”…””}”(hja  h²hh³Nh´NubjK  )”}”(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ji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jk  uh1jJ  hja  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KZhj1  h²hubhÞ)”}”(hŒ$[3] drivers/firmware/qcom/qcom_scm.c”h]”hŒ$[3] drivers/firmware/qcom/qcom_scm.c”…””}”(hj~  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K\hj1  h²hubhÞ)”}”(hŒ%[4] drivers/tee/qcomtee/qcomtee_msg.h”h]”hŒ%[4] drivers/tee/qcomtee/qcomtee_msg.h”…””}”(hjŒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K^hj1  h²hubhÞ)”}”(hŒ%[5] https://github.com/quic/quic-teec”h]”(hŒ[5] ”…””}”(hjš  h²hh³Nh´NubjK  )”}”(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¤  uh1jJ  hjš  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K`hj1  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¹  j1  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.