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_err.h"
9 #include "esp_log.h"
10 #include "esp_efuse.h"
11 #include "esp_efuse_table.h"
12 #include "esp_efuse_rtc_calib.h"
13 #include "hal/adc_types.h"
14 
esp_efuse_rtc_calib_get_ver(void)15 int esp_efuse_rtc_calib_get_ver(void)
16 {
17     uint32_t blk_ver_major = 0;
18     ESP_ERROR_CHECK(esp_efuse_read_field_blob(ESP_EFUSE_BLK_VERSION_MAJOR, &blk_ver_major, ESP_EFUSE_BLK_VERSION_MAJOR[0]->bit_count)); // IDF-5366
19 
20     uint32_t cali_version = (blk_ver_major == 1) ? ESP_EFUSE_ADC_CALIB_VER : 0;
21     if (!cali_version) {
22         ESP_LOGW("eFuse", "calibration efuse version does not match, set default version to 0");
23     }
24 
25     return cali_version;
26 }
27 
esp_efuse_rtc_calib_get_init_code(int version,uint32_t adc_unit,int atten)28 uint32_t esp_efuse_rtc_calib_get_init_code(int version, uint32_t adc_unit, int atten)
29 {
30     assert((version >= ESP_EFUSE_ADC_CALIB_VER_MIN) &&
31            (version <= ESP_EFUSE_ADC_CALIB_VER_MAX));
32     assert(atten < 4);
33     assert(adc_unit <= ADC_UNIT_2);
34 
35     const esp_efuse_desc_t **desc[8] = {ESP_EFUSE_ADC1_INIT_CODE_ATTEN0, ESP_EFUSE_ADC1_INIT_CODE_ATTEN1, ESP_EFUSE_ADC1_INIT_CODE_ATTEN2, ESP_EFUSE_ADC1_INIT_CODE_ATTEN3,
36                                         ESP_EFUSE_ADC2_INIT_CODE_ATTEN0, ESP_EFUSE_ADC2_INIT_CODE_ATTEN1, ESP_EFUSE_ADC2_INIT_CODE_ATTEN2, ESP_EFUSE_ADC2_INIT_CODE_ATTEN3};
37     int efuse_icode_bits = 0;
38     uint32_t adc_icode[4] = {};
39     uint32_t adc_icode_diff[4] = {};
40     uint8_t desc_index = (adc_unit == ADC_UNIT_1) ? 0 : 4;
41 
42     for (int diff_index = 0; diff_index < 4; diff_index++) {
43         efuse_icode_bits = esp_efuse_get_field_size(desc[desc_index]);
44         ESP_ERROR_CHECK(esp_efuse_read_field_blob(desc[desc_index], &adc_icode_diff[diff_index], efuse_icode_bits));
45         desc_index++;
46     }
47 
48     //Version 1 logic for calculating ADC ICode based on EFUSE burnt value
49     if (adc_unit == ADC_UNIT_1) {
50         adc_icode[0] = adc_icode_diff[0] + 1850;
51         adc_icode[1] = adc_icode_diff[1] + adc_icode[0] + 90;
52         adc_icode[2] = adc_icode_diff[2] + adc_icode[1];
53         adc_icode[3] = adc_icode_diff[3] + adc_icode[2] + 70;
54     } else {
55         adc_icode[0] = adc_icode_diff[0] + 2020;
56         adc_icode[1] = adc_icode_diff[1] + adc_icode[0];
57         adc_icode[2] = adc_icode_diff[2] + adc_icode[1];
58         adc_icode[3] = adc_icode_diff[3] + adc_icode[2];
59     }
60 
61     return adc_icode[atten];
62 }
63 
esp_efuse_rtc_calib_get_cal_voltage(int version,uint32_t adc_unit,int atten,uint32_t * out_digi,uint32_t * out_vol_mv)64 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)
65 {
66     assert((version >= ESP_EFUSE_ADC_CALIB_VER_MIN) &&
67            (version <= ESP_EFUSE_ADC_CALIB_VER_MAX));
68     assert(atten < 4);
69     assert(adc_unit <= ADC_UNIT_2);
70 
71     int efuse_vol_bits = 0;
72     uint32_t adc_vol_diff[8] = {};
73     uint32_t adc1_vol[4] = {};
74     uint32_t adc2_vol[4] = {};
75     const esp_efuse_desc_t **desc[8] = {ESP_EFUSE_ADC1_CAL_VOL_ATTEN0, ESP_EFUSE_ADC1_CAL_VOL_ATTEN1, ESP_EFUSE_ADC1_CAL_VOL_ATTEN2, ESP_EFUSE_ADC1_CAL_VOL_ATTEN3,
76                                         ESP_EFUSE_ADC2_CAL_VOL_ATTEN0, ESP_EFUSE_ADC2_CAL_VOL_ATTEN1, ESP_EFUSE_ADC2_CAL_VOL_ATTEN2, ESP_EFUSE_ADC2_CAL_VOL_ATTEN3};
77     for (int i = 0; i < 8; i++) {
78         efuse_vol_bits = esp_efuse_get_field_size(desc[i]);
79         ESP_ERROR_CHECK(esp_efuse_read_field_blob(desc[i], &adc_vol_diff[i], efuse_vol_bits));
80     }
81 
82     adc1_vol[3] = adc_vol_diff[3] + 900;
83     adc1_vol[2] = adc_vol_diff[2] + adc1_vol[3] + 800;
84     adc1_vol[1] = adc_vol_diff[1] + adc1_vol[2] + 700;
85     adc1_vol[0] = adc_vol_diff[0] + adc1_vol[1] + 800;
86     adc2_vol[3] = adc1_vol[3] - adc_vol_diff[7] + 15;
87     adc2_vol[2] = adc1_vol[2] - adc_vol_diff[6] + 20;
88     adc2_vol[1] = adc1_vol[1] - adc_vol_diff[5] + 10;
89     adc2_vol[0] = adc1_vol[0] - adc_vol_diff[4] + 40;
90 
91     *out_digi = (adc_unit == ADC_UNIT_1) ? adc1_vol[atten] : adc2_vol[atten];
92     *out_vol_mv = 850;
93 
94     return ESP_OK;
95 }
96 
esp_efuse_rtc_calib_get_tsens_val(float * tsens_cal)97 esp_err_t esp_efuse_rtc_calib_get_tsens_val(float* tsens_cal)
98 {
99     uint32_t version = esp_efuse_rtc_calib_get_ver();
100     if (version != 1) {
101         *tsens_cal = 0.0;
102         return ESP_ERR_NOT_SUPPORTED;
103     }
104     const esp_efuse_desc_t** cal_temp_efuse;
105     cal_temp_efuse = ESP_EFUSE_TEMP_CALIB;
106     int cal_temp_size = esp_efuse_get_field_size(cal_temp_efuse);
107     assert(cal_temp_size == 9);
108 
109     uint32_t cal_temp = 0;
110     esp_err_t err = esp_efuse_read_field_blob(cal_temp_efuse, &cal_temp, cal_temp_size);
111     assert(err == ESP_OK);
112     (void)err;
113     // BIT(8) stands for sign: 1: negtive, 0: positive
114     *tsens_cal = ((cal_temp & BIT(8)) != 0)? -(uint8_t)cal_temp: (uint8_t)cal_temp;
115     return ESP_OK;
116 }
117