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