1 /*
2  * SPDX-FileCopyrightText: 2020-2023 Espressif Systems (Shanghai) CO LTD
3  *
4  * SPDX-License-Identifier: Apache-2.0
5  */
6 
7 #include <esp_bit_defs.h>
8 #include "esp_efuse.h"
9 #include "esp_efuse_table.h"
10 #include "esp_efuse_rtc_calib.h"
11 
esp_efuse_rtc_calib_get_ver(void)12 int esp_efuse_rtc_calib_get_ver(void)
13 {
14     uint32_t blk_ver_major = 0;
15     esp_efuse_read_field_blob(ESP_EFUSE_BLK_VERSION_MAJOR, &blk_ver_major, ESP_EFUSE_BLK_VERSION_MAJOR[0]->bit_count); // IDF-5366
16 
17     uint32_t cali_version = (blk_ver_major == 1) ? ESP_EFUSE_ADC_CALIB_VER : 0;
18     if (!cali_version) {
19         ESP_LOGW("eFuse", "calibration efuse version does not match, set default version to 0");
20     }
21 
22     return cali_version;
23 }
24 
esp_efuse_rtc_calib_get_init_code(int version,uint32_t adc_unit,int atten)25 uint32_t esp_efuse_rtc_calib_get_init_code(int version, uint32_t adc_unit, int atten)
26 {
27     assert((version >= ESP_EFUSE_ADC_CALIB_VER_MIN) &&
28            (version <= ESP_EFUSE_ADC_CALIB_VER_MAX));
29     (void) adc_unit;
30     const esp_efuse_desc_t** init_code_efuse;
31     assert(atten < 4);
32     if (atten == 0) {
33         init_code_efuse = ESP_EFUSE_ADC1_INIT_CODE_ATTEN0;
34     } else if (atten == 1) {
35         init_code_efuse = ESP_EFUSE_ADC1_INIT_CODE_ATTEN1;
36     } else if (atten == 2) {
37         init_code_efuse = ESP_EFUSE_ADC1_INIT_CODE_ATTEN2;
38     } else {
39         init_code_efuse = ESP_EFUSE_ADC1_INIT_CODE_ATTEN3;
40     }
41 
42     int init_code_size = esp_efuse_get_field_size(init_code_efuse);
43     assert(init_code_size == 10);
44 
45     uint32_t init_code = 0;
46     ESP_ERROR_CHECK(esp_efuse_read_field_blob(init_code_efuse, &init_code, init_code_size));
47     return init_code + 1000;    // version 1 logic
48 }
49 
esp_efuse_rtc_calib_get_cal_voltage(int version,uint32_t adc_unit,int atten,uint32_t * out_digi,uint32_t * out_vol_mv)50 esp_err_t esp_efuse_rtc_calib_get_cal_voltage(int version, uint32_t adc_unit, int atten, uint32_t* out_digi, uint32_t* out_vol_mv)
51 {
52     (void)adc_unit;    //On esp32c3,  V1 we don't have calibration data for ADC2, using the efuse data of ADC1
53     const esp_efuse_desc_t** cal_vol_efuse;
54     uint32_t calib_vol_expected_mv;
55     if ((version < ESP_EFUSE_ADC_CALIB_VER_MIN) ||
56         (version > ESP_EFUSE_ADC_CALIB_VER_MAX)) {
57         return ESP_ERR_INVALID_ARG;
58     }
59     if (atten >= 4) {
60         return ESP_ERR_INVALID_ARG;
61     }
62     if (atten == 0) {
63         cal_vol_efuse = ESP_EFUSE_ADC1_CAL_VOL_ATTEN0;
64         calib_vol_expected_mv = 400;
65     } else if (atten == 1) {
66         cal_vol_efuse = ESP_EFUSE_ADC1_CAL_VOL_ATTEN1;
67         calib_vol_expected_mv = 550;
68     } else if (atten == 2) {
69         cal_vol_efuse = ESP_EFUSE_ADC1_CAL_VOL_ATTEN2;
70         calib_vol_expected_mv = 750;
71     } else {
72         cal_vol_efuse = ESP_EFUSE_ADC1_CAL_VOL_ATTEN3;
73         calib_vol_expected_mv = 1370;
74     }
75 
76     assert(cal_vol_efuse[0]->bit_count == 10);
77 
78     uint32_t cal_vol = 0;
79     ESP_ERROR_CHECK(esp_efuse_read_field_blob(cal_vol_efuse, &cal_vol, cal_vol_efuse[0]->bit_count));
80 
81     *out_digi = 2000 + ((cal_vol & BIT(9))? -(cal_vol & ~BIT9): cal_vol);
82     *out_vol_mv = calib_vol_expected_mv;
83     return ESP_OK;
84 }
85 
esp_efuse_rtc_calib_get_tsens_val(float * tsens_cal)86 esp_err_t esp_efuse_rtc_calib_get_tsens_val(float* tsens_cal)
87 {
88     uint32_t version = esp_efuse_rtc_calib_get_ver();
89     if (version != 1) {
90         *tsens_cal = 0.0;
91         return ESP_ERR_NOT_SUPPORTED;
92     }
93     const esp_efuse_desc_t** cal_temp_efuse;
94     cal_temp_efuse = ESP_EFUSE_TEMP_CALIB;
95     int cal_temp_size = esp_efuse_get_field_size(cal_temp_efuse);
96     assert(cal_temp_size == 9);
97 
98     uint32_t cal_temp = 0;
99     esp_err_t err = esp_efuse_read_field_blob(cal_temp_efuse, &cal_temp, cal_temp_size);
100     assert(err == ESP_OK);
101     (void)err;
102     // BIT(8) stands for sign: 1: negtive, 0: positive
103     *tsens_cal = ((cal_temp & BIT(8)) != 0)? -(uint8_t)cal_temp: (uint8_t)cal_temp;
104     return ESP_OK;
105 }
106