Design notes¶
The record behind each feature: the problem, the options weighed, what was decided and why, what was measured, what is still open. They are written for whoever develops YANC; the user-facing text is the manual (../index.md). Each note marks what is a fact (read in the code), what was measured and what was deduced, and most end with a section “For the documentation” listing what the manual has to say.
Rules for SAPHO/¶
Pay only for what you use. Every block exists only when an opcode of the program needs it: a
generateon the opcode parameters, never left to the synthesiser to prune (measured: it does not, precision review 2026-09-15).No mux input at don’t care (Luciano, 2026-10-16). Every multiplexer is guided by the opcode parameters: each input is a term or a row inside the
generate(or guard) of the operation that uses it, and what is not generated is a constant 0. Noxdefault, noxarm, noxon an absent operator’s output. An unusedxinput still costs logic (Yosys: +21 % in a floatula_mux, pipeln-and-division.md 4.3).
note |
about |
|---|---|
the v7.1 command line, the |
|
two SAPHOs passing a value: the protocol, the single-link design (v7.0, superseded in part) |
|
several links per processor: chains, fan-out, fan-in, two clocks |
|
|
|
|
|
|
|
|
|
|
|
handing SAPHO to Quartus or Vivado without showing its source: IEEE 1735, vendor schemes, a service (notes, parked until a partnership) |
|
a whole array through a port, one word per clock, stopping while the FIFO is full (design, not implemented) |
|
a dual-port memory for arrays, a controller and a MAC ( |
|
the Dirac notation as expressions with shapes, computed in loops, and loops with pointers and |
|
user names that collide in the assembly |
|
a variable written and never read leaves the program; |
|
the slow dividers: the pipeline tried and dropped, the register cuts kept (5 and 4 stages since 2026-10-16, section 4.4) |
|
the known ways to normalise a float on an FPGA: eight built, two fitted, none faster; finished, |
|
the known ways to align the exponents and add; the add as a separate circuit built, not fitted; finished, |
|
the float and word-width review (2026-09): the evidence behind TODO items 1 to 9 |
|
the HDL audit: the evidence behind issues #32 to #35 |