v19.0.0

Migration Guide

This is a working draft for the up-coming v19.0.0 release.

This document lists recommended and required changes for those migrating from the previous v18.12.0 firmware release to the new v19.0.0 firmware release.

TT-Flash Update

As part of the update to firmware release 19.0, the firmware bundle revision has been incremented to 2.0.0. Users must update to tt-flash 3.4.7 or later to install this firmware update, as the update process has changed.

To update to tt-flash, run pip install 'tt-flash>=3.4.7'

Firmware Update Process

As part of the update to firmware 19.0, the DMFW bootloader will be updated. This update process takes longer than a standard update, so the reset phase for updates from 18.x -> 19.x within tt-flash will take 60 seconds versus 20 seconds for a standard update. The update process will look like so:

tt-flash fw_pack-19.0.0.fwbundle
Stage: SETUP
        Searching for default sys-config path
        Checking /etc/tenstorrent/config.json: not found
        Checking ~/.config/tenstorrent/config.json: not found

        Could not find config in default search locations, if you need it, either pass it in explicitly or generate one
        Warning: continuing without sys-config, galaxy systems will not be reset
Stage: DETECT
Stage: FLASH
        Sub Stage: VERIFY
                Verifying fw-package can be flashed: complete
                Verifying Blackhole[0] can be flashed
        Stage: FLASH
                Sub Stage FLASH Step 1: Blackhole[0]
                        Detected major version upgrade from (18, 12, 0, 0) to (19, 0, 0, 1)
                        ROM version is: (18, 12, 0, 0). tt-flash version is: (19, 0, 0, 1)
                        FW bundle version > ROM version. ROM will now be updated.
                Sub Stage FLASH Step 2: Blackhole[0] {p150a}
                        Writing new firmware... SUCCESS
                        Firmware verification... SUCCESS
Stage: RESET
                Detected update across major version, will wait 60 seconds for m3 to boot after reset
 Starting reset on devices at PCI indices: 0
 Waiting for 60 seconds for potential hotplug removal.
 Waiting for devices to reappear on pci bus...
 Reset successfully completed for device at PCI index 0.
 Finishing reset on devices at PCI indices: 0
FLASH SUCCESS