telemetry.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 Tenstorrent AI ULC
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef TELEMETRY_H
#define TELEMETRY_H
 
#include <stdbool.h>
#include <stdint.h>


#define TELEMETRY_VERSION 0x00000100


#define TAG_BOARD_ID_HIGH 1

#define TAG_BOARD_ID_LOW 2

#define TAG_ASIC_ID 3

#define TAG_HARVESTING_STATE 4

#define TAG_UPDATE_TELEM_SPEED 5

#define TAG_VCORE 6

#define TAG_TDP 7

#define TAG_TDC 8

#define TAG_VDD_LIMITS 9

#define TAG_THM_LIMIT_SHUTDOWN 10

#define TAG_ASIC_TEMPERATURE 11

#define TAG_VREG_TEMPERATURE 12

#define TAG_BOARD_TEMPERATURE 13

#define TAG_AICLK 14

#define TAG_AXICLK 15

#define TAG_ARCCLK 16

#define TAG_L2CPUCLK0 17

#define TAG_L2CPUCLK1 18

#define TAG_L2CPUCLK2 19

#define TAG_L2CPUCLK3 20

#define TAG_ETH_LIVE_STATUS 21

#define TAG_GDDR_STATUS 22

#define TAG_GDDR_SPEED 23

#define TAG_ETH_FW_VERSION 24

#define TAG_GDDR_FW_VERSION 25

#define TAG_DM_APP_FW_VERSION 26

#define TAG_DM_BL_FW_VERSION 27

#define TAG_FLASH_BUNDLE_VERSION 28

#define TAG_CM_FW_VERSION 29

#define TAG_L2CPU_FW_VERSION 30

#define TAG_FAN_SPEED 31

#define TAG_TIMER_HEARTBEAT 32

#define TAG_TELEM_ENUM_COUNT 33

#define TAG_ENABLED_TENSIX_COL 34

#define TAG_ENABLED_ETH 35

#define TAG_ENABLED_GDDR 36

#define TAG_ENABLED_L2CPU 37

#define TAG_PCIE_USAGE 38

#define TAG_INPUT_CURRENT 39

#define TAG_NOC_TRANSLATION 40

#define TAG_FAN_RPM 41

#define TAG_GDDR_0_1_TEMP 42

#define TAG_GDDR_2_3_TEMP 43

#define TAG_GDDR_4_5_TEMP 44

#define TAG_GDDR_6_7_TEMP 45

#define TAG_GDDR_0_1_CORR_ERRS 46

#define TAG_GDDR_2_3_CORR_ERRS 47

#define TAG_GDDR_4_5_CORR_ERRS 48

#define TAG_GDDR_6_7_CORR_ERRS 49

#define TAG_GDDR_UNCORR_ERRS 50

#define TAG_MAX_GDDR_TEMP 51

#define TAG_ASIC_LOCATION 52

#define TAG_BOARD_POWER_LIMIT 53

#define TAG_INPUT_POWER 54

#define TAG_TDC_LIMIT_MAX 55

#define TAG_THM_LIMIT_THROTTLE 56

#define TAG_FW_BUILD_DATE 57

#define TAG_TT_FLASH_VERSION 58

#define TAG_ENABLED_TENSIX_ROW 59

#define TAG_THERM_TRIP_COUNT 60

#define TAG_ASIC_ID_HIGH 61

#define TAG_ASIC_ID_LOW 62

#define TAG_AICLK_LIMIT_MAX 63

#define TAG_TDP_LIMIT_MAX 64
 /* end of telemetry_tag group */
 
/* Not a real tag, signifies the last tag in the list.
 * MUST be incremented if new tags are defined.
 */
#define TAG_COUNT 65
 
/* Telemetry tags are at offset `tag` in the telemetry buffer */
#define TELEM_OFFSET(tag) (tag)
 
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);
 
#endif