Common Microcontroller Functions#

STACK_VECTOR_INDEX#

#define STACK_VECTOR_INDEX

0U

A numerical definition for a vector.

RESET_VECTOR_INDEX#

#define RESET_VECTOR_INDEX

1U

A numerical definition for a vector.

NMI_VECTOR_INDEX#

#define NMI_VECTOR_INDEX

2U

A numerical definition for a vector.

HARD_FAULT_VECTOR_INDEX#

#define HARD_FAULT_VECTOR_INDEX

3U

A numerical definition for a vector.

MEMORY_FAULT_VECTOR_INDEX#

#define MEMORY_FAULT_VECTOR_INDEX

4U

A numerical definition for a vector.

BUS_FAULT_VECTOR_INDEX#

#define BUS_FAULT_VECTOR_INDEX

5U

A numerical definition for a vector.

USAGE_FAULT_VECTOR_INDEX#

#define USAGE_FAULT_VECTOR_INDEX

6U

A numerical definition for a vector.

RESERVED07_VECTOR_INDEX#

#define RESERVED07_VECTOR_INDEX

7U

A numerical definition for a vector.

RESERVED08_VECTOR_INDEX#

#define RESERVED08_VECTOR_INDEX

8U

A numerical definition for a vector.

RESERVED09_VECTOR_INDEX#

#define RESERVED09_VECTOR_INDEX

9U

A numerical definition for a vector.

RESERVED10_VECTOR_INDEX#

#define RESERVED10_VECTOR_INDEX

10U

A numerical definition for a vector.

SVCALL_VECTOR_INDEX#

#define SVCALL_VECTOR_INDEX

11U

A numerical definition for a vector.

DEBUG_MONITOR_VECTOR_INDEX#

#define DEBUG_MONITOR_VECTOR_INDEX

12U

A numerical definition for a vector.

RESERVED13_VECTOR_INDEX#

#define RESERVED13_VECTOR_INDEX

13U

A numerical definition for a vector.

PENDSV_VECTOR_INDEX#

#define PENDSV_VECTOR_INDEX

14U

A numerical definition for a vector.

SYSTICK_VECTOR_INDEX#

#define SYSTICK_VECTOR_INDEX

15U

A numerical definition for a vector.

TIMER1_VECTOR_INDEX#

#define TIMER1_VECTOR_INDEX

16U

A numerical definition for a vector.

TIMER2_VECTOR_INDEX#

#define TIMER2_VECTOR_INDEX

17U

A numerical definition for a vector.

MANAGEMENT_VECTOR_INDEX#

#define MANAGEMENT_VECTOR_INDEX

18U

A numerical definition for a vector.

BASEBAND_VECTOR_INDEX#

#define BASEBAND_VECTOR_INDEX

19U

A numerical definition for a vector.

SLEEP_TIMER_VECTOR_INDEX#

#define SLEEP_TIMER_VECTOR_INDEX

20U

A numerical definition for a vector.

SC1_VECTOR_INDEX#

#define SC1_VECTOR_INDEX

21U

A numerical definition for a vector.

SC2_VECTOR_INDEX#

#define SC2_VECTOR_INDEX

22U

A numerical definition for a vector.

SECURITY_VECTOR_INDEX#

#define SECURITY_VECTOR_INDEX

23U

A numerical definition for a vector.

MAC_TIMER_VECTOR_INDEX#

#define MAC_TIMER_VECTOR_INDEX

24U

A numerical definition for a vector.

MAC_TX_VECTOR_INDEX#

#define MAC_TX_VECTOR_INDEX

25U

A numerical definition for a vector.

MAC_RX_VECTOR_INDEX#

#define MAC_RX_VECTOR_INDEX

26U

A numerical definition for a vector.

ADC_VECTOR_INDEX#

#define ADC_VECTOR_INDEX

27U

A numerical definition for a vector.

IRQA_VECTOR_INDEX#

#define IRQA_VECTOR_INDEX

28U

A numerical definition for a vector.

IRQB_VECTOR_INDEX#

#define IRQB_VECTOR_INDEX

29U

A numerical definition for a vector.

IRQC_VECTOR_INDEX#

#define IRQC_VECTOR_INDEX

30U

A numerical definition for a vector.

IRQD_VECTOR_INDEX#

#define IRQD_VECTOR_INDEX

31U

A numerical definition for a vector.

DEBUG_VECTOR_INDEX#

#define DEBUG_VECTOR_INDEX

32U

A numerical definition for a vector.

SC3_VECTOR_INDEX#

#define SC3_VECTOR_INDEX

33U

A numerical definition for a vector.

SC4_VECTOR_INDEX#

#define SC4_VECTOR_INDEX

34U

A numerical definition for a vector.

USB_VECTOR_INDEX#

#define USB_VECTOR_INDEX

35U

A numerical definition for a vector.

VECTOR_TABLE_LENGTH#

#define VECTOR_TABLE_LENGTH

36U

Number of vectors.

SleepModes#

SleepModes

Enumerations for the possible microcontroller sleep modes.

• SLEEPMODE_RUNNING Everything is active and running. In practice this mode is not used, but it is defined for completeness of information.

• SLEEPMODE_IDLE Only the CPU is idled. The rest of the chip continues running normally. The chip will wake from any interrupt.

• SLEEPMODE_WAKETIMER The sleep timer clock sources remain running. The RC is always running and the 32kHz XTAL depends on the board header. Wakeup is possible from both GPIO and the sleep timer. System time is maintained. The sleep timer is assumed to be configured properly for wake events.

• SLEEPMODE_MAINTAINTIMER The sleep timer clock sources remain running. The RC is always running and the 32kHz XTAL depends on the board header. Wakeup is possible from only GPIO. System time is maintained. NOTE: This mode is not available on EM2XX chips.

• SLEEPMODE_NOTIMER The sleep timer clock sources (both RC and XTAL) are turned off. Wakeup is possible from only GPIO. System time is lost.

• SLEEPMODE_HIBERNATE This maps to EM4 Hibernate on the EFM32/EFR32 devices. RAM is not retained in SLEEPMODE_HIBERNATE so waking up from this sleepmode will behave like a reset. NOTE: This mode is only available on EFM32/EFR32

WakeEvents#

typedef uint32_t WakeEvents

WakeMask#

typedef uint32_t WakeMask

halCommonVreg1v8EnableCount#

volatile int8_t halCommonVreg1v8EnableCount

Helper variable to track the state of 1.8V regulator.

Note

• : Only used when DISABLE_INTERNAL_1V8_REGULATOR is defined.

halStackProcessBootCount#

void halStackProcessBootCount (void )

Called from emberInit and provides a means for the HAL to increment a boot counter, most commonly in non-volatile memory.

This is useful while debugging to determine the number of resets that might be seen over a period of time. Exposing this functionality allows the application to disable or alter processing of the boot counter if, for example, the application is expecting a lot of resets that could wear out non-volatile storage or some

@stackusage Called from emberInit only as helpful debugging information. This should be left enabled by default, but this function can also be reduced to a simple return statement if boot counting is not desired.

halGetResetInfo#

uint8_t halGetResetInfo (void )

Gets information about what caused the microcontroller to reset.

Returns

• A code identifying the cause of the reset.

halGetResetString#

PGM_P halGetResetString (void )

Calls halGetResetInfo() and supplies a string describing it.

@appusage Useful for diagnostic printing of text just after program initialization.

Returns

• A pointer to a program space string.

halInit#

void halInit (void )

Initializes microcontroller-specific peripherals.

halReboot#

void halReboot (void )

Restarts the microcontroller and therefore everything else.

halPowerUp#

void halPowerUp (void )

Powers up microcontroller peripherals and board peripherals.

halPowerDown#

void halPowerDown (void )

Powers down microcontroller peripherals and board peripherals.

halResume#

void halResume (void )

Resumes microcontroller peripherals and board peripherals.

halSuspend#

void halSuspend (void )

Suspends microcontroller peripherals and board peripherals.

halInternalEnableWatchDog#

void halInternalEnableWatchDog (void )

Enables the watchdog timer.

halInternalDisableWatchDog#

void halInternalDisableWatchDog (uint8_t magicKey)

Disables the watchdog timer.

Note

• To prevent the watchdog from being disabled accidentally, a magic key must be provided.

halInternalWatchDogEnabled#

bool halInternalWatchDogEnabled (void )

Determines whether the watchdog has been enabled or disabled.

Returns

• A bool value indicating if the watchdog is current enabled.

halSleep#

void halSleep (SleepModes sleepMode)

Puts the microcontroller to sleep in a specified mode.

Note

• This routine always enables interrupts.

See Also

• SleepModes

halSleepPreserveInts#

void halSleepPreserveInts (SleepModes sleepMode)

Same as halSleep() except it preserves the current interrupt state rather than always enabling interrupts prior to returning.

See Also

• SleepModes

halCommonDelayMicroseconds#

void halCommonDelayMicroseconds (uint16_t us)

Blocks the current thread of execution for the specified amount of time, in microseconds.

The function is implemented with cycle-counted busy loops and is intended to create the short delays required when interfacing with hardware peripherals.

The accuracy of the timing provided by this function is not specified, but a general rule is that when running off of a crystal oscillator it will be within 10us. If the micro is running off of another type of oscillator (e.g. RC) the timing accuracy will potentially be much worse.

halCommonDisableVreg1v8#

void halCommonDisableVreg1v8 (void )

Disable the 1.8V regulator. This function is to be used when the 1.8V supply is provided externally. Disabling the regulator saves current consumption. Disabling the regulator will cause ADC readings of external signals to be wrong. These exteranl signals include analog sources ADC0 thru ADC5 and VDD_PADS/4.

Note

• : Only used when DISABLE_INTERNAL_1V8_REGULATOR is defined.

halCommonEnableVreg1v8#

void halCommonEnableVreg1v8 (void )

Enable the 1.8V regulator. Normally the 1.8V regulator is enabled out of reset. This function is only needed if the 1.8V regulator has been disabled and ADC conversions on external signals are needed. These exteranl signals include analog sources ADC0 thru ADC5 and VDD_PADS/4. The state of 1v8 survives deep sleep.

Note

• : Only used when DISABLE_INTERNAL_1V8_REGULATOR is defined.

halBeforeEM4#

void halBeforeEM4 (uint32_t duration, RTCCRamData input)

halAfterEM4#

RTCCRamData halAfterEM4 (void )

halInternalSysReset#

void halInternalSysReset (uint16_t extendedCause)

Records the specified reset cause then forces a reboot.

halGetExtendedResetInfo#

uint16_t halGetExtendedResetInfo (void )

Returns the Extended Reset Cause information.

Returns

• A 16-bit code identifying the base and extended cause of the reset

halGetExtendedResetString#

PGM_P halGetExtendedResetString (void )

Calls halGetExtendedResetInfo() and supplies a string describing the extended cause of the reset. halGetResetString() should also be called to get the string for the base reset cause.

@appusage Useful for diagnostic printing of text just after program initialization.

Returns

• A pointer to a program space string.

halSetRadioHoldOff#

EmberStatus halSetRadioHoldOff (bool enable)

Enables or disables Radio HoldOff support.

Returns

• EMBER_SUCCESS if Radio HoldOff was configured as desired or EMBER_BAD_ARGUMENT if requesting it be enabled but RHO has not been configured by the BOARD_HEADER.

halGetRadioHoldOff#

bool halGetRadioHoldOff (void )

Returns whether Radio HoldOff has been enabled or not.

Returns

• true if Radio HoldOff has been enabled, false otherwise.

halStackRadioPowerDownBoard#

void halStackRadioPowerDownBoard (void )

To assist with saving power when the radio automatically powers down, this function allows the stack to tell the HAL to put pins specific to radio functionality in their powerdown state. The pin state used is the state used by halInternalPowerDownBoard, but applied only to the pins identified in the global variable gpioRadioPowerBoardMask. The stack will automatically call this function as needed, but it will only change GPIO state based on gpioRadioPowerBoardMask. Most commonly, the bits set in gpioRadioPowerBoardMask petain to using a Front End Module. This function is often called from interrupt context.

halStackRadio2PowerDownBoard#

void halStackRadio2PowerDownBoard (void )

To assist with saving power when radio2 automatically powers down, this function allows the stack to tell the HAL to put pins specific to radio functionality in their powerdown state. The pin state used is the state used by halInternalPowerDownBoard, but applied only to the pins identified in the global variable gpioRadioPowerBoardMask. The stack will automatically call this function as needed, but it will only change GPIO state based on gpioRadioPowerBoardMask. Most commonly, the bits set in gpioRadioPowerBoardMask petain to using a Front End Module. This function is often called from interrupt context.

halStackRadioPowerUpBoard#

void halStackRadioPowerUpBoard (void )

To assist with saving power when the radio automatically powers up, this function allows the stack to tell the HAL to put pins specific to radio functionality in their powerup state. The pin state used is the state used by halInternalPowerUpBoard, but applied only to the pins identified in the global variable gpioRadioPowerBoardMask. The stack will automatically call this function as needed, but it will only change GPIO state based on gpioRadioPowerBoardMask. Most commonly, the bits set in gpioRadioPowerBoardMask petain to using a Front End Module. This function can be called from interrupt context.

halStackRadio2PowerUpBoard#

void halStackRadio2PowerUpBoard (void )

To assist with saving power when radio2 automatically powers up, this function allows the stack to tell the HAL to put pins specific to radio functionality in their powerup state. The pin state used is the state used by halInternalPowerUpBoard, but applied only to the pins identified in the global variable gpioRadioPowerBoardMask. The stack will automatically call this function as needed, but it will only change GPIO state based on gpioRadioPowerBoardMask. Most commonly, the bits set in gpioRadioPowerBoardMask petain to using a Front End Module. This function can be called from interrupt context.

halStackRadioPowerMainControl#

void halStackRadioPowerMainControl (bool powerUp)

This function is called automatically by the stack prior to Radio power-up and after Radio power-down. It can be used to prepare for the radio being powered on and to clean up after it's been powered off. Unlike halStackRadioPowerUpBoard() and halStackRadioPowerDownBoard(), which can be called from interrupt context, this function is only called from main-line context.

halRadioPowerUpHandler#

void halRadioPowerUpHandler (void )

Handler called in main context prior to radio being powered on.

halRadioPowerDownHandler#

void halRadioPowerDownHandler (void )

Handler called in main context after radio has been powered off.

halGetEm2xxResetInfo#

#define halGetEm2xxResetInfo

()

Calls halGetExtendedResetInfo() and translates the EM35x reset code to the corresponding value used by the EM2XX HAL. Any reset codes not present in the EM2XX are returned after being OR'ed with 0x80.

@appusage Used by the EZSP host as a platform-independent NCP reset code.

Returns

• The EM2XX-compatible reset code. If not supported by the EM2XX, return the platform-specific code with B7 set.

MICRO_DISABLE_WATCH_DOG_KEY#

#define MICRO_DISABLE_WATCH_DOG_KEY

0xA5U

The value that must be passed as the single parameter to halInternalDisableWatchDog() in order to successfully disable the watchdog timer.

GPIO_MASK_SIZE#

#define GPIO_MASK_SIZE

24

GPIO_MASK#

#define GPIO_MASK

0xFFFFFF

WAKE_GPIO_MASK#

#define WAKE_GPIO_MASK

GPIO_MASK

WAKE_GPIO_SIZE#

#define WAKE_GPIO_SIZE

GPIO_MASK_SIZE

WAKE_MASK_INVALID#

#define WAKE_MASK_INVALID

(-1)

WAKE_EVENT_SIZE#

#define WAKE_EVENT_SIZE

WakeMask

Note

• The preprocessor symbol WAKE_EVENT_SIZE has been deprecated. Please use WakeMask instead.

DEBUG_TOGGLE#

#define DEBUG_TOGGLE