path: root/src/usr/htmgt/htmgt.C

/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/usr/htmgt/htmgt.C $                                       */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2014,2018                        */
/* [+] International Business Machines Corp.                              */
/*                                                                        */
/*                                                                        */
/* Licensed under the Apache License, Version 2.0 (the "License");        */
/* you may not use this file except in compliance with the License.       */
/* You may obtain a copy of the License at                                */
/*                                                                        */
/*     http://www.apache.org/licenses/LICENSE-2.0                         */
/*                                                                        */
/* Unless required by applicable law or agreed to in writing, software    */
/* distributed under the License is distributed on an "AS IS" BASIS,      */
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or        */
/* implied. See the License for the specific language governing           */
/* permissions and limitations under the License.                         */
/*                                                                        */
/* IBM_PROLOG_END_TAG                                                     */

#include <htmgt/htmgt.H>
#include <htmgt/htmgt_reasoncodes.H>
#include "htmgt_activate.H"
#include "htmgt_cfgdata.H"
#include "htmgt_utility.H"
#include "htmgt_memthrottles.H"
#include "htmgt_poll.H"
#include <devicefw/userif.H>
#include <config.h>
#include <console/consoleif.H>

//  Targeting support
#include <targeting/common/commontargeting.H>
#include <targeting/common/utilFilter.H>
#include <targeting/common/attributes.H>
#include <targeting/common/targetservice.H>

#include <sys/time.h>
#include <targeting/common/attributeTank.H>

#include <isteps/pm/pm_common_ext.H>
namespace HTMGT
{

    // Move the OCCs to active state or log unrecoverable error and
    // stay in safe mode
    void processOccStartStatus(const bool i_startCompleted,
                               TARGETING::Target * i_failedOccTarget)
    {
        TMGT_INF(">>processOccStartStatus(%d,0x%p)",
                 i_startCompleted, i_failedOccTarget);
        errlHndl_t l_err = nullptr;
        uint32_t l_huid = 0;
        bool skip_comm = true;
        if (i_failedOccTarget)
        {
            l_huid = TARGETING::get_huid(i_failedOccTarget);
        }
        TMGT_INF("processOccStartStatus(Start Success=%c, failedOcc=0x%08X)",
                 i_startCompleted?'y':'n', l_huid);

        if (false == int_flags_set(FLAG_HOLD_OCCS_IN_RESET))
        {
            if (i_startCompleted)
            {
                // Query functional OCCs (OCCs have just been started)
                l_err = OccManager::buildOccs(true);
                if (nullptr == l_err)
                {
                    if (nullptr != OccManager::getMasterOcc())
                    {
                        do
                        {
#ifndef __HOSTBOOT_RUNTIME
                            // Calc memory throttles (once per IPL)
                            l_err = calcMemThrottles();
                            if( l_err )
                            {
                                break;
                            }
#endif

                            // Make sure OCCs are ready for communication
                            l_err = OccManager::waitForOccCheckpoint();
                            if( l_err )
                            {
                                break;
                            }

#ifdef __HOSTBOOT_RUNTIME
                            // TODO RTC 124738  Final solution TBD
                            //  Perhapse POLL scom 0x6a214 until bit 31 is set?
                            nanosleep(1,0);
#endif

                            // Send poll to establish comm
                            TMGT_INF("Send initial poll to all OCCs to"
                                     " establish comm");
                            l_err = OccManager::sendOccPoll();
                            if (l_err)
                            {
                                if (OccManager::occNeedsReset())
                                {
                                    // No need to continue if reset is required
                                    TMGT_ERR("processOccStartStatus(): "
                                            "OCCs need to be reset");
                                    break;
                                }
                                else
                                {
                                    // Continue even if failed (will be retried)
                                    ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
                                }
                            }
                            skip_comm = false;

                            // Send ALL config data
                            sendOccConfigData();

                            // Set the User PCAP
                            l_err = sendOccUserPowerCap();
                            if (l_err)
                            {
                                break;
                            }

                            // Wait for all OCCs to go to the target state
                            l_err = waitForOccState();
                            if ( l_err )
                            {
                                break;
                            }

                            // Set active sensors for all OCCs,
                            // so BMC can start communication with OCCs
                            l_err = setOccActiveSensors(true);
                            if (l_err)
                            {
                                // Continue even if failed to update sensor
                                ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
                            }

                        } while(0);
                    }
                    else
                    {
                        TMGT_ERR("Unable to find any Master capable OCCs");
                        /*@
                         * @errortype
                         * @reasoncode      HTMGT_RC_OCC_MASTER_NOT_FOUND
                         * @moduleid        HTMGT_MOD_LOAD_START_STATUS
                         * @userdata1       number of OCCs
                         * @devdesc         No OCC master was found
                         */
                        bldErrLog(l_err, HTMGT_MOD_LOAD_START_STATUS,
                                  HTMGT_RC_OCC_MASTER_NOT_FOUND,
                                  0, OccManager::getNumOccs(), 0, 0,
                                  ERRORLOG::ERRL_SEV_INFORMATIONAL);
                    }
                }
                else
                {
                    // Failed to find functional OCCs, no need to try again
                    // Set original error log  as unrecoverable and commit
                    l_err->setSev(ERRORLOG::ERRL_SEV_UNRECOVERABLE);
                    ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
                }
            }
            else
            {
                TMGT_ERR("All OCCs were not loaded/started successfully");
                /*@
                 * @errortype
                 * @reasoncode      HTMGT_RC_OCC_START_FAIL
                 * @moduleid        HTMGT_MOD_LOAD_START_STATUS
                 * @userdata1       Failing OCC HUID
                 * @devdesc         OCCs were not loaded/started successfully
                 */
                bldErrLog(l_err, HTMGT_MOD_LOAD_START_STATUS,
                          HTMGT_RC_OCC_START_FAIL,
                          0, l_huid, 0, 0,
                          ERRORLOG::ERRL_SEV_INFORMATIONAL);
            }

            if (nullptr != l_err)
            {
                TMGT_ERR("OCCs not all active (rc=0x%04X).  Attempting OCC "
                         "Reset", l_err->reasonCode());
                TMGT_CONSOLE("OCCs are not active (rc=0x%04X). "
                             "Attempting OCC Reset",
                             l_err->reasonCode());
                TMGT_INF("processOccStartStatus: Calling resetOccs");
                // Reset ALL OCCs, don't skip incrementing reset count, and
                // if comm has not been established, don't try to talk to OCCs
                errlHndl_t err2 = OccManager::resetOccs(nullptr,
                                                        false,
                                                        skip_comm);
                if(err2)
                {
                    TMGT_ERR("OccManager::resetOccs failed with 0x%04X",
                             err2->reasonCode());

                    // Set original error log  as unrecoverable and commit
                    l_err->setSev(ERRORLOG::ERRL_SEV_UNRECOVERABLE);
                    ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);

                    // Commit occReset error
                    ERRORLOG::errlCommit(err2, HTMGT_COMP_ID);
                }
                else
                {
                    // retry worked - commit original error as informational
                    TMGT_INF("processOccStartStatus: OCC failed to go active "
                             "with 0x%04X, but recovery was successful",
                             l_err->reasonCode());
                    l_err->setSev(ERRORLOG::ERRL_SEV_INFORMATIONAL);
                    ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
                }
            }
        }
        else
        {
            TMGT_INF("processOccStartStatus: Skipping start of OCCS due to "
                     "internal flags 0x%08X", get_int_flags());
            // Reset all OCCs
            TMGT_INF("processOccStartStatus: Calling HBPM::resetPMAll()");
            l_err = HBPM::resetPMAll();
            if(l_err)
            {
                l_err->setSev(ERRORLOG::ERRL_SEV_INFORMATIONAL);
                l_err->collectTrace("HTMGT");
                ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
            }

        }

        TMGT_INF("<<processOccStartStatus()");

    } // end processOccStartStatus()



    // Notify HTMGT that an OCC has an error to report
    void processOccError(TARGETING::Target * i_procTarget)
    {
        TMGT_INF(">>processOccAttn(0x%p)", i_procTarget);

        TARGETING::Target* sys = nullptr;
        TARGETING::targetService().getTopLevelTarget(sys);
        uint8_t safeMode = 0;

        // If the system is in safemode then can't talk to OCCs -
        // ignore call to processOccError
        if(sys &&
           sys->tryGetAttr<TARGETING::ATTR_HTMGT_SAFEMODE>(safeMode) &&
           safeMode)
        {
            return;
        }

        bool polledOneOcc = false;
        errlHndl_t err = OccManager::buildOccs();
        if (nullptr == err)
        {
            if (i_procTarget != nullptr)
            {
                const uint32_t l_huid =
                    i_procTarget->getAttr<TARGETING::ATTR_HUID>();
                TMGT_INF("processOccAttn(HUID=0x%08X) called", l_huid);

                TARGETING::TargetHandleList pOccs;
                getChildChiplets(pOccs, i_procTarget, TARGETING::TYPE_OCC);
                if (pOccs.size() > 0)
                {
                    // Poll specified OCC flushing any errors
                    errlHndl_t err = OccManager::sendOccPoll(true, pOccs[0]);
                    if (err)
                    {
                        ERRORLOG::errlCommit(err, HTMGT_COMP_ID);
                    }
                    polledOneOcc = true;
                }
            }

            if ((OccManager::getNumOccs() > 1) || (false == polledOneOcc))
            {
                // Send POLL command to all OCCs to flush any other errors
                errlHndl_t err = OccManager::sendOccPoll(true);
                if (err)
                {
                    ERRORLOG::errlCommit(err, HTMGT_COMP_ID);
                }
            }

            if (OccManager::occNeedsReset())
            {
                TMGT_ERR("processOccAttn(): OCCs need to be reset");
                // Don't pass failed target as OCC should have already
                // been marked as failed during the poll.
                errlHndl_t err = OccManager::resetOccs(nullptr);
                if(err)
                {
                    TMGT_ERR("processOccAttn(): Error when attempting"
                             " to reset OCCs");
                    ERRORLOG::errlCommit(err, HTMGT_COMP_ID);
                }
            }
        }
        else
        {
            // OCC build failed...
            TMGT_ERR("processOccAttn() called, but unable to find OCCs");
            ERRORLOG::errlCommit(err, HTMGT_COMP_ID);
        }
        TMGT_INF("<<processOccAttn()");

    } // end processOccError()



    // Notify HTMGT that an OCC has failed and needs to be reset
    void processOccReset(TARGETING::Target * i_proc)
    {
        TMGT_INF(">>processOccReset(0x%p)", i_proc);
        errlHndl_t errl = nullptr;
        TARGETING::Target * failedOccTarget = nullptr;

        TARGETING::Target* sys = nullptr;
        TARGETING::targetService().getTopLevelTarget(sys);
        uint8_t safeMode = 0;

        // If the system is in safemode then ignore request to reset OCCs
        if(sys &&
           sys->tryGetAttr<TARGETING::ATTR_HTMGT_SAFEMODE>(safeMode) &&
           safeMode)
        {
            return;
        }

        if( i_proc )
        {
            TARGETING::TargetHandleList pOccs;
            getChildChiplets(pOccs, i_proc, TARGETING::TYPE_OCC);
            if (pOccs.size() > 0)
            {
                failedOccTarget = pOccs[0];
            }
        }

        if(nullptr != failedOccTarget)
        {
            uint32_t huid = failedOccTarget->getAttr<TARGETING::ATTR_HUID>();
            TMGT_INF("processOccReset(HUID=0x%08X) called", huid);
        }
        else
        {
            uint32_t huid = i_proc->getAttr<TARGETING::ATTR_HUID>();
            TMGT_INF("processOccReset: Invalid OCC target (proc huid=0x08X)"
                     "resetting OCCs anyway",
                     huid);

            /*@
             * @errortype
             * @reasoncode      HTMGT_RC_INVALID_PARAMETER
             * @moduleid        HTMGT_MOD_PROCESS_OCC_RESET
             * @userdata1       Processor HUID
             * @devdesc         No OCC target found for proc Target,
             */
            bldErrLog(errl,
                      HTMGT_MOD_PROCESS_OCC_RESET,
                      HTMGT_RC_INVALID_PARAMETER,
                      0, huid, 0, 1,
                      ERRORLOG::ERRL_SEV_INFORMATIONAL);

            // Add HB firmware callout
            errl->addProcedureCallout(HWAS::EPUB_PRC_HB_CODE,
                                      HWAS::SRCI_PRIORITY_MED);
            ERRORLOG::errlCommit(errl, HTMGT_COMP_ID); // sets errl to nullptr
        }

        if (false == int_flags_set(FLAG_EXT_RESET_DISABLED))
        {
            errl = OccManager::resetOccs(failedOccTarget);
            if(errl)
            {
                ERRORLOG::errlCommit(errl, HTMGT_COMP_ID); // sets errl to nullptr
            }
        }
        else
        {
            TMGT_INF("processOccReset: Skipping external reset due to "
                     "internal flags 0x%08X", get_int_flags());
        }
        TMGT_INF("<<processOccReset()");

    } // end processOccReset()



    // Set the OCC state
    errlHndl_t enableOccActuation(bool i_occActivation)
    {
        TMGT_INF(">>enableOccActuation(%c)", i_occActivation?'Y':'N');
        errlHndl_t l_err = nullptr;
        TARGETING::Target* sys = nullptr;

        // If the system is already in safemode then can't talk to OCCs
        TARGETING::targetService().getTopLevelTarget(sys);
        uint8_t safeMode = 0;
        if(sys)
        {
            sys->tryGetAttr<TARGETING::ATTR_HTMGT_SAFEMODE>(safeMode);
        }

        if (0 == safeMode)
        {
            occStateId targetState = OCC_STATE_ACTIVE;
            if (false == i_occActivation)
            {
                targetState = OCC_STATE_OBSERVATION;
            }

            // Set state for all OCCs
            l_err = OccManager::setOccState(targetState);
            if (nullptr == l_err)
            {
                TMGT_INF("enableOccActuation: OCC states updated to 0x%02X",
                         targetState);
            }

            if (OccManager::occNeedsReset())
            {
                if (l_err)
                {
                    // Commit setOccState elog since OCCs will be reset
                    // and recovery attempted.
                    ERRORLOG::errlCommit(l_err, HTMGT_COMP_ID);
                }

                TMGT_ERR("enableOccActuation(): OCCs need to be reset");
                // Don't pass failed target as OCC should have already
                // been marked as failed during the poll.
                l_err = OccManager::resetOccs(nullptr);

                // NOTE: If the system exceeded its reset count and ended up
                // in safe mode an error may not be returned here (if a
                // failure happened after the first reset attempt).
                // This is because the resets are recursive:
                //   HTMGT calls back into HBRT to initiate the reset, then
                //   HBRT calls into HTMGT when reset completed
                // To detected this condition we need to check for safe mode
                // after the recovery attempts and return error if in safe.
                if(sys)
                {
                    sys->tryGetAttr<TARGETING::ATTR_HTMGT_SAFEMODE>(safeMode);
                }
            }
        }

        if ((nullptr == l_err) && safeMode)
        {
            // Create an elog so the user knows the cmd failed.
            TMGT_ERR("enableOccActuation(): System is in safe mode");
            uint32_t safeInstance = 0;
            uint32_t safeRc = OccManager::getSafeModeReason(safeInstance);
            /*@
             * @errortype
             * @reasoncode      HTMGT_RC_OCC_CRIT_FAILURE
             * @moduleid        HTMGT_MOD_ENABLE_OCC_ACTUATION
             * @userdata1[0:31]  OCC activate [1==true][0==false]
             * @userdata1[32:63] return code triggering safe mode
             * @userdata2[0:31]  safeMode flag
             * @userdata2[32:63] OCC instance
             * @devdesc         Operation not allowed, system is in safe mode
             */
            bldErrLog(l_err,
                      HTMGT_MOD_ENABLE_OCC_ACTUATION,
                      HTMGT_RC_OCC_CRIT_FAILURE,
                      i_occActivation, safeRc, safeMode, safeInstance,
                      ERRORLOG::ERRL_SEV_UNRECOVERABLE);
        }

        TMGT_INF("<<enableOccActuation() returning 0x%04X",
                 (l_err==nullptr) ? 0 : l_err->reasonCode());
        return l_err;

    } // end enableOccActuation()


    // Send pass-thru command to HTMGT
    errlHndl_t passThruCommand(uint16_t   i_cmdLength,
                               uint8_t *  i_cmdData,
                               uint16_t & o_rspLength,
                               uint8_t *  o_rspData)
    {
        errlHndl_t err = nullptr;
        htmgtReasonCode failingSrc = HTMGT_RC_NO_ERROR;
        o_rspLength = 0;

        err = OccManager::buildOccs();
        if (nullptr == err)
        {
            if ((i_cmdLength > 0) && (NULL != i_cmdData))
            {
                switch (i_cmdData[0])
                {
                    case PASSTHRU_OCC_STATUS:
                        TMGT_INF("passThruCommand: OCC Status");
                        OccManager::getOccData(o_rspLength, o_rspData);
                        break;

                    case PASSTHRU_INTERNAL_FLAG:
                        if (i_cmdLength == 1)
                        {
                            // get internal flag value
                            o_rspLength = 4;
                            UINT32_PUT(o_rspData, get_int_flags());
                        }
                        else if (i_cmdLength == 5)
                        {
                            // set internal flag value
                            TMGT_INF("passThruCommand: Updating internal flags "
                                    "from 0x%08X to 0x%08X",
                                    get_int_flags(), UINT32_GET(&i_cmdData[1]));
                            set_int_flags(UINT32_GET(&i_cmdData[1]));
                        }
                        else
                        {
                            TMGT_ERR("passThruCommand: invalid internal flag "
                                     "length %d", i_cmdLength);
                            failingSrc = HTMGT_RC_INVALID_LENGTH;
                        }
                        break;

                    case PASSTHRU_SEND_OCC_COMMAND:
                        if (i_cmdLength >= 3)
                        {
                            const uint8_t occInstance = i_cmdData[1];
                            const occCommandType occCmd =
                                (occCommandType)i_cmdData[2];
                            const uint16_t dataLen = i_cmdLength-3;
                            Occ *occPtr = OccManager::getOcc(occInstance);
                            if (occPtr)
                            {
                                TMGT_INF("passThruCommand: Send OCC%d command "
                                         "0x%02X (%d bytes)",
                                         occInstance, occCmd, dataLen);
                                OccCmd cmd(occPtr, occCmd, dataLen, &i_cmdData[3]);
                                err = cmd.sendOccCmd();
                                if (err != NULL)
                                {
                                    TMGT_ERR("passThruCommand: OCC%d cmd 0x%02X "
                                             "failed with rc 0x%04X",
                                             occInstance, occCmd,
                                             err->reasonCode());
                                }
                                else
                                {
                                    uint8_t *rspPtr = NULL;
                                    o_rspLength = cmd.getResponseData(rspPtr);
                                    memcpy(o_rspData, rspPtr, o_rspLength);
                                    TMGT_INF("passThruCommand: OCC%d rsp status "
                                             "0x%02X (%d bytes)", occInstance,
                                             o_rspData[2], o_rspLength);
                                }
                            }
                            else
                            {
                                TMGT_ERR("passThruCommand: Unable to find OCC%d",
                                         occInstance);
                                /*@
                                 * @errortype
                                 * @reasoncode   HTMGT_RC_OCC_UNAVAILABLE
                                 * @moduleid     HTMGT_MOD_PASS_THRU
                                 * @userdata1    command data[0-7]
                                 * @userdata2    command data length
                                 * @devdesc      Specified OCC not available
                                 */
                                failingSrc = HTMGT_RC_OCC_UNAVAILABLE;
                            }
                        }
                        else
                        {
                            TMGT_ERR("passThruCommand: invalid OCC command "
                                     "length %d", i_cmdLength);
                            failingSrc = HTMGT_RC_INVALID_LENGTH;
                        }
                        break;

                    case PASSTHRU_CLEAR_RESET_COUNTS:
                        TMGT_INF("passThruCommand: Clear all OCC reset counts");
                        OccManager::clearResetCounts();
                        break;

                    case PASSTHRU_EXIT_SAFE_MODE:
                        {
                            TMGT_INF("passThruCommand: Clear Safe Mode");
                            // Clear OCC reset counts and failed flags
                            OccManager::clearResetCounts();
                            // Clear safe mode reason
                            OccManager::updateSafeModeReason(0, 0);
                            // Clear system safe mode flag/attribute
                            TARGETING::Target* sys = NULL;
                            TARGETING::targetService().getTopLevelTarget(sys);
                            const uint8_t safeMode = 0;
                            // Mark system as NOT being in safe mode
                            if(sys)
                            {
                                sys->setAttr<TARGETING::ATTR_HTMGT_SAFEMODE>
                                    (safeMode);
                            }
                            // Reset the OCCs (do not increment reset count
                            // or attempt comm with OCC since they are in reset)
                            TMGT_INF("passThruCommand: Calling resetOccs");
                            err = OccManager::resetOccs(NULL, true, true);
                            if (err != NULL)
                            {
                                TMGT_ERR("passThruCommand: Exit Save Mode "
                                         "resetOccs failed with rc 0x%04X",
                                         err->reasonCode());
                            }
                        }
                        break;

                    case PASSTHRU_RESET_PM_COMPLEX:
                        TMGT_INF("passThruCommand: Reset PM Complex");

                        err = OccManager::resetOccs(nullptr, true, true);
                        if(err)
                        {
                            TMGT_ERR("passThruCommand: Reset PM Complex FAIL "
                                        "with rc 0x%04X", err->reasonCode() );
                        }
                        break;

                    //HOLD for future need. case PASSTHRU_QUERY_MODE_FUNCTION:
                    //    TMGT_INF("passThruCommand: Query mode or function");

                    //    break;

                    case PASSTHRU_ENA_DIS_OPAL_STATE:
                      {
                        TMGT_INF("passThruCommand: enable/disable OPAL STATE");

                        if (i_cmdLength == 2)
                        {
                           //0 = disable OPAL mode (i.e. run as PowerVM)
                           if (i_cmdData[1] == 0)
                           {
                               G_system_type = OCC_CFGDATA_OPENPOWER_POWERVM;
                           }
                           //1 = enable OPAL mode
                           else if (i_cmdData[1] == 1)
                           {
                                G_system_type = OCC_CFGDATA_OPENPOWER_OPALVM;
                           }
                           else
                           {
                              TMGT_ERR("passThruCommand: Invalid requested OPAL"
                                         " mode 0x%02X ", i_cmdData[1] );
                                /*@
                                 * @errortype
                                 * @reasoncode   HTMGT_RC_INVALID_PARAMETER
                                 * @moduleid     HTMGT_MOD_PASS_THRU
                                 * @userdata1    command data[0-7]
                                 * @userdata2    command data length
                                 * @devdesc      Invalid pass thru command data
                                 */
                              failingSrc = HTMGT_RC_INVALID_PARAMETER;
                           }
                            if(failingSrc == HTMGT_RC_NO_ERROR)
                            {
                              TMGT_INF("passThruCommand: OPAL State(0x%02X), "
                                        "resetting PM Complex", G_system_type);
                              err = OccManager::resetOccs(nullptr,true,true);
                              if(err)
                              {
                                TMGT_ERR("passThruCommand: PM Complex Reset "
                                        "failed with rc 0x%04X after updating "
                                        "OPAL state", err->reasonCode());
                              }
                           }
                        }
                        else
                        {
                            TMGT_ERR("passThruCommand: invalid OPAL State "
                                     "length %d", i_cmdLength);
                            failingSrc = HTMGT_RC_INVALID_LENGTH;
                        }
                      }
                      break;

                    case PASSTHRU_SET_OCC_STATE:
                        {
                            TMGT_INF("passThruCommand: Set OCC State");
                            occStateId l_targetState = (occStateId)i_cmdData[1];
                            //Validate state requested is supported.
                            if( (l_targetState == OCC_STATE_OBSERVATION) ||
                                (l_targetState == OCC_STATE_ACTIVE) ||
                                (l_targetState == OCC_STATE_CHARACTERIZATION) )
                            {
                                // Set state for all OCCs
                                err = OccManager::setOccState(l_targetState);
                                if (nullptr == err)
                                {
                                    TMGT_INF("passThruCommand: OCC states  "
                                            "updated to 0x%02X", l_targetState);
                                }
                                else
                                {
                                    TMGT_ERR("passThruCommand: OCC state change"
                                            " FAIL with rc 0x%04X",
                                            err->reasonCode());
                                }
                            }
                            else
                            {
                                TMGT_ERR("passThruCommand: Invalid requested "
                                         "state 0x%08X ", l_targetState );
                                failingSrc = HTMGT_RC_INVALID_PARAMETER;
                            }
                        }
                        break;

                    case PASSTHRU_OCC_CFG_DATA:
                        if (i_cmdLength == 3)
                        {
                            const uint8_t occInstance = i_cmdData[1];
                            const uint8_t format = i_cmdData[2];
                            Occ *occPtr = OccManager::getOcc(occInstance);
                            if (occPtr)
                            {
                                TMGT_INF("passThruCommand: OCC%d config format "
                                         "0x%02X",
                                         occInstance, format);
                                readConfigData(occPtr, format,
                                               o_rspLength, o_rspData);
                            }
                            else
                            {
                                TMGT_ERR("passThruCommand: Unable to find "
                                         "OCC%d", occInstance);
                                failingSrc = HTMGT_RC_OCC_UNAVAILABLE;
                            }
                        }
                        else
                        {
                            TMGT_ERR("passThruCommand: invalid data length %d",
                                     i_cmdLength);
                            failingSrc = HTMGT_RC_INVALID_LENGTH;
                        }
                        break;


                    default:
                        TMGT_ERR("passThruCommand: Invalid command 0x%08X "
                              "(%d bytes)", UINT32_GET(i_cmdData), i_cmdLength);
                        /*@
                         * @errortype
                         * @reasoncode   HTMGT_RC_INVALID_DATA
                         * @moduleid     HTMGT_MOD_PASS_THRU
                         * @userdata1    command data[0-7]
                         * @userdata2    command data length
                         * @devdesc      Invalid pass thru command
                         */
                        failingSrc = HTMGT_RC_INVALID_DATA;
                        break;
                }

                if ((HTMGT_RC_NO_ERROR != failingSrc) && (NULL == err))
                {
                    bldErrLog(err, HTMGT_MOD_PASS_THRU,
                              failingSrc,
                              UINT32_GET(i_cmdData),
                              UINT32_GET(&i_cmdData[4]),
                              0, i_cmdLength,
                              ERRORLOG::ERRL_SEV_INFORMATIONAL);
                }
            }
        }

        return err;

    } // end passThruCommand()

}