Tsensor#

Tsensor(Temperature Sensor)提供芯片内部温度采集功能,支持温度传感器初始化与当前温度值查询。

模块公共头文件

#include "include/driver/tsensor.h"

接口清单#

接口名称

功能简述

uapi_tsensor_init

初始化 Tsensor,配置采样周期、采样模式并启动采样

uapi_tsensor_get_current_temp

获取 Tsensor 当前温度值

Functions#

uapi_tsensor_init #

errcode_t uapi_tsensor_init(void)

声明头文件

#include "include/driver/tsensor.h"

功能说明

  • 初始化 Tsensor 模块,配置采样周期与采样模式并启动采样。

  • 初始化后可调用 uapi_tsensor_get_current_temp 查询温度。

  • 重复调用时再次执行初始化流程。

前置条件

  • 调用时序约束:作为 Tsensor 模块入口,须在 get_current_temp 之前调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功初始化

Other

其他错误码,参考errcode_t

执行失败

uapi_tsensor_get_current_temp #

errcode_t uapi_tsensor_get_current_temp(int8_t *temp)

声明头文件

#include "include/driver/tsensor.h"

功能说明

  • 获取 Tsensor 当前温度值。

  • 温度通过输出参数返回,单位为 ℃。

  • 温度值可能无效,需通过返回值判断是否成功获取。

前置条件

  • 调用时序约束:必须在 uapi_tsensor_init 成功返回后调用。

出参

名称

数据类型

输出说明

temp

int8_t *

当前温度值,单位为 ℃,成功获取时有效,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

获取温度成功,温度有效

温度采集成功

Other

其他错误码,参考errcode_t

执行失败

Type definitions#

typedef_errcode_t #

typedef uint32_t errcode_t;

使用说明

本模块返回类型为 errcode_t 的对外接口的返回值类型。

Macros#

ERRCODE_SUCC #

#define ERRCODE_SUCC                                        0UL