Tenstorrent GraySkull Note

Grayskull™ e75/e150 Tensix Processor link

This section outlines the system requirements, physical installation instructions, and initial software set-up for Grayskull™ e75 and e150 Tensix Processor add-in boards.

• Specifications/Requirements
• Hardware Installation
• Software Setup
• Regulatory Compliance

NOTE: Software support for Grayskull has been discontinued. The last supported versions of Tenstorrent’s software for Grayskull are as follows:

• TT-Firmware: fw_pack-80.14.0.0.fwbundle
• TT-KMD: ttkmd_1.31
• TT-Buda: v0.19.3
• TT-Metalium: v0.55

Installation

Based on: https://docs.tenstorrent.com/tt-metal/latest/tt-metalium/installing.html#prerequisites

[!important]

1. Use python 3.10

TT-KMD driver install

• DKMS must be installed:

OS	Command
Ubuntu / Debian	apt install dkms
Fedora	dnf install dkms
Enterprise Linux Based	dnf install epel-release && dnf install dkms

• Install the latest TT-KMD version:

git clone https://github.com/tenstorrent/tt-kmd.git
cd tt-kmd
# checkout to v1.31
git checkout ttkmd-1.31
sudo dkms add .
sudo dkms install tenstorrent/1.31
sudo modprobe tenstorrent

• For more information visit Tenstorrents TT-KMD GitHub repository.

Update Device TT-Firmware with TT-Flash

Be sure to align the FW version with the compatible version in the table above for your particular configuration.

• Install TT-Flash:

  pip install git+https://github.com/tenstorrent/tt-flash.git

• Reboot to load changes.

• Download and install the TT-Firmware version according to the table above. We will use latest here as example:

git clone https://github.com/tenstorrent/tt-firmware
cd tt-firmwarte
git checkout v80.14.0.0
tt-flash flash --fw-tar fw_pack-18.14.0.0.fwbundle

• For more information visit Tenstorrent’s TT-Firmware GitHub Repository and TT-Flash Github Repository.

---

Install System Management Interface (TT-SMI)

pip install git+https://github.com/tenstorrent/[email protected]

A display with device information, telemetry, and firmware will appear:

If the tool runs without error, your system has been configured correctly.

• For more information, visit Tenstorrent’s TT-SMI GitHub repository.

Install TT-Metal!

[!warning]
Switch your Python to 3.10 version in this step

Clone tt-metal repo, switch to correct version:

git clone https://github.com/tenstorrent/tt-metal.git --recurse-submodules
cd tt-metal
git checkout v0.55.0
git submodule update --init --recursive

Some Pre-requests:

sudo apt install libboost-all-dev
sudo apt install lld
sudo apt install pandoc libtbb-dev libcapstone-dev pkg-config
sudo bash install_dependencies.sh

[!note]
Also, install latest cmake as well.

Add this into second line of CMakeLists.txt:

set(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)

Set environment variables:

export ARCH_NAME=grayskull
export TT_METAL_HOME=$(pwd)

Then build the library:

./build_metal.sh

If you have YAML error, download this file: grayskull_120_arch.yaml

Install TTNN

After TT-Metal is compiled, in the same directory, use:

pip install .