The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.
Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more
mbed 2
This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.
TARGET_TB_SENSE_12/TARGET_Silicon_Labs/TARGET_EFM32/emlib/inc/em_ramfunc.h@142:4eea097334d6, 2017-05-10 (annotated)
- Committer:
- Anna Bridge
- Date:
- Wed May 10 11:31:27 2017 +0100
- Revision:
- 142:4eea097334d6
- Child:
- 159:7130f322cb7e
Release 142 of the mbed library
Ports for Upcoming Targets
Fixes and Changes
4059: [Silicon Labs] Rename targets https://github.com/ARMmbed/mbed-os/pull/4059
4187: [NCS36510] Reduce default heap size allocated by IAR to 1/4 of RAM https://github.com/ARMmbed/mbed-os/pull/4187
4225: fixed missing device_name for xDot and removed progen https://github.com/ARMmbed/mbed-os/pull/4225
4251: Fix C++11 build error w/ u-blox EVK-ODIN-W2 https://github.com/ARMmbed/mbed-os/pull/4251
4236: STM32 Fixed warning related to __packed redefinition https://github.com/ARMmbed/mbed-os/pull/4236
4190: LPC4088: Enable LWIP feature https://github.com/ARMmbed/mbed-os/pull/4190
4260: Inherit Xadow M0 target from LPC11U35_501 https://github.com/ARMmbed/mbed-os/pull/4260
4249: Add consistent button names across targets https://github.com/ARMmbed/mbed-os/pull/4249
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Anna Bridge |
142:4eea097334d6 | 1 | /***************************************************************************//** |
Anna Bridge |
142:4eea097334d6 | 2 | * @file em_ramfunc.h |
Anna Bridge |
142:4eea097334d6 | 3 | * @brief RAM code support. |
Anna Bridge |
142:4eea097334d6 | 4 | * @version 5.1.2 |
Anna Bridge |
142:4eea097334d6 | 5 | ******************************************************************************* |
Anna Bridge |
142:4eea097334d6 | 6 | * @section License |
Anna Bridge |
142:4eea097334d6 | 7 | * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b> |
Anna Bridge |
142:4eea097334d6 | 8 | ******************************************************************************* |
Anna Bridge |
142:4eea097334d6 | 9 | * |
Anna Bridge |
142:4eea097334d6 | 10 | * Permission is granted to anyone to use this software for any purpose, |
Anna Bridge |
142:4eea097334d6 | 11 | * including commercial applications, and to alter it and redistribute it |
Anna Bridge |
142:4eea097334d6 | 12 | * freely, subject to the following restrictions: |
Anna Bridge |
142:4eea097334d6 | 13 | * |
Anna Bridge |
142:4eea097334d6 | 14 | * 1. The origin of this software must not be misrepresented; you must not |
Anna Bridge |
142:4eea097334d6 | 15 | * claim that you wrote the original software. |
Anna Bridge |
142:4eea097334d6 | 16 | * 2. Altered source versions must be plainly marked as such, and must not be |
Anna Bridge |
142:4eea097334d6 | 17 | * misrepresented as being the original software. |
Anna Bridge |
142:4eea097334d6 | 18 | * 3. This notice may not be removed or altered from any source distribution. |
Anna Bridge |
142:4eea097334d6 | 19 | * |
Anna Bridge |
142:4eea097334d6 | 20 | * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no |
Anna Bridge |
142:4eea097334d6 | 21 | * obligation to support this Software. Silicon Labs is providing the |
Anna Bridge |
142:4eea097334d6 | 22 | * Software "AS IS", with no express or implied warranties of any kind, |
Anna Bridge |
142:4eea097334d6 | 23 | * including, but not limited to, any implied warranties of merchantability |
Anna Bridge |
142:4eea097334d6 | 24 | * or fitness for any particular purpose or warranties against infringement |
Anna Bridge |
142:4eea097334d6 | 25 | * of any proprietary rights of a third party. |
Anna Bridge |
142:4eea097334d6 | 26 | * |
Anna Bridge |
142:4eea097334d6 | 27 | * Silicon Labs will not be liable for any consequential, incidental, or |
Anna Bridge |
142:4eea097334d6 | 28 | * special damages, or any other relief, or for any claim by any third party, |
Anna Bridge |
142:4eea097334d6 | 29 | * arising from your use of this Software. |
Anna Bridge |
142:4eea097334d6 | 30 | * |
Anna Bridge |
142:4eea097334d6 | 31 | ******************************************************************************/ |
Anna Bridge |
142:4eea097334d6 | 32 | |
Anna Bridge |
142:4eea097334d6 | 33 | #ifndef EM_RAMFUNC_H |
Anna Bridge |
142:4eea097334d6 | 34 | #define EM_RAMFUNC_H |
Anna Bridge |
142:4eea097334d6 | 35 | |
Anna Bridge |
142:4eea097334d6 | 36 | #ifdef __cplusplus |
Anna Bridge |
142:4eea097334d6 | 37 | extern "C" { |
Anna Bridge |
142:4eea097334d6 | 38 | #endif |
Anna Bridge |
142:4eea097334d6 | 39 | |
Anna Bridge |
142:4eea097334d6 | 40 | /***************************************************************************//** |
Anna Bridge |
142:4eea097334d6 | 41 | * @addtogroup emlib |
Anna Bridge |
142:4eea097334d6 | 42 | * @{ |
Anna Bridge |
142:4eea097334d6 | 43 | * @addtogroup RAMFUNC |
Anna Bridge |
142:4eea097334d6 | 44 | * @brief RAM code support. |
Anna Bridge |
142:4eea097334d6 | 45 | * @details |
Anna Bridge |
142:4eea097334d6 | 46 | * This module provides support for executing code from RAM. A unified method |
Anna Bridge |
142:4eea097334d6 | 47 | * to manage RAM code across all supported tools is provided. |
Anna Bridge |
142:4eea097334d6 | 48 | * @{ |
Anna Bridge |
142:4eea097334d6 | 49 | |
Anna Bridge |
142:4eea097334d6 | 50 | @note |
Anna Bridge |
142:4eea097334d6 | 51 | Other cross-compiler support macros are implemented in @ref COMMON. |
Anna Bridge |
142:4eea097334d6 | 52 | |
Anna Bridge |
142:4eea097334d6 | 53 | @note |
Anna Bridge |
142:4eea097334d6 | 54 | Functions executing from RAM should not be declared as static. |
Anna Bridge |
142:4eea097334d6 | 55 | |
Anna Bridge |
142:4eea097334d6 | 56 | @warning |
Anna Bridge |
142:4eea097334d6 | 57 | With GCC in hosted mode (default), standard library facilities are available |
Anna Bridge |
142:4eea097334d6 | 58 | to the tool regardless of the section attribute. Calls to standard libraries |
Anna Bridge |
142:4eea097334d6 | 59 | placed in the default section may therefore occur. To disable hosted mode, |
Anna Bridge |
142:4eea097334d6 | 60 | add '-ffreestanding' to the build command line. This is the only way to |
Anna Bridge |
142:4eea097334d6 | 61 | guarantee no calls to standard libraries with GCC. |
Anna Bridge |
142:4eea097334d6 | 62 | Read more at https://gcc.gnu.org/onlinedocs/gcc-5.3.0/gcc/Standards.html |
Anna Bridge |
142:4eea097334d6 | 63 | |
Anna Bridge |
142:4eea097334d6 | 64 | @n @section ramfunc_usage Usage |
Anna Bridge |
142:4eea097334d6 | 65 | |
Anna Bridge |
142:4eea097334d6 | 66 | In your .h file: |
Anna Bridge |
142:4eea097334d6 | 67 | @verbatim |
Anna Bridge |
142:4eea097334d6 | 68 | #include "em_ramfunc.h" |
Anna Bridge |
142:4eea097334d6 | 69 | |
Anna Bridge |
142:4eea097334d6 | 70 | SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 71 | void MyPrint(const char* string); |
Anna Bridge |
142:4eea097334d6 | 72 | @endverbatim |
Anna Bridge |
142:4eea097334d6 | 73 | |
Anna Bridge |
142:4eea097334d6 | 74 | Issues have been observed with armgcc when there is no declarator. It is |
Anna Bridge |
142:4eea097334d6 | 75 | recommended to have a declarator also for internal functions, but move the |
Anna Bridge |
142:4eea097334d6 | 76 | declarator to the .c file. |
Anna Bridge |
142:4eea097334d6 | 77 | |
Anna Bridge |
142:4eea097334d6 | 78 | In your .c file: |
Anna Bridge |
142:4eea097334d6 | 79 | @verbatim |
Anna Bridge |
142:4eea097334d6 | 80 | #include "em_ramfunc.h" |
Anna Bridge |
142:4eea097334d6 | 81 | |
Anna Bridge |
142:4eea097334d6 | 82 | SL_RAMFUNC_DEFINITION_BEGIN |
Anna Bridge |
142:4eea097334d6 | 83 | void MyPrint(const char* string) |
Anna Bridge |
142:4eea097334d6 | 84 | { |
Anna Bridge |
142:4eea097334d6 | 85 | ... |
Anna Bridge |
142:4eea097334d6 | 86 | } |
Anna Bridge |
142:4eea097334d6 | 87 | SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 88 | @endverbatim |
Anna Bridge |
142:4eea097334d6 | 89 | |
Anna Bridge |
142:4eea097334d6 | 90 | |
Anna Bridge |
142:4eea097334d6 | 91 | ******************************************************************************/ |
Anna Bridge |
142:4eea097334d6 | 92 | |
Anna Bridge |
142:4eea097334d6 | 93 | /******************************************************************************* |
Anna Bridge |
142:4eea097334d6 | 94 | ****************************** DEFINES *********************************** |
Anna Bridge |
142:4eea097334d6 | 95 | ******************************************************************************/ |
Anna Bridge |
142:4eea097334d6 | 96 | |
Anna Bridge |
142:4eea097334d6 | 97 | /** |
Anna Bridge |
142:4eea097334d6 | 98 | * @brief |
Anna Bridge |
142:4eea097334d6 | 99 | * This define is not present by default. By compiling with the define |
Anna Bridge |
142:4eea097334d6 | 100 | * @ref SL_RAMFUNC_DISABLE, code placed in RAM by the SL_RAMFUNC macros |
Anna Bridge |
142:4eea097334d6 | 101 | * will be placed in default code space (Flash) instead. |
Anna Bridge |
142:4eea097334d6 | 102 | * |
Anna Bridge |
142:4eea097334d6 | 103 | * @note |
Anna Bridge |
142:4eea097334d6 | 104 | * This define is not present by default. |
Anna Bridge |
142:4eea097334d6 | 105 | */ |
Anna Bridge |
142:4eea097334d6 | 106 | #if defined(DOXY_DOC_ONLY) |
Anna Bridge |
142:4eea097334d6 | 107 | #define SL_RAMFUNC_DISABLE |
Anna Bridge |
142:4eea097334d6 | 108 | #endif |
Anna Bridge |
142:4eea097334d6 | 109 | |
Anna Bridge |
142:4eea097334d6 | 110 | #if defined(SL_RAMFUNC_DISABLE) |
Anna Bridge |
142:4eea097334d6 | 111 | /** @brief Compiler ported function declarator for RAM code. */ |
Anna Bridge |
142:4eea097334d6 | 112 | #define SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 113 | |
Anna Bridge |
142:4eea097334d6 | 114 | /** @brief Compiler ported function definition begin marker for RAM code. */ |
Anna Bridge |
142:4eea097334d6 | 115 | #define SL_RAMFUNC_DEFINITION_BEGIN |
Anna Bridge |
142:4eea097334d6 | 116 | |
Anna Bridge |
142:4eea097334d6 | 117 | /** @brief Compiler ported function definition end marker for RAM code. */ |
Anna Bridge |
142:4eea097334d6 | 118 | #define SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 119 | |
Anna Bridge |
142:4eea097334d6 | 120 | #elif defined(__CC_ARM) |
Anna Bridge |
142:4eea097334d6 | 121 | /* MDK-ARM compiler */ |
Anna Bridge |
142:4eea097334d6 | 122 | #define SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 123 | #define SL_RAMFUNC_DEFINITION_BEGIN _Pragma("arm section code=\"ram_code\"") |
Anna Bridge |
142:4eea097334d6 | 124 | #define SL_RAMFUNC_DEFINITION_END _Pragma("arm section code") |
Anna Bridge |
142:4eea097334d6 | 125 | |
Anna Bridge |
142:4eea097334d6 | 126 | #elif defined(__ICCARM__) |
Anna Bridge |
142:4eea097334d6 | 127 | /* IAR Embedded Workbench */ |
Anna Bridge |
142:4eea097334d6 | 128 | #define SL_RAMFUNC_DECLARATOR __ramfunc |
Anna Bridge |
142:4eea097334d6 | 129 | #define SL_RAMFUNC_DEFINITION_BEGIN SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 130 | #define SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 131 | |
Anna Bridge |
142:4eea097334d6 | 132 | #elif defined(__GNUC__) && defined(__CROSSWORKS_ARM) |
Anna Bridge |
142:4eea097334d6 | 133 | /* Rowley Crossworks */ |
Anna Bridge |
142:4eea097334d6 | 134 | #define SL_RAMFUNC_DECLARATOR __attribute__ ((section(".fast"))) |
Anna Bridge |
142:4eea097334d6 | 135 | #define SL_RAMFUNC_DEFINITION_BEGIN SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 136 | #define SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 137 | |
Anna Bridge |
142:4eea097334d6 | 138 | #elif defined(__GNUC__) |
Anna Bridge |
142:4eea097334d6 | 139 | /* Simplicity Studio, Atollic and vanilla armgcc */ |
Anna Bridge |
142:4eea097334d6 | 140 | #define SL_RAMFUNC_DECLARATOR __attribute__ ((section(".ram"))) |
Anna Bridge |
142:4eea097334d6 | 141 | #define SL_RAMFUNC_DEFINITION_BEGIN SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 142 | #define SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 143 | |
Anna Bridge |
142:4eea097334d6 | 144 | #endif |
Anna Bridge |
142:4eea097334d6 | 145 | |
Anna Bridge |
142:4eea097334d6 | 146 | /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
Anna Bridge |
142:4eea097334d6 | 147 | /* Deprecated macro names and user config */ |
Anna Bridge |
142:4eea097334d6 | 148 | #if defined(RAMFUNC_DISABLE) |
Anna Bridge |
142:4eea097334d6 | 149 | #define SL_RAMFUNC_DISABLE |
Anna Bridge |
142:4eea097334d6 | 150 | #endif |
Anna Bridge |
142:4eea097334d6 | 151 | |
Anna Bridge |
142:4eea097334d6 | 152 | #define RAMFUNC_DECLARATOR SL_RAMFUNC_DECLARATOR |
Anna Bridge |
142:4eea097334d6 | 153 | #define RAMFUNC_DEFINITION_BEGIN SL_RAMFUNC_DEFINITION_BEGIN |
Anna Bridge |
142:4eea097334d6 | 154 | #define RAMFUNC_DEFINITION_END SL_RAMFUNC_DEFINITION_END |
Anna Bridge |
142:4eea097334d6 | 155 | /** @endcond */ |
Anna Bridge |
142:4eea097334d6 | 156 | |
Anna Bridge |
142:4eea097334d6 | 157 | /** @} (end addtogroup RAMFUNC) */ |
Anna Bridge |
142:4eea097334d6 | 158 | /** @} (end addtogroup emlib) */ |
Anna Bridge |
142:4eea097334d6 | 159 | |
Anna Bridge |
142:4eea097334d6 | 160 | #ifdef __cplusplus |
Anna Bridge |
142:4eea097334d6 | 161 | } |
Anna Bridge |
142:4eea097334d6 | 162 | #endif |
Anna Bridge |
142:4eea097334d6 | 163 | |
Anna Bridge |
142:4eea097334d6 | 164 | #endif /* EM_RAMFUNC_H */ |