#include <stdbool.h>
#include <stdint.h>

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 )

Macros

Functions