<commit_before>/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/import/chips/p9/procedures/hwp/nest/p9_tod_move_tod_to_tb.H $ */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2015,2019                        */
/* [+] 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                                                     */
//-----------------------------------------------------------------------------------
//
/// @file p9_tod_move_tod_to_tb.H
/// @brief Procedures to initialize the TOD to 'running' state
///
// *HWP HWP Owner: <NAME> <EMAIL>
// *HWP FW Owner: <NAME> <EMAIL>
// *HWP Team: Nest
// *HWP Level: 2
// *HWP Consumed by:
// ----------------------------------------------------------------------------------
//
// *! ADDITIONAL COMMENTS :
// *!
// *!
// *!
//-----------------------------------------------------------------------------------

#ifndef _P9_TOD_MOVE_TOD_TO_TB_H_
#define _P9_TOD_MOVE_TOD_TO_TB_H_

//-----------------------------------------------------------------------------------
// Includes
//-----------------------------------------------------------------------------------

#include <fapi2.H>
#include <p9_tod_utils.H>

//-----------------------------------------------------------------------------------
// Structure definitions
//-----------------------------------------------------------------------------------

//function pointer typedef definition for HWP call support
typedef fapi2::ReturnCode
(*p9_tod_move_tod_to_tb_FP_t) (const tod_topology_node*, const uint8_t,
                               fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>* );

//-----------------------------------------------------------------------------------
// Constant definitions
//-----------------------------------------------------------------------------------

extern "C" {

//-----------------------------------------------------------------------------------
// Function prototype
//-----------------------------------------------------------------------------------

    /// @brief move_tod_to_tb
    /// @param[in] i_tod_node => Reference to TOD topology (FAPI targets are included in this)
    /// @param[in] i_failingTodProc => Pointer to the fapi target, the memory location addressed by this parameter will be populated with processor target which is not able ot receive proper signals from OSC. Caller needs to look at this parameter only when p9_tod_move_tod_to_tb fail and reason code indicated OSC failure. Defaulted to NULL.
    /// @param[in] i_thread_num => the thread number to complete the transaction on
    /// @return FAPI_RC_SUCCESS if TOD topology is successfully initialized else FAPI or ECMD error is sent through
    fapi2::ReturnCode p9_tod_move_tod_to_tb(const tod_topology_node* i_tod_node,
                                            const uint8_t i_thread_num,
                                            fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>* i_failingTodProc = NULL);


    /// @brief Gets the value in the TFMR register
    /// @param[in] i_target       => P9 chip target
    /// @param[in] i_thread_num   => The thread number we want to run on
    /// @param[out] o_tfmr_val    => Value that is in the TFMR register
    /// @return FAPI_RC_SUCCESS if TFMR read is successful else FAPI or ECMD error is sent through
    fapi2::ReturnCode p9_tod_utils_get_tfmr_reg(
        const fapi2::Target<fapi2::TARGET_TYPE_CORE>& i_target,
        const uint8_t i_thread_num,
        fapi2::buffer<uint64_t>& o_tfmr_val);

    /// @brief Sets the value in the TFMR register
    /// @param[in] i_target => P9 chip target
    /// @param[in] i_thread_num => The thread number we want to run on
    /// @param[in] i_tfmr_val => Value that will be put in the TFMR register
    /// @return FAPI_RC_SUCCESS if TFMR write is successful else FAPI or ECMD error is sent through
    fapi2::ReturnCode p9_tod_utils_set_tfmr_reg(
        const fapi2::Target<fapi2::TARGET_TYPE_CORE>& i_target,
        const uint8_t i_thread_num,
        fapi2::buffer<uint64_t>& i_tfmr_val);

} //extern "C"

#endif //_P9_TOD_MOVE_TOD_TO_TB_H_
<commit_msg>L3 update -- TOD HWPs<commit_after>/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/import/chips/p9/procedures/hwp/nest/p9_tod_move_tod_to_tb.H $ */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2015,2019                        */
/* [+] 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                                                     */
//------------------------------------------------------------------------------
//
/// @file p9_tod_move_tod_to_tb.H
/// @brief Procedures to initialize the TOD to 'running' state
///
// *HWP HWP Owner: <NAME> <EMAIL>
// *HWP HWP Owner: <NAME> <EMAIL>
// *HWP FW Owner: <NAME> <EMAIL>
// *HWP Team: Nest
// *HWP Level: 3
// *HWP Consumed by: Cronus only
//
// -----------------------------------------------------------------------------

#ifndef _P9_TOD_MOVE_TOD_TO_TB_H_
#define _P9_TOD_MOVE_TOD_TO_TB_H_

//------------------------------------------------------------------------------
// Includes
//------------------------------------------------------------------------------

#include <fapi2.H>
#include <p9_tod_utils.H>

//------------------------------------------------------------------------------
// Structure definitions
//------------------------------------------------------------------------------

//function pointer typedef definition for HWP call support
typedef fapi2::ReturnCode (*p9_tod_move_tod_to_tb_FP_t) (
    const tod_topology_node*,
    const uint8_t,
    fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>*);

//------------------------------------------------------------------------------
// Function prototype
//------------------------------------------------------------------------------

extern "C" {

/// @brief HWP entry point -- move_tod_to_tb
/// @param[in] i_tod_node Reference to TOD topology (including FAPI targets)
/// @param[in] i_thread_num The thread number to complete the transaction on
/// @param[in] i_failingTodProc Pointer to the fapi target, will be populated
///            with processor processor target which is not able ot receive
///            proper signals from OSC. Caller needs to look at this parameter
///            only when p9_tod_move_tod_to_tb fails and reason code indicated
///            OSC failure.  Defaulted to NULL.
/// @return FAPI_RC_SUCCESS if TOD topology is successfully initialized else
///         error
    fapi2::ReturnCode p9_tod_move_tod_to_tb(
        const tod_topology_node* i_tod_node,
        const uint8_t i_thread_num,
        fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>* o_failingTodProc = NULL);

} //extern "C"

#endif //_P9_TOD_MOVE_TOD_TO_TB_H_

{'fraction_non_alphanumeric': 0.23468551526326573, 'fraction_numerical': 0.008502356074574882, 'mean_word_length': 0.9767159343996761, 'pattern_counts': {'":': 0, '<': 25, '<?xml version=': 0, '>': 34, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 66, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2403497', 'n_tokens_mistral': 2247, 'n_tokens_neox': 2159, 'n_words': 651}