ST / ST_Events-old

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   HelloWorld_CCA01M1 HelloWorld_CCA02M1 CI-data-logger-server HelloWorld_CCA02M1 ... more

This is a fork of the events subdirectory of https://github.com/ARMmbed/mbed-os.

Note, you must import this library with import name: events!!!

hal/api/toolchain.h@6231:a9915ab0d683, 2016-06-01 (annotated)

Committer:
Christopher Haster
Date:
Wed Jun 01 16:10:19 2016 -0500
Revision:
6231:a9915ab0d683
Parent:
6230:ff703c65fe9c
Child:
6375:81a9af277ac6
Changed MBED_PACKED to a macro



Supports both __packed and __attribute__((packed)) styles of attriubtes



MBED_PACKED(struct) foo {

    blablabla

};

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Mihail Stoyanov 6088:e1cf77a573c5 1 /* mbed Microcontroller Library
Mihail Stoyanov 6088:e1cf77a573c5 2 * Copyright (c) 2006-2013 ARM Limited
Mihail Stoyanov 6088:e1cf77a573c5 3 *
Mihail Stoyanov 6088:e1cf77a573c5 4 * Licensed under the Apache License, Version 2.0 (the "License");
Mihail Stoyanov 6088:e1cf77a573c5 5 * you may not use this file except in compliance with the License.
Mihail Stoyanov 6088:e1cf77a573c5 6 * You may obtain a copy of the License at
Mihail Stoyanov 6088:e1cf77a573c5 7 *
Mihail Stoyanov 6088:e1cf77a573c5 8 * http://www.apache.org/licenses/LICENSE-2.0
Mihail Stoyanov 6088:e1cf77a573c5 9 *
Mihail Stoyanov 6088:e1cf77a573c5 10 * Unless required by applicable law or agreed to in writing, software
Mihail Stoyanov 6088:e1cf77a573c5 11 * distributed under the License is distributed on an "AS IS" BASIS,
Mihail Stoyanov 6088:e1cf77a573c5 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Mihail Stoyanov 6088:e1cf77a573c5 13 * See the License for the specific language governing permissions and
Mihail Stoyanov 6088:e1cf77a573c5 14 * limitations under the License.
Mihail Stoyanov 6088:e1cf77a573c5 15 */
Mihail Stoyanov 6088:e1cf77a573c5 16 #ifndef MBED_TOOLCHAIN_H
Mihail Stoyanov 6088:e1cf77a573c5 17 #define MBED_TOOLCHAIN_H
Mihail Stoyanov 6088:e1cf77a573c5 18
Christopher Haster 6227:3878cce6d3d8 19
Christopher Haster 6227:3878cce6d3d8 20 // Warning for unsupported compilers
Christopher Haster 6227:3878cce6d3d8 21 #if !defined(__GNUC__) /* GCC */ \
Christopher Haster 6227:3878cce6d3d8 22 && !defined(__CC_ARM) /* ARMCC */ \
Christopher Haster 6227:3878cce6d3d8 23 && !defined(__clang__) /* LLVM/Clang */ \
Christopher Haster 6227:3878cce6d3d8 24 && !defined(__ICCARM__) /* IAR */
Christopher Haster 6227:3878cce6d3d8 25 #warning "This compiler is not yet supported."
Christopher Haster 6227:3878cce6d3d8 26 #endif
Christopher Haster 6227:3878cce6d3d8 27
Christopher Haster 6227:3878cce6d3d8 28
Christopher Haster 6227:3878cce6d3d8 29 // Attributes
Christopher Haster 6227:3878cce6d3d8 30
Christopher Haster 6228:2ad5514e5699 31 /** MBED_PACKED
Christopher Haster 6227:3878cce6d3d8 32 * Pack a structure, preventing any padding from being added between fields.
Christopher Haster 6227:3878cce6d3d8 33 *
Christopher Haster 6227:3878cce6d3d8 34 * @code
Christopher Haster 6227:3878cce6d3d8 35 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 36 *
Christopher Haster 6231:a9915ab0d683 37 * MBED_PACKED(struct) foo {
Christopher Haster 6227:3878cce6d3d8 38 * char x;
Christopher Haster 6227:3878cce6d3d8 39 * int y;
Christopher Haster 6231:a9915ab0d683 40 * };
Christopher Haster 6227:3878cce6d3d8 41 * @endcode
Christopher Haster 6227:3878cce6d3d8 42 */
Christopher Haster 6228:2ad5514e5699 43 #ifndef MBED_PACKED
Christopher Haster 6227:3878cce6d3d8 44 #if defined(__ICCARM__)
Christopher Haster 6231:a9915ab0d683 45 #define MBED_PACKED(struct) __packed struct
Christopher Haster 6227:3878cce6d3d8 46 #else
Christopher Haster 6231:a9915ab0d683 47 #define MBED_PACKED(struct) struct __attribute__((packed))
Christopher Haster 6227:3878cce6d3d8 48 #endif
Christopher Haster 6227:3878cce6d3d8 49 #endif
Christopher Haster 6227:3878cce6d3d8 50
Christopher Haster 6228:2ad5514e5699 51 /** MBED_ALIGN(N)
Christopher Haster 6227:3878cce6d3d8 52 * Declare a variable to be aligned on an N-byte boundary.
Christopher Haster 6227:3878cce6d3d8 53 *
Christopher Haster 6227:3878cce6d3d8 54 * @code
Christopher Haster 6227:3878cce6d3d8 55 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 56 *
Christopher Haster 6228:2ad5514e5699 57 * MBED_ALIGN(16) char a;
Christopher Haster 6227:3878cce6d3d8 58 * @endcode
Christopher Haster 6227:3878cce6d3d8 59 */
Christopher Haster 6228:2ad5514e5699 60 #ifndef MBED_ALIGN
Christopher Haster 6227:3878cce6d3d8 61 #if defined(__ICCARM__)
Christopher Haster 6228:2ad5514e5699 62 #define _MBED_ALIGN(N) _Pragma(#N)
Christopher Haster 6228:2ad5514e5699 63 #define MBED_ALIGN(N) _MBED_ALIGN(data_alignment=N)
Christopher Haster 6227:3878cce6d3d8 64 #else
Christopher Haster 6228:2ad5514e5699 65 #define MBED_ALIGN(N) __attribute__((aligned(N)))
Christopher Haster 6227:3878cce6d3d8 66 #endif
Christopher Haster 6227:3878cce6d3d8 67 #endif
Christopher Haster 6227:3878cce6d3d8 68
Christopher Haster 6228:2ad5514e5699 69 /** MBED_UNUSED
Christopher Haster 6227:3878cce6d3d8 70 * Declare a function argument to be unused, suppressing compiler warnings
Christopher Haster 6227:3878cce6d3d8 71 *
Christopher Haster 6227:3878cce6d3d8 72 * @code
Christopher Haster 6227:3878cce6d3d8 73 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 74 *
Christopher Haster 6228:2ad5514e5699 75 * void foo(MBED_UNUSED int arg) {
Christopher Haster 6227:3878cce6d3d8 76 *
Christopher Haster 6227:3878cce6d3d8 77 * }
Christopher Haster 6227:3878cce6d3d8 78 * @endcode
Christopher Haster 6227:3878cce6d3d8 79 */
Christopher Haster 6228:2ad5514e5699 80 #ifndef MBED_UNUSED
Christopher Haster 6227:3878cce6d3d8 81 #if defined(__GNUC__) || defined(__clang__) || defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 82 #define MBED_UNUSED __attribute__((__unused__))
Christopher Haster 6227:3878cce6d3d8 83 #else
Christopher Haster 6228:2ad5514e5699 84 #define MBED_UNUSED
Christopher Haster 6227:3878cce6d3d8 85 #endif
Christopher Haster 6227:3878cce6d3d8 86 #endif
Christopher Haster 6227:3878cce6d3d8 87
Christopher Haster 6228:2ad5514e5699 88 /** MBED_WEAK
Christopher Haster 6227:3878cce6d3d8 89 * Mark a function as being weak.
Christopher Haster 6227:3878cce6d3d8 90 *
Christopher Haster 6227:3878cce6d3d8 91 * @note
Christopher Haster 6227:3878cce6d3d8 92 * weak functions are not friendly to making code re-usable, as they can only
Christopher Haster 6227:3878cce6d3d8 93 * be overridden once (and if they are multiply overridden the linker will emit
Christopher Haster 6227:3878cce6d3d8 94 * no warning). You should not normally use weak symbols as part of the API to
Christopher Haster 6227:3878cce6d3d8 95 * re-usable modules.
Christopher Haster 6227:3878cce6d3d8 96 *
Christopher Haster 6227:3878cce6d3d8 97 * @code
Christopher Haster 6227:3878cce6d3d8 98 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 99 *
Christopher Haster 6228:2ad5514e5699 100 * MBED_WEAK void foo() {
Christopher Haster 6227:3878cce6d3d8 101 * // a weak implementation of foo that can be overriden by a definition
Christopher Haster 6227:3878cce6d3d8 102 * // without __weak
Christopher Haster 6227:3878cce6d3d8 103 * }
Christopher Haster 6227:3878cce6d3d8 104 * @endcode
Christopher Haster 6227:3878cce6d3d8 105 */
Christopher Haster 6228:2ad5514e5699 106 #ifndef MBED_WEAK
Christopher Haster 6227:3878cce6d3d8 107 #if defined(__ICCARM__)
Christopher Haster 6228:2ad5514e5699 108 #define MBED_WEAK __weak
Christopher Haster 6227:3878cce6d3d8 109 #else
Christopher Haster 6228:2ad5514e5699 110 #define MBED_WEAK __attribute__((weak))
Christopher Haster 6227:3878cce6d3d8 111 #endif
Christopher Haster 6227:3878cce6d3d8 112 #endif
Christopher Haster 6227:3878cce6d3d8 113
Christopher Haster 6228:2ad5514e5699 114 /** MBED_PURE
Christopher Haster 6227:3878cce6d3d8 115 * Hint to the compiler that a function depends only on parameters
Christopher Haster 6227:3878cce6d3d8 116 *
Christopher Haster 6227:3878cce6d3d8 117 * @code
Christopher Haster 6227:3878cce6d3d8 118 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 119 *
Christopher Haster 6228:2ad5514e5699 120 * MBED_PURE int foo(int arg){
Christopher Haster 6227:3878cce6d3d8 121 * // no access to global variables
Christopher Haster 6227:3878cce6d3d8 122 * }
Christopher Haster 6227:3878cce6d3d8 123 * @endcode
Christopher Haster 6227:3878cce6d3d8 124 */
Christopher Haster 6228:2ad5514e5699 125 #ifndef MBED_PURE
Christopher Haster 6227:3878cce6d3d8 126 #if defined(__GNUC__) || defined(__clang__) || defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 127 #define MBED_PURE __attribute__((const))
Christopher Haster 6227:3878cce6d3d8 128 #else
Christopher Haster 6228:2ad5514e5699 129 #define MBED_PURE
Christopher Haster 6227:3878cce6d3d8 130 #endif
Christopher Haster 6227:3878cce6d3d8 131 #endif
Christopher Haster 6227:3878cce6d3d8 132
Christopher Haster 6228:2ad5514e5699 133 /** MBED_FORCEINLINE
Christopher Haster 6227:3878cce6d3d8 134 * Declare a function that must always be inlined. Failure to inline
Christopher Haster 6227:3878cce6d3d8 135 * such a function will result in an error.
Christopher Haster 6227:3878cce6d3d8 136 *
Christopher Haster 6227:3878cce6d3d8 137 * @code
Christopher Haster 6227:3878cce6d3d8 138 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 139 *
Christopher Haster 6228:2ad5514e5699 140 * MBED_FORCEINLINE void foo() {
Christopher Haster 6227:3878cce6d3d8 141 *
Christopher Haster 6227:3878cce6d3d8 142 * }
Christopher Haster 6227:3878cce6d3d8 143 * @endcode
Christopher Haster 6227:3878cce6d3d8 144 */
Christopher Haster 6228:2ad5514e5699 145 #ifndef MBED_FORCEINLINE
Christopher Haster 6227:3878cce6d3d8 146 #if defined(__GNUC__) || defined(__clang__) || defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 147 #define MBED_FORCEINLINE static inline __attribute__((always_inline))
Christopher Haster 6227:3878cce6d3d8 148 #elif defined(__ICCARM__)
geky 6230:ff703c65fe9c 149 #define MBED_FORCEINLINE _Pragma("inline=forced") static
Christopher Haster 6227:3878cce6d3d8 150 #else
Christopher Haster 6228:2ad5514e5699 151 #define MBED_FORCEINLINE static inline
Christopher Haster 6227:3878cce6d3d8 152 #endif
Christopher Haster 6227:3878cce6d3d8 153 #endif
Christopher Haster 6227:3878cce6d3d8 154
Christopher Haster 6228:2ad5514e5699 155 /** MBED_NORETURN
Christopher Haster 6227:3878cce6d3d8 156 * Declare a function that will never return.
Christopher Haster 6227:3878cce6d3d8 157 *
Christopher Haster 6227:3878cce6d3d8 158 * @code
Christopher Haster 6227:3878cce6d3d8 159 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 160 *
Christopher Haster 6228:2ad5514e5699 161 * MBED_NORETURN void foo() {
Christopher Haster 6227:3878cce6d3d8 162 * // must never return
Christopher Haster 6227:3878cce6d3d8 163 * while (1) {}
Christopher Haster 6227:3878cce6d3d8 164 * }
Christopher Haster 6227:3878cce6d3d8 165 * @endcode
Christopher Haster 6227:3878cce6d3d8 166 */
Christopher Haster 6228:2ad5514e5699 167 #ifndef MBED_NORETURN
Christopher Haster 6227:3878cce6d3d8 168 #if defined(__GNUC__) || defined(__clang__) || defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 169 #define MBED_NORETURN __attribute__((noreturn))
Christopher Haster 6227:3878cce6d3d8 170 #elif defined(__ICCARM__)
Christopher Haster 6228:2ad5514e5699 171 #define MBED_NORETURN __noreturn
Christopher Haster 6227:3878cce6d3d8 172 #else
Christopher Haster 6228:2ad5514e5699 173 #define MBED_NORETURN
Christopher Haster 6227:3878cce6d3d8 174 #endif
Christopher Haster 6227:3878cce6d3d8 175 #endif
Christopher Haster 6227:3878cce6d3d8 176
Christopher Haster 6228:2ad5514e5699 177 /** MBED_UNREACHABLE
Christopher Haster 6227:3878cce6d3d8 178 * An unreachable statement. If the statement is reached,
Christopher Haster 6227:3878cce6d3d8 179 * behaviour is undefined. Useful in situations where the compiler
Christopher Haster 6227:3878cce6d3d8 180 * cannot deduce the unreachability of code.
Christopher Haster 6227:3878cce6d3d8 181 *
Christopher Haster 6227:3878cce6d3d8 182 * @code
Christopher Haster 6227:3878cce6d3d8 183 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 184 *
Christopher Haster 6227:3878cce6d3d8 185 * void foo(int arg) {
Christopher Haster 6227:3878cce6d3d8 186 * switch (arg) {
Christopher Haster 6227:3878cce6d3d8 187 * case 1: return 1;
Christopher Haster 6227:3878cce6d3d8 188 * case 2: return 2;
Christopher Haster 6227:3878cce6d3d8 189 * ...
Christopher Haster 6227:3878cce6d3d8 190 * }
Christopher Haster 6228:2ad5514e5699 191 * MBED_UNREACHABLE;
Christopher Haster 6227:3878cce6d3d8 192 * }
Christopher Haster 6227:3878cce6d3d8 193 * @endcode
Christopher Haster 6227:3878cce6d3d8 194 */
Christopher Haster 6228:2ad5514e5699 195 #ifndef MBED_UNREACHABLE
Christopher Haster 6227:3878cce6d3d8 196 #if (defined(__GNUC__) || defined(__clang__)) && !defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 197 #define MBED_UNREACHABLE __builtin_unreachable()
Christopher Haster 6227:3878cce6d3d8 198 #else
Christopher Haster 6228:2ad5514e5699 199 #define MBED_UNREACHABLE while (1)
Christopher Haster 6227:3878cce6d3d8 200 #endif
Christopher Haster 6227:3878cce6d3d8 201 #endif
Christopher Haster 6227:3878cce6d3d8 202
Christopher Haster 6228:2ad5514e5699 203 /** MBED_DEPRECATED("message string")
Christopher Haster 6227:3878cce6d3d8 204 * Mark a function declaration as deprecated, if it used then a warning will be
Christopher Haster 6227:3878cce6d3d8 205 * issued by the compiler possibly including the provided message. Note that not
Christopher Haster 6227:3878cce6d3d8 206 * all compilers are able to display the message.
Christopher Haster 6227:3878cce6d3d8 207 *
Christopher Haster 6227:3878cce6d3d8 208 * @code
Christopher Haster 6227:3878cce6d3d8 209 * #include "toolchain.h"
Christopher Haster 6227:3878cce6d3d8 210 *
Christopher Haster 6228:2ad5514e5699 211 * MBED_DEPRECATED("don't foo any more, bar instead")
Christopher Haster 6227:3878cce6d3d8 212 * void foo(int arg);
Christopher Haster 6227:3878cce6d3d8 213 * @endcode
Christopher Haster 6227:3878cce6d3d8 214 */
Christopher Haster 6228:2ad5514e5699 215 #ifndef MBED_DEPRECATED
Christopher Haster 6227:3878cce6d3d8 216 #if defined(__GNUC__) || defined(__clang__)
Christopher Haster 6228:2ad5514e5699 217 #define MBED_DEPRECATED(M) __attribute__((deprecated(M)))
Christopher Haster 6227:3878cce6d3d8 218 #elif defined(__CC_ARM)
Christopher Haster 6228:2ad5514e5699 219 #define MBED_DEPRECATED(M) __attribute__((deprecated))
Christopher Haster 6227:3878cce6d3d8 220 #else
Christopher Haster 6228:2ad5514e5699 221 #define MBED_DEPRECATED(M)
Christopher Haster 6227:3878cce6d3d8 222 #endif
Christopher Haster 6227:3878cce6d3d8 223 #endif
Christopher Haster 6227:3878cce6d3d8 224
Christopher Haster 6227:3878cce6d3d8 225
Christopher Haster 6227:3878cce6d3d8 226 // FILEHANDLE declaration
Mihail Stoyanov 6088:e1cf77a573c5 227 #if defined(TOOLCHAIN_ARM)
Mihail Stoyanov 6088:e1cf77a573c5 228 #include <rt_sys.h>
Mihail Stoyanov 6088:e1cf77a573c5 229 #endif
Mihail Stoyanov 6088:e1cf77a573c5 230
Mihail Stoyanov 6088:e1cf77a573c5 231 #ifndef FILEHANDLE
Mihail Stoyanov 6088:e1cf77a573c5 232 typedef int FILEHANDLE;
Mihail Stoyanov 6088:e1cf77a573c5 233 #endif
Mihail Stoyanov 6088:e1cf77a573c5 234
Christopher Haster 6227:3878cce6d3d8 235 // Backwards compatibility
Christopher Haster 6228:2ad5514e5699 236 #ifndef WEAK
Christopher Haster 6228:2ad5514e5699 237 #define WEAK MBED_WEAK
Christopher Haster 6228:2ad5514e5699 238 #endif
Christopher Haster 6228:2ad5514e5699 239
geky 6229:bce3990e9675 240 #ifndef PACKED
Christopher Haster 6231:a9915ab0d683 241 #define PACKED MBED_PACKED()
geky 6229:bce3990e9675 242 #endif
geky 6229:bce3990e9675 243
Christopher Haster 6227:3878cce6d3d8 244 #ifndef EXTERN
Christopher Haster 6227:3878cce6d3d8 245 #define EXTERN extern
Mihail Stoyanov 6088:e1cf77a573c5 246 #endif
Mihail Stoyanov 6088:e1cf77a573c5 247
Mihail Stoyanov 6088:e1cf77a573c5 248 #endif