From 4bfabc4136f0fa861aaf730d2e61405590633fe6 Mon Sep 17 00:00:00 2001
From: Ross Thompson <ross1728@gmail.com>
Date: Tue, 17 Jan 2023 22:54:42 -0600
Subject: [PATCH] formating ahbinterface.

---
 pipelined/src/ebu/ahbcacheinterface.sv |  2 +-
 pipelined/src/ebu/ahbinterface.sv      | 30 +++++++++++++-------------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/pipelined/src/ebu/ahbcacheinterface.sv b/pipelined/src/ebu/ahbcacheinterface.sv
index ad5f3464..8b9e29e8 100644
--- a/pipelined/src/ebu/ahbcacheinterface.sv
+++ b/pipelined/src/ebu/ahbcacheinterface.sv
@@ -72,6 +72,7 @@ module ahbcacheinterface #(parameter BEATSPERLINE, LINELEN, LOGWPL, LLENPOVERAHB
   logic [`PA_BITS-1:0]         LocalHADDR;                             // Address after selecting between cached and uncached operation
   logic [LOGWPL-1:0]           BeatCountDelayed;                       // Beat within the cache line in the second (Data) cache stage
   logic                        CaptureEn;                              // Enable updating the Fetch buffer with valid data from HRDATA
+  logic [`AHBW/8-1:0] 		   BusByteMaskM;                           // Byte enables within a word.  For cache request all 1s
   logic [`AHBW-1:0]            PreHWDATA;                              // AHB Address phase write data
 
   genvar                       index;
@@ -106,7 +107,6 @@ module ahbcacheinterface #(parameter BEATSPERLINE, LINELEN, LOGWPL, LLENPOVERAHB
 
   // *** bummer need a second byte mask for bus as it is AHBW rather than LLEN.
   // probably can merge by muxing PAdrM's LLEN/8-1 index bit based on HTRANS being != 0.
-  logic [`AHBW/8-1:0]  BusByteMaskM;
   swbytemask #(`AHBW) busswbytemask(.Size(HSIZE), .Adr(HADDR[$clog2(`AHBW/8)-1:0]), .ByteMask(BusByteMaskM));
   
   flopen #(`AHBW/8) HWSTRBReg(HCLK, HREADY, BusByteMaskM[`AHBW/8-1:0], HWSTRB);
diff --git a/pipelined/src/ebu/ahbinterface.sv b/pipelined/src/ebu/ahbinterface.sv
index 28813eb1..63449fe8 100644
--- a/pipelined/src/ebu/ahbinterface.sv
+++ b/pipelined/src/ebu/ahbinterface.sv
@@ -31,24 +31,24 @@
 `include "wally-config.vh"
 
 module ahbinterface #(parameter LSU = 0) ( // **** modify to use LSU/ifu parameter to control widths of buses
-  input logic                HCLK, HRESETn,
+  input logic 							HCLK, HRESETn,
   // bus interface
-  input logic                HREADY,
-  input logic [`XLEN-1:0]    HRDATA,
-  output logic [1:0]         HTRANS,
-  output logic               HWRITE,
-  output logic [`XLEN-1:0]   HWDATA,
-  output logic [`XLEN/8-1:0] HWSTRB,
+  input logic 							HREADY,       // AHB peripheral ready
+  output logic [1:0] 					HTRANS,       // AHB transaction type, 00: IDLE, 10 NON_SEQ, 11 SEQ
+  output logic 							HWRITE,       // AHB 0: Read operation 1: Write operation 
+  input logic [`XLEN-1:0] 				HRDATA,       // AHB read data
+  output logic [`XLEN-1:0] 				HWDATA,       // AHB write data
+  output logic [`XLEN/8-1:0] 			HWSTRB,       // AHB byte mask
   
   // lsu/ifu interface
-  input logic                Flush,
-  input logic [1:0]          BusRW,
-  input logic [`XLEN/8-1:0]  ByteMask,
-  input logic [`XLEN-1:0]    WriteData,
-  input logic                Stall,
-  output logic               BusStall,
-  output logic               BusCommitted,
-  output logic [(LSU ? `XLEN : 32)-1:0]   FetchBuffer
+  input logic 							Stall,        // Core pipeline is stalled
+  input logic 							Flush,        // Pipeline stage flush. Prevents bus transaction from starting
+  input logic [1:0] 					BusRW,        // Memory operation read/write control: 10: read, 01: write
+  input logic [`XLEN/8-1:0] 			ByteMask,     // Bytes enables within a word
+  input logic [`XLEN-1:0] 				WriteData,    // IEU write data for a store
+  output logic 							BusStall,     // Bus is busy with an in flight memory operation
+  output logic 							BusCommitted, // Bus is busy with an in flight memory operation and it is not safe to take an interrupt
+  output logic [(LSU ? `XLEN : 32)-1:0] FetchBuffer   // Register to hold HRDATA after arriving from the bus
 );
   
   logic                       CaptureEn;