mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-11-25 18:55:24 +00:00
3dd580298b
this adds calls to depthcharge (using callbacks) to do auxiliary firmware updates. in particular, this is intended to trigger TCPC updates, but other programmables could also be updated. no firmware updates take place until a board file has actually registered a firmware update "driver". board file updates to follow. TEST="COV=1 make" passes. depthcharge boots on snappy. with additional follow-on CLs, we can update the ps8751. the companion depthcharge changes are here: https://chromium-review.googlesource.com/c/498150/ the working design doc is here: https://docs.google.com/a/google.com/document/d/1uzS0b3O3Us1QI2Sx7LDkjEfHmuhYB2BolrAoNwCVoc0/edit?usp=sharing these features depend on vboot API updates: CQ-DEPEND=CL:498150 BUG=b:35586896 BRANCH=none Change-Id: If0d634eab08b429a8e7e80f5fe11eab3705bba0f Signed-off-by: Caveh Jalali <caveh@google.com> Reviewed-on: https://chromium-review.googlesource.com/505260 Reviewed-by: Stefan Reinauer <reinauer@chromium.org>
100 lines
2.9 KiB
C
100 lines
2.9 KiB
C
/* Copyright 2016 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*
|
|
* EC software sync for verified boot
|
|
*/
|
|
|
|
#ifndef VBOOT_REFERENCE_EC_SYNC_H_
|
|
#define VBOOT_REFERENCE_EC_SYNC_H_
|
|
|
|
#include "vboot_api.h"
|
|
|
|
struct vb2_context;
|
|
struct VbCommonParams;
|
|
|
|
/**
|
|
* EC sync, phase 1
|
|
*
|
|
* This checks whether the EC is running the correct image to do EC sync, and
|
|
* whether any updates are necessary.
|
|
*
|
|
* @param ctx Vboot2 context
|
|
* @param cparams Vboot common params
|
|
* @return VBERROR_SUCCESS, VBERROR_EC_REBOOT_TO_RO_REQUIRED if the EC must
|
|
* reboot back to its RO code to continue EC sync, or other non-zero error
|
|
* code.
|
|
*/
|
|
VbError_t ec_sync_phase1(struct vb2_context *ctx,
|
|
struct VbCommonParams *cparams);
|
|
|
|
/**
|
|
* Returns non-zero if the EC will perform a slow update during phase 2.
|
|
*
|
|
* This is only valid after calling ec_sync_phase1(), before calling
|
|
* ec_sync_phase2().
|
|
*
|
|
* @param ctx Vboot2 context
|
|
* @param cparams Vboot common params
|
|
* @return non-zero if a slow update will be done; zero if no update or a
|
|
* fast update.
|
|
*/
|
|
int ec_will_update_slowly(struct vb2_context *ctx,
|
|
struct VbCommonParams *cparams);
|
|
|
|
/**
|
|
* Check if auxiliary firmware blobs need to be updated.
|
|
*
|
|
* @param ctx Vboot2 context
|
|
* @param cparams Vboot common params
|
|
* @param severity VB_AUX_FW_{NO,FAST,SLOW}_UPDATE
|
|
* @return VBERROR_SUCCESS or non-zero error code.
|
|
*/
|
|
VbError_t ec_sync_check_aux_fw(struct vb2_context *ctx,
|
|
struct VbCommonParams *cparams,
|
|
VbAuxFwUpdateSeverity_t *severity);
|
|
|
|
/**
|
|
* EC sync, phase 2
|
|
*
|
|
* This updates the EC if necessary, makes sure it has protected its image(s),
|
|
* and makes sure it has jumped to the correct image.
|
|
*
|
|
* If ec_will_update_slowly(), it is suggested that the caller display a
|
|
* warning screen before calling phase 2.
|
|
*
|
|
* @param ctx Vboot2 context
|
|
* @param cparams Vboot common params
|
|
* @return VBERROR_SUCCESS, VBERROR_EC_REBOOT_TO_RO_REQUIRED if the EC must
|
|
* reboot back to its RO code to continue EC sync, or other non-zero error
|
|
* code.
|
|
*/
|
|
VbError_t ec_sync_phase2(struct vb2_context *ctx,
|
|
struct VbCommonParams *cparams);
|
|
|
|
/**
|
|
* EC sync, phase 3
|
|
*
|
|
* This completes EC sync and handles battery cutoff if needed.
|
|
*
|
|
* @param ctx Vboot2 context
|
|
* @param cparams Vboot common params
|
|
* @return VBERROR_SUCCESS or non-zero error code.
|
|
*/
|
|
VbError_t ec_sync_phase3(struct vb2_context *ctx, VbCommonParams *cparams);
|
|
|
|
/**
|
|
* Sync all EC devices to expected versions.
|
|
*
|
|
* This is a high-level function which calls the functions above.
|
|
*
|
|
* @param ctx Vboot context
|
|
* @param devidx EC device index to sync
|
|
* @param cparams Common vboot params
|
|
* @return VBERROR_SUCCESS, or non-zero if error.
|
|
*/
|
|
VbError_t ec_sync_all(struct vb2_context *ctx, struct
|
|
VbCommonParams *cparams);
|
|
|
|
#endif /* VBOOT_REFERENCE_EC_SYNC_H_ */
|