1 /*
2  * SPDX-FileCopyrightText: 2019-2021 Espressif Systems (Shanghai) CO LTD
3  *
4  * SPDX-License-Identifier: Apache-2.0
5  */
6 
7 #pragma once
8 
9 #ifdef __cplusplus
10 extern "C" {
11 #endif
12 
13 #define COUNT_EFUSE_REG_PER_BLOCK 8      /* The number of registers per block. */
14 
15 #define ESP_EFUSE_SECURE_VERSION_NUM_BLOCK EFUSE_BLK3
16 
17 #define ESP_EFUSE_FIELD_CORRESPONDS_CODING_SCHEME(blk, max_num_bit)                                   \
18 	esp_efuse_coding_scheme_t scheme = esp_efuse_get_coding_scheme(blk);                              \
19     if ((scheme == EFUSE_CODING_SCHEME_3_4    && max_num_bit > 192) ||                                \
20         (scheme == EFUSE_CODING_SCHEME_REPEAT && max_num_bit > 128)) {                                \
21     	return false;                                                                                 \
22     }
23 
24 /* @brief Encode one or more sets of 6 byte sequences into
25  * 8 bytes suitable for 3/4 Coding Scheme.
26  *
27  * This function is only useful if the CODING_SCHEME efuse
28  * is set to value 1 for 3/4 Coding Scheme.
29  *
30  * @param[in] in_bytes Pointer to a sequence of bytes to encode for 3/4 Coding Scheme. Must have length in_bytes_len. After being written to hardware, these bytes will read back as little-endian words.
31  * @param[out] out_words Pointer to array of words suitable for writing to efuse write registers. Array must contain 2 words (8 bytes) for every 6 bytes in in_bytes_len. Can be a pointer to efuse write registers.
32  * @param in_bytes_len. Length of array pointed to by in_bytes, in bytes. Must be a multiple of 6.
33  *
34  * @return ESP_ERR_INVALID_ARG if either pointer is null or in_bytes_len is not a multiple of 6. ESP_OK otherwise.
35  */
36 esp_err_t esp_efuse_utility_apply_34_encoding(const uint8_t *in_bytes, uint32_t *out_words, size_t in_bytes_len);
37 
38 #ifdef __cplusplus
39 }
40 #endif
41