Merge branch 'doc/update_tsens_doc' into 'master'

doc(temperature_sensor): Update temperature snesor docs, remove inaccurate part

See merge request espressif/esp-idf!40369
This commit is contained in:
C.S.M
2025-07-07 13:42:56 +08:00
3 changed files with 9 additions and 49 deletions

View File

@@ -8,29 +8,9 @@ Introduction
The {IDF_TARGET_NAME} has a built-in sensor used to measure the chip's internal temperature. The temperature sensor module contains an 8-bit Sigma-Delta analog-to-digital converter (ADC) and a digital-to-analog converter (DAC) to compensate for the temperature measurement.
Due to restrictions of hardware, the sensor has predefined measurement ranges with specific measurement errors. See the table below for details.
.. list-table::
:header-rows: 1
:widths: 50 50
:align: center
* - Predefined Range (°C)
- Error (°C)
* - 50 ~ 125
- < 3
* - 20 ~ 100
- < 2
* - -10 ~ 80
- < 1
* - -30 ~ 50
- < 2
* - -40 ~ 20
- < 3
.. note::
The temperature sensor is designed primarily to measure the temperature changes inside the chip. The internal temperature of a chip is usually higher than the ambient temperature, and is affected by factors such as the microcontroller's clock frequency or I/O load, and the external thermal environment.
The temperature sensor is designed primarily to measure the temperature **inside** the silicon. The sensor can reflect the temperature changes very well but it can't give a precise measurement value. So it's not recommended to use it for ambient temperature measurement.
Functional Overview
-------------------

View File

@@ -8,29 +8,9 @@
{IDF_TARGET_NAME} 内置传感器,用于测量芯片内部的温度。该温度传感器模组包含一个 8 位 Sigma-Delta 模拟-数字转换器 (ADC) 和一个数字-模拟转换器 (DAC),可以补偿测量结果,减少温度测量的误差。
由于硬件限制,温度传感器存在预定义的测量范围及其对应误差,详见下表:
.. list-table::
:header-rows: 1
:widths: 50 50
:align: center
* - 预定义测量范围 (°C)
- 测量误差 (°C)
* - 50 ~ 125
- < 3
* - 20 ~ 100
- < 2
* - -10 ~ 80
- < 1
* - -30 ~ 50
- < 2
* - -40 ~ 20
- < 3
.. note::
温度传感器主要用于测量芯片内部的温度变化。芯片内部温度通常高于环境温度,并且受到微控制器的时钟频率或 I/O 负载、外部散热环境等因素影响
温度传感器主要用于测量芯片内部的温度变化。温度值可用作衡量温度变化趋势,但无法提供精确的温度数值,因此不建议用作精准测量温度
功能概述
-------------------

View File

@@ -7,13 +7,13 @@ The ESP32-S2/C3/S3/C2 has a built-in temperature sensor. The temperature sensor
The conversion relationship is the first two columns of the table below. Among them, `offset = 0`(default) is the main measurement option, and other values are extended measurement options.
| DAC level | offset | measure range(℃) | measure error(℃) |
| :-------: | :----: | :--------------: | :--------------: |
| 0 | -2 | 50 ~ 125 | < 3 |
| 1 | -1 | 20 ~ 100 | < 2 |
| 2 | 0 | -10 ~ 80 | < 1 |
| 3 | 1 | -30 ~ 50 | < 2 |
| 4 | 2 | -40 ~ 20 | < 3 |
| DAC level | offset | measure range(℃) |
| :-------: | :----: | :--------------: |
| 0 | -2 | 50 ~ 125 |
| 1 | -1 | 20 ~ 100 |
| 2 | 0 | -10 ~ 80 |
| 3 | 1 | -30 ~ 50 |
| 4 | 2 | -40 ~ 20 |
## How to use example