Route UI

Tool for visualizing test data for Tenstorrent hardware, with support for displaying multiple chips, analyzing operation performance, and link congestion.

Demo

Application demo

route-ui.mp4

Multichip view and L1 memory reports per core

Route-ui.-.Demo.-.small.mp4

Operations and table view

DRAM detailed view

Pipes

Operation performance

Links and external links performace

Cluster view

Pre-requisites

• Node.js (v20.11.1)
• npm
• One of the node versioning tool below:
  • nvm
  • volta

Install

Clone the repo and install dependencies:

git clone --depth 1 --branch main https://github.com/tenstorrent/route-ui.git
cd route-ui
npm install

Starting Development

Start the app in the dev environment:

npm start

Packaging for Production

To package apps for the local platform:

npm run package

npm run package-linux

Post Installation (mac only)

run xattr -d com.apple.quarantine /Applications/Route\ UI.app in terminal after installation to bypass Apple security settings

required and expected files and folders in run folder

Inside the folder containing a run you want to visualize, the following files and folders are expected:

• runtime_data.yaml
• cluster_desc.yaml
• /device_desc_runtime/
• /netlist_analyzer/
• /reports/
• /perf_results/
• /perf_results/metadata/
• /perf_results/graph_descriptor/
• /perf_results/queue_descriptor/
• /perf_results/analyzer_results/