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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/usr/diag/prdf/common/framework/register/prdfScomRegisterAccess.H $ */
/* */
/* OpenPOWER HostBoot Project */
/* */
/* COPYRIGHT International Business Machines Corp. 2012,2014 */
/* */
/* 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 */
#ifndef __PRDF_REGISTER_
#define __PRDF_REGISTER_
#include <prdfScomRegister.H>
#include <prdfBitString.H>
#include <prdfPlatServices.H>
/**
* @brief Models register.This model of register has target info
*
* In order to reduce the register objects required by PRD to do attention
* analysis, these are shared across all the RuleChip objects associated with
* target of same type.In order to realize this,target info is taken out of
* register object .RuleChip contains target info.During Analysis ,pointer to
* Rulechip under analysis is maintained in Service Data collector.During
* register Read and Write,target info is obtained by register from service data
* collector.This idea fails when getRegister is called for Register read and
* write.It may be called from plugin code which may use a RuleChip different
* from the one in SDC.We would like to avoid SDC getting updated from multiple
* places.To simplify solution for this use case, a wrapper register is required
* .This register model knows which rule chip it is associated with.When plugin
* code calls getRegister ,instead of returning targetless flyweight object,it
* returns an object of class ScomRegisterAccess.Since register Read Write is
* in parent class ,it's just a container for Rulechip pointer giving us a way
* to do scom without having to look for associated target/rule chip somewhere
* else.
*/
namespace PRDF
{
class ScomRegisterAccess : public ScomRegister
{
public :
/**
* @brief constructor
* @param i_Register Reference to flyweight register
* @param i_pchip RuleChip associated with register
*/
ScomRegisterAccess( const SCAN_COMM_REGISTER_CLASS & i_Register,
ExtensibleChip* i_pchip );
/**
* @brief constructor
*/
ScomRegisterAccess():ScomRegister( ),iv_containerChip ( NULL ){ };
/**
* @brief Destructor
*/
~ScomRegisterAccess(){ };
/**
* @brief Returns pointer to rulechip associated with register
* @return Returns rule chip pointer
*/
virtual ExtensibleChip* getChip( ) const;
/**
* @brief compares two ScomRegisterAccess register for equality
* @param i_rightRegister register to be compared against
* @return Returns true if registers are equal false otherwise
*/
bool operator == ( const ScomRegisterAccess & i_rightRegister ) const;
/**
* @brief defines < operation for ScomRegisterAccess
* @param i_rightRegister register to be compared against
* @return Returns false if i_rightRegisters is less and true otherwise
*/
bool operator < ( const ScomRegisterAccess & i_rightRegister ) const;
/**
* @brief defines >= operation for ScomRegisterAccess
* @param i_right register to be compared against
* @return Returns true if registers is >= i_rightRegister false
* otherwise
*/
bool operator >= ( const ScomRegisterAccess & i_right ) const;
private://Data
ExtensibleChip* iv_containerChip;
};
}//namepsace PRDF ends
#endif
|
