UCD flash update invoker

Implements the main algorithm for finding applicable UCDs to perform flash
update on and walking the UCD flash image table of contents to find the
image associated with a UCD.  Also adds a check to skip the update if
simics is running.

RTC: 201991
Change-Id: Ib35abec2f0a2ed22ae8d41a2acecd146f699bc43
Reviewed-on: http://rchgit01.rchland.ibm.com/gerrit1/73484
Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com>
Tested-by: FSP CI Jenkins <fsp-CI-jenkins+hostboot@us.ibm.com>
Reviewed-by: Ilya Smirnov <ismirno@us.ibm.com>
Reviewed-by: Matthew Raybuck <matthew.raybuck@ibm.com>
Tested-by: Jenkins OP Build CI <op-jenkins+hostboot@us.ibm.com>
Tested-by: Jenkins OP HW <op-hw-jenkins+hostboot@us.ibm.com>
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>

1 files changed, 24 insertions, 0 deletions

diff --git a/src/include/usr/isteps/ucd/updateUcdFlash.H b/src/include/usr/isteps/ucd/updateUcdFlash.H
index a1487e78d..2cc7e8e84 100644
--- a/src/include/usr/isteps/ucd/updateUcdFlash.H
+++ b/src/include/usr/isteps/ucd/updateUcdFlash.H
@@ -27,6 +27,7 @@
 #define __UPDATE_UCD_FLASH_H
 
 #include <targeting/common/target.H>
+#include <util/utilmem.H>
 #include <errl/errlentry.H>
 
 namespace POWER_SEQUENCER
@@ -39,6 +40,29 @@ namespace UCD // UCD series
 {
 
 /**
+ *  @brief Applies UCD data flash image updates (if needed) to the requested
+ *      UCDs
+ *
+ *  @param[in] i_powerSequencers Fixed vector of PowerSequencer targets to
+ *      update flash image on
+ *  @param[in] i_image Reference to UtilMem buffer holding the UCD flash image
+ *      contents (including header, TOC entries, and flash images).  Note: the
+ *      implementation will not alter the buffer content, and will seek back
+ *      to the beginning before handing control back.
+ *
+ *  @return errlHndl_t Error log handle
+ *  @retval nullptr Successfully took action against all requested UCDs.  It's
+ *      possible an individual UCD update failed, in which case the error is
+ *      committed.
+ *  @retval !nullptr Failed to take action against one or more requested UCDs.
+ *      Typically this is due to a firmware problem.  Handle points to valid
+ *      error log
+ */
+errlHndl_t updateAllUcdFlashImages(
+    const TARGETING::TargetHandleList& i_powerSequencers,
+          UtilMem&                     i_image);
+
+/**
  *  @brief Updates a UCD target's flash image
  *
  *  @param[in] i_pUcd UCD's target; must not be nullptr