path: root/Documentation
diff options
authorRouven Czerwinski <>2020-01-28 06:38:22 +0100
committerSascha Hauer <>2020-01-30 06:22:28 +0100
commitaf1a0da42f9493b2d4266580b15d52946b326ca7 (patch)
treed172f2b155ba67b7155c3d8878c4644f74995420 /Documentation
parent7df7be816731b302ae3defe4c9d43ff99d71dbcf (diff)
user: add documentation for OP-TEE loading
Some rudimentary documentation how to load OP-TEE. Signed-off-by: Rouven Czerwinski <> Signed-off-by: Sascha Hauer <>
Diffstat (limited to 'Documentation')
2 files changed, 30 insertions, 0 deletions
diff --git a/Documentation/user/optee.rst b/Documentation/user/optee.rst
new file mode 100644
index 0000000..950917b
--- /dev/null
+++ b/Documentation/user/optee.rst
@@ -0,0 +1,29 @@
+.. _optee:
+Barebox is able to start the Open Portable Trusted Execution Environment
+(OP-TEE) either before starting the linux kernel or during lowlevel board
+initialization in the Pre Bootloader ``PBL``.
+Before Linux start
+Enable the `CONFIG_BOOTM_OPTEE` configuration variable and configure the
+`CONFIG_OPTEE_SIZE` variable. This will reserve a memory area at the end
+of memory for OP-TEE to run, usually Barebox would relocate itself there. To
+load OP-TEE before the kernel is started, configure the global ``bootm.tee``
+variable to point to a valid OPTEE v1 binary.
+During the PBL
+To start OP-TEE during the lowlevel initialization of your board in the ``PBL``,
+enable the ``CONFIG_PBL_OPTEE`` configuration variable. your board should then
+call the function ``start_optee_early(void* tee, void* fdt)`` with a valid tee
+and FDT. Ensure that your OP-TEE is compiled with ``CFG_NS_ENTRY_ADDR`` unset,
+otherwise OP-TEE will not correctly return to barebox after startup.
+Since OP-TEE in the default configuration also modifies the device tree, don't
+pass the barebox internal device tree, instead copy it into a different memory
+location and pass it to OP-TEE afterwards.
+The modified device tree can then be passed to the main barebox start function.
diff --git a/Documentation/user/user-manual.rst b/Documentation/user/user-manual.rst
index 41fdb88..827683e 100644
--- a/Documentation/user/user-manual.rst
+++ b/Documentation/user/user-manual.rst
@@ -33,6 +33,7 @@ Contents:
+ optee