Coordinate systems docs

pjanevskiTT commented 1 week ago

Write a doc about coordinate systems. Base for this document is open-umd document which explains all coordinate systems we have

Note for reviews

Feel free to suggest any naming conventions for these coordinate systems. Naming from the initial doc is going to be followed for now, just because it seems that this is mostly accepted across different tenstorrent products (syseng tools, tt-metal, tt-umd)

pjanevskiTT commented 1 week ago

Comment from original harvesting PR https://github.com/tenstorrent/tt-umd/pull/202#discussion_r1814977324

pjanevskiTT commented 1 week ago

One more comment from original PR https://github.com/tenstorrent/tt-umd/pull/202#discussion_r1817054285

alewycky-tenstorrent commented 1 week ago

Suggestion on naming:

Physical: actual chip layout, not used by SW
NOC post-translate: the burned-in NOC coordinates (currently "Physical")
NOC pre-translate: NOC translation LUT input coordinates (currently "HW translated")
Virtualized: no change (virtualized is the coord space that makes NOC pre-translate look like a chip without translation at all)
Logical: no change (logical is the coord space with just tensixes based at 0-0?)

Also I suggest addressing them in this order (or the reverse) because that's how they are layered.

tenstorrent / tt-umd

Coordinate systems docs #223

Note for reviews