TT Zephyr Platforms 19.0.0-rc2
Tenstorrent Firmware
Loading...
Searching...
No Matches
telemetry.h File Reference
#include <stdbool.h>
#include <stdint.h>

Go to the source code of this file.

Macros

#define TELEMETRY_VERSION   0x00000100
 The current version of the tenstorrent telemetry interface v0.1.0 - Only update when redefining the meaning of an existing tag Semver format: 0 x 00 Major Minor Patch.
#define TAG_BOARD_ID_HIGH   1
 High part of the board ID.
#define TAG_BOARD_ID_LOW   2
 Low part of the board ID.
#define TAG_ASIC_ID   3
 ASIC ID.
#define TAG_HARVESTING_STATE   4
 Harvesting state of the system.
#define TAG_UPDATE_TELEM_SPEED   5
 Update interval for telemetry in milliseconds.
#define TAG_VCORE   6
 VCore voltage in millivolts.
#define TAG_TDP   7
 Thermal design power (TDP) in watts.
#define TAG_TDC   8
 Thermal design current (TDC) in amperes.
#define TAG_VDD_LIMITS   9
 VDD limits (min and max) in millivolts.
#define TAG_THM_LIMIT_SHUTDOWN   10
 Thermal shutdown limit in degrees Celsius.
#define TAG_ASIC_TEMPERATURE   11
 ASIC temperature in signed 16.16 fixed-point format.
#define TAG_VREG_TEMPERATURE   12
 Voltage regulator temperature in degrees Celsius. (Not implemented)
#define TAG_BOARD_TEMPERATURE   13
 Board temperature in degrees Celsius. (Not implemented)
#define TAG_AICLK   14
 AI clock frequency in megahertz.
#define TAG_AXICLK   15
 AXI clock frequency in megahertz.
#define TAG_ARCCLK   16
 ARC clock frequency in megahertz.
#define TAG_L2CPUCLK0   17
 L2CPU clock 0 frequency in megahertz.
#define TAG_L2CPUCLK1   18
 L2CPU clock 1 frequency in megahertz.
#define TAG_L2CPUCLK2   19
 L2CPU clock 2 frequency in megahertz.
#define TAG_L2CPUCLK3   20
 L2CPU clock 3 frequency in megahertz.
#define TAG_ETH_LIVE_STATUS   21
 Ethernet live status.
#define TAG_GDDR_STATUS   22
 GDDR status.
#define TAG_GDDR_SPEED   23
 GDDR speed in megabits per second.
#define TAG_ETH_FW_VERSION   24
 Ethernet firmware version.
#define TAG_GDDR_FW_VERSION   25
 GDDR firmware version.
#define TAG_DM_APP_FW_VERSION   26
 DM application firmware version.
#define TAG_DM_BL_FW_VERSION   27
 DM bootloader firmware version.
#define TAG_FLASH_BUNDLE_VERSION   28
 Flash bundle version.
#define TAG_CM_FW_VERSION   29
 CM firmware version.
#define TAG_L2CPU_FW_VERSION   30
 L2CPU firmware version.
#define TAG_FAN_SPEED   31
 Fan speed as a percentage.
#define TAG_TIMER_HEARTBEAT   32
 Timer heartbeat counter.
#define TAG_TELEM_ENUM_COUNT   33
 Total number of telemetry tags.
#define TAG_ENABLED_TENSIX_COL   34
 Enabled Tensix columns.
#define TAG_ENABLED_ETH   35
 Enabled Ethernet interfaces.
#define TAG_ENABLED_GDDR   36
 Enabled GDDR interfaces.
#define TAG_ENABLED_L2CPU   37
 Enabled L2CPU cores.
#define TAG_PCIE_USAGE   38
 PCIe usage information.
#define TAG_INPUT_CURRENT   39
 Input current in amperes.
#define TAG_NOC_TRANSLATION   40
 NOC translation status.
#define TAG_FAN_RPM   41
 Fan RPM.
#define TAG_GDDR_0_1_TEMP   42
 GDDR 0 and 1 temperature.
#define TAG_GDDR_2_3_TEMP   43
 GDDR 2 and 3 temperature.
#define TAG_GDDR_4_5_TEMP   44
 GDDR 4 and 5 temperature.
#define TAG_GDDR_6_7_TEMP   45
 GDDR 6 and 7 temperature.
#define TAG_GDDR_0_1_CORR_ERRS   46
 GDDR 0 and 1 corrected errors.
#define TAG_GDDR_2_3_CORR_ERRS   47
 GDDR 2 and 3 corrected errors.
#define TAG_GDDR_4_5_CORR_ERRS   48
 GDDR 4 and 5 corrected errors.
#define TAG_GDDR_6_7_CORR_ERRS   49
 GDDR 6 and 7 corrected errors.
#define TAG_GDDR_UNCORR_ERRS   50
 GDDR uncorrected errors.
#define TAG_MAX_GDDR_TEMP   51
 Maximum GDDR temperature.
#define TAG_ASIC_LOCATION   52
 ASIC location.
#define TAG_BOARD_POWER_LIMIT   53
 Board power limit in watts.
#define TAG_INPUT_POWER   54
 Input power in watts.
#define TAG_TDC_LIMIT_MAX   55
 Maximum TDC limit in amperes.
#define TAG_THM_LIMIT_THROTTLE   56
 Thermal throttle limit in degrees Celsius.
#define TAG_FW_BUILD_DATE   57
 Firmware build date.
#define TAG_TT_FLASH_VERSION   58
 TT flash version.
#define TAG_ENABLED_TENSIX_ROW   59
 Enabled Tensix rows.
#define TAG_THERM_TRIP_COUNT   60
 Thermal trip count.
#define TAG_ASIC_ID_HIGH   61
 High part of the ASIC ID.
#define TAG_ASIC_ID_LOW   62
 Low part of the ASIC ID.
#define TAG_AICLK_LIMIT_MAX   63
 Maximum AI clock frequency.
#define TAG_TDP_LIMIT_MAX   64
 Maximum TDP limit in watts.
#define TAG_COUNT   65
#define TELEM_OFFSET(tag)

Functions

void init_telemetry (uint32_t app_version)
uint32_t ConvertFloatToTelemetry (float value)
float ConvertTelemetryToFloat (int32_t value)
int GetMaxGDDRTemp (void)
void StartTelemetryTimer (void)
void UpdateDmFwVersion (uint32_t bl_version, uint32_t app_version)
void UpdateTelemetryNocTranslation (bool translation_enabled)
void UpdateTelemetryBoardPowerLimit (uint32_t power_limit)
void UpdateTelemetryThermTripCount (uint16_t therm_trip_count)
bool GetTelemetryTagValid (uint16_t tag)
uint32_t GetTelemetryTag (uint16_t tag)

Macro Definition Documentation

◆ TAG_COUNT

#define TAG_COUNT   65

◆ TELEM_OFFSET

#define TELEM_OFFSET ( tag)
Value:
(tag)

◆ TELEMETRY_VERSION

#define TELEMETRY_VERSION   0x00000100

The current version of the tenstorrent telemetry interface v0.1.0 - Only update when redefining the meaning of an existing tag Semver format: 0 x 00 Major Minor Patch.

Function Documentation

◆ ConvertFloatToTelemetry()

uint32_t ConvertFloatToTelemetry ( float value)

◆ ConvertTelemetryToFloat()

float ConvertTelemetryToFloat ( int32_t value)

◆ GetMaxGDDRTemp()

int GetMaxGDDRTemp ( void )

◆ GetTelemetryTag()

uint32_t GetTelemetryTag ( uint16_t tag)

◆ GetTelemetryTagValid()

bool GetTelemetryTagValid ( uint16_t tag)

◆ init_telemetry()

void init_telemetry ( uint32_t app_version)

◆ StartTelemetryTimer()

void StartTelemetryTimer ( void )

◆ UpdateDmFwVersion()

void UpdateDmFwVersion ( uint32_t bl_version,
uint32_t app_version )

◆ UpdateTelemetryBoardPowerLimit()

void UpdateTelemetryBoardPowerLimit ( uint32_t power_limit)

◆ UpdateTelemetryNocTranslation()

void UpdateTelemetryNocTranslation ( bool translation_enabled)

◆ UpdateTelemetryThermTripCount()

void UpdateTelemetryThermTripCount ( uint16_t therm_trip_count)