1// -*- mode:c++ -*- 2 3// Copyright (c) 2007 The Hewlett-Packard Development Company 4// All rights reserved. 5// 6// Redistribution and use of this software in source and binary forms, 7// with or without modification, are permitted provided that the 8// following conditions are met: 9// 10// The software must be used only for Non-Commercial Use which means any 11// use which is NOT directed to receiving any direct monetary 12// compensation for, or commercial advantage from such use. Illustrative 13// examples of non-commercial use are academic research, personal study, 14// teaching, education and corporate research & development. 15// Illustrative examples of commercial use are distributing products for 16// commercial advantage and providing services using the software for 17// commercial advantage. 18// 19// If you wish to use this software or functionality therein that may be 20// covered by patents for commercial use, please contact: 21// Director of Intellectual Property Licensing 22// Office of Strategy and Technology 23// Hewlett-Packard Company 24// 1501 Page Mill Road 25// Palo Alto, California 94304 26// 27// Redistributions of source code must retain the above copyright notice, 28// this list of conditions and the following disclaimer. Redistributions 29// in binary form must reproduce the above copyright notice, this list of 30// conditions and the following disclaimer in the documentation and/or 31// other materials provided with the distribution. Neither the name of 32// the COPYRIGHT HOLDER(s), HEWLETT-PACKARD COMPANY, nor the names of its 33// contributors may be used to endorse or promote products derived from 34// this software without specific prior written permission. No right of 35// sublicense is granted herewith. Derivatives of the software and 36// output created using the software may be prepared, but only for 37// Non-Commercial Uses. Derivatives of the software may be shared with 38// others provided: (i) the others agree to abide by the list of 39// conditions herein which includes the Non-Commercial Use restrictions; 40// and (ii) such Derivatives of the software include the above copyright 41// notice to acknowledge the contribution from this software where 42// applicable, this list of conditions and the disclaimer below. 43// 44// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 45// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 46// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 47// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 48// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 49// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 50// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 51// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 52// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 53// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 54// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 55// 56// Authors: Gabe Black 57
|
58//The operand types a microop template can be specialized with
59output header {{
60 enum OperandType {
61 RegisterOperand,
62 ImmediateOperand
63 };
|
58let {{ 59 # This will be populated with mappings between microop mnemonics and 60 # the classes that represent them. 61 microopClasses = {} |
62}}; 63 64//A class which is the base of all x86 micro ops. It provides a function to 65//set necessary flags appropriately. 66output header {{ 67 class X86MicroOpBase : public X86StaticInst 68 { 69 protected: 70 const char * instMnem; 71 uint8_t opSize; 72 uint8_t addrSize; 73 74 X86MicroOpBase(ExtMachInst _machInst, 75 const char *mnem, const char *_instMnem, 76 bool isMicro, bool isDelayed, 77 bool isFirst, bool isLast, 78 OpClass __opClass) : 79 X86StaticInst(mnem, _machInst, __opClass), 80 instMnem(_instMnem) 81 { 82 flags[IsMicroOp] = isMicro; 83 flags[IsDelayedCommit] = isDelayed; 84 flags[IsFirstMicroOp] = isFirst; 85 flags[IsLastMicroOp] = isLast; 86 } 87 88 std::string generateDisassembly(Addr pc, 89 const SymbolTable *symtab) const 90 { 91 std::stringstream ss; 92 93 ccprintf(ss, "\t%s.%s", instMnem, mnemonic); 94 95 return ss.str(); 96 } 97 }; 98}}; 99
|
102// This sets up a class which is templated on the type of
103// arguments a particular flavor of a microcode instruction
104// can accept. It's parameters are specialized to create polymorphic
105// behavior in microops.
106def template BaseMicroOpTemplateDeclare {{
107 template%(signature)s
108 class %(class_name)s;
109}};
|
100////////////////////////////////////////////////////////////////////////// 101// 102// Base class for the python representation of x86 microops |
103 104let {{
|
112 def buildBaseMicroOpTemplate(Name, numParams):
113 assert(numParams > 0)
114 signature = "<"
115 signature += "int SignatureOperandTypeSpecifier0"
116 for count in xrange(1,numParams):
117 signature += \
118 ", int SingatureOperandTypeSpecifier%d" % count
119 signature += ">"
120 subs = {"signature" : signature, "class_name" : Name}
121 return BaseMicroOpTemplateDeclare.subst(subs)
|
105 class X86Microop(object): 106 def __init__(self, name): 107 self.name = name 108 109 # This converts a list of python bools into 110 # a comma seperated list of C++ bools. 111 def microFlagsText(self, vals): 112 text = "" 113 for val in vals: 114 if val: 115 text += ", true" 116 else: 117 text += ", false" 118 return text 119 120 def getAllocator(self, mnemonic, *microFlags): 121 return 'new %s(machInst, %s)' % (self.className, mnemonic, self.microFlagsText(microFlags)) |
122}}; 123
|
124let {{
125 def buildMicroOpTemplateDict(*params):
126 signature = "<"
127 if len(params):
128 signature += params[0]
129 if len(params) > 1:
130 for param in params[1:]:
131 signature += ", %s" % param
132 signature += ">"
133 subs = {"param_dec" : "", "param_arg_dec" : "",
134 "param_init" : "", "signature" : signature}
135 for count in xrange(len(params)):
136 subs["param_dec"] += "uint64_t param%d;\n" % count
137 subs["param_arg_dec"] += ", uint64_t _param%d" % count
138 subs["param_init"] += ", param%d(_param%d)" % (count, count)
139 return subs
|
124////////////////////////////////////////////////////////////////////////// 125// 126// LdStOp Microop templates 127// 128////////////////////////////////////////////////////////////////////////// 129 130def template MicroLdStOpDeclare {{ 131 class %(class_name)s : public X86MicroOpBase 132 { 133 protected: 134 const uint8_t scale; 135 const RegIndex index; 136 const RegIndex base; 137 const uint64_t disp; 138 const uint8_t segment; 139 const RegIndex data; 140 const uint8_t dataSize; 141 const uint8_t addressSize; 142 void buildMe(); 143 144 public: 145 %(class_name)s(ExtMachInst _machInst, 146 const char * instMnem, 147 bool isMicro, bool isDelayed, bool isFirst, bool isLast, 148 uint8_t _scale, RegIndex _index, RegIndex _base, 149 uint64_t _disp, uint8_t _segment, 150 RegIndex _data, 151 uint8_t _dataSize, uint8_t _addressSize); 152 153 %(class_name)s(ExtMachInst _machInst, 154 const char * instMnem, 155 uint8_t _scale, RegIndex _index, RegIndex _base, 156 uint64_t _disp, uint8_t _segment, 157 RegIndex _data, 158 uint8_t _dataSize, uint8_t _addressSize); 159 160 %(BasicExecDeclare)s 161 }; |
162}}; 163
|
142// A tmeplate for building a specialized version of the microcode
143// instruction which specifies which arguments it wants
144def template MicroOpDeclare {{
145 template<>
146 class %(class_name)s%(signature)s : public X86MicroOpBase
|
164def template MicroLdStOpConstructor {{ 165 166 inline void %(class_name)s::buildMe() |
167 {
|
168 %(constructor)s; 169 } 170 171 inline %(class_name)s::%(class_name)s( 172 ExtMachInst machInst, const char * instMnem, 173 uint8_t _scale, RegIndex _index, RegIndex _base, 174 uint64_t _disp, uint8_t _segment, 175 RegIndex _data, 176 uint8_t _dataSize, uint8_t _addressSize) : 177 %(base_class)s(machInst, "%(mnemonic)s", instMnem, 178 false, false, false, false, %(op_class)s), 179 scale(_scale), index(_index), base(_base), 180 disp(_disp), segment(_segment), 181 data(_data), 182 dataSize(_dataSize), addressSize(_addressSize) 183 { 184 buildMe(); 185 } 186 187 inline %(class_name)s::%(class_name)s( 188 ExtMachInst machInst, const char * instMnem, 189 bool isMicro, bool isDelayed, bool isFirst, bool isLast, 190 uint8_t _scale, RegIndex _index, RegIndex _base, 191 uint64_t _disp, uint8_t segment, 192 RegIndex data, 193 uint8_t dataSize, uint8_t addressSize) : 194 %(base_class)s(machInst, "%(mnemonic)s", instMnem, 195 isMicro, isDelayed, isFirst, isLast, %(op_class)s), 196 scale(_scale), index(_index), base(_base), 197 disp(_disp), segment(_segment), 198 data(_data), 199 dataSize(_dataSize), addressSize(_addressSize) 200 { 201 buildMe(); 202 } 203}}; 204 205////////////////////////////////////////////////////////////////////////// 206// 207// LIMMOp Microop templates 208// 209////////////////////////////////////////////////////////////////////////// 210 211def template MicroLIMMOpDeclare {{ 212 class %(class_name)s : public X86MicroOpBase 213 { |
214 protected:
|
149 %(param_dec)s
|
215 const RegIndex dest; 216 const uint64_t imm; |
217 void buildMe(); 218 219 public: 220 %(class_name)s(ExtMachInst _machInst, 221 const char * instMnem,
|
155 bool isMicro, bool isDelayed,
156 bool isFirst, bool isLast
157 %(param_arg_dec)s);
|
222 bool isMicro, bool isDelayed, bool isFirst, bool isLast, 223 RegIndex _dest, uint64_t _imm); |
224 225 %(class_name)s(ExtMachInst _machInst,
|
160 const char * instMnem
161 %(param_arg_dec)s);
|
226 const char * instMnem, 227 RegIndex _dest, uint64_t _imm); |
228 229 %(BasicExecDeclare)s 230 }; 231}}; 232
|
167def template MicroOpConstructor {{
|
233def template MicroLIMMOpConstructor {{ |
234
|
169 inline void %(class_name)s%(signature)s::buildMe()
|
235 inline void %(class_name)s::buildMe() |
236 { 237 %(constructor)s; 238 } 239
|
174 inline %(class_name)s%(signature)s::%(class_name)s(
175 ExtMachInst machInst, const char * instMnem
176 %(param_arg_dec)s) :
|
240 inline %(class_name)s::%(class_name)s( 241 ExtMachInst machInst, const char * instMnem, 242 RegIndex _dest, uint64_t _imm) : |
243 %(base_class)s(machInst, "%(mnemonic)s", instMnem,
|
178 false, false, false, false, %(op_class)s)
179 %(param_init)s
|
244 false, false, false, false, %(op_class)s), 245 dest(_dest), imm(_imm) |
246 { 247 buildMe(); 248 } 249
|
184 inline %(class_name)s%(signature)s::%(class_name)s(
|
250 inline %(class_name)s::%(class_name)s( |
251 ExtMachInst machInst, const char * instMnem,
|
186 bool isMicro, bool isDelayed, bool isFirst, bool isLast
187 %(param_arg_dec)s)
188 : %(base_class)s(machInst, "%(mnemonic)s", instMnem,
189 isMicro, isDelayed, isFirst, isLast, %(op_class)s)
190 %(param_init)s
|
252 bool isMicro, bool isDelayed, bool isFirst, bool isLast, 253 RegIndex _dest, uint64_t _imm) : 254 %(base_class)s(machInst, "%(mnemonic)s", instMnem, 255 isMicro, isDelayed, isFirst, isLast, %(op_class)s), 256 dest(_dest), imm(_imm) |
257 { 258 buildMe(); 259 } 260}};
|
261 262////////////////////////////////////////////////////////////////////////// 263// 264// FpOp Microop templates 265// 266////////////////////////////////////////////////////////////////////////// 267 268//TODO Actually write an fp microop base class. |
|