readme (zh)

# NTC 驱动组件概述

[English Version](./README.md)

ntc驱动组件针对于不同热敏电阻初始化以及相应的温度读取做了封装,使用一个抽象层管理这些方案,便于开发者集成到自己的应用程序中,目前 ESP32-C2 / ESP32-C3 / ESP32 / ESP32-C6 / ESP32-S3 系列芯片都已经完成支持。

NTC Driver 适用电路:
    单 ADC 通道测量:
    当NTC在上面时,随着温度升高, NTC 的电阻值下降,导致分压电路中 NTC 端的电压下降,固定电阻端的电压上升,最终输出电压会随之变化。而当 NTC 在下面时,情况正好相反, NTC 的电阻值下降会导致分压电路中 NTC 端的电压上升,固定电阻端的电压下降,输出电压也会相应变化。因此, NTC 在上面和下面会得到相反的结果,这一点在设计和使用 NTC 测量电路时需要特别注意,确保正确理解和处理 NTC 的温度特性。
    Vcc  --------> Rref  --------> Rt  --------> GND

## ntc 热敏电阻方案使用示例

```c
    //1.选择ntc传感器并进行硬件参数初始化配置
    ntc_config_t ntc_config = {
        .b_value = 3950,
        .r25_ohm = 10000,
        .fixed_ohm = 10000,
        .vdd_mv = 3300,
        .atten = EXAMPLE_ADC_ATTEN,
        .channel = EXAMPLE_ADC1_CHAN3,
        .unit = ADC_UNIT_1
    };

    //2.创建 NTC 驱动并初始化 ADC
    ntc_device_handle_t ntc = NULL;;
    adc_oneshot_unit_handle_t adc_handle = NULL;
    ESP_ERROR_CHECK(ntc_dev_create(&ntc_config, &ntc, &adc_handle));
    ESP_ERROR_CHECK(ntc_dev_get_adc_handle(ntc, &adc_handle));

    //3.调用温度函数
    float temp = ntc_dev_get_temperature(ntc);
    ESP_LOGI(TAG, "NTC temperature = %.2f ℃", temp);
    ESP_ERROR_CHECK(ntc_dev_delete(ntc));
```

## 示例代码

[点击此处](https://github.com/espressif/esp-iot-solution/tree/master/examples/sensors/ntc_temperature_sensor) 获取示例代码及使用说明。

Links

Supports all targets

License: Apache-2.0

To add this component to your project, run:

idf.py add-dependency "espressif/ntc_driver^0.1.0"

or download archive

Stats

  • Archive size
    Archive size: 12.15 KB
  • Downloaded in total
    Downloaded in total 16.2k times
  • Downloaded this version
    This version: 10 times

Badge

espressif/ntc_driver version: 0.1.0
|