lm32_include.v

Sun, 04 Apr 2010 20:42:58 +0100

author
Philip Pemberton <philpem@philpem.me.uk>
date
Sun, 04 Apr 2010 20:42:58 +0100
changeset 1
ae6035050124
parent 0
cd0b58aa6f83
child 4
99b7b037ce82
permissions
-rw-r--r--

remove need for system_conf.v

philpem@0 1 // =============================================================================
philpem@0 2 // COPYRIGHT NOTICE
philpem@0 3 // Copyright 2006 (c) Lattice Semiconductor Corporation
philpem@0 4 // ALL RIGHTS RESERVED
philpem@0 5 // This confidential and proprietary software may be used only as authorised by
philpem@0 6 // a licensing agreement from Lattice Semiconductor Corporation.
philpem@0 7 // The entire notice above must be reproduced on all authorized copies and
philpem@0 8 // copies may only be made to the extent permitted by a licensing agreement from
philpem@0 9 // Lattice Semiconductor Corporation.
philpem@0 10 //
philpem@0 11 // Lattice Semiconductor Corporation TEL : 1-800-Lattice (USA and Canada)
philpem@0 12 // 5555 NE Moore Court 408-826-6000 (other locations)
philpem@0 13 // Hillsboro, OR 97124 web : http://www.latticesemi.com/
philpem@0 14 // U.S.A email: techsupport@latticesemi.com
philpem@0 15 // =============================================================================/
philpem@0 16 // FILE DETAILS
philpem@0 17 // Project : LatticeMico32
philpem@0 18 // File : lm32_include.v
philpem@0 19 // Title : CPU global macros
philpem@0 20 // Version : 6.1.17
philpem@0 21 // : Initial Release
philpem@0 22 // Version : 7.0SP2, 3.0
philpem@0 23 // : No Change
philpem@0 24 // Version : 3.1
philpem@0 25 // : No Change
philpem@0 26 // Version : 3.2
philpem@0 27 // : No Change
philpem@0 28 // Version : 3.3
philpem@0 29 // : Support for extended configuration register
philpem@0 30 // =============================================================================
philpem@0 31
philpem@0 32 `ifdef LM32_INCLUDE_V
philpem@0 33 `else
philpem@0 34 `define LM32_INCLUDE_V
philpem@0 35
philpem@1 36 // (config opts from http://www.reflextor.org/trac/a51/browser/fpga/main/cores/lm32/rtl/lm32_include.v?rev=20)
philpem@1 37 //
philpem@1 38 // Common configuration options
philpem@1 39 //
philpem@1 40
philpem@1 41 `define CFG_EBA_RESET 32'h0
philpem@1 42 `define CFG_DEBA_RESET 32'h0
philpem@1 43
philpem@1 44 `define CFG_PL_MULTIPLY_ENABLED
philpem@1 45 `define CFG_PL_BARREL_SHIFT_ENABLED
philpem@1 46 `define CFG_SIGN_EXTEND_ENABLED
philpem@1 47 `define CFG_MC_DIVIDE_ENABLED
philpem@1 48
philpem@1 49 // Bug in Mico32/Xst ?
philpem@1 50 // CFG_ICACHE_ASSOCIATIVITY=2 => works fine
philpem@1 51 // CFG_ICACHE_ASSOCIATIVITY=1 => disaster
philpem@1 52 // TODO: try with the expensive synthesizers
philpem@1 53 `define CFG_ICACHE_ENABLED
philpem@1 54 `define CFG_ICACHE_ASSOCIATIVITY 2
philpem@1 55 `define CFG_ICACHE_SETS 512
philpem@1 56 `define CFG_ICACHE_BYTES_PER_LINE 16
philpem@1 57 `define CFG_ICACHE_BASE_ADDRESS 32'h0
philpem@1 58 `define CFG_ICACHE_LIMIT 32'h7fffffff
philpem@1 59
philpem@1 60 `define CFG_DCACHE_ENABLED
philpem@1 61 `define CFG_DCACHE_ASSOCIATIVITY 2
philpem@1 62 `define CFG_DCACHE_SETS 512
philpem@1 63 `define CFG_DCACHE_BYTES_PER_LINE 16
philpem@1 64 `define CFG_DCACHE_BASE_ADDRESS 32'h0
philpem@1 65 `define CFG_DCACHE_LIMIT 32'h7fffffff
philpem@1 66
philpem@1 67 //
philpem@1 68 // End of common configuration options
philpem@1 69 //
philpem@0 70
philpem@0 71 `ifdef TRUE
philpem@0 72 `else
philpem@0 73 `define TRUE 1'b1
philpem@0 74 `define FALSE 1'b0
philpem@0 75 `define TRUE_N 1'b0
philpem@0 76 `define FALSE_N 1'b1
philpem@0 77 `endif
philpem@0 78
philpem@0 79 // Wishbone configuration
philpem@0 80 `define CFG_IWB_ENABLED
philpem@0 81 `define CFG_DWB_ENABLED
philpem@0 82
philpem@0 83 // Data-path width
philpem@0 84 `define LM32_WORD_WIDTH 32
philpem@0 85 `define LM32_WORD_RNG (`LM32_WORD_WIDTH-1):0
philpem@0 86 `define LM32_SHIFT_WIDTH 5
philpem@0 87 `define LM32_SHIFT_RNG (`LM32_SHIFT_WIDTH-1):0
philpem@0 88 `define LM32_BYTE_SELECT_WIDTH 4
philpem@0 89 `define LM32_BYTE_SELECT_RNG (`LM32_BYTE_SELECT_WIDTH-1):0
philpem@0 90
philpem@0 91 // Register file size
philpem@0 92 `define LM32_REGISTERS 32
philpem@0 93 `define LM32_REG_IDX_WIDTH 5
philpem@0 94 `define LM32_REG_IDX_RNG (`LM32_REG_IDX_WIDTH-1):0
philpem@0 95
philpem@0 96 // Standard register numbers
philpem@0 97 `define LM32_RA_REG `LM32_REG_IDX_WIDTH'd29
philpem@0 98 `define LM32_EA_REG `LM32_REG_IDX_WIDTH'd30
philpem@0 99 `define LM32_BA_REG `LM32_REG_IDX_WIDTH'd31
philpem@0 100
philpem@0 101 // Range of Program Counter. Two LSBs are always 0.
philpem@0 102 // `ifdef CFG_ICACHE_ENABLED
philpem@0 103 // `define LM32_PC_WIDTH (clogb2(`CFG_ICACHE_LIMIT-`CFG_ICACHE_BASE_ADDRESS)-2)
philpem@0 104 // `else
philpem@0 105 // `ifdef CFG_IWB_ENABLED
philpem@0 106 `define LM32_PC_WIDTH (`LM32_WORD_WIDTH-2)
philpem@0 107 // `else
philpem@0 108 // `define LM32_PC_WIDTH `LM32_IROM_ADDRESS_WIDTH
philpem@0 109 // `endif
philpem@0 110 // `endif
philpem@0 111 `define LM32_PC_RNG (`LM32_PC_WIDTH+2-1):2
philpem@0 112
philpem@0 113 // Range of an instruction
philpem@0 114 `define LM32_INSTRUCTION_WIDTH 32
philpem@0 115 `define LM32_INSTRUCTION_RNG (`LM32_INSTRUCTION_WIDTH-1):0
philpem@0 116
philpem@0 117 // Adder operation
philpem@0 118 `define LM32_ADDER_OP_ADD 1'b0
philpem@0 119 `define LM32_ADDER_OP_SUBTRACT 1'b1
philpem@0 120
philpem@0 121 // Shift direction
philpem@0 122 `define LM32_SHIFT_OP_RIGHT 1'b0
philpem@0 123 `define LM32_SHIFT_OP_LEFT 1'b1
philpem@0 124
philpem@0 125 // Currently always enabled
philpem@0 126 `define CFG_BUS_ERRORS_ENABLED
philpem@0 127
philpem@0 128 // Derive macro that indicates whether we have single-stepping or not
philpem@0 129 `ifdef CFG_ROM_DEBUG_ENABLED
philpem@0 130 `define LM32_SINGLE_STEP_ENABLED
philpem@0 131 `else
philpem@0 132 `ifdef CFG_HW_DEBUG_ENABLED
philpem@0 133 `define LM32_SINGLE_STEP_ENABLED
philpem@0 134 `endif
philpem@0 135 `endif
philpem@0 136
philpem@0 137 // Derive macro that indicates whether JTAG interface is required
philpem@0 138 `ifdef CFG_JTAG_UART_ENABLED
philpem@0 139 `define LM32_JTAG_ENABLED
philpem@0 140 `else
philpem@0 141 `ifdef CFG_DEBUG_ENABLED
philpem@0 142 `define LM32_JTAG_ENABLED
philpem@0 143 `else
philpem@0 144 `endif
philpem@0 145 `endif
philpem@0 146
philpem@0 147 // Derive macro that indicates whether we have a barrel-shifter or not
philpem@0 148 `ifdef CFG_PL_BARREL_SHIFT_ENABLED
philpem@0 149 `define LM32_BARREL_SHIFT_ENABLED
philpem@0 150 `else // CFG_PL_BARREL_SHIFT_ENABLED
philpem@0 151 `ifdef CFG_MC_BARREL_SHIFT_ENABLED
philpem@0 152 `define LM32_BARREL_SHIFT_ENABLED
philpem@0 153 `else
philpem@0 154 `define LM32_NO_BARREL_SHIFT
philpem@0 155 `endif
philpem@0 156 `endif // CFG_PL_BARREL_SHIFT_ENABLED
philpem@0 157
philpem@0 158 // Derive macro that indicates whether we have a multiplier or not
philpem@0 159 `ifdef CFG_PL_MULTIPLY_ENABLED
philpem@0 160 `define LM32_MULTIPLY_ENABLED
philpem@0 161 `else
philpem@0 162 `ifdef CFG_MC_MULTIPLY_ENABLED
philpem@0 163 `define LM32_MULTIPLY_ENABLED
philpem@0 164 `endif
philpem@0 165 `endif
philpem@0 166
philpem@0 167 // Derive a macro that indicates whether or not the multi-cycle arithmetic unit is required
philpem@0 168 `ifdef CFG_MC_DIVIDE_ENABLED
philpem@0 169 `define LM32_MC_ARITHMETIC_ENABLED
philpem@0 170 `endif
philpem@0 171 `ifdef CFG_MC_MULTIPLY_ENABLED
philpem@0 172 `define LM32_MC_ARITHMETIC_ENABLED
philpem@0 173 `endif
philpem@0 174 `ifdef CFG_MC_BARREL_SHIFT_ENABLED
philpem@0 175 `define LM32_MC_ARITHMETIC_ENABLED
philpem@0 176 `endif
philpem@0 177
philpem@0 178 // Derive macro that indicates if we are using an EBR register file
philpem@0 179 `ifdef CFG_EBR_POSEDGE_REGISTER_FILE
philpem@0 180 `define LM32_EBR_REGISTER_FILE
philpem@0 181 `endif
philpem@0 182 `ifdef CFG_EBR_NEGEDGE_REGISTER_FILE
philpem@0 183 `define LM32_EBR_REGISTER_FILE
philpem@0 184 `endif
philpem@0 185
philpem@0 186 // Revision number
philpem@0 187 `define LM32_REVISION 6'h02
philpem@0 188
philpem@0 189 // Logical operations - Function encoded directly in instruction
philpem@0 190 `define LM32_LOGIC_OP_RNG 3:0
philpem@0 191
philpem@0 192 // Conditions for conditional branches
philpem@0 193 `define LM32_CONDITION_WIDTH 3
philpem@0 194 `define LM32_CONDITION_RNG (`LM32_CONDITION_WIDTH-1):0
philpem@0 195 `define LM32_CONDITION_E 3'b001
philpem@0 196 `define LM32_CONDITION_G 3'b010
philpem@0 197 `define LM32_CONDITION_GE 3'b011
philpem@0 198 `define LM32_CONDITION_GEU 3'b100
philpem@0 199 `define LM32_CONDITION_GU 3'b101
philpem@0 200 `define LM32_CONDITION_NE 3'b111
philpem@0 201 `define LM32_CONDITION_U1 3'b000
philpem@0 202 `define LM32_CONDITION_U2 3'b110
philpem@0 203
philpem@0 204 // Size of load or store instruction - Encoding corresponds to opcode
philpem@0 205 `define LM32_SIZE_WIDTH 2
philpem@0 206 `define LM32_SIZE_RNG 1:0
philpem@0 207 `define LM32_SIZE_BYTE 2'b00
philpem@0 208 `define LM32_SIZE_HWORD 2'b11
philpem@0 209 `define LM32_SIZE_WORD 2'b10
philpem@0 210 `define LM32_ADDRESS_LSBS_WIDTH 2
philpem@0 211
philpem@0 212 // Width and range of a CSR index
philpem@0 213 `ifdef CFG_DEBUG_ENABLED
philpem@0 214 `define LM32_CSR_WIDTH 5
philpem@0 215 `define LM32_CSR_RNG (`LM32_CSR_WIDTH-1):0
philpem@0 216 `else
philpem@0 217 `ifdef CFG_JTAG_ENABLED
philpem@0 218 `define LM32_CSR_WIDTH 4
philpem@0 219 `define LM32_CSR_RNG (`LM32_CSR_WIDTH-1):0
philpem@0 220 `else
philpem@0 221 `define LM32_CSR_WIDTH 3
philpem@0 222 `define LM32_CSR_RNG (`LM32_CSR_WIDTH-1):0
philpem@0 223 `endif
philpem@0 224 `endif
philpem@0 225
philpem@0 226 // CSR indices
philpem@0 227 `define LM32_CSR_IE `LM32_CSR_WIDTH'h0
philpem@0 228 `define LM32_CSR_IM `LM32_CSR_WIDTH'h1
philpem@0 229 `define LM32_CSR_IP `LM32_CSR_WIDTH'h2
philpem@0 230 `define LM32_CSR_ICC `LM32_CSR_WIDTH'h3
philpem@0 231 `define LM32_CSR_DCC `LM32_CSR_WIDTH'h4
philpem@0 232 `define LM32_CSR_CC `LM32_CSR_WIDTH'h5
philpem@0 233 `define LM32_CSR_CFG `LM32_CSR_WIDTH'h6
philpem@0 234 `define LM32_CSR_EBA `LM32_CSR_WIDTH'h7
philpem@0 235 `ifdef CFG_DEBUG_ENABLED
philpem@0 236 `define LM32_CSR_DC `LM32_CSR_WIDTH'h8
philpem@0 237 `define LM32_CSR_DEBA `LM32_CSR_WIDTH'h9
philpem@0 238 `endif
philpem@0 239 `define LM32_CSR_CFG2 `LM32_CSR_WIDTH'ha
philpem@0 240 `ifdef CFG_JTAG_ENABLED
philpem@0 241 `define LM32_CSR_JTX `LM32_CSR_WIDTH'he
philpem@0 242 `define LM32_CSR_JRX `LM32_CSR_WIDTH'hf
philpem@0 243 `endif
philpem@0 244 `ifdef CFG_DEBUG_ENABLED
philpem@0 245 `define LM32_CSR_BP0 `LM32_CSR_WIDTH'h10
philpem@0 246 `define LM32_CSR_BP1 `LM32_CSR_WIDTH'h11
philpem@0 247 `define LM32_CSR_BP2 `LM32_CSR_WIDTH'h12
philpem@0 248 `define LM32_CSR_BP3 `LM32_CSR_WIDTH'h13
philpem@0 249 `define LM32_CSR_WP0 `LM32_CSR_WIDTH'h18
philpem@0 250 `define LM32_CSR_WP1 `LM32_CSR_WIDTH'h19
philpem@0 251 `define LM32_CSR_WP2 `LM32_CSR_WIDTH'h1a
philpem@0 252 `define LM32_CSR_WP3 `LM32_CSR_WIDTH'h1b
philpem@0 253 `endif
philpem@0 254
philpem@0 255 // Values for WPC CSR
philpem@0 256 `define LM32_WPC_C_RNG 1:0
philpem@0 257 `define LM32_WPC_C_DISABLED 2'b00
philpem@0 258 `define LM32_WPC_C_READ 2'b01
philpem@0 259 `define LM32_WPC_C_WRITE 2'b10
philpem@0 260 `define LM32_WPC_C_READ_WRITE 2'b11
philpem@0 261
philpem@0 262 // Exception IDs
philpem@0 263 `define LM32_EID_WIDTH 3
philpem@0 264 `define LM32_EID_RNG (`LM32_EID_WIDTH-1):0
philpem@0 265 `define LM32_EID_RESET 3'h0
philpem@0 266 `define LM32_EID_BREAKPOINT 3'd1
philpem@0 267 `define LM32_EID_INST_BUS_ERROR 3'h2
philpem@0 268 `define LM32_EID_WATCHPOINT 3'd3
philpem@0 269 `define LM32_EID_DATA_BUS_ERROR 3'h4
philpem@0 270 `define LM32_EID_DIVIDE_BY_ZERO 3'h5
philpem@0 271 `define LM32_EID_INTERRUPT 3'h6
philpem@0 272 `define LM32_EID_SCALL 3'h7
philpem@0 273
philpem@0 274 // Pipeline result selection mux controls
philpem@0 275
philpem@0 276 `define LM32_D_RESULT_SEL_0_RNG 0:0
philpem@0 277 `define LM32_D_RESULT_SEL_0_REG_0 1'b0
philpem@0 278 `define LM32_D_RESULT_SEL_0_NEXT_PC 1'b1
philpem@0 279
philpem@0 280 `define LM32_D_RESULT_SEL_1_RNG 1:0
philpem@0 281 `define LM32_D_RESULT_SEL_1_ZERO 2'b00
philpem@0 282 `define LM32_D_RESULT_SEL_1_REG_1 2'b01
philpem@0 283 `define LM32_D_RESULT_SEL_1_IMMEDIATE 2'b10
philpem@0 284
philpem@0 285 `define LM32_USER_OPCODE_WIDTH 11
philpem@0 286 `define LM32_USER_OPCODE_RNG (`LM32_USER_OPCODE_WIDTH-1):0
philpem@0 287
philpem@0 288 // Derive a macro to indicate if either of the caches are implemented
philpem@0 289 `ifdef CFG_ICACHE_ENABLED
philpem@0 290 `define LM32_CACHE_ENABLED
philpem@0 291 `else
philpem@0 292 `ifdef CFG_DCACHE_ENABLED
philpem@0 293 `define LM32_CACHE_ENABLED
philpem@0 294 `endif
philpem@0 295 `endif
philpem@0 296
philpem@0 297 /////////////////////////////////////////////////////
philpem@0 298 // Interrupts
philpem@0 299 /////////////////////////////////////////////////////
philpem@0 300
philpem@0 301 // Always enable interrupts
philpem@0 302 `define CFG_INTERRUPTS_ENABLED
philpem@0 303
philpem@0 304 // Currently this is fixed to 32 and should not be changed
philpem@0 305 `define CFG_INTERRUPTS 32
philpem@0 306 `define LM32_INTERRUPT_WIDTH `CFG_INTERRUPTS
philpem@0 307 `define LM32_INTERRUPT_RNG (`LM32_INTERRUPT_WIDTH-1):0
philpem@0 308
philpem@0 309 /////////////////////////////////////////////////////
philpem@0 310 // General
philpem@0 311 /////////////////////////////////////////////////////
philpem@0 312
philpem@0 313 // Sub-word range types
philpem@0 314 `define LM32_BYTE_WIDTH 8
philpem@0 315 `define LM32_BYTE_RNG 7:0
philpem@0 316 `define LM32_HWORD_WIDTH 16
philpem@0 317 `define LM32_HWORD_RNG 15:0
philpem@0 318
philpem@0 319 // Word sub-byte indicies
philpem@0 320 `define LM32_BYTE_0_RNG 7:0
philpem@0 321 `define LM32_BYTE_1_RNG 15:8
philpem@0 322 `define LM32_BYTE_2_RNG 23:16
philpem@0 323 `define LM32_BYTE_3_RNG 31:24
philpem@0 324
philpem@0 325 // Word sub-halfword indices
philpem@0 326 `define LM32_HWORD_0_RNG 15:0
philpem@0 327 `define LM32_HWORD_1_RNG 31:16
philpem@0 328
philpem@0 329 // Use an asynchronous reset
philpem@0 330 // To use a synchronous reset, define this macro as nothing
philpem@0 331 `define CFG_RESET_SENSITIVITY
philpem@0 332
philpem@0 333 // V.T. Srce
philpem@0 334 `define SRCE
philpem@0 335
philpem@0 336 // Whether to include context registers for debug exceptions
philpem@0 337 // in addition to standard exception handling registers
philpem@0 338 // Bizarre - Removing this increases LUT count!
philpem@0 339 `define CFG_DEBUG_EXCEPTIONS_ENABLED
philpem@0 340
philpem@0 341 // Wishbone defines
philpem@0 342 // Refer to Wishbone System-on-Chip Interconnection Architecture
philpem@0 343 // These should probably be moved to a Wishbone common file
philpem@0 344
philpem@0 345 // Wishbone cycle types
philpem@0 346 `define LM32_CTYPE_WIDTH 3
philpem@0 347 `define LM32_CTYPE_RNG (`LM32_CTYPE_WIDTH-1):0
philpem@0 348 `define LM32_CTYPE_CLASSIC 3'b000
philpem@0 349 `define LM32_CTYPE_CONSTANT 3'b001
philpem@0 350 `define LM32_CTYPE_INCREMENTING 3'b010
philpem@0 351 `define LM32_CTYPE_END 3'b111
philpem@0 352
philpem@0 353 // Wishbone burst types
philpem@0 354 `define LM32_BTYPE_WIDTH 2
philpem@0 355 `define LM32_BTYPE_RNG (`LM32_BTYPE_WIDTH-1):0
philpem@0 356 `define LM32_BTYPE_LINEAR 2'b00
philpem@0 357 `define LM32_BTYPE_4_BEAT 2'b01
philpem@0 358 `define LM32_BTYPE_8_BEAT 2'b10
philpem@0 359 `define LM32_BTYPE_16_BEAT 2'b11
philpem@0 360
philpem@0 361 `endif