summaryrefslogtreecommitdiffstats
path: root/src/usr/hwpf/hwp/build_winkle_images/p8_set_pore_bar/p8_pfet_control.H
blob: 1c5ce25ad35afe1543a6b7649aacff5d7de3bb1c (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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/usr/hwpf/hwp/build_winkle_images/p8_set_pore_bar/p8_pfet_control.H $ */
/*                                                                        */
/* IBM CONFIDENTIAL                                                       */
/*                                                                        */
/* COPYRIGHT International Business Machines Corp. 2012                   */
/*                                                                        */
/* p1                                                                     */
/*                                                                        */
/* Object Code Only (OCO) source materials                                */
/* Licensed Internal Code Source Materials                                */
/* IBM HostBoot Licensed Internal Code                                    */
/*                                                                        */
/* The source code for this program is not published or otherwise         */
/* divested of its trade secrets, irrespective of what has been           */
/* deposited with the U.S. Copyright Office.                              */
/*                                                                        */
/* Origin: 30                                                             */
/*                                                                        */
/* IBM_PROLOG_END_TAG                                                     */
// $Id: p8_pfet_control.H,v 1.2 2012/12/12 04:28:30 stillgs Exp $
// $Source: /afs/awd/projects/eclipz/KnowledgeBase/.cvsroot/eclipz/chips/p8/working/procedures/ipl/fapi/p8_pfet_control.H,v $
//------------------------------------------------------------------------------
// *|
// *! (C) Copyright International Business Machines Corp. 2011
// *! All Rights Reserved -- Property of IBM
// *! *** IBM Confidential ***
// *|
// *! TITLE       : p8_pfet_control.H
// *! DESCRIPTION : General routines for controlling EX chiplet PFET headers
// *!
// *! OWNER NAME  : Ralf Maier    Email: ralf.maier@de.ibm.com
// *! BACKUP NAME : Greg Still    Email: stillgs@us.ibm.com
// *!
//------------------------------------------------------------------------------

#ifndef _P8_PFETCTL_H_
#define _P8_PFETCTL_H_


extern "C" {

#include "p8_pfet_types.H"

// Overrides
extern const uint32_t NO_ORVAL_PARM; 
extern const uint32_t NO_ORSEL_PARM;
extern const uint32_t OR_DISABLE;
extern uint32_t or_val; 
extern uint32_t or_sel; 

// Domains
extern pfet_dom_t domain;

// Force operation
extern pfet_force_t force_op;

// Vret and voff selectors
extern const int32_t FIRST_STAGE;
extern const int32_t LAST_STAGE;
extern const int32_t NO_SEL_PARM;
extern int32_t vret_sel;
extern int32_t voff_sel; 

// stage_value string
extern char * stage_values_str;
// powup_delay_values_str
extern char * powup_delay_values_str;
// powdn_delay_values_str
extern char * powdn_delay_values_str;

// \todo  Define the read structure for programmatic data return

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


// function pointer typedef definition for HWP call support
typedef fapi::ReturnCode (*p8_pfet_control_FP_t) (const fapi::Target&,
                                                uint8_t, 
                                                pfet_dom_t,
                                                pfet_force_t
                                               );
                                               
typedef fapi::ReturnCode (*p8_pfet_read_FP_t)   (const fapi::Target&);

//------------------------------------------------------------------------------
// Constant definitions
//------------------------------------------------------------------------------
// Macros for easier handling of parms
#define PFET_FORCE(target_mac, ex_mac, domain_mac, op_mac) \
  p8_pfet_control(target_mac, ex_mac, domain_mac, op_mac);

//------------------------------------------------------------------------------
// Parameter structure definitions
//------------------------------------------------------------------------------


//------------------------------------------------------------------------------
// Function prototype
//------------------------------------------------------------------------------
/// \param[in] i_target     Chip target
/// \param[in] domain       Domain: BOTH, ECO, CORE

/// \retval ECMD_SUCCESS if something good happens,
/// \retval BAD_RETURN_CODE otherwise
fapi::ReturnCode 
p8_pfet_control(    const fapi::Target& i_target, 
                    uint8_t             i_ex_number,
                    pfet_dom_t          domain,
                    pfet_force_t        op
                 );


fapi::ReturnCode 
p8_pfet_read(   const fapi::Target& i_target);


uint8_t convert_delay_to_value (uint32_t i_delay, uint32_t i_attr_proc_nest_frequency);

} // extern "C"

#endif // _P8_PFETCTL_H_
OpenPOWER on IntegriCloud