See IAR PLATFORM_HEADER Configuration for detailed documentation.

License#

Copyright 2018 Silicon Laboratories Inc. www.silabs.com

The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of Silicon Labs Master Software License Agreement (MSLA) available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed to you in Source Code format and is governed by the sections of the MSLA applicable to Source Code.

/***************************************************************************/
#ifndef __IAR_H__
#define __IAR_H__

#ifndef __ICCARM__
  #error Improper PLATFORM_HEADER
#endif

#ifdef  LEGACY_PHY_BUILD

#include "hal/hal.h" // Use phy/hal/hal.h instead, per search rules

#else

#if (__VER__ < 6040002)
  #error Only IAR EWARM versions greater than 6.40.2 are supported
#endif // __VER__

#ifndef DOXYGEN_SHOULD_SKIP_THIS
// Inclusion of <intrinsics.h> should be coming from the CMSIS files.
  #include <stddef.h>
  #include <stdarg.h>
  #include <stdint.h>
  #include <stdbool.h>
  #include <string.h>
  #if defined (CORTEXM3_EFM32_MICRO)
// EFR32
    #include "em_device.h"
    #define NVIC_CONFIG "hal/micro/cortexm3/efm32/nvic-config.h"
    #include "interrupts-efm32.h"
  #else
    #error Unknown CORTEXM3 micro
  #endif
//Provide a default NVIC configuration file.  The build process can
//override this if it needs to.
  #ifndef NVIC_CONFIG
    #define NVIC_CONFIG "hal/micro/cortexm3/nvic-config.h"
  #endif

// suppress warnings about unknown pragmas
//  (as they may be pragmas known to other platforms)
#pragma diag_suppress = pe161

#endif  // DOXYGEN_SHOULD_SKIP_THIS


typedef bool boolean; /*To ease adoption of bool instead of boolean.*/
typedef unsigned char int8u;
typedef signed char int8s;
typedef unsigned short int16u;
typedef signed short int16s;
typedef unsigned int int32u;
typedef signed int int32s;
typedef unsigned long long int64u;
typedef signed long long int64s;
typedef unsigned int PointerType;

#define HAL_HAS_INT64

#define _HAL_USE_COMMON_PGM_




#define BIGENDIAN_CPU  false

#define NTOHS(val) (__REV16(val))
#define NTOHL(val) (__REV(val))

#define NO_STRIPPING  __root

#define EEPROM  errorerror

#ifndef __SOURCEFILE__

  #define __SOURCEFILE__ __FILE__
#endif

#undef assert

void halInternalAssertFailed(const char *filename, int linenumber);

#ifdef DOXYGEN_SHOULD_SKIP_THIS
#define assert(condition)
#else //DOXYGEN_SHOULD_SKIP_THIS
// Don't define PUSH_REGS_BEFORE_ASSERT if it causes problems with the compiler.
// For example, in some compilers any inline assembly disables all optimization.
//
// For IAR V5.30, inline assembly apparently does not affect compiler output.
//#define PUSH_REGS_BEFORE_ASSERT
#ifdef PUSH_REGS_BEFORE_ASSERT
#define assert(condition)            \
  do { if (!(condition)) {           \
         asm ("PUSH {R0,R1,R2,LR}"); \
         halInternalAssertFailed(__SOURCEFILE__, __LINE__); } } while (0)
#else
#define assert(condition)  \
  do { if (!(condition)) { \
         halInternalAssertFailed(__SOURCEFILE__, __LINE__); } } while (0)
#endif
#endif //DOXYGEN_SHOULD_SKIP_THIS

void halInternalResetWatchDog(void);

#ifdef RTOS
void rtosResetWatchdog(void);

  #define halResetWatchdog()  rtosResetWatchdog()
#else
  #define halResetWatchdog()  halInternalResetWatchDog()
#endif //RTOS

#define UNUSED

#define SIGNED_ENUM

#define STACK_FILL_VALUE  0xCDCDCDCDU

#ifdef RAMEXE
//If the whole build is running out of RAM, as chosen by the RAMEXE build
//define, then define RAMFUNC to nothing since it's not needed.
  #define RAMFUNC
#else //RAMEXE
  #define RAMFUNC __ramfunc
#endif //RAMEXE

#define NO_OPERATION() __NOP()

#define SET_REG_FIELD(reg, field, value)          \
  do {                                            \
    reg = ((reg & (~field##_MASK))                \
           | ((((uint32_t) value) << field##_BIT) \
              & (field##_MASK)));                 \
  } while (0)

#define SET_CMSIS_REG(reg, mask, value)  \
  do {                                   \
    reg = (((reg) & (~mask)) | (value)); \
  } while (0)

#define SET_CMSIS_REG_FIELD(reg, field, value) \
  do {                                         \
    reg = ((reg & (~_##field##_MASK))          \
           | ((value << _##field##_SHIFT)      \
              & (_##field##_MASK)));           \
  } while (0)

#define simulatedTimePasses()

#define simulatedTimePassesMs(x)

#define simulatedSerialTimePasses()

#define _HAL_USE_COMMON_DIVMOD_

#define VAR_AT_SEGMENT(__variableDeclaration, __segmentName) \
  __variableDeclaration @ __segmentName

#define STRINGIZE(X) #X

#define ALIGNMENT(X) \
  _Pragma(STRINGIZE(data_alignment = X))

#define WEAK(__symbol) \
  __weak __symbol

#define NO_INIT(__symbol) \
  __no_init __symbol

#define STATIC_ASSERT(__condition, __errorstr) \
  static_assert(__condition, __errorstr)




// EFR32xG22 may zero out the high portion of RAM after reset, meaning that data
// we wish to preserve across resets should be in the lower addresses. To deal
// with this, we defined a (new) __NO_INIT__ section adjacent to the reset info
// block and are selecting it and the old placement here based on the part for
// which we're compiling.
#if defined(_SILICON_LABS_32B_SERIES_2_CONFIG_2)
  #define __NO_INIT__     ".noinitnew"
#else
  #define __NO_INIT__     ".noinitlegacy"
#endif

#define __DEBUG_CHANNEL__ "DEBUG_CHANNEL"
#define __INTVEC__ ".intvec"
#define __CSTACK__ "CSTACK"
#define __RESETINFO__ "RESETINFO"
#define __DATA_INIT__ ".data_init"
#define __DATA__ ".data"
#define __BSS__ ".bss"
#define __CONST__ ".rodata"
#define __TEXT__ ".text"
#define __TEXTRW_INIT__ ".textrw_init"
#define __TEXTRW__ ".textrw"
#define __AAT__ "AAT"  // Application address table
#define __BAT__ "BAT"  // Bootloader address table
#define __BAT_INIT__ "BAT"  // Bootloader address table
#define __FAT__ "FAT"  // Fixed address table
#define __RAT__ "RAT"  // Ramexe address table
#define __SIMEE__ "SIMEE" //Simulated EEPROM storage
#define __PSSTORE__ "PSSTORE" //PS Store storage
#define __LONGTOKEN__ "LONGTOKEN" //Dotdot MFg Certificate storage
#define __EMHEAP__ "EMHEAP" // Heap region for extra memory
#define __GUARD_REGION__ "GUARD_REGION" // Guard page between heap and stack
#define __DLIB_PERTHREAD_INIT__ "__DLIB_PERTHREAD_init" // DLIB_PERTHREAD flash initialization data
#define __DLIB_PERTHREAD_INITIALIZED_DATA__ "DLIB_PERTHREAD_INITIALIZED_DATA" // DLIB_PERTHREAD RAM region to init
#define __DLIB_PERTHREAD_ZERO_DATA__ "DLIB_PERTHREAD_ZERO_DATA" // DLIB_PERTHREAD RAM region to zero out
#define __INTERNAL_STORAGE__ "INTERNAL_STORAGE" //Internal storage region
#define __LOCKBITS_IN_MAINFLASH__ "LOCKBITS_IN_MAINFLASH" //Region of main flash for Lock Bits on Series2 Devices.
#define __UNRETAINED_RAM__ "UNRETAINED_RAM" //Region of RAM not retained during deepsleep

//=============================================================================
// The '#pragma segment=' declaration must be used before attempting to access
// the segments so the compiler properly handles the __segment_*() functions.
//
// The segment names used here are the default segment names used by IAR. Refer
// to the IAR Compiler Reference Guide for a proper description of these
// segments.
//=============================================================================
#pragma segment=__NO_INIT__
#pragma segment=__DEBUG_CHANNEL__
#pragma segment=__INTVEC__
#pragma segment=__CSTACK__
#pragma segment=__RESETINFO__
#pragma segment=__DATA_INIT__
#pragma segment=__DATA__
#pragma segment=__BSS__
#pragma segment=__CONST__
#pragma segment=__TEXT__
#pragma segment=__TEXTRW_INIT__
#pragma segment=__TEXTRW__
#pragma segment=__AAT__
#pragma segment=__BAT__
#pragma segment=__FAT__
#pragma segment=__RAT__
#pragma segment=__SIMEE__
#pragma segment=__PSSTORE__
#pragma segment=__LONGTOKEN__
#pragma segment=__EMHEAP__
#pragma segment=__GUARD_REGION__
#pragma segment=__DLIB_PERTHREAD_INIT__
#pragma segment=__DLIB_PERTHREAD_INITIALIZED_DATA__
#pragma segment=__DLIB_PERTHREAD_ZERO_DATA__
#pragma segment=__INTERNAL_STORAGE__
#pragma segment=__LOCKBITS_IN_MAINFLASH__
#pragma segment=__UNRETAINED_RAM__

#define _NO_INIT_SEGMENT_BEGIN                         __segment_begin(__NO_INIT__)
#define _DEBUG_CHANNEL_SEGMENT_BEGIN                   __segment_begin(__DEBUG_CHANNEL__)
#define _INTVEC_SEGMENT_BEGIN                          __segment_begin(__INTVEC__)
#define _CSTACK_SEGMENT_BEGIN                          __segment_begin(__CSTACK__)
#define _RESETINFO_SEGMENT_BEGIN                       __segment_begin(__RESETINFO__)
#define _DATA_INIT_SEGMENT_BEGIN                       __segment_begin(__DATA_INIT__)
#define _DATA_SEGMENT_BEGIN                            __segment_begin(__DATA__)
#define _BSS_SEGMENT_BEGIN                             __segment_begin(__BSS__)
#define _CONST_SEGMENT_BEGIN                           __segment_begin(__CONST__)
#define _TEXT_SEGMENT_BEGIN                            __segment_begin(__TEXT__)
#define _TEXTRW_INIT_SEGMENT_BEGIN                     __segment_begin(__TEXTRW_INIT__)
#define _TEXTRW_SEGMENT_BEGIN                          __segment_begin(__TEXTRW__)
#define _AAT_SEGMENT_BEGIN                             __segment_begin(__AAT__)
#define _BAT_SEGMENT_BEGIN                             __segment_begin(__BAT__)
#define _BAT_INIT_SEGMENT_BEGIN                        __segment_begin(__BAT_INIT__)
#define _FAT_SEGMENT_BEGIN                             __segment_begin(__FAT__)
#define _RAT_SEGMENT_BEGIN                             __segment_begin(__RAT__)
#define _SIMEE_SEGMENT_BEGIN                           __segment_begin(__SIMEE__)
#define _PSSTORE_SEGMENT_BEGIN                         __segment_begin(__PSSTORE__)
#define _LONGTOKEN_SEGMENT_BEGIN                       __segment_begin(__LONGTOKEN__)
#define _EMHEAP_SEGMENT_BEGIN                          __segment_begin(__EMHEAP__)
#define _GUARD_REGION_SEGMENT_BEGIN                    __segment_begin(__GUARD_REGION__)
#define _DLIB_PERTHREAD_INIT_SEGMENT_BEGIN             __segment_begin(__DLIB_PERTHREAD_INIT__)
#define _DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_BEGIN __segment_begin(__DLIB_PERTHREAD_INITIALIZED_DATA__)
#define _DLIB_PERTHREAD_ZERO_DATA_SEGMENT_BEGIN        __segment_begin(__DLIB_PERTHREAD_ZERO_DATA__)
#define _INTERNAL_STORAGE_SEGMENT_BEGIN                __segment_begin(__INTERNAL_STORAGE__)
#define _LOCKBITS_IN_MAINFLASH_SEGMENT_BEGIN           __segment_begin(__LOCKBITS_IN_MAINFLASH__)
#define _UNRETAINED_RAM_SEGMENT_BEGIN                  __segment_begin(__UNRETAINED_RAM__)

#define _NO_INIT_SEGMENT_END                         __segment_end(__NO_INIT__)
#define _DEBUG_CHANNEL_SEGMENT_END                   __segment_end(__DEBUG_CHANNEL__)
#define _INTVEC_SEGMENT_END                          __segment_end(__INTVEC__)
#define _CSTACK_SEGMENT_END                          __segment_end(__CSTACK__)
#define _RESETINFO_SEGMENT_END                       __segment_end(__RESETINFO__)
#define _DATA_INIT_SEGMENT_END                       __segment_end(__DATA_INIT__)
#define _DATA_SEGMENT_END                            __segment_end(__DATA__)
#define _BSS_SEGMENT_END                             __segment_end(__BSS__)
#define _CONST_SEGMENT_END                           __segment_end(__CONST__)
#define _TEXT_SEGMENT_END                            __segment_end(__TEXT__)
#define _TEXTRW_INIT_SEGMENT_END                     __segment_end(__TEXTRW_INIT__)
#define _TEXTRW_SEGMENT_END                          __segment_end(__TEXTRW__)
#define _AAT_SEGMENT_END                             __segment_end(__AAT__)
#define _BAT_SEGMENT_END                             __segment_end(__BAT__)
#define _BAT_INIT_SEGMENT_END                        __segment_end(__BAT_INIT__)
#define _FAT_SEGMENT_END                             __segment_end(__FAT__)
#define _RAT_SEGMENT_END                             __segment_end(__RAT__)
#define _SIMEE_SEGMENT_END                           __segment_end(__SIMEE__)
#define _PSSTORE_SEGMENT_END                         __segment_end(__PSSTORE__)
#define _LONGTOKEN_SEGMENT_END                       __segment_end(__LONGTOKEN__)
#define _EMHEAP_SEGMENT_END                          __segment_end(__EMHEAP__)
#define _GUARD_REGION_SEGMENT_END                    __segment_end(__GUARD_REGION__)
#define _DLIB_PERTHREAD_INIT_SEGMENT_END             __segment_end(__DLIB_PERTHREAD_INIT__)
#define _DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_END __segment_end(__DLIB_PERTHREAD_INITIALIZED_DATA__)
#define _DLIB_PERTHREAD_ZERO_DATA_SEGMENT_END        __segment_end(__DLIB_PERTHREAD_ZERO_DATA__)
#define _INTERNAL_STORAGE_SEGMENT_END                __segment_end(__INTERNAL_STORAGE__)
#define _LOCKBITS_IN_MAINFLASH_SEGMENT_END           __segment_end(__LOCKBITS_IN_MAINFLASH__)
#define _UNRETAINED_RAM_SEGMENT_END                  __segment_end(__UNRETAINED_RAM__)

#define _NO_INIT_SEGMENT_SIZE                         __segment_size(__NO_INIT__)
#define _DEBUG_CHANNEL_SEGMENT_SIZE                   __segment_size(__DEBUG_CHANNEL__)
#define _INTVEC_SEGMENT_SIZE                          __segment_size(__INTVEC__)
#define _CSTACK_SEGMENT_SIZE                          __segment_size(__CSTACK__)
#define _RESETINFO_SEGMENT_SIZE                       __segment_size(__RESETINFO__)
#define _DATA_INIT_SEGMENT_SIZE                       __segment_size(__DATA_INIT__)
#define _DATA_SEGMENT_SIZE                            __segment_size(__DATA__)
#define _BSS_SEGMENT_SIZE                             __segment_size(__BSS__)
#define _CONST_SEGMENT_SIZE                           __segment_size(__CONST__)
#define _TEXT_SEGMENT_SIZE                            __segment_size(__TEXT__)
#define _TEXTRW_INIT_SEGMENT_SIZE                     __segment_size(__TEXTRW_INIT__)
#define _TEXTRW_SEGMENT_SIZE                          __segment_size(__TEXTRW__)
#define _AAT_SEGMENT_SIZE                             __segment_size(__AAT__)
#define _BAT_SEGMENT_SIZE                             __segment_size(__BAT__)
#define _BAT_INIT_SEGMENT_SIZE                        __segment_size(__BAT_INIT__)
#define _FAT_SEGMENT_SIZE                             __segment_size(__FAT__)
#define _RAT_SEGMENT_SIZE                             __segment_size(__RAT__)
#define _SIMEE_SEGMENT_SIZE                           __segment_size(__SIMEE__)
#define _PSSTORE_SEGMENT_SIZE                         __segment_size(__PSSTORE__)
#define _LONGTOKEN_SEGMENT_SIZE                       __segment_size(__LONGTOKEN__)
#define _EMHEAP_SEGMENT_SIZE                          __segment_size(__EMHEAP__)
#define _GUARD_REGION_SEGMENT_SIZE                    __segment_size(__GUARD_REGION__)
#define _DLIB_PERTHREAD_INIT_SEGMENT_SIZE             __segment_size(__DLIB_PERTHREAD_INIT__)
#define _DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_SIZE __segment_size(__DLIB_PERTHREAD_INITIALIZED_DATA__)
#define _DLIB_PERTHREAD_ZERO_DATA_SEGMENT_SIZE        __segment_size(__DLIB_PERTHREAD_ZERO_DATA__)
#define _INTERNAL_STORAGE_SEGMENT_SIZE                __segment_size(__INTERNAL_STORAGE__)
#define _LOCKBITS_IN_MAINFLASH_SEGMENT_SIZE           __segment_size(__LOCKBITS_IN_MAINFLASH__)
#define _UNRETAINED_RAM_SEGMENT_SIZE                  __segment_size(__UNRETAINED_RAM__)

//A utility function for inserting barrier instructions.  These
//instructions should be used whenever the MPU is enabled or disabled so
//that all memory/instruction accesses can complete before the MPU changes
//state.
void _executeBarrierInstructions(void);

// #define _HAL_USE_COMMON_MEMUTILS_




int abs(int I);




#define PLATCOMMONOKTOINCLUDE
  #include "hal/micro/generic/compiler/platform-common.h"
#undef PLATCOMMONOKTOINCLUDE

#define MAIN_FUNCTION_PARAMETERS void
#define MAIN_FUNCTION_ARGUMENTS

#endif//LEGACY_PHY_BUILD
#endif // __IAR_H__

Master Variable Types#

LEGACY_PHY_BUILDThese are a set of typedefs to make the size of all variable declarations explicitly known.

#define
HAL_HAS_INT64

Denotes that this platform supports 64-bit data-types.

#define
_HAL_USE_COMMON_PGM_

Use the Master Program Memory Declarations from platform-common.h.

typedef bool

A typedef to make the size of the variable explicitly known.

typedef unsigned char

Denotes that this platform supports 64-bit data-types.

typedef signed char

Denotes that this platform supports 64-bit data-types.

typedef unsigned short

Denotes that this platform supports 64-bit data-types.

typedef signed short

Denotes that this platform supports 64-bit data-types.

typedef unsigned int

Denotes that this platform supports 64-bit data-types.

typedef signed int

Denotes that this platform supports 64-bit data-types.

typedef unsigned long long

Denotes that this platform supports 64-bit data-types.

typedef signed long long

Denotes that this platform supports 64-bit data-types.

typedef unsigned int

Denotes that this platform supports 64-bit data-types.

Miscellaneous Macros#

#define
BIGENDIAN_CPU false

A convenient method for code to know what endiannes processor it is running on. For the Cortex-M3, we are little endian.

#define
NTOHS (val)

Define intrinsics for NTOHL and NTOHS to save code space by making endian.c compile to nothing.

#define
NTOHL (val)

A convenient method for code to know what endiannes processor it is running on. For the Cortex-M3, we are little endian.

#define
NO_STRIPPING __root

A friendlier name for the compiler's intrinsic for not stripping.

#define
EEPROM errorerror

A friendlier name for the compiler's intrinsic for eeprom reference.

#define
__SOURCEFILE__ __FILE__

The SOURCEFILE macro is used by asserts to list the filename if it isn't otherwise defined, set it to the compiler intrinsic which specifies the whole filename and path of the sourcefile.

#define
assert (condition)

A custom implementation of the C language assert macro. This macro implements the conditional evaluation and calls the function halInternalAssertFailed(). (see hal/micro/micro.h)

#define
halResetWatchdog ()

A convenient method for code to know what endiannes processor it is running on. For the Cortex-M3, we are little endian.

#define
UNUSED

Declare a variable as unused to avoid a warning. Has no effect in IAR builds.

#define
SIGNED_ENUM

Some platforms need to cast enum values that have the high bit set.

#define
STACK_FILL_VALUE 0xCDCDCDCDU

Define the magic value that is interpreted by IAR C-SPY's Stack View.

#define
RAMFUNC __ramfunc

Define a generic RAM function identifier to a compiler specific one.

#define
NO_OPERATION ()

Define a generic no operation identifier to a compiler specific one.

#define
SET_REG_FIELD (reg, field, value)

A convenience macro that makes it easy to change the field of a register to any unsigned value.

#define
SET_CMSIS_REG (reg, mask, value)

A convenience macro that makes it easy to change a register using the provided mask(s) and value(s). Example: SET_CMSIS_REG(GPIO->P[1].CFGH, (_GPIO_P_CFGH_Px5_MASK | _GPIO_P_CFGH_Px6_MASK), (GPIO_P_CFGH_Px5_OUT | GPIO_P_CFGH_Px6_OUT));.

#define
SET_CMSIS_REG_FIELD (reg, field, value)

A convenience macro that makes it easy to change the field of a register, as defined in CMSIS Device headers, to any unsigned value. Example using EM35xx: SET_CMSIS_REG_FIELD(GPIO->P[0].CFGL, GPIO_P_CFGL_Px0, _GPIO_P_CFGL_Px0_OUT);.

#define
simulatedTimePasses ()

Stub for code not running in simulation.

#define
simulatedTimePassesMs (x)

Stub for code not running in simulation.

#define
simulatedSerialTimePasses ()

Stub for code not running in simulation.

#define
_HAL_USE_COMMON_DIVMOD_

Use the Divide and Modulus Operations from platform-common.h.

#define
VAR_AT_SEGMENT (__variableDeclaration, __segmentName)

Provide a portable way to specify the segment where a variable lives.

#define
STRINGIZE (X)

Convinience macro for turning a token into a string.

#define
ALIGNMENT (X)

Provide a portable way to align data.

#define
WEAK (__symbol)

Provide a portable way to specify a symbol as weak.

#define
NO_INIT (__symbol)

Provide a portable way to specify a non initialized symbol.

#define
STATIC_ASSERT (__condition, __errorstr)

Provide a portable way to specify a compile time assert.

void
halInternalAssertFailed(const char *filename, int linenumber)

A prototype definition for use by the assert macro. (see hal/micro/micro.h)

void

Macro to reset the watchdog timer. Note: be very very careful when using this as you can easily get into an infinite loop if you are not careful.

Portable segment names#

#define
__NO_INIT__ ".noinitlegacy"

Portable segment names.

#define
__DEBUG_CHANNEL__ "DEBUG_CHANNEL"

Portable segment names.

#define
__INTVEC__ ".intvec"

Portable segment names.

#define
__CSTACK__ "CSTACK"

Portable segment names.

#define
__RESETINFO__ "RESETINFO"

Portable segment names.

#define
__DATA_INIT__ ".data_init"

Portable segment names.

#define
__DATA__ ".data"

Portable segment names.

#define
__BSS__ ".bss"

Portable segment names.

#define
__CONST__ ".rodata"

Portable segment names.

#define
__TEXT__ ".text"

Portable segment names.

#define
__TEXTRW_INIT__ ".textrw_init"

Portable segment names.

#define
__TEXTRW__ ".textrw"

Portable segment names.

#define
__AAT__ "AAT"

Portable segment names.

#define
__BAT__ "BAT"

Portable segment names.

#define
__BAT_INIT__ "BAT"

Portable segment names.

#define
__FAT__ "FAT"

Portable segment names.

#define
__RAT__ "RAT"

Portable segment names.

#define
__SIMEE__ "SIMEE"

Portable segment names.

#define
__PSSTORE__ "PSSTORE"

Portable segment names.

#define
__LONGTOKEN__ "LONGTOKEN"

Portable segment names.

#define
__EMHEAP__ "EMHEAP"

Portable segment names.

#define
__GUARD_REGION__ "GUARD_REGION"

Portable segment names.

#define
__DLIB_PERTHREAD_INIT__ "__DLIB_PERTHREAD_init"

Portable segment names.

#define
__DLIB_PERTHREAD_INITIALIZED_DATA__ "DLIB_PERTHREAD_INITIALIZED_DATA"

Portable segment names.

#define
__DLIB_PERTHREAD_ZERO_DATA__ "DLIB_PERTHREAD_ZERO_DATA"

Portable segment names.

#define
__INTERNAL_STORAGE__ "INTERNAL_STORAGE"

Portable segment names.

#define
__LOCKBITS_IN_MAINFLASH__ "LOCKBITS_IN_MAINFLASH"

Portable segment names.

#define
__UNRETAINED_RAM__ "UNRETAINED_RAM"

Portable segment names.

#define
_NO_INIT_SEGMENT_BEGIN __segment_begin(__NO_INIT__)

Portable segment names.

#define
_DEBUG_CHANNEL_SEGMENT_BEGIN __segment_begin(__DEBUG_CHANNEL__)

Portable segment names.

#define
_INTVEC_SEGMENT_BEGIN __segment_begin(__INTVEC__)

Portable segment names.

#define
_CSTACK_SEGMENT_BEGIN __segment_begin(__CSTACK__)

Portable segment names.

#define
_RESETINFO_SEGMENT_BEGIN __segment_begin(__RESETINFO__)

Portable segment names.

#define
_DATA_INIT_SEGMENT_BEGIN __segment_begin(__DATA_INIT__)

Portable segment names.

#define
_DATA_SEGMENT_BEGIN __segment_begin(__DATA__)

Portable segment names.

#define
_BSS_SEGMENT_BEGIN __segment_begin(__BSS__)

Portable segment names.

#define
_CONST_SEGMENT_BEGIN __segment_begin(__CONST__)

Portable segment names.

#define
_TEXT_SEGMENT_BEGIN __segment_begin(__TEXT__)

Portable segment names.

#define
_TEXTRW_INIT_SEGMENT_BEGIN __segment_begin(__TEXTRW_INIT__)

Portable segment names.

#define
_TEXTRW_SEGMENT_BEGIN __segment_begin(__TEXTRW__)

Portable segment names.

#define
_AAT_SEGMENT_BEGIN __segment_begin(__AAT__)

Portable segment names.

#define
_BAT_SEGMENT_BEGIN __segment_begin(__BAT__)

Portable segment names.

#define
_BAT_INIT_SEGMENT_BEGIN __segment_begin(__BAT_INIT__)

Portable segment names.

#define
_FAT_SEGMENT_BEGIN __segment_begin(__FAT__)

Portable segment names.

#define
_RAT_SEGMENT_BEGIN __segment_begin(__RAT__)

Portable segment names.

#define
_SIMEE_SEGMENT_BEGIN __segment_begin(__SIMEE__)

Portable segment names.

#define
_PSSTORE_SEGMENT_BEGIN __segment_begin(__PSSTORE__)

Portable segment names.

#define
_LONGTOKEN_SEGMENT_BEGIN __segment_begin(__LONGTOKEN__)

Portable segment names.

#define
_EMHEAP_SEGMENT_BEGIN __segment_begin(__EMHEAP__)

Portable segment names.

#define
_GUARD_REGION_SEGMENT_BEGIN __segment_begin(__GUARD_REGION__)

Portable segment names.

#define
_DLIB_PERTHREAD_INIT_SEGMENT_BEGIN __segment_begin(__DLIB_PERTHREAD_INIT__)

Portable segment names.

#define
_DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_BEGIN __segment_begin(__DLIB_PERTHREAD_INITIALIZED_DATA__)

Portable segment names.

#define
_DLIB_PERTHREAD_ZERO_DATA_SEGMENT_BEGIN __segment_begin(__DLIB_PERTHREAD_ZERO_DATA__)

Portable segment names.

#define
_INTERNAL_STORAGE_SEGMENT_BEGIN __segment_begin(__INTERNAL_STORAGE__)

Portable segment names.

#define
_LOCKBITS_IN_MAINFLASH_SEGMENT_BEGIN __segment_begin(__LOCKBITS_IN_MAINFLASH__)

Portable segment names.

#define
_UNRETAINED_RAM_SEGMENT_BEGIN __segment_begin(__UNRETAINED_RAM__)

Portable segment names.

#define
_NO_INIT_SEGMENT_END __segment_end(__NO_INIT__)

Portable segment names.

#define
_DEBUG_CHANNEL_SEGMENT_END __segment_end(__DEBUG_CHANNEL__)

Portable segment names.

#define
_INTVEC_SEGMENT_END __segment_end(__INTVEC__)

Portable segment names.

#define
_CSTACK_SEGMENT_END __segment_end(__CSTACK__)

Portable segment names.

#define
_RESETINFO_SEGMENT_END __segment_end(__RESETINFO__)

Portable segment names.

#define
_DATA_INIT_SEGMENT_END __segment_end(__DATA_INIT__)

Portable segment names.

#define
_DATA_SEGMENT_END __segment_end(__DATA__)

Portable segment names.

#define
_BSS_SEGMENT_END __segment_end(__BSS__)

Portable segment names.

#define
_CONST_SEGMENT_END __segment_end(__CONST__)

Portable segment names.

#define
_TEXT_SEGMENT_END __segment_end(__TEXT__)

Portable segment names.

#define
_TEXTRW_INIT_SEGMENT_END __segment_end(__TEXTRW_INIT__)

Portable segment names.

#define
_TEXTRW_SEGMENT_END __segment_end(__TEXTRW__)

Portable segment names.

#define
_AAT_SEGMENT_END __segment_end(__AAT__)

Portable segment names.

#define
_BAT_SEGMENT_END __segment_end(__BAT__)

Portable segment names.

#define
_BAT_INIT_SEGMENT_END __segment_end(__BAT_INIT__)

Portable segment names.

#define
_FAT_SEGMENT_END __segment_end(__FAT__)

Portable segment names.

#define
_RAT_SEGMENT_END __segment_end(__RAT__)

Portable segment names.

#define
_SIMEE_SEGMENT_END __segment_end(__SIMEE__)

Portable segment names.

#define
_PSSTORE_SEGMENT_END __segment_end(__PSSTORE__)

Portable segment names.

#define
_LONGTOKEN_SEGMENT_END __segment_end(__LONGTOKEN__)

Portable segment names.

#define
_EMHEAP_SEGMENT_END __segment_end(__EMHEAP__)

Portable segment names.

#define
_GUARD_REGION_SEGMENT_END __segment_end(__GUARD_REGION__)

Portable segment names.

#define
_DLIB_PERTHREAD_INIT_SEGMENT_END __segment_end(__DLIB_PERTHREAD_INIT__)

Portable segment names.

#define
_DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_END __segment_end(__DLIB_PERTHREAD_INITIALIZED_DATA__)

Portable segment names.

#define
_DLIB_PERTHREAD_ZERO_DATA_SEGMENT_END __segment_end(__DLIB_PERTHREAD_ZERO_DATA__)

Portable segment names.

#define
_INTERNAL_STORAGE_SEGMENT_END __segment_end(__INTERNAL_STORAGE__)

Portable segment names.

#define
_LOCKBITS_IN_MAINFLASH_SEGMENT_END __segment_end(__LOCKBITS_IN_MAINFLASH__)

Portable segment names.

#define
_UNRETAINED_RAM_SEGMENT_END __segment_end(__UNRETAINED_RAM__)

Portable segment names.

#define
_NO_INIT_SEGMENT_SIZE __segment_size(__NO_INIT__)

Portable segment names.

#define
_DEBUG_CHANNEL_SEGMENT_SIZE __segment_size(__DEBUG_CHANNEL__)

Portable segment names.

#define
_INTVEC_SEGMENT_SIZE __segment_size(__INTVEC__)

Portable segment names.

#define
_CSTACK_SEGMENT_SIZE __segment_size(__CSTACK__)

Portable segment names.

#define
_RESETINFO_SEGMENT_SIZE __segment_size(__RESETINFO__)

Portable segment names.

#define
_DATA_INIT_SEGMENT_SIZE __segment_size(__DATA_INIT__)

Portable segment names.

#define
_DATA_SEGMENT_SIZE __segment_size(__DATA__)

Portable segment names.

#define
_BSS_SEGMENT_SIZE __segment_size(__BSS__)

Portable segment names.

#define
_CONST_SEGMENT_SIZE __segment_size(__CONST__)

Portable segment names.

#define
_TEXT_SEGMENT_SIZE __segment_size(__TEXT__)

Portable segment names.

#define
_TEXTRW_INIT_SEGMENT_SIZE __segment_size(__TEXTRW_INIT__)

Portable segment names.

#define
_TEXTRW_SEGMENT_SIZE __segment_size(__TEXTRW__)

Portable segment names.

#define
_AAT_SEGMENT_SIZE __segment_size(__AAT__)

Portable segment names.

#define
_BAT_SEGMENT_SIZE __segment_size(__BAT__)

Portable segment names.

#define
_BAT_INIT_SEGMENT_SIZE __segment_size(__BAT_INIT__)

Portable segment names.

#define
_FAT_SEGMENT_SIZE __segment_size(__FAT__)

Portable segment names.

#define
_RAT_SEGMENT_SIZE __segment_size(__RAT__)

Portable segment names.

#define
_SIMEE_SEGMENT_SIZE __segment_size(__SIMEE__)

Portable segment names.

#define
_PSSTORE_SEGMENT_SIZE __segment_size(__PSSTORE__)

Portable segment names.

#define
_LONGTOKEN_SEGMENT_SIZE __segment_size(__LONGTOKEN__)

Portable segment names.

#define
_EMHEAP_SEGMENT_SIZE __segment_size(__EMHEAP__)

Portable segment names.

#define
_GUARD_REGION_SEGMENT_SIZE __segment_size(__GUARD_REGION__)

Portable segment names.

#define
_DLIB_PERTHREAD_INIT_SEGMENT_SIZE __segment_size(__DLIB_PERTHREAD_INIT__)

Portable segment names.

#define
_DLIB_PERTHREAD_INITIALIZED_DATA_SEGMENT_SIZE __segment_size(__DLIB_PERTHREAD_INITIALIZED_DATA__)

Portable segment names.

#define
_DLIB_PERTHREAD_ZERO_DATA_SEGMENT_SIZE __segment_size(__DLIB_PERTHREAD_ZERO_DATA__)

Portable segment names.

#define
_INTERNAL_STORAGE_SEGMENT_SIZE __segment_size(__INTERNAL_STORAGE__)

Portable segment names.

#define
_LOCKBITS_IN_MAINFLASH_SEGMENT_SIZE __segment_size(__LOCKBITS_IN_MAINFLASH__)

Portable segment names.

#define
_UNRETAINED_RAM_SEGMENT_SIZE __segment_size(__UNRETAINED_RAM__)

Portable segment names.

External Declarations#

If the line below is uncommented we will use Ember memory APIs, otherwise, we will use the C Standard library (memset,memcpy,memmove) APIs.These are routines that are defined in certain header files that we don't want to include, e.g. stdlib.h

#define
PLATCOMMONOKTOINCLUDE

Include platform-common.h last to pick up defaults and common definitions.

#define
MAIN_FUNCTION_PARAMETERS void

The kind of arguments the main function takes.

#define
MAIN_FUNCTION_ARGUMENTS

Include platform-common.h last to pick up defaults and common definitions.

int
abs(int I)

Returns the absolute value of I (also called the magnitude of I). That is, if I is negative, the result is the opposite of I, but if I is nonnegative the result is I.

Functions#

Master Variable Types Documentation#

boolean#

typedef bool boolean

A typedef to make the size of the variable explicitly known.


Definition at line 82 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int8u#

typedef unsigned char int8u

Denotes that this platform supports 64-bit data-types.


Definition at line 83 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int8s#

typedef signed char int8s

Denotes that this platform supports 64-bit data-types.


Definition at line 84 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int16u#

typedef unsigned short int16u

Denotes that this platform supports 64-bit data-types.


Definition at line 85 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int16s#

typedef signed short int16s

Denotes that this platform supports 64-bit data-types.


Definition at line 86 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int32u#

typedef unsigned int int32u

Denotes that this platform supports 64-bit data-types.


Definition at line 87 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int32s#

typedef signed int int32s

Denotes that this platform supports 64-bit data-types.


Definition at line 88 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int64u#

typedef unsigned long long int64u

Denotes that this platform supports 64-bit data-types.


Definition at line 89 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

int64s#

typedef signed long long int64s

Denotes that this platform supports 64-bit data-types.


Definition at line 90 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

PointerType#

typedef unsigned int PointerType

Denotes that this platform supports 64-bit data-types.


Definition at line 91 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

Miscellaneous Macros Documentation#

halInternalAssertFailed#

void halInternalAssertFailed (const char * filename, int linenumber)

A prototype definition for use by the assert macro. (see hal/micro/micro.h)

Parameters
TypeDirectionArgument NameDescription
const char *N/Afilename
intN/Alinenumber

Definition at line 152 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

halInternalResetWatchDog#

void halInternalResetWatchDog (void )

Macro to reset the watchdog timer. Note: be very very careful when using this as you can easily get into an infinite loop if you are not careful.

Parameters
TypeDirectionArgument NameDescription
voidN/A

Definition at line 184 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

Portable segment names Documentation#

External Declarations Documentation#

abs#

int abs (int I)

Returns the absolute value of I (also called the magnitude of I). That is, if I is negative, the result is the opposite of I, but if I is nonnegative the result is I.

Parameters
TypeDirectionArgument NameDescription
intN/AI

An integer.

Returns

  • A nonnegative integer.


Definition at line 527 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h

Function Documentation#

_executeBarrierInstructions#

void _executeBarrierInstructions (void )
Parameters
TypeDirectionArgument NameDescription
voidN/A

Definition at line 501 of file /mnt/raid/workspaces/ws.GB1qsZ2Je/overlay/gsdk/platform/base/hal/micro/cortexm3/compiler/iar.h