Commit d08467c0 authored by GuillemCabo's avatar GuillemCabo
Browse files

De-RISC doc release

parent a391c427
......@@ -2,11 +2,11 @@
\section{Overview}
\label{chapter1}
The SafePMU (Safe Performance Monitoring Unit) is an AHB slave capable of monitoring SoC events, enforce contention control, and identifying profiling errors on run-time.
Figure "\ref{fig:blkdia}" shows the structure of the unit. It is composed of an ahb wrapper (\textit{ahb\_wrapper.vhd}) that maps the SystemVerilog implementation into a VHDL module that can be instanced in SELENE and De-RISC SoCs. The SystemVerilog AHB interface (\textit{pmu\_ahb.sv}) offers support for a subset of AHB requests. This module also instances the interface agnostic PMU (\textit{PMU\_raw.sv}). The latter is used as the generator of the statistic unit. It generates the memory map and the instances for each of the features.\\
Figure "\ref{fig:blkdia}" shows the structure of the unit. It is composed of an ahb wrapper (\textit{ahb\_wrapper.vhd}) that maps the SystemVerilog implementation into a VHDL module that can be instanced in De-RISC SoC. The SystemVerilog AHB interface (\textit{pmu\_ahb.sv}) offers support for a subset of AHB requests. This module also instances the interface agnostic PMU (\textit{PMU\_raw.sv}). The latter is used as the generator of the statistic unit. It generates the memory map and the instances for each of the features.\\
\\
The main features are:\\
\begin{itemize}
\item \textbf{Self-test:} Allows to configure the counters' inputs to a fixed value bypassing the crossbar and ignoring the inputs. This mode allows for tests of the software and the unit under known conditions.
\item \textbf{Self-test:} Allows to configure the counters inputs to a fixed value bypassing the crossbar and ignoring the SoC inputs. This mode allows for tests of the software and the unit under known conditions.
\item \textbf{Crossbar:} Allows to route any input event to any counter.
\item \textbf{Counters:} Group of simple counters with settable initial values and general control register.
\item \textbf{Overflow:} Detection of overflow for counters, interrupt capable with dedicated interruption vector and per counter interrupt enable.
......
......@@ -3,15 +3,15 @@
\subsection{General}
The SafePMU attaches to a 128-bit wide AHB bus but only supports Single burst 32-bit accesses. AHB Lock accesses and protection control are not implemented.\\
\\
The unit is compatible with GRLIB \textit{plug\&play}(P\&P). Vendor and device's default configuration values are \textit{"BSC"} and \textit{" AHB Performance Monitoring Unit"} respectively. Regardless, release \textit{v3.2.4} of GRMON, the unit may appear as \textit{"Unknown device"}.
The unit is compatible with GRLIB \textit{plug\&play}(P\&P). Vendor and device's default configuration values are \textit{"BSC"} and \textit{" AHB Performance Monitoring Unit"} respectively. Regardless, in release \textit{v3.2.4} of GRMON, the unit may appear as \textit{"Unknown device"}.
\subsection{Default input events}
%explain signals
%distinction bteen CCS and regular signals
In its default implementation, the unit provides up to 32 input events. Each one of the events can be routed to any mechanism of the module through the crossbar.\\
\\
Table \ref{table:t_ev} shows the inputs and mapping to the crossbar input for the current \href{https://gitlab.bsc.es/selene/selene-hardware/-/merge_requests/2}{SELENE release}. The number of signals and arrangements may change in the upcoming versions. \\
Table \ref{table:t_ev} shows the inputs and mapping to the crossbar input for the current release. The number of signals and arrangements may change in the upcoming versions. \\
\begin{table}[H]
\caption{SELENE default input events}
\caption{SoC default input events}
\label{table:t_ev}
\centering
\begin{footnotesize}
......
\section{Instantiation}
An example design is provided in the context of SELENE and De-RISC. Integration examples of earlier releases of the unit along LEON3MP can be provided under demand.\\
An example design is provided in the context of De-RISC. Integration examples of earlier releases of the unit along LEON3MP can be provided under demand.\\
\\
\belowcaptionskip=-10pt
\begin{lstlisting}[label=ins-prot,caption=SafePMU instance example for gpp\_sys,style=vhdl]
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment