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


typedef struct {
        uint32_t kernel_nops_at_aiclk_fmin: 1;

        uint32_t gddr_therm_trip: 1;

        uint32_t extended_board_id: 1;

        uint32_t reserved: 29;
} telemetry_feature_flags_bits_0_t;

typedef union {
        uint32_t u32_all;
        telemetry_feature_flags_bits_0_t bits;
} telemetry_feature_flags_0_t;
 /* end of telemetry_feature_capabilities */


#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

#define TAG_AICLK_ARB_MIN 65

#define TAG_AICLK_ARB_MAX 66

#define TAG_ENABLED_MIN_ARB 67

#define TAG_ENABLED_MAX_ARB 68

#define TAG_AICLK_PPM_INFO 69

#define TAG_HOST_AICLK_LIMIT 70

#define TAG_SMBUS_ERRORS 71

#define TAG_GDDR_MRISC_NOC2AXI_PORT 72

#define TAG_GDDR_WEST_IO_POWER 73

#define TAG_GDDR_EAST_IO_POWER 74

#define TAG_KERNEL_THROTTLER 75

#define TAG_NOP_START_COUNT 76

#define TAG_NOP_ON_DURATION 77

#define TAG_FW_CAPABILITIES_0 78

#define TAG_FW_ACTIVE_CONFIG_0 79

#define TAG_FLASH_JEDEC_ID 80

#define TAG_CCFGOVR_STATE 81

#define TAG_CCFGOVR_SEQ 82

#define TAG_BOARD_ID_EXT_HIGH 83

#define TAG_BOARD_ID_EXT_MIDDLE 84

#define TAG_BOARD_ID_EXT_LOW 85
 /* 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 86

#define TELEM_UPDATE_INTERVAL_DEFAULT_MS 100

#define TELEM_UPDATE_INTERVAL_MIN_MS 1
 
int init_telemetry(void);
uint32_t ConvertFloatToTelemetry(float value);
float ConvertTelemetryToFloat(int32_t value);
int StartTelemetryTimer(void);

uint8_t TelemetrySetUpdateInterval(uint32_t interval_ms);
void UpdateDmFwVersion(uint32_t bl_version, uint32_t app_version);
void UpdateTelemetryNocTranslation(bool translation_enabled);
void UpdateTelemetryBoardPowerLimit(uint32_t power_limit);
void UpdateTelemetryTdpLimit(uint32_t tdp_limit);
void UpdateTelemetryThermTripCount(uint16_t therm_trip_count);
void UpdateTelemetryHostAiclkLimit(uint32_t fmax);
void UpdateTelemetryKernelThrottler(bool enabled, uint32_t stop_nops_freq);
void UpdateTelemetryFlashJedecId(uint32_t jedec_id);
uint32_t GetTelemetryFlashJedecId(void);
void UpdateTelemetryGddrThermTrip(bool enabled);
telemetry_feature_flags_bits_0_t GetActiveFeatures(void);
bool GetTelemetryTagValid(uint16_t tag);
uint32_t GetTelemetryTag(uint16_t tag);
 
#endif