esp-idf-sys 0.37.2

Bindings for ESP-IDF (Espressif's IoT Development Framework)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! This module contains a macro - `esp_app_desc` - that - when invoked - defines
//! the ESP-IDF `esp_app_desc` application description with default information as per below.
//!
//! `esp_app_desc` structure fields as defined by the macro:
//! - version - from CARGO_PKG_VERSION
//! - project_name - from CARGO_PKG_NAME
//! - time - current build time
//! - date - current build date
//! - idf_ver - current IDF version from bindings
//! - app_elf_sha256 - [0; 32]
//! - min_efuse_blk_rev_full - CONFIG_ESP_EFUSE_BLOCK_REV_MIN_FULL
//! - secure_version - 0
//!
//! If you need a custom definition, don't use the macro but rather - manually define your own
//! static instance of the `esp_app_desc_t` structure in the `.rodata_desc` link section.

#[macro_export]
macro_rules! esp_app_desc {
    () => {
        // For backwards compatibility
        $crate::esp_app_desc!(false);
    };
    {} => {
        // New way to call the macro
        $crate::esp_app_desc!(true);
    };
    ($fix_date_time_swap: expr) => {
        #[no_mangle]
        #[used]
        #[link_section = ".rodata_desc"]
        #[allow(non_upper_case_globals)]
        pub static esp_app_desc: $crate::esp_app_desc_t = {
            const fn str_to_cstr_array<const C: usize>(s: &str) -> [::core::ffi::c_char; C] {
                let bytes = s.as_bytes();
                assert!(bytes.len() < C);

                let mut ret: [::core::ffi::c_char; C] = [0; C];
                let mut index = 0;
                while index < bytes.len() {
                    ret[index] = bytes[index] as _;
                    index += 1;
                }

                ret
            }

            $crate::esp_app_desc_t {
                magic_word: $crate::ESP_APP_DESC_MAGIC_WORD,
                secure_version: 0,
                reserv1: [0; 2],
                version: str_to_cstr_array(env!("CARGO_PKG_VERSION")),
                project_name: str_to_cstr_array(env!("CARGO_PKG_NAME")),
                #[cfg(all(esp_idf_app_compile_time_date, not(esp_idf_app_reproducible_build)))]
                time: str_to_cstr_array(if $fix_date_time_swap {
                    $crate::build_time::build_time_utc!("%H:%M:%S")
                } else {
                    $crate::build_time::build_time_utc!("%Y-%m-%d")
                }),
                #[cfg(all(esp_idf_app_compile_time_date, not(esp_idf_app_reproducible_build)))]
                date: str_to_cstr_array(if $fix_date_time_swap {
                    $crate::build_time::build_time_utc!("%Y-%m-%d")
                } else {
                    $crate::build_time::build_time_utc!("%H:%M:%S")
                }),
                #[cfg(not(all(
                    esp_idf_app_compile_time_date,
                    not(esp_idf_app_reproducible_build)
                )))]
                time: [0i8; 16],
                #[cfg(not(all(
                    esp_idf_app_compile_time_date,
                    not(esp_idf_app_reproducible_build)
                )))]
                date: [0i8; 16],
                idf_ver: str_to_cstr_array($crate::const_format::formatcp!(
                    "{}.{}.{}",
                    $crate::ESP_IDF_VERSION_MAJOR,
                    $crate::ESP_IDF_VERSION_MINOR,
                    $crate::ESP_IDF_VERSION_PATCH
                )),
                app_elf_sha256: [0; 32],
                #[cfg(any(
                    esp_idf_version_patch_at_least_5_1_7,
                    esp_idf_version_patch_at_least_5_2_3,
                    esp_idf_version_at_least_5_3_2,
                ))]
                min_efuse_blk_rev_full: $crate::CONFIG_ESP_EFUSE_BLOCK_REV_MIN_FULL as _,
                #[cfg(any(
                    esp_idf_version_patch_at_least_5_1_7,
                    esp_idf_version_patch_at_least_5_2_3,
                    esp_idf_version_at_least_5_3_2,
                ))]
                max_efuse_blk_rev_full: $crate::CONFIG_ESP_EFUSE_BLOCK_REV_MAX_FULL as _,
                #[cfg(esp_idf_version_at_least_5_4_0)]
                mmu_page_size: 0,
                #[cfg(esp_idf_version_at_least_5_4_0)]
                reserv3: [0; 3],
                #[cfg(esp_idf_version_at_least_5_4_0)]
                reserv2: [0; 18],
                #[cfg(any(
                    esp_idf_version_patch_at_least_5_1_7,
                    esp_idf_version_patch_at_least_5_2_3,
                    esp_idf_version_patch_at_least_5_3_2,
                ))]
                reserv2: [0; 19],
                #[cfg(not(any(
                    esp_idf_version_patch_at_least_5_1_7,
                    esp_idf_version_patch_at_least_5_2_3,
                    esp_idf_version_at_least_5_3_2,
                )))]
                reserv2: [0; 20],
            }
        };
    };
}