From 90a5a79a453e72538a4b4de459f920b73039008d Mon Sep 17 00:00:00 2001
From: MicroCoreLabs <54004369+MicroCoreLabs@users.noreply.github.com>
Date: Sat, 19 Oct 2019 14:47:42 -0700
Subject: [PATCH] Uploaded 10_19_2019

---
 MCLR5/Core/DPROM_8Kx128.v            |  80 +++++
 MCLR5/Core/MCLR5.v                   | 491 +++++++++++++++++++++++++++
 MCLR5/Core/MCLR5_alu.v               | 206 +++++++++++
 MCLR5/Movies_Pictures/Quadissue1.JPG | Bin 0 -> 63761 bytes
 MCLR5/README.md                      |  12 +
 5 files changed, 789 insertions(+)
 create mode 100644 MCLR5/Core/DPROM_8Kx128.v
 create mode 100644 MCLR5/Core/MCLR5.v
 create mode 100644 MCLR5/Core/MCLR5_alu.v
 create mode 100644 MCLR5/Movies_Pictures/Quadissue1.JPG
 create mode 100644 MCLR5/README.md

diff --git a/MCLR5/Core/DPROM_8Kx128.v b/MCLR5/Core/DPROM_8Kx128.v
new file mode 100644
index 0000000..ff2fdd9
--- /dev/null
+++ b/MCLR5/Core/DPROM_8Kx128.v
@@ -0,0 +1,80 @@
+//
+//  File Name   :  DPROM_8Kx128.v
+//  Used on     :  
+//  Author      :  Ted Fried, MicroCore Labs
+//  Creation    :  8/57/2017
+//  Code Type   :  Behavioral
+//
+//   Description:
+//   ============
+//   Xilinx ROM behavioral model.
+// 
+//
+
+//------------------------------------------------------------------------
+
+
+`timescale 1ns/100ps
+
+
+
+module DPROM_8Kx128
+  (
+	input			    clka,
+	input[12:0]		    addra,
+	output reg[127:0]   douta,
+	
+	input			    clkb,
+	input[12:0]		    addrb,
+	output reg[127:0]   doutb
+
+  );
+
+//------------------------------------------------------------------------
+
+integer file, k, l;
+reg  [127:0]     ram_array[0:8191];
+
+
+									  
+//------------------------------------------------------------------------
+
+
+initial
+  begin
+
+    // Zero out the RAM so there are no X's
+    for (k = 0; k < 8192 ; k = k + 1)
+	  begin
+	    ram_array[k] = 'h0;
+	  end
+	  
+	  
+	// Load the instructions into the array using ASCII byte file
+    $readmemh("D:/MCL/MCLR5/Quad_Issue/usercode_rom.hex", ram_array);
+    //$readmemb("C:/MCL/MCLR5/Quad_Issue/usercode_rom.hex", ram_array);
+	
+  end											  
+
+  
+  
+always @(posedge clka)
+  begin
+  
+    douta <= ram_array[addra];
+    doutb <= ram_array[addrb];
+	  
+  end
+
+												 
+
+
+//------------------------------------------------------------------------
+
+endmodule 
+
+
+//------------------------------------------------------------------------
+
+                   
+     
diff --git a/MCLR5/Core/MCLR5.v b/MCLR5/Core/MCLR5.v
new file mode 100644
index 0000000..25ca134
--- /dev/null
+++ b/MCLR5/Core/MCLR5.v
@@ -0,0 +1,491 @@
+//
+//
+//  File Name   :  MCLR5.v
+//  Author      :  Ted Fried, MicroCore Labs
+//  Creation    :  4/27/2018
+//  Code Type   :  Synthesizable
+//
+//------------------------------------------------------------------------
+//
+//   Description:
+//   ============
+//   
+//  Quad-issue Superscalar Risc V Processor
+//
+//------------------------------------------------------------------------
+//
+// Copyright (C) 2018 by Ted Fried info@MicroCoreLabs.com
+// 
+// Permission to use, copy, modify, and distribute this software and its 
+// documentation for any purpose and without fee is hereby granted, provided 
+// that the above copyright notice appear in all copies and that both that
+// copyright notice and this permission notice appear in supporting documentation. 
+// This software is provided "as is" without express or implied warranty.
+//
+//------------------------------------------------------------------------
+//
+// Modification History:
+// =====================
+//
+// Revision 1 4/27/18
+// Initial revision
+//
+//
+//------------------------------------------------------------------------
+
+
+module MCLR5
+  (  
+  input 			CORE_CLK,
+  input 			RST_n,
+  
+  output [31:0] 	LOAD_STORE_ADDRESS,
+  output [31:0] 	STORE_DATA,
+  input  [31:0] 	LOAD_DATA,
+  output 		 	LOAD_REQ,
+  output     	 	STORE_REQ
+
+  );
+
+//------------------------------------------------------------------------
+
+// Internal Signals
+
+reg new_pc_stall = 'h0;
+reg alu0_load_req_d = 'h0;
+reg alu1_load_req_d = 'h0;
+reg alu2_load_req_d = 'h0;
+reg alu3_load_req_d = 'h0;
+reg [31:0] register_1 = 'h0;
+reg [31:0] register_2 = 'h0;
+reg [31:0] register_3 = 'h0;
+reg [31:0] register_4 = 'h0;
+reg [3:0] loadstore_stall = 'h0;
+reg [31:0] new_pc = 'h0;
+wire alu0_load_req;
+wire alu1_load_req;
+wire alu2_load_req;
+wire alu3_load_req;
+wire alu0_store_req;
+wire alu1_store_req;
+wire alu2_store_req;
+wire alu3_store_req;
+wire [31:0] i_immediate;
+wire [255:0] program_rom_data;
+wire [31:0] new_pc_plus1;
+wire [32:0] alu0_rd;
+wire [32:0] alu1_rd;
+wire [32:0] alu2_rd;
+wire [32:0] alu3_rd;
+wire [32:0] alu0_newpc;
+wire [32:0] alu1_newpc;
+wire [32:0] alu2_newpc;
+wire [32:0] alu3_newpc;
+wire [31:0] alu0_opcode;
+wire [31:0] alu1_opcode;
+wire [31:0] alu2_opcode;
+wire [31:0] alu3_opcode;
+wire [31:0] alu0_pc;
+wire [31:0] alu1_pc;
+wire [31:0] alu2_pc;
+wire [31:0] alu3_pc;
+wire [31:0] alu0_rs1;
+wire [31:0] alu1_rs1;
+wire [31:0] alu2_rs1;
+wire [31:0] alu3_rs1;
+wire [31:0] alu0_rs2;
+wire [31:0] alu1_rs2;
+wire [31:0] alu2_rs2;
+wire [31:0] alu3_rs2;
+wire [31:0] alu0_load_store_address;
+wire [31:0] alu0_store_data;
+wire [31:0] alu0_load_data;
+wire [4:0]  alu0_opcode_rs1;
+wire [4:0]  alu1_opcode_rs1;
+wire [4:0]  alu2_opcode_rs1;
+wire [4:0]  alu3_opcode_rs1;
+wire [4:0]  alu0_opcode_rs2;
+wire [4:0]  alu1_opcode_rs2;
+wire [4:0]  alu2_opcode_rs2;
+wire [4:0]  alu3_opcode_rs2;
+wire [4:0]  alu0_opcode_rd;
+wire [4:0]  alu1_opcode_rd;
+wire [4:0]  alu2_opcode_rd;
+wire [4:0]  alu3_opcode_rd;
+
+
+
+
+
+/*
+// For Xilinx FPGAs 
+DPROM_8Kx128	code_rom			 
+  (
+    .clka		(CORE_CLK),
+    .addra		(new_pc[14:2]),
+    .douta		(program_rom_data[127:0]),
+
+    .clkb		(CORE_CLK),
+    .addrb		(new_pc_plus1[14:2]),
+    .doutb		(program_rom_data[255:128])
+  );
+
+  */
+  
+	DPROM_8Kx128 code_rom (
+		.address_a (new_pc[14:2]), //   input,   width = 13,  ram_input.address_a
+		.address_b (new_pc_plus1[14:2]), //   input,   width = 13,           .address_b
+		.clock     (CORE_CLK),     //   input,    width = 1,           .clock
+		.q_a       (program_rom_data[127:0]),       //  output,  width = 128, ram_output.q_a
+		.q_b       (program_rom_data[255:128])        //  output,  width = 128,           .q_b
+	);
+
+
+
+
+	
+  
+assign new_pc_plus1 = new_pc + 3'h4;
+
+
+assign alu0_pc = new_pc;
+assign alu1_pc = new_pc + 1;
+assign alu2_pc = new_pc + 2;
+assign alu3_pc = new_pc + 3;
+  
+
+
+assign alu0_opcode = (new_pc[1:0]==2'h0) ? program_rom_data[31:0]   :
+                     (new_pc[1:0]==2'h1) ? program_rom_data[63:32]  :
+                     (new_pc[1:0]==2'h2) ? program_rom_data[95:64]  :
+					                       program_rom_data[127:96] ;
+  
+
+assign alu1_opcode = (new_pc[1:0]==2'h0) ? program_rom_data[63:32]   :
+                     (new_pc[1:0]==2'h1) ? program_rom_data[95:64]   :
+					 (new_pc[1:0]==2'h2) ? program_rom_data[127:96]  :
+                                           program_rom_data[159:128] ;
+	
+assign alu2_opcode = (new_pc[1:0]==2'h0) ? program_rom_data[95:64]   :
+					 (new_pc[1:0]==2'h1) ? program_rom_data[127:96]  :
+                     (new_pc[1:0]==2'h2) ? program_rom_data[159:128] :
+										   program_rom_data[191:160] ;
+									
+assign alu3_opcode = (new_pc[1:0]==2'h0) ? program_rom_data[127:96]  :
+                     (new_pc[1:0]==2'h1) ? program_rom_data[159:128] :
+					 (new_pc[1:0]==2'h2) ? program_rom_data[191:160] :
+					                       program_rom_data[223:192] ;
+										
+										
+
+// Register decodes from the opcode
+//
+assign alu0_opcode_rs1 = alu0_opcode[19:15];  
+assign alu0_opcode_rs2 = alu0_opcode[24:20];
+assign alu0_opcode_rd  = alu0_opcode[11:7];
+
+assign alu1_opcode_rs1 = alu1_opcode[19:15];  
+assign alu1_opcode_rs2 = alu1_opcode[24:20];
+assign alu1_opcode_rd  = alu1_opcode[11:7];
+
+assign alu2_opcode_rs1 = alu2_opcode[19:15];  
+assign alu2_opcode_rs2 = alu2_opcode[24:20];
+assign alu2_opcode_rd  = alu2_opcode[11:7];
+
+assign alu3_opcode_rs1 = alu3_opcode[19:15];  
+assign alu3_opcode_rs2 = alu3_opcode[24:20];
+assign alu3_opcode_rd  = alu3_opcode[11:7];
+
+
+assign LOAD_STORE_ADDRESS = alu0_load_store_address;
+assign STORE_DATA = alu0_store_data;
+assign alu0_load_data = LOAD_DATA;
+assign LOAD_REQ = alu0_load_req;
+assign STORE_REQ = alu0_store_req;
+
+  
+
+// Register read-port routing
+// If the previous alu has modified a register that this alu needs, then use this value,
+// otherwise take the register from the main register-file.
+//
+
+assign alu0_rs1 = (alu0_opcode_rs1 == 5'h00) ? 32'h0      :
+                  (alu0_opcode_rs1 == 5'h01) ? register_1 :
+                  (alu0_opcode_rs1 == 5'h02) ? register_2 :
+                  (alu0_opcode_rs1 == 5'h03) ? register_3 :
+				                               register_4 ;
+
+
+
+assign alu0_rs2 = (alu0_opcode_rs2 == 5'h00) ? 32'h0      :
+                  (alu0_opcode_rs2 == 5'h01) ? register_1 :
+                  (alu0_opcode_rs2 == 5'h02) ? register_2 :
+                  (alu0_opcode_rs2 == 5'h03) ? register_3 :
+				                               register_4 ;
+
+												  
+//------------------------------------------------------------------------
+												  
+												  
+assign alu1_rs1 = ( alu0_rd[32]==1'b1 && (alu1_opcode_rs1==alu0_opcode_rd) ) ? alu0_rd[31:0] :
+                  (alu1_opcode_rs1 == 5'h00) ? 32'h0      :
+                  (alu1_opcode_rs1 == 5'h01) ? register_1 :
+                  (alu1_opcode_rs1 == 5'h02) ? register_2 :
+                  (alu1_opcode_rs1 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  
+				  											  
+												  
+assign alu1_rs2 = ( alu0_rd[32]==1'b1 && (alu1_opcode_rs2==alu0_opcode_rd) ) ? alu0_rd[31:0]  :
+                  (alu1_opcode_rs2 == 5'h00) ? 32'h0      :
+                  (alu1_opcode_rs2 == 5'h01) ? register_1 :
+                  (alu1_opcode_rs2 == 5'h02) ? register_2 :
+                  (alu1_opcode_rs2 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  
+//------------------------------------------------------------------------
+												  
+												  
+assign alu2_rs1 = ( alu1_rd[32]==1'b1 && (alu2_opcode_rs1==alu1_opcode_rd) ) ? alu1_rd[31:0]  :
+                  ( alu0_rd[32]==1'b1 && (alu2_opcode_rs1==alu0_opcode_rd) ) ? alu0_rd[31:0]  :
+                  (alu2_opcode_rs1 == 5'h00) ? 32'h0      :
+                  (alu2_opcode_rs1 == 5'h01) ? register_1 :
+                  (alu2_opcode_rs1 == 5'h02) ? register_2 :
+                  (alu2_opcode_rs1 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  
+				  											  
+												  
+												  
+assign alu2_rs2 = ( alu1_rd[32]==1'b1 && (alu2_opcode_rs2==alu1_opcode_rd) ) ? alu1_rd[31:0]  :
+                  ( alu0_rd[32]==1'b1 && (alu2_opcode_rs2==alu0_opcode_rd) ) ? alu0_rd[31:0]  :
+                  (alu2_opcode_rs2 == 5'h00) ? 32'h0      :
+                  (alu2_opcode_rs2 == 5'h01) ? register_1 :
+                  (alu2_opcode_rs2 == 5'h02) ? register_2 :
+                  (alu2_opcode_rs2 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  			  
+//------------------------------------------------------------------------
+												  
+												  
+assign alu3_rs1 = ( alu2_rd[32]==1'b1 && (alu3_opcode_rs1==alu2_opcode_rd) ) ? alu2_rd[31:0]  :
+                  ( alu1_rd[32]==1'b1 && (alu3_opcode_rs1==alu1_opcode_rd) ) ? alu1_rd[31:0]  :
+                  ( alu0_rd[32]==1'b1 && (alu3_opcode_rs1==alu0_opcode_rd) ) ? alu0_rd[31:0]  :
+                  (alu3_opcode_rs1 == 5'h00) ? 32'h0      :
+                  (alu3_opcode_rs1 == 5'h01) ? register_1 :
+                  (alu3_opcode_rs1 == 5'h02) ? register_2 :
+                  (alu3_opcode_rs1 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  
+				  											  
+												  
+												  
+assign alu3_rs2 = ( alu2_rd[32]==1'b1 && (alu3_opcode_rs2==alu2_opcode_rd) ) ? alu2_rd[31:0]  :
+                  ( alu1_rd[32]==1'b1 && (alu3_opcode_rs2==alu1_opcode_rd) ) ? alu1_rd[31:0]  :
+                  ( alu0_rd[32]==1'b1 && (alu3_opcode_rs2==alu0_opcode_rd) ) ? alu0_rd[31:0]  :
+                  (alu3_opcode_rs2 == 5'h00) ? 32'h0      :
+                  (alu3_opcode_rs2 == 5'h01) ? register_1 :
+                  (alu3_opcode_rs2 == 5'h02) ? register_2 :
+                  (alu3_opcode_rs2 == 5'h03) ? register_3 :
+				                               register_4 ;
+				  
+				  							
+
+	
+//------------------------------------------------------------------------------------------  
+//
+// Register writebacks
+//
+//------------------------------------------------------------------------------------------
+
+always @(posedge CORE_CLK or negedge RST_n)
+begin : REGISTER_WRITEBACKS
+
+  if (RST_n==1'b0)
+    begin
+      alu0_load_req_d <= 'h0;
+	  new_pc <= 32'hFFFF_FFFC;
+    end
+    
+else    
+  begin     
+		 
+   if (  (loadstore_stall == 4'b0000 && (alu0_load_req==1'b1 || alu0_store_req==1'b1) ) ||
+         (loadstore_stall == 4'b0000 && (alu1_load_req==1'b1 || alu1_store_req==1'b1) ) ||
+         (loadstore_stall == 4'b0000 && (alu2_load_req==1'b1 || alu2_store_req==1'b1) ) ||
+         (loadstore_stall == 4'b0000 && (alu3_load_req==1'b1 || alu3_store_req==1'b1) ) )		 
+	  begin
+	    loadstore_stall <= 4'b1111; // new_pc_stall for three cycles
+      end
+	else
+	  begin
+	    loadstore_stall <= { 1'b0 , loadstore_stall[3:1] };
+      end
+
+	  
+	  
+  // Writeback register file
+  // Only write back registers that have been updated.
+  // Block register updates if a previous alu is taking a branch
+  //
+  if (new_pc_stall==1'b0 && ((loadstore_stall==4'b0001 || alu0_newpc[32]==1'b0) && alu1_newpc[32]==1'b0 && alu2_newpc[32]==1'b0) && alu3_rd[32]==1'b1)
+    begin
+	  case (alu3_opcode_rd)
+	    5'h01 : register_1 <= alu3_rd[31:0];
+	    5'h02 : register_2 <= alu3_rd[31:0];
+	    5'h03 : register_3 <= alu3_rd[31:0];
+	    5'h04 : register_4 <= alu3_rd[31:0];
+		default: ;
+      endcase
+	end
+	
+  else if (new_pc_stall==1'b0 && ((loadstore_stall==4'b0001 || alu0_newpc[32]==1'b0) && alu1_newpc[32]==1'b0) && alu2_rd[32]==1'b1)
+    begin
+	  case (alu2_opcode_rd)
+	    5'h01 : register_1 <= alu2_rd[31:0];
+	    5'h02 : register_2 <= alu2_rd[31:0];
+	    5'h03 : register_3 <= alu2_rd[31:0];
+	    5'h04 : register_4 <= alu2_rd[31:0];
+		default: ;
+      endcase
+	end
+
+  else if (new_pc_stall==1'b0 && (loadstore_stall==4'b0001 || alu0_newpc[32]==1'b0) && alu1_rd[32]==1'b1)
+    begin
+	  case (alu1_opcode_rd)
+	    5'h01 : register_1 <= alu1_rd[31:0];
+	    5'h02 : register_2 <= alu1_rd[31:0];
+	    5'h03 : register_3 <= alu1_rd[31:0];
+	    5'h04 : register_4 <= alu1_rd[31:0];
+		default: ;
+      endcase
+	end
+	
+  else if (new_pc_stall==1'b0 && alu0_rd[32]==1'b1)
+    begin
+	  case (alu0_opcode_rd)
+	    5'h01 : register_1 <= alu0_rd[31:0];
+	    5'h02 : register_2 <= alu0_rd[31:0];
+	    5'h03 : register_3 <= alu0_rd[31:0];
+	    5'h04 : register_4 <= alu0_rd[31:0];
+		default: ;
+      endcase
+	end
+  
+  
+//------------------------------------------------------------------------
+//
+// Update the PC for branches/jumps
+// Otherwise increment the PC by four
+//
+//------------------------------------------------------------------------
+
+  if ((new_pc_stall==1'b0 && alu0_newpc[32]==1'b1) && loadstore_stall!=4'b0001)
+    begin
+	  new_pc_stall <= 1'b1;
+	  new_pc <= alu0_newpc[31:0];
+	end
+	
+  else if (new_pc_stall==1'b0 && alu1_newpc[32]==1'b1)
+    begin
+	  new_pc_stall <= 1'b1;
+	  new_pc <= alu1_newpc[31:0];
+	end
+   	
+  else if (new_pc_stall==1'b0 && alu2_newpc[32]==1'b1)
+    begin
+	  new_pc_stall <= 1'b1;
+	  new_pc <= alu2_newpc[31:0];
+	end
+   	
+  else if (new_pc_stall==1'b0 && alu3_newpc[32]==1'b1)
+    begin
+	  new_pc_stall <= 1'b1;
+	  new_pc <= alu3_newpc[31:0];
+	end
+	
+  else
+    begin	
+	  new_pc <= new_pc + 32'h0000_0004;
+	  new_pc_stall <= 1'b0;
+	end
+   
+  end
+end // Register writebacks
+
+
+
+//------------------------------------------------------------------------
+//
+// MCLR5 ALU cores
+//
+//------------------------------------------------------------------------
+
+MCLR5_alu					mclr5_alu0
+  (
+    .OPCODE					(alu0_opcode),
+    .PC						(alu0_pc),
+    .RS1					(alu0_rs1),
+    .RS2					(alu0_rs2),
+    .RD						(alu0_rd),
+    .NEWPC					(alu0_newpc),
+    .LOAD_DATA	     		(alu0_load_data),
+    .STORE_DATA	     		(alu0_store_data),
+    .LOAD_REQ	 		    (alu0_load_req),
+    .STORE_REQ	 		    (alu0_store_req),
+    .LOAD_STORE_ADDRESS	 	(alu0_load_store_address)
+  );
+
+
+MCLR5_alu					mclr5_alu1
+  (
+    .OPCODE					(alu1_opcode),
+    .PC						(alu1_pc),
+    .RS1					(alu1_rs1),
+    .RS2					(alu1_rs2),
+    .RD						(alu1_rd),
+    .NEWPC					(alu1_newpc),
+    .LOAD_DATA	     		(),
+    .STORE_DATA	     		(),
+    .LOAD_REQ	 		    (alu1_load_req),
+    .STORE_REQ	 		    (alu1_store_req),
+    .LOAD_STORE_ADDRESS	 	()
+  );
+
+
+MCLR5_alu					mclr5_alu2
+  (
+    .OPCODE					(alu2_opcode),
+    .PC						(alu2_pc),
+    .RS1					(alu2_rs1),
+    .RS2					(alu2_rs2),
+    .RD						(alu2_rd),
+    .NEWPC					(alu2_newpc),
+    .LOAD_DATA	     		(),
+    .STORE_DATA	     		(),
+    .LOAD_REQ	 		    (alu2_load_req),
+    .STORE_REQ	 		    (alu2_store_req),
+    .LOAD_STORE_ADDRESS	 	()
+  );
+
+
+
+MCLR5_alu					mclr5_alu3
+  (
+    .OPCODE					(alu3_opcode),
+    .PC						(alu3_pc),
+    .RS1					(alu3_rs1),
+    .RS2					(alu3_rs2),
+    .RD						(alu3_rd),
+    .NEWPC					(alu3_newpc),
+    .LOAD_DATA	     		(),
+    .STORE_DATA	     		(),
+    .LOAD_REQ	 		    (alu3_load_req),
+    .STORE_REQ	 		    (alu3_store_req),
+    .LOAD_STORE_ADDRESS	 	()
+  );
+
+
+ 
+endmodule // MCLR5.v
diff --git a/MCLR5/Core/MCLR5_alu.v b/MCLR5/Core/MCLR5_alu.v
new file mode 100644
index 0000000..cbf8c1d
--- /dev/null
+++ b/MCLR5/Core/MCLR5_alu.v
@@ -0,0 +1,206 @@
+//
+//
+//  File Name   :  MCLR5_alu.v
+//  Author      :  Ted Fried, MicroCore Labs
+//  Creation    :  4/21/2018
+//  Code Type   :  Synthesizable
+//
+//------------------------------------------------------------------------
+//
+//   Description:
+//   ============
+//   
+//  Quad-issue Superscalar Risc V Processor ALU core
+//
+//------------------------------------------------------------------------
+//
+// Copyright (C) 2018 by Ted Fried info@MicroCoreLabs.com
+// 
+// Permission to use, copy, modify, and distribute this software and its 
+// documentation for any purpose and without fee is hereby granted, provided 
+// that the above copyright notice appear in all copies and that both that
+// copyright notice and this permission notice appear in supporting documentation. 
+// This software is provided "as is" without express or implied warranty.
+//
+//------------------------------------------------------------------------
+//
+// Modification History:
+// =====================
+//
+// Revision 1 4/21/18
+// Initial revision
+//
+//
+//------------------------------------------------------------------------
+
+
+module MCLR5_alu
+  (  
+  
+    input  [31:0]       OPCODE,
+    input  [31:0]       PC,
+
+    input  [31:0]       RS1,
+    input  [31:0]       RS2,
+    output reg [32:0]   RD,
+    output reg [32:0]   NEWPC,
+    input  [31:0]       LOAD_DATA,
+    output [31:0]       STORE_DATA,
+    output reg          LOAD_REQ,
+    output reg          STORE_REQ,
+    output reg [31:0]   LOAD_STORE_ADDRESS
+
+  );
+
+//------------------------------------------------------------------------
+      
+
+// Internal Signals
+
+wire beq_taken;
+wire bne_taken;
+wire blt_taken;
+wire bge_taken;
+wire bltu_taken;
+wire bgeu_taken;
+wire slti_true;
+wire sltiu_true;
+wire slt_true;
+wire sltu_true;
+wire [31:0] i_immediate;
+wire [31:0] s_immediate;
+wire [31:0] b_immediate;
+wire [31:0] u_immediate;
+wire [31:0] j_immediate;
+wire [31:0] slli_result;
+wire [31:0] srli_result;
+wire [31:0] srai_result;
+wire [31:0] sll_result;
+wire [31:0] srl_result;
+wire [31:0] sra_result;
+wire [31:0] pc_adjusted;
+
+
+
+//------------------------------------------------------------------------
+//
+// RISC V ALU
+//
+//------------------------------------------------------------------------
+
+assign i_immediate = { {21{OPCODE[31]}} , OPCODE[30:25] , OPCODE[24:21] , OPCODE[20] } ;
+assign s_immediate = { {21{OPCODE[31]}} , OPCODE[30:25] , OPCODE[11:8] , OPCODE[7] } ;
+assign b_immediate = { {20{OPCODE[31]}} , OPCODE[7] , OPCODE[30:25] , OPCODE[11:8] , 1'b0 } ;
+assign u_immediate = { OPCODE[31] , OPCODE[30:20] , OPCODE[19:12] , 12'b0 } ;
+assign j_immediate = { {12{OPCODE[31]}} , OPCODE[19:12] , OPCODE[20] , OPCODE[30:25] , OPCODE[24:21] , 1'b0 } ;
+
+
+assign slti_true  = ($signed(RS1) < $signed(i_immediate))   ? 32'h0000_0001 : 32'h0000_0000;
+assign sltiu_true = (RS1 < i_immediate)                     ? 32'h0000_0001 : 32'h0000_0000;
+assign slt_true   = ($signed(RS1) < $signed(RS2))           ? 32'h0000_0001 : 32'h0000_0000;
+assign sltu_true  = (RS1 < RS2)                             ? 32'h0000_0001 : 32'h0000_0000;
+
+
+assign slli_result = 32'h0123_4567;
+assign srli_result = 32'h0123_4567;
+assign srai_result = 32'h0123_4567;
+assign sll_result  = 32'h0123_4567;
+assign srl_result  = 32'h0123_4567;
+assign sra_result  = 32'h0123_4567;
+
+assign beq_taken  = (RS1 == RS1)                    ? 1'b1 : 1'b0;
+assign bne_taken  = (RS1 != RS1)                    ? 1'b1 : 1'b0;
+assign blt_taken  = ($signed(RS1) < $signed(RS2))   ? 1'b1 : 1'b0;
+assign bge_taken  = ($signed(RS1) >= $signed(RS2))  ? 1'b1 : 1'b0;
+assign bltu_taken = (RS1 < RS2)                     ? 1'b1 : 1'b0;
+assign bgeu_taken = (RS1 >= RS2)                    ? 1'b1 : 1'b0;
+
+		
+assign pc_adjusted = PC - 4'h4;  // Subtracts pipelined PC to the true PC
+																					
+assign STORE_DATA = RS2; 
+
+
+always @* begin
+  casex (OPCODE)
+
+    32'b???????_?????_?????_???_?????_01101?? : RD = { 1'b1 , {u_immediate[31:12] , 12'b0 } }            ;   // LUI
+    32'b???????_?????_?????_???_?????_00101?? : RD = { 1'b1 , PC + {u_immediate[31:12] , 12'b0 }  }      ;   // AUIPC
+    32'b???????_?????_?????_???_?????_11011?? : RD = { 1'b1 , PC + 3'h4 }                         		 ;   // JAL
+    32'b???????_?????_?????_???_?????_11001?? : RD = { 1'b1 , PC + 3'h4 }                         		 ;   // JALR
+    32'b???????_?????_?????_000_?????_00100?? : RD = { 1'b1 , RS1 + i_immediate }                 		 ;   // ADDI
+    32'b???????_?????_?????_010_?????_00100?? : RD = { 1'b1 , slti_true }                         		 ;   // SLTI
+    32'b???????_?????_?????_011_?????_00100?? : RD = { 1'b1 , sltiu_true }                        		 ;   // SLTIU
+    32'b???????_?????_?????_100_?????_00100?? : RD = { 1'b1 , RS1 ^ i_immediate }                 		 ;   // XORI
+    32'b???????_?????_?????_110_?????_00100?? : RD = { 1'b1 , RS1 | i_immediate }                 		 ;   // ORI
+    32'b???????_?????_?????_111_?????_00100?? : RD = { 1'b1 , RS1 & i_immediate }                 		 ;   // ANDI
+    32'b???????_?????_?????_001_?????_00100?? : RD = { 1'b1 , slli_result }                       		 ;   // SLLI
+    32'b?0?????_?????_?????_101_?????_00100?? : RD = { 1'b1 , srli_result }                       		 ;   // SRLI
+    32'b?1?????_?????_?????_101_?????_00100?? : RD = { 1'b1 , srai_result }                       		 ;   // SRAI
+    32'b?0?????_?????_?????_000_?????_01100?? : RD = { 1'b1 , RS1 + RS2 }                         		 ;   // ADD
+    32'b?1?????_?????_?????_000_?????_01100?? : RD = { 1'b1 , RS1 - RS2 }                         		 ;   // SUB
+    32'b???????_?????_?????_001_?????_01100?? : RD = { 1'b1 , sll_result }                        		 ;   // SLL
+    32'b???????_?????_?????_010_?????_01100?? : RD = { 1'b1 , slt_true }                          		 ;   // SLT
+    32'b???????_?????_?????_011_?????_01100?? : RD = { 1'b1 , sltu_true }                         		 ;   // SLTU
+    32'b???????_?????_?????_100_?????_01100?? : RD = { 1'b1 , RS1 ^ RS2 }                         		 ;   // XOR
+    32'b?0?????_?????_?????_101_?????_01100?? : RD = { 1'b1 , srl_result }                        		 ;   // SRL
+    32'b?1?????_?????_?????_101_?????_01100?? : RD = { 1'b1 , sra_result }                        		 ;   // SRA
+    32'b???????_?????_?????_110_?????_01100?? : RD = { 1'b1 , RS1 | RS2 }                         		 ;   // OR
+    32'b???????_?????_?????_111_?????_01100?? : RD = { 1'b1 , RS1 & RS2 }                         		 ;   // AND
+		
+    32'b???????_?????_?????_010_?????_00000?? : RD = { 1'b1 , LOAD_DATA }                         		 ;   // LW
+    default :                                   RD = { 1'b0 , 32'h0000_0000 }                     		 ;   	
+	
+  endcase
+  
+ 
+  casex (OPCODE)
+
+    32'b???????_?????_?????_010_?????_00000?? : LOAD_STORE_ADDRESS = RS1 + i_immediate ; // Loads  	
+    32'b???????_?????_?????_010_?????_01000?? : LOAD_STORE_ADDRESS = RS1 + s_immediate ; // Stores  	
+	default : ;
+  endcase
+      
+ 
+  casex (OPCODE)
+
+    32'b???????_?????_?????_010_?????_00000?? : LOAD_REQ = 1'b1 ;
+    32'b???????_?????_?????_010_?????_01000?? : STORE_REQ = 1'b1 ;  	
+    default :   begin LOAD_REQ = 1'b0 ; STORE_REQ = 1'b0;  end                             
+	
+  endcase
+  
+         
+  casex (OPCODE)
+
+    32'b???????_?????_?????_???_?????_11011?? : NEWPC = { 1'b1 ,  pc_adjusted + j_immediate                     }  ;   // JAL
+    32'b???????_?????_?????_000_?????_11001?? : NEWPC = { 1'b1 , ( RS1 + i_immediate) & 32'hFFFF_FFFE           }  ;   // JALR
+                                                                                                                
+    32'b???????_?????_?????_010_?????_00000?? : NEWPC = { 1'b1 ,  pc_adjusted                                   }  ;   // LW
+    32'b???????_?????_?????_010_?????_01000?? : NEWPC = { 1'b1 ,  pc_adjusted                                   }  ;   // SW
+
+    //32'hBBBBBBBB : NEWPC = { 1'b1 ,  pc_adjusted + 4'h6                                   }  ;   // Temp jump code !!!!
+    
+    32'b???????_?????_?????_000_?????_11000?? : if (beq_taken ==  1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BEQ
+    32'b???????_?????_?????_001_?????_11000?? : if (bne_taken ==  1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BNE
+    32'b???????_?????_?????_100_?????_11000?? : if (blt_taken ==  1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BLT
+    32'b???????_?????_?????_101_?????_11000?? : if (bge_taken ==  1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BGE
+    32'b???????_?????_?????_110_?????_11000?? : if (bltu_taken == 1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BLTU
+    32'b???????_?????_?????_111_?????_11000?? : if (bgeu_taken == 1'b1) NEWPC = { 1'b1 ,  pc_adjusted + b_immediate      }  ;   // BGEU
+
+ 	
+    default :                                   NEWPC = { 1'b0 ,  32'h0000_0000                                 }  ;   // No Branch Taken  	
+	
+  endcase
+  
+   
+  
+  
+end
+
+
+	
+
+
+ 
+endmodule // MCLR5_alu.v
diff --git a/MCLR5/Movies_Pictures/Quadissue1.JPG b/MCLR5/Movies_Pictures/Quadissue1.JPG
new file mode 100644
index 0000000000000000000000000000000000000000..0edac9079425f9ea3cc6b2e338ebddf4c88eefe7
GIT binary patch
literal 63761
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

literal 0
HcmV?d00001

diff --git a/MCLR5/README.md b/MCLR5/README.md
new file mode 100644
index 0000000..2c13e5d
--- /dev/null
+++ b/MCLR5/README.md
@@ -0,0 +1,12 @@
+# Quad-issue Superscalar RISCV
+
+
+ - Up to four instructions can be simultaneously issued and retired.
+ - ALU cores are combinational.
+ - Core can handle branches which occur in any of the four pipelines.
+ - Can also handle register dependancies in the pipeline.
+
+** Very incomplete! Once it was able to issue multiple instructions and handle branches and register dependancies I got bored and moved on!  :)
+
+	
+For questions email me at www.MicroCoreLabs.com