mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-08-17 09:57:01 +02:00
f1054c93cc
In certain Trusted OS implementations it is a requirement to pass them the
highest power level which will enter a power down state during a PSCI
CPU_SUSPEND or SYSTEM_SUSPEND API invocation. This patch passes this power level
to the SPD in the "max_off_pwrlvl" parameter of the svc_suspend() hook.
Currently, the highest power level which was requested to be placed in a low
power state (retention or power down) is passed to the SPD svc_suspend_finish()
hook. This hook is called after emerging from the low power state. It is more
useful to pass the highest power level which was powered down instead. This
patch does this by changing the semantics of the parameter passed to an SPD's
svc_suspend_finish() hook. The name of the parameter has been changed from
"suspend_level" to "max_off_pwrlvl" as well. Same changes have been made to the
parameter passed to the tsp_cpu_resume_main() function.
NOTE: THIS PATCH CHANGES THE SEMANTICS OF THE EXISTING "svc_suspend_finish()"
API BETWEEN THE PSCI AND SPD/SP IMPLEMENTATIONS. THE LATTER MIGHT NEED
UPDATES TO ENSURE CORRECT BEHAVIOUR.
Change-Id: If3a9d39b13119bbb6281f508a91f78a2f46a8b90
244 lines
9.0 KiB
C
244 lines
9.0 KiB
C
/*
|
|
* Copyright (c) 2013-2015, ARM Limited and Contributors. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
*
|
|
* Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* Neither the name of ARM nor the names of its contributors may be used
|
|
* to endorse or promote products derived from this software without specific
|
|
* prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#include <arch_helpers.h>
|
|
#include <assert.h>
|
|
#include <bl_common.h>
|
|
#include <context_mgmt.h>
|
|
#include <debug.h>
|
|
#include <platform.h>
|
|
#include "opteed_private.h"
|
|
|
|
/*******************************************************************************
|
|
* The target cpu is being turned on. Allow the OPTEED/OPTEE to perform any
|
|
* actions needed. Nothing at the moment.
|
|
******************************************************************************/
|
|
static void opteed_cpu_on_handler(uint64_t target_cpu)
|
|
{
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* This cpu is being turned off. Allow the OPTEED/OPTEE to perform any actions
|
|
* needed
|
|
******************************************************************************/
|
|
static int32_t opteed_cpu_off_handler(uint64_t unused)
|
|
{
|
|
int32_t rc = 0;
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_ON);
|
|
|
|
/* Program the entry point and enter OPTEE */
|
|
cm_set_elr_el3(SECURE, (uint64_t) &optee_vectors->cpu_off_entry);
|
|
rc = opteed_synchronous_sp_entry(optee_ctx);
|
|
|
|
/*
|
|
* Read the response from OPTEE. A non-zero return means that
|
|
* something went wrong while communicating with OPTEE.
|
|
*/
|
|
if (rc != 0)
|
|
panic();
|
|
|
|
/*
|
|
* Reset OPTEE's context for a fresh start when this cpu is turned on
|
|
* subsequently.
|
|
*/
|
|
set_optee_pstate(optee_ctx->state, OPTEE_PSTATE_OFF);
|
|
|
|
return 0;
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* This cpu is being suspended. S-EL1 state must have been saved in the
|
|
* resident cpu (mpidr format) if it is a UP/UP migratable OPTEE.
|
|
******************************************************************************/
|
|
static void opteed_cpu_suspend_handler(uint64_t max_off_pwrlvl)
|
|
{
|
|
int32_t rc = 0;
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_ON);
|
|
|
|
/* Program the entry point and enter OPTEE */
|
|
cm_set_elr_el3(SECURE, (uint64_t) &optee_vectors->cpu_suspend_entry);
|
|
rc = opteed_synchronous_sp_entry(optee_ctx);
|
|
|
|
/*
|
|
* Read the response from OPTEE. A non-zero return means that
|
|
* something went wrong while communicating with OPTEE.
|
|
*/
|
|
if (rc != 0)
|
|
panic();
|
|
|
|
/* Update its context to reflect the state OPTEE is in */
|
|
set_optee_pstate(optee_ctx->state, OPTEE_PSTATE_SUSPEND);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* This cpu has been turned on. Enter OPTEE to initialise S-EL1 and other bits
|
|
* before passing control back to the Secure Monitor. Entry in S-El1 is done
|
|
* after initialising minimal architectural state that guarantees safe
|
|
* execution.
|
|
******************************************************************************/
|
|
static void opteed_cpu_on_finish_handler(uint64_t unused)
|
|
{
|
|
int32_t rc = 0;
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
entry_point_info_t optee_on_entrypoint;
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_OFF);
|
|
|
|
opteed_init_optee_ep_state(&optee_on_entrypoint, opteed_rw,
|
|
(uint64_t)&optee_vectors->cpu_on_entry,
|
|
optee_ctx);
|
|
|
|
/* Initialise this cpu's secure context */
|
|
cm_init_my_context(&optee_on_entrypoint);
|
|
|
|
/* Enter OPTEE */
|
|
rc = opteed_synchronous_sp_entry(optee_ctx);
|
|
|
|
/*
|
|
* Read the response from OPTEE. A non-zero return means that
|
|
* something went wrong while communicating with OPTEE.
|
|
*/
|
|
if (rc != 0)
|
|
panic();
|
|
|
|
/* Update its context to reflect the state OPTEE is in */
|
|
set_optee_pstate(optee_ctx->state, OPTEE_PSTATE_ON);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* This cpu has resumed from suspend. The OPTEED saved the OPTEE context when it
|
|
* completed the preceding suspend call. Use that context to program an entry
|
|
* into OPTEE to allow it to do any remaining book keeping
|
|
******************************************************************************/
|
|
static void opteed_cpu_suspend_finish_handler(uint64_t max_off_pwrlvl)
|
|
{
|
|
int32_t rc = 0;
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_SUSPEND);
|
|
|
|
/* Program the entry point, max_off_pwrlvl and enter the SP */
|
|
write_ctx_reg(get_gpregs_ctx(&optee_ctx->cpu_ctx),
|
|
CTX_GPREG_X0,
|
|
max_off_pwrlvl);
|
|
cm_set_elr_el3(SECURE, (uint64_t) &optee_vectors->cpu_resume_entry);
|
|
rc = opteed_synchronous_sp_entry(optee_ctx);
|
|
|
|
/*
|
|
* Read the response from OPTEE. A non-zero return means that
|
|
* something went wrong while communicating with OPTEE.
|
|
*/
|
|
if (rc != 0)
|
|
panic();
|
|
|
|
/* Update its context to reflect the state OPTEE is in */
|
|
set_optee_pstate(optee_ctx->state, OPTEE_PSTATE_ON);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* Return the type of OPTEE the OPTEED is dealing with. Report the current
|
|
* resident cpu (mpidr format) if it is a UP/UP migratable OPTEE.
|
|
******************************************************************************/
|
|
static int32_t opteed_cpu_migrate_info(uint64_t *resident_cpu)
|
|
{
|
|
return OPTEE_MIGRATE_INFO;
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* System is about to be switched off. Allow the OPTEED/OPTEE to perform
|
|
* any actions needed.
|
|
******************************************************************************/
|
|
static void opteed_system_off(void)
|
|
{
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_ON);
|
|
|
|
/* Program the entry point */
|
|
cm_set_elr_el3(SECURE, (uint64_t) &optee_vectors->system_off_entry);
|
|
|
|
/* Enter OPTEE. We do not care about the return value because we
|
|
* must continue the shutdown anyway */
|
|
opteed_synchronous_sp_entry(optee_ctx);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
* System is about to be reset. Allow the OPTEED/OPTEE to perform
|
|
* any actions needed.
|
|
******************************************************************************/
|
|
static void opteed_system_reset(void)
|
|
{
|
|
uint32_t linear_id = plat_my_core_pos();
|
|
optee_context_t *optee_ctx = &opteed_sp_context[linear_id];
|
|
|
|
assert(optee_vectors);
|
|
assert(get_optee_pstate(optee_ctx->state) == OPTEE_PSTATE_ON);
|
|
|
|
/* Program the entry point */
|
|
cm_set_elr_el3(SECURE, (uint64_t) &optee_vectors->system_reset_entry);
|
|
|
|
/* Enter OPTEE. We do not care about the return value because we
|
|
* must continue the reset anyway */
|
|
opteed_synchronous_sp_entry(optee_ctx);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
* Structure populated by the OPTEE Dispatcher to be given a chance to
|
|
* perform any OPTEE bookkeeping before PSCI executes a power mgmt.
|
|
* operation.
|
|
******************************************************************************/
|
|
const spd_pm_ops_t opteed_pm = {
|
|
.svc_on = opteed_cpu_on_handler,
|
|
.svc_off = opteed_cpu_off_handler,
|
|
.svc_suspend = opteed_cpu_suspend_handler,
|
|
.svc_on_finish = opteed_cpu_on_finish_handler,
|
|
.svc_suspend_finish = opteed_cpu_suspend_finish_handler,
|
|
.svc_migrate = NULL,
|
|
.svc_migrate_info = opteed_cpu_migrate_info,
|
|
.svc_system_off = opteed_system_off,
|
|
.svc_system_reset = opteed_system_reset,
|
|
};
|
|
|