mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-04 09:01:40 +01:00 
			
		
		
		
	Added .rtc_noinit and .noinit section definitions into linker file /esp32/ld/esp32.common.ld. The macro __NOINIT_ATTR, RTC_NOINIT_ATTR declared in esp32/esp_attr.h file. Added unit test file to test added behavior for noinit variables and its attributes. Added documentation changes for new added attributes. Make some corrections after code review: The linker file has been corrected to place noinit section before bss_start to make it safer. Documentation file has been modified to clarify reset behavior of allocated data . Corrected typos in test_noinit.c and removed assertion of noinit variable to avoid possible issues with ROM boot loader memory allocation. The linker file has been corrected to place noinit section before bss_start to make it safer. Documentation file has been modified to clarify reset behavior of allocated data . Corrected typos in test_noinit.c and removed assertion of noinit variable to avoid possible issues with ROM boot loader memory allocation. Update test_noinit.c file to address RTCWDT_RTC_RESET reset reason instead of POWERON_RESET. Test optimized to pass automated unit testing. esp32: Add .noinit and .rtc_noinit sections to the linker script Update of general-notes.rst documentation to fomat examples as code and attributes as identifiers. Test test_noinit.c corrected to pass automated testing (support ofTEST_CASE_MULTIPLE_STAGES()) https://ezredmine.espressif.cn:8765/issues/15878
		
			
				
	
	
		
			59 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			59 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
// 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__
 | 
						|
 | 
						|
#define ROMFN_ATTR
 | 
						|
 | 
						|
//Normally, the linker script will put all code and rodata in flash,
 | 
						|
//and all variables in shared RAM. These macros can be used to redirect
 | 
						|
//particular functions/variables to other memory regions.
 | 
						|
 | 
						|
// Forces code into IRAM instead of flash.
 | 
						|
#define IRAM_ATTR __attribute__((section(".iram1")))
 | 
						|
 | 
						|
// Forces data into DRAM instead of flash
 | 
						|
#define DRAM_ATTR __attribute__((section(".dram1")))
 | 
						|
 | 
						|
// 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
 | 
						|
 | 
						|
// Forces a string into DRAM instead of flash
 | 
						|
// Use as ets_printf(DRAM_STR("Hello world!\n"));
 | 
						|
#define DRAM_STR(str) (__extension__({static const DRAM_ATTR char __c[] = (str); (const char *)&__c;}))
 | 
						|
 | 
						|
// Forces code into RTC fast memory. See "docs/deep-sleep-stub.rst"
 | 
						|
#define RTC_IRAM_ATTR __attribute__((section(".rtc.text")))
 | 
						|
 | 
						|
// Forces data into RTC slow memory. See "docs/deep-sleep-stub.rst"
 | 
						|
// Any variable marked with this attribute will keep its value
 | 
						|
// during a deep sleep / wake cycle.
 | 
						|
#define RTC_DATA_ATTR __attribute__((section(".rtc.data")))
 | 
						|
 | 
						|
// Forces read-only data into RTC slow memory. See "docs/deep-sleep-stub.rst"
 | 
						|
#define RTC_RODATA_ATTR __attribute__((section(".rtc.rodata")))
 | 
						|
 | 
						|
// Forces data into noinit section to avoid initialization after restart.
 | 
						|
#define __NOINIT_ATTR __attribute__((section(".noinit")))
 | 
						|
 | 
						|
// 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.
 | 
						|
#define RTC_NOINIT_ATTR  __attribute__((section(".rtc_noinit")))
 | 
						|
 | 
						|
#endif /* __ESP_ATTR_H__ */
 |