micheleandClaude Sonnet 5
0e73eb4726
Was a separate, untracked directory (DataSheet/) outside the repo. Renamed to lowercase and moved in as hardware/v2/docs/datasheet/, with its own .gitignore for LaTeX build byproducts (compiled PDFs stay tracked, .aux/.log/.toc/etc do not). Now versioned and shares this repo's own remote instead of living untracked on disk. Content: IT+EN LaTeX chapter sources, reference manufacturer PDFs, and compiled datasheet PDFs including the 2026-09-07 SDRAM upgrade addendum (AS4C32M16SB-7BIN part/pinout/timing) in the v2-en chapters. Note: hardware/v2/docs/DatasheetLatex/ (and the v1 sibling) is a separate, already-tracked, differently-structured LaTeX document that predates this move -- left untouched, not merged, since its chapter set and content differ and merging was not requested. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013xXuuRUWZScuo1DeYJxs3v
56 lines
3.0 KiB
TeX
56 lines
3.0 KiB
TeX
\chapter{Top-level module}
|
|
\label{ch:toplevel}
|
|
|
|
\section{\texttt{neural\_multiprocessor.v}}
|
|
The real, hardware-facing top level: \code{dataflow\_core.v} (Dependency
|
|
Manager $+$ Neural Director $+$ \code{N\_SLOTS}$\times$(Memory Manager $+$
|
|
Neural Processor) $+$ Activation Cache) with its \code{N\_SLOTS}$+$1
|
|
Memory Backend Interface ports funneled through \code{slot\_mem\_arbiter.v}
|
|
down to the real, unmodified V1 PSRAM chain
|
|
(\code{memory\_interface.v} $\to$ \code{psram\_controller.v}).
|
|
|
|
\begin{tabularx}{\textwidth}{L{3.4cm} C{1.2cm} C{1.6cm} Y}
|
|
\toprule
|
|
\rowh \thd{Port} & \thd{Dir} & \thd{Width} & \thd{Function} \\
|
|
\midrule
|
|
\code{clk}, \code{rst} & IN & 1 & System clock, synchronous reset. \\
|
|
\rowa \code{reg\_valid} & IN & 1 & Node registration request (ch.~\ref{ch:host}). \\
|
|
\code{reg\_ready} & OUT & 1 & This node id's table slot is \code{EMPTY}. \\
|
|
\rowa \code{reg\_node\_id} & IN & $\lceil\log_2\text{N\_NODES}\rceil$ & Node id. \\
|
|
\code{reg\_required} & IN & $\lceil\log_2(\text{MAX\_DEPS}{+}1)\rceil$ & Producer count. \\
|
|
\rowa \code{reg\_producer\_ids} & IN & \code{MAX\_DEPS}$\times\lceil\log_2\text{N\_NODES}\rceil$ & Packed producer id list. \\
|
|
\code{reg\_x\_base}, \code{reg\_w\_base}, \code{reg\_result\_addr} & IN & \code{ADDR\_WIDTH} each & Job descriptor addresses. \\
|
|
\rowa \code{reg\_n\_tiles} & IN & 16 & Tile count. \\
|
|
\code{psram\_a} & OUT & \code{ADDR\_WIDTH} & PSRAM address bus (real V1 controller, unmodified). \\
|
|
\rowa \code{psram\_dq} & INOUT & \code{PSRAM\_DATA\_WIDTH} & PSRAM bidirectional data bus. \\
|
|
\code{psram\_ce\_n}, \code{psram\_oe\_n}, \code{psram\_we\_n}, \code{psram\_lb\_n}, \code{psram\_ub\_n}, \code{psram\_zz\_n} & OUT & 1 each & PSRAM control, identical to V1's own real, verified signal set. \\
|
|
\bottomrule
|
|
\end{tabularx}
|
|
|
|
\begin{fnnote}[No \texttt{int8\_memory\_access.v} in this datapath]
|
|
Earlier milestones instantiated V1's \code{int8\_memory\_access.v}
|
|
between the arbiter and \code{memory\_interface.v}. Post word-burst
|
|
rewrite (ch.~\ref{ch:mem}), it is no longer instantiated here --- the
|
|
file itself is untouched (still frozen V1); V2 simply reuses one layer
|
|
lower in the same frozen stack.
|
|
\end{fnnote}
|
|
|
|
\section{Internal hierarchy}
|
|
\noindent\code{neural\_multiprocessor.v}
|
|
\begin{itemize}[leftmargin=2.4em]
|
|
\footnotesize
|
|
\item \code{u\_dataflow\_core} : \code{dataflow\_core.v}
|
|
\begin{itemize}
|
|
\item \code{u\_dep\_mgr} : \code{dependency\_manager.v}
|
|
\item \code{u\_director} : \code{neural\_director.v}
|
|
\item \code{GEN\_SLOT[0..N\_SLOTS-1]}: \code{memory\_manager.v} $+$ \code{neural\_processor.v}
|
|
\begin{itemize}
|
|
\item[--] \code{u\_prefetch} : \code{prefetch\_engine.v} (weights only, word-level)
|
|
\end{itemize}
|
|
\item \code{u\_activation\_cache} : \code{activation\_cache.v}
|
|
\end{itemize}
|
|
\item \code{u\_arbiter} : \code{slot\_mem\_arbiter.v} (\code{N\_SLOTS}$+$1 ports)
|
|
\item \code{u\_memif} : \code{memory\_interface.v} (frozen V1)
|
|
\item \code{u\_psram\_ctrl} : \code{psram\_controller.v} (frozen V1)
|
|
\end{itemize}
|