fix

Author: amichai-bd

docs/fabric/MAS_router/mas_arbiter.md

@@ -0,0 +1,61 @@
+Micro-Architecture Specification (MAS) for Arbiter Module
+# 1. Overview
+Brief Description:
+This document details the micro-architecture of an Arbiter module designed to manage multiple client requests and select a winner based on a predefined arbitration scheme.
+
+Purpose and Functionality:
+The Arbiter module is used to arbitrate among NUM_CLIENTS clients. It determines which client gains access based on the input signals.
+
+# 2. Block Diagram
+[Placeholder for Block Diagram]
+Insert High-Level Block Diagram of the Arbiter here
+
+# 3. Interfaces
+Signal Descriptions:
+
+| Signal Name      | Direction | Description                                 |
+|------------------|-----------|---------------------------------------------|
+| clk              | Input     | Clock signal.                               |
+| rst              | Input     | Reset signal.                               |
+| valid_candidate  | Input     | Array indicating valid candidates.          |
+| winner_dec_id    | Output    | Decision array indicating the winner.       |
+
+# 4. Functional Description
+Operational Modes:
+
+The module arbitrates among NUM_CLIENTS clients.
+It uses the valid_candidate array to determine which clients are currently requesting access.
+Data Flow Description:
+
+The arbiter prioritizes clients based on a fixed scheme.
+Upon determining a winner, the winner_dec_id signal is asserted corresponding to the winning client.
+# 5. Configuration and Control
+Configuration Registers:
+
+NUM_CLIENTS: Defines the number of clients participating in arbitration.
+# 6. Performance and Characteristics
+Throughput:
+Dependent on the clock frequency.
+
+Latency:
+Typically one clock cycle for arbitration decision.
+
+# 7. Error Handling and Exceptions
+The module does not explicitly include error handling mechanisms in the provided RTL. Design-specific error handling should be considered.
+# 8. Testing and Verification
+Test Plan Overview:
+
+Verify correct arbitration among multiple clients.
+Test for edge cases where multiple clients request access simultaneously.
+Verification Strategies:
+
+Simulate with varying numbers of clients.
+Stress test with simultaneous requests.
+
+# 9. Change Log
+Revision History:
+
+Initial version: [Date]
+Author Information:
+
+[Author Name]

docs/fabric/MAS_router/mas_fifo.md

@@ -9,7 +9,7 @@ The FIFO module is intended for buffering data. It supports basic operations suc
 Placeholder for Block Diagram
 [Insert High-Level Block Diagram of the FIFO here]
 ![2024-01-31-11-44-31.png](/snapshots/2024-01-31-11-44-31.png)
-![test2.png](/drawio/test2.png)
+![test2.png](/drawio/test2.jpg)
 
 # Configuration FIFO parameters:
 DATA_WIDTH: Defines the width of the data in the FIFO.