2016-08-17 15:08:22 +00:00
|
|
|
// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
#ifndef __ESP_ATTR_H__
|
|
|
|
#define __ESP_ATTR_H__
|
|
|
|
|
2019-01-02 06:04:53 +00:00
|
|
|
#include "sdkconfig.h"
|
|
|
|
|
2016-08-17 15:08:22 +00:00
|
|
|
#define ROMFN_ATTR
|
|
|
|
|
|
|
|
//Normally, the linker script will put all code and rodata in flash,
|
2016-09-12 07:23:15 +00:00
|
|
|
//and all variables in shared RAM. These macros can be used to redirect
|
|
|
|
//particular functions/variables to other memory regions.
|
2016-08-17 15:08:22 +00:00
|
|
|
|
2018-12-07 04:14:58 +00:00
|
|
|
// Forces code into IRAM instead of flash
|
|
|
|
#define IRAM_ATTR _SECTION_ATTR_IMPL(".iram1", __COUNTER__)
|
2016-08-17 15:08:22 +00:00
|
|
|
|
2016-08-24 09:20:00 +00:00
|
|
|
// Forces data into DRAM instead of flash
|
2018-12-07 04:14:58 +00:00
|
|
|
#define DRAM_ATTR _SECTION_ATTR_IMPL(".dram1", __COUNTER__)
|
2016-08-17 15:08:22 +00:00
|
|
|
|
2020-04-16 10:32:07 +00:00
|
|
|
#ifdef CONFIG_ESP32_IRAM_AS_8BIT_ACCESSIBLE_MEMORY
|
|
|
|
// Forces data into IRAM instead of DRAM
|
|
|
|
#define IRAM_DATA_ATTR __attribute__((section(".iram.data")))
|
|
|
|
|
2020-06-14 18:35:38 +00:00
|
|
|
// Forces data into IRAM instead of DRAM and map it to coredump
|
|
|
|
#define COREDUMP_IRAM_DATA_ATTR _SECTION_ATTR_IMPL(".iram.data.coredump", __COUNTER__)
|
|
|
|
|
2020-04-16 10:32:07 +00:00
|
|
|
// Forces bss into IRAM instead of DRAM
|
|
|
|
#define IRAM_BSS_ATTR __attribute__((section(".iram.bss")))
|
|
|
|
#else
|
2020-06-14 18:35:38 +00:00
|
|
|
#define COREDUMP_IRAM_DATA_ATTR
|
2020-04-16 10:32:07 +00:00
|
|
|
#define IRAM_DATA_ATTR
|
|
|
|
|
|
|
|
#define IRAM_BSS_ATTR
|
|
|
|
#endif
|
|
|
|
|
2017-11-16 09:31:15 +00:00
|
|
|
// Forces data to be 4 bytes aligned
|
|
|
|
#define WORD_ALIGNED_ATTR __attribute__((aligned(4)))
|
|
|
|
|
|
|
|
// Forces data to be placed to DMA-capable places
|
|
|
|
#define DMA_ATTR WORD_ALIGNED_ATTR DRAM_ATTR
|
|
|
|
|
2019-07-29 06:31:30 +00:00
|
|
|
// Forces a function to be inlined
|
|
|
|
#define FORCE_INLINE_ATTR static inline __attribute__((always_inline))
|
|
|
|
|
2017-01-11 09:23:23 +00:00
|
|
|
// Forces a string into DRAM instead of flash
|
2020-07-21 05:07:34 +00:00
|
|
|
// Use as esp_rom_printf(DRAM_STR("Hello world!\n"));
|
2016-11-17 10:05:47 +00:00
|
|
|
#define DRAM_STR(str) (__extension__({static const DRAM_ATTR char __c[] = (str); (const char *)&__c;}))
|
|
|
|
|
2016-10-13 00:46:51 +00:00
|
|
|
// Forces code into RTC fast memory. See "docs/deep-sleep-stub.rst"
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_IRAM_ATTR _SECTION_ATTR_IMPL(".rtc.text", __COUNTER__)
|
2016-09-12 07:23:15 +00:00
|
|
|
|
2018-09-14 10:28:18 +00:00
|
|
|
#if CONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY
|
|
|
|
// Forces bss variable into external memory. "
|
2018-12-07 04:14:58 +00:00
|
|
|
#define EXT_RAM_ATTR _SECTION_ATTR_IMPL(".ext_ram.bss", __COUNTER__)
|
2018-09-14 10:28:18 +00:00
|
|
|
#else
|
2019-07-29 06:31:30 +00:00
|
|
|
#define EXT_RAM_ATTR
|
2018-09-14 10:28:18 +00:00
|
|
|
#endif
|
|
|
|
|
2016-10-13 00:46:51 +00:00
|
|
|
// Forces data into RTC slow memory. See "docs/deep-sleep-stub.rst"
|
2016-09-12 07:23:15 +00:00
|
|
|
// Any variable marked with this attribute will keep its value
|
|
|
|
// during a deep sleep / wake cycle.
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_DATA_ATTR _SECTION_ATTR_IMPL(".rtc.data", __COUNTER__)
|
2016-09-12 07:23:15 +00:00
|
|
|
|
2018-03-22 13:39:19 +00:00
|
|
|
// Forces read-only data into RTC memory. See "docs/deep-sleep-stub.rst"
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_RODATA_ATTR _SECTION_ATTR_IMPL(".rtc.rodata", __COUNTER__)
|
2016-09-12 07:23:15 +00:00
|
|
|
|
2018-03-22 13:39:19 +00:00
|
|
|
// Allows to place data into RTC_SLOW memory.
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_SLOW_ATTR _SECTION_ATTR_IMPL(".rtc.force_slow", __COUNTER__)
|
2018-03-22 13:39:19 +00:00
|
|
|
|
|
|
|
// Allows to place data into RTC_FAST memory.
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_FAST_ATTR _SECTION_ATTR_IMPL(".rtc.force_fast", __COUNTER__)
|
2018-03-22 13:39:19 +00:00
|
|
|
|
2018-02-26 17:32:58 +00:00
|
|
|
// Forces data into noinit section to avoid initialization after restart.
|
2018-12-07 04:14:58 +00:00
|
|
|
#define __NOINIT_ATTR _SECTION_ATTR_IMPL(".noinit", __COUNTER__)
|
2018-02-26 17:32:58 +00:00
|
|
|
|
|
|
|
// Forces data into RTC slow memory of .noinit section.
|
|
|
|
// Any variable marked with this attribute will keep its value
|
|
|
|
// after restart or during a deep sleep / wake cycle.
|
2018-12-07 04:14:58 +00:00
|
|
|
#define RTC_NOINIT_ATTR _SECTION_ATTR_IMPL(".rtc_noinit", __COUNTER__)
|
2018-02-26 17:32:58 +00:00
|
|
|
|
2020-06-14 18:35:38 +00:00
|
|
|
// Forces code into DRAM instead of flash and map it to coredump
|
|
|
|
#define COREDUMP_DRAM_ATTR _SECTION_ATTR_IMPL(".dram1.coredump", __COUNTER__)
|
|
|
|
|
|
|
|
// Forces data into RTC memory and map it to coredump
|
|
|
|
#define COREDUMP_RTC_DATA_ATTR _SECTION_ATTR_IMPL(".rtc.coredump", __COUNTER__)
|
|
|
|
|
|
|
|
// Allows to place data into RTC_FAST memory and map it to coredump
|
|
|
|
#define COREDUMP_RTC_FAST_ATTR _SECTION_ATTR_IMPL(".rtc.fast.coredump", __COUNTER__)
|
|
|
|
|
2018-09-28 10:29:52 +00:00
|
|
|
// Forces to not inline function
|
|
|
|
#define NOINLINE_ATTR __attribute__((noinline))
|
|
|
|
|
2019-08-08 09:49:12 +00:00
|
|
|
// This allows using enum as flags in C++
|
|
|
|
// Format: FLAG_ATTR(flag_enum_t)
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
2019-09-04 21:35:08 +00:00
|
|
|
// Inline is required here to avoid multiple definition error in linker
|
2019-08-08 09:49:12 +00:00
|
|
|
#define FLAG_ATTR_IMPL(TYPE, INT_TYPE) \
|
2019-09-04 21:35:08 +00:00
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator~ (TYPE a) { return (TYPE)~(INT_TYPE)a; } \
|
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator| (TYPE a, TYPE b) { return (TYPE)((INT_TYPE)a | (INT_TYPE)b); } \
|
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator& (TYPE a, TYPE b) { return (TYPE)((INT_TYPE)a & (INT_TYPE)b); } \
|
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator^ (TYPE a, TYPE b) { return (TYPE)((INT_TYPE)a ^ (INT_TYPE)b); } \
|
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator>> (TYPE a, int b) { return (TYPE)((INT_TYPE)a >> b); } \
|
|
|
|
FORCE_INLINE_ATTR constexpr TYPE operator<< (TYPE a, int b) { return (TYPE)((INT_TYPE)a << b); } \
|
|
|
|
FORCE_INLINE_ATTR TYPE& operator|=(TYPE& a, TYPE b) { a = a | b; return a; } \
|
|
|
|
FORCE_INLINE_ATTR TYPE& operator&=(TYPE& a, TYPE b) { a = a & b; return a; } \
|
|
|
|
FORCE_INLINE_ATTR TYPE& operator^=(TYPE& a, TYPE b) { a = a ^ b; return a; } \
|
|
|
|
FORCE_INLINE_ATTR TYPE& operator>>=(TYPE& a, int b) { a >>= b; return a; } \
|
|
|
|
FORCE_INLINE_ATTR TYPE& operator<<=(TYPE& a, int b) { a <<= b; return a; }
|
2019-08-08 09:49:12 +00:00
|
|
|
|
|
|
|
#define FLAG_ATTR_U32(TYPE) FLAG_ATTR_IMPL(TYPE, uint32_t)
|
|
|
|
#define FLAG_ATTR FLAG_ATTR_U32
|
|
|
|
|
|
|
|
#else
|
|
|
|
#define FLAG_ATTR(TYPE)
|
|
|
|
#endif
|
|
|
|
|
2018-12-07 04:14:58 +00:00
|
|
|
// Implementation for a unique custom section
|
|
|
|
//
|
|
|
|
// This prevents gcc producing "x causes a section type conflict with y"
|
|
|
|
// errors if two variables in the same source file have different linkage (maybe const & non-const) but are placed in the same custom section
|
|
|
|
//
|
|
|
|
// Using unique sections also means --gc-sections can remove unused
|
|
|
|
// data with a custom section type set
|
|
|
|
#define _SECTION_ATTR_IMPL(SECTION, COUNTER) __attribute__((section(SECTION "." _COUNTER_STRINGIFY(COUNTER))))
|
|
|
|
|
|
|
|
#define _COUNTER_STRINGIFY(COUNTER) #COUNTER
|
|
|
|
|
2019-04-17 06:31:07 +00:00
|
|
|
/* Use IDF_DEPRECATED attribute to mark anything deprecated from use in
|
|
|
|
ESP-IDF's own source code, but not deprecated for external users.
|
|
|
|
*/
|
|
|
|
#ifdef IDF_CI_BUILD
|
|
|
|
#define IDF_DEPRECATED(REASON) __attribute__((deprecated(REASON)))
|
|
|
|
#else
|
|
|
|
#define IDF_DEPRECATED(REASON)
|
|
|
|
#endif
|
|
|
|
|
2016-08-17 15:08:22 +00:00
|
|
|
#endif /* __ESP_ATTR_H__ */
|