summaryrefslogtreecommitdiffstats
path: root/src/import/chips/p9/procedures/hwp/perv/p9_stopclocks.H
blob: 3338f667cdd073f72d6f0f1efbe2800eb456df5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/import/chips/p9/procedures/hwp/perv/p9_stopclocks.H $     */
/*                                                                        */
/* OpenPOWER sbe Project                                                  */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2016,2017                        */
/* [+] 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_stopclocks.H
///
/// @brief This is the header file for p9_stopclocks.
//------------------------------------------------------------------------------
// *HWP HW Owner        : Soma BhanuTej <soma.bhanu@in.ibm.com>
// *HWP HW Backup Owner : Srinivas V Naga <srinivan@in.ibm.com>
// *HWP FW Owner        : Sunil Kumar <skumar8j@in.ibm.com>
// *HWP Team            : Perv
// *HWP Level           : 2
// *HWP Consumed by     : FSP:HB
//------------------------------------------------------------------------------


#ifndef _P9_STOPCLOCKS_H_
#define _P9_STOPCLOCKS_H_
#define btos(x) ((x)?"TRUE":"FALSE")

#include <fapi2.H>
#include <p9_hcd_common.H>

typedef fapi2::ReturnCode (*p9_stopclocks_FP_t)(const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>&,
        const bool,
        const bool,
        const bool,
        const bool,
        const bool,
        const bool,
        const bool,
        const bool,
        const p9hcd::P9_HCD_CLK_CTRL_CONSTANTS,
        const p9hcd::P9_HCD_EX_CTRL_CONSTANTS );

extern "C"
{
    /**
    * @brief p9_stopclocks procedure:  The purpose of this procedure is to stop the clocks of the P9 processor chip
    *
    * @param[in] i_target                Reference to processor chip target
    * @param[in] i_stop_nest_clks        True if NEST chiplet clocks should be stopped, else false
    * @param[in] i_stop_mc_clks          True if MC   chiplet clocks should be stopped, else false
    * @param[in] i_stop_xbus_clks        True if XBUS chiplet clocks should be stopped, else false
    * @param[in] i_stop_obus_clks        True if OBUS chiplet clocks should be stopped, else false
    * @param[in] i_stop_pcie_clks        True if PCIE chiplet clocks should be stopped, else false
    * @param[in] i_stop_tp_clks          True if PERV (TP) chiplet clocks all except PIB/NET should be stopped, else false
    * @param[in] i_stop_pib_clks         True if PERV (TP) chiplet PIB/NET clocks should be stopped, else false
    * @param[in] i_stop_vitl_clks        True if PERV VITL clocks should be stopped, else false
    * @param[in] i_eq_clk_regions        EQ chiplet clock regions of which clocks should be stopped
    * @param[in] i_ex_select             EX chiplet selected for clocks stop
    *
    * @return ReturnCode
    */
    fapi2::ReturnCode p9_stopclocks(const fapi2::Target<fapi2::TARGET_TYPE_PROC_CHIP>& i_target_chip,
                                    const bool i_stop_nest_clks = true,
                                    const bool i_stop_mc_clks = true,
                                    const bool i_stop_xbus_clks = true,
                                    const bool i_stop_obus_clks = true,
                                    const bool i_stop_pcie_clks = true,
                                    const bool i_stop_tp_clks = false,
                                    const bool i_stop_pib_clks = false,
                                    const bool i_stop_vitl_clks = false,
                                    const p9hcd::P9_HCD_CLK_CTRL_CONSTANTS i_eq_clk_regions = p9hcd::CLK_REGION_ALL_BUT_PLL_REFR,
                                    const p9hcd::P9_HCD_EX_CTRL_CONSTANTS i_ex_select = p9hcd::BOTH_EX);
}

#endif
OpenPOWER on IntegriCloud