docs: bring datasheet/ into the main repo under hardware/v2/docs

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
2026-09-07 05:09:14 +02:00
commit 0e73eb4726
66 changed files with 7652 additions and 0 deletions
@@ -0,0 +1,45 @@
+# FPGA-Neural — Datasheet
+
+Datasheet tecnico multicapitolo dell'engine FPGA-Neural, in italiano e inglese.
+Ricostruito a partire dal codice RTL, dalla documentazione e dai benchmark presenti
+nella repository (revisione A1, settembre 2026).
+
+## Struttura
+
+```
+docs/datasheet/
+├── FPGA-Neural-Datasheet.pdf        ← PDF italiano (36 pagine)
+├── FPGA-Neural-Datasheet.tex        ← sorgente principale (IT)
+├── preamble.tex                     ← stili, palette, box, TikZ
+├── chapters/                        ← 14 capitoli (IT)
+└── en/
+    ├── FPGA-Neural-Datasheet-EN.pdf ← PDF inglese (36 pagine)
+    ├── FPGA-Neural-Datasheet-EN.tex ← sorgente principale (EN)
+    ├── preamble.tex                 ← stili (EN)
+    └── chapters/                    ← 14 capitoli (EN)
+```
+
+## Compilazione
+
+Serve una distribuzione LaTeX con `pgfplots`, `tikz-timing`, `tcolorbox`,
+`ltablex`, `listings`, `babel`.
+
+```sh
+# Italiano
+cd docs/datasheet
+pdflatex FPGA-Neural-Datasheet.tex
+pdflatex FPGA-Neural-Datasheet.tex   # 2ª passata per indice e riferimenti
+
+# Inglese
+cd docs/datasheet/en
+pdflatex FPGA-Neural-Datasheet-EN.tex
+pdflatex FPGA-Neural-Datasheet-EN.tex
+```
+
+## Nota sul pinout
+
+Il capitolo *Progetto hardware e mappa dei segnali* riporta l'analisi completa
+segnale-per-segnale del top-level `spi_neuron_top`, con la colonna **Ball**
+compilata con assegnazioni CABGA381 reali (53 segnali, `.lpf` reale in
+`synth/`) e verificata da un place\&route reale (`nextpnr-ecp5`, 0 errori di
+vincolo, `Program finished normally`) — non più auto-piazzate.