Skip to content

gHashTag/tt-trinity-phi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TRI-1 Phi — Trinity φ-anchor

Submit License Sacred

One of three neurons of Trinity TRI-NET — three sacred constants embodied in silicon:

  • φ-anchorTHIS REPO (1×1, Lucas POST proving φ²+φ⁻²=3 on power-up, canonical seed 0x47C0)
  • e-enginett-trinity-euler (8×2, 18 SUPER-CROWN modules)
  • γ-surfacett-trinity-gamma (8×4, 32 PE full mesh)

Apache-2.0 · ternary {−1,0,+1} · SKY130A · DOI 10.5281/zenodo.19227877

Sacred Formula

V = n × 3^k × π^m × φ^p × e^q × γ^r × C^t × G^u

This chip is the φ^p factor — the golden anchor that all Trinity computation references. Single ternary cell. Power-up emits the canonical hash 0x47C0 as witness of dot4(1,2,3,4) over GF(16), proving the Trinity identity φ²+φ⁻²=3 through Lucas recurrence.

Renamed from tt-trinity-nano

This repository was renamed from tt-trinity-nano on 2026-05-16 as part of the Trinity TRI-NET sacred-constant naming. The old URL redirects to this one — old clones/forks continue to work.


TRI-1 Nano — Single-tile Trinity GF16 MAC

🌳 Trinity role: BRANCH-SILICON — TTSKY26b shuttle SKU 1 of 3. Sibling of tt-trinity-gf16 (Mid) and tt-trinity-max (Max). Spec: TRI_NET_SHUTTLE_TRIAD · EPIC trinity-fpga#49 L-DPC7.

Anchor: φ² + φ⁻² = 3 · DOI 10.5281/zenodo.19227877

What it is

The smallest, simplest, most-likely-to-tape-out cleanly member of the TRI-1 Triad — three Trinity ternary-MAC silicon dies submitted to the same TinyTapeout shuttle (TTSKY26b, close 2026-05-18):

SKU Repo Tiles Modules Role
Nano this 1×1 5 (1 tile + GF16 leaves) floor of the family — must close
Mid tt-trinity-gf16 8×2 15 SUPER-CROWN modules + GF16 mesh + BLAKE3 + ternary matmul + Lucas POST + BPB counter + Wishbone flagship
Max tt-trinity-max (TBD) 4×4 mesh full mesh-of-meshes, target stretch stretch goal

All three drive the same canonical 16-bit constant 0x47C0 on {uio_out, uo_out} immediately after reset, computed from the same hard-coded dot4(1.0, 2.0, 3.0, 4.0) in GF16. That equality is the cross-die anchor of TG-TRIAD-X (Theorem 36.1) in PhD chapter 36.

Architecture

                 ┌──────────────────────────────────────────┐
   ui_in[0]      │       tt_um_trinity_nano (top)           │
   load_mode ───►│                                          │
   ui_in[7]      │   ┌───────────────────────────────────┐  │
   load_strobe ─►│   │ canonical gf16_dot4(1,2,3,4)      │  │ ──► uo_out[7:0]   = 0xC0
   ui_in[6]      │   │   (combinational, always live)    │  │     uio_out[7:0]  = 0x47
   compute_s ───►│   └───────────────────────────────────┘  │
                 │                                          │
   uio_in[7:0]   │   ┌───────────────────────────────────┐  │
   operand ─────►│   │ trinity_gf16_tile #(TILE_ID=0)    │──┼──► uo_out / uio_out
                 │   │ packet path (LOAD_A, COMPUTE,     │  │     when load_mode=1
                 │   │  RESULT, RECEIPT)                 │  │
                 │   └───────────────────────────────────┘  │
                 └──────────────────────────────────────────┘
  • load_mode = 0 (default): output pins always present 0x47C0. This is what the TT test harness samples on the first cycle after reset, and it is what the TG-TRIAD-X canonical job observes from all three dies.
  • load_mode = 1: rising edges on ui_in[7] clock the byte on uio_in into operand-A lanes 0…3 of the internal tile; a rising edge on ui_in[6] then issues a COMPUTE packet. Result appears on the uo_out+uio_out pins on the next cycle.

Hard constraints (Silicon Invariants)

Rule Statement Enforced by
R-SI-1 0 new * operators in synthesisable RTL Code review; gf16_mul is XOR-based
R-SI-2 0 DSP / multiplier macros OpenLane2 reports
R-SI-3 WNS ≥ 0 ns at 50 MHz on SKY130A OpenLane2 STA
R-SI-4 DRC-clean (0 violations) OpenLane2 KLayout DRC
R-SI-5 LVS-clean OpenLane2 LVS
R-SI-6 Apache-2.0 only, no vendor IP LICENSE + source headers

Build

# Local simulation (iverilog)
cd test
make
# GDS via GitHub Actions
git push
# → triggers .github/workflows/gds.yaml
# → OpenLane2 (SKY130A) → DRC + LVS + STA → uploads gds_artifact

Pin mapping

See info.yaml for the canonical map. Summary:

  • ui_in[0]load_mode
  • ui_in[6]compute_strobe
  • ui_in[7]load_lane_strobe
  • uio_in — operand byte (low 8 bits of GF16 element)
  • uo_out — result[7:0]
  • uio_out — result[15:8]
  • uio_oe8'hFF (always drive)

Provenance

See also

About

TRI-1 Phi — Trinity φ-anchor: 1×1 single-cell Lucas POST proving φ²+φ⁻²=3 on power-up, canonical seed 0x47C0. TTSKY26b · Apache-2.0 · ternary · SKY130A · Bazaar Green AI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors