Common Microcontroller Functions#
Many of the supplied example applications use these microcontroller functions. See hal/micro/micro.h for source code.
Note
The term SFD refers to the Start Frame Delimiter.
Many of the supplied example applications use these microcontroller functions. See hal/micro/micro-common.h for source code.
Modules#
Enumerations#
Enumerations for the possible microcontroller sleep modes.
Variables#
Helper variable to track the state of 1.8V regulator.
Functions#
Called from emberInit and provides a means for the HAL to increment a boot counter, most commonly in non-volatile memory.
Gets information about what caused the microcontroller to reset.
Calls halGetResetInfo() and supplies a string describing it.
Initializes microcontroller-specific peripherals.
Restarts the microcontroller and therefore everything else.
Powers up microcontroller peripherals and board peripherals.
Powers down microcontroller peripherals and board peripherals.
Resumes microcontroller peripherals and board peripherals.
Suspends microcontroller peripherals and board peripherals.
Enables the watchdog timer.
Disables the watchdog timer.
Determines whether the watchdog has been enabled or disabled.
Puts the microcontroller to sleep in a specified mode.
Same as halSleep() except it preserves the current interrupt state rather than always enabling interrupts prior to returning.
Blocks the current thread of execution for the specified amount of time, in microseconds.
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.
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.
Macros#
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.
The value that must be passed as the single parameter to halInternalDisableWatchDog() in order to successfully disable the watchdog timer.
Enumeration Documentation#
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
Enumerator | |
---|---|
SLEEPMODE_RUNNING | |
SLEEPMODE_IDLE | |
SLEEPMODE_WAKETIMER | |
SLEEPMODE_MAINTAINTIMER | |
SLEEPMODE_NOTIMER | |
SLEEPMODE_HIBERNATE | |
SLEEPMODE_RESERVED | |
SLEEPMODE_POWERDOWN | |
SLEEPMODE_POWERSAVE |
106
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
Typedef Documentation#
WakeEvents#
typedef uint32_t WakeEvents
141
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
WakeMask#
typedef uint32_t WakeMask
142
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
Variable Documentation#
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.
195
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
Function Documentation#
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.
N/A |
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
EmberStack Usage:\n 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.
68
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro.h
halGetResetInfo#
uint8_t halGetResetInfo (void )
Gets information about what caused the microcontroller to reset.
N/A |
Returns
A code identifying the cause of the reset.
74
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro.h
halGetResetString#
PGM_P halGetResetString (void )
Calls halGetResetInfo() and supplies a string describing it.
N/A |
Application Usage:\n Useful for diagnostic printing of text just after program#
initialization.
Returns
A pointer to a program space string.
83
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro.h
halInit#
void halInit (void )
Initializes microcontroller-specific peripherals.
N/A |
30
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halReboot#
void halReboot (void )
Restarts the microcontroller and therefore everything else.
N/A |
34
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halPowerUp#
void halPowerUp (void )
Powers up microcontroller peripherals and board peripherals.
N/A |
38
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halPowerDown#
void halPowerDown (void )
Powers down microcontroller peripherals and board peripherals.
N/A |
42
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halResume#
void halResume (void )
Resumes microcontroller peripherals and board peripherals.
N/A |
46
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halSuspend#
void halSuspend (void )
Suspends microcontroller peripherals and board peripherals.
N/A |
50
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halInternalEnableWatchDog#
void halInternalEnableWatchDog (void )
Enables the watchdog timer.
N/A |
60
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halInternalDisableWatchDog#
void halInternalDisableWatchDog (uint8_t magicKey)
Disables the watchdog timer.
N/A | magicKey | A value (MICRO_DISABLE_WATCH_DOG_KEY) that enables the function. |
Note
To prevent the watchdog from being disabled accidentally, a magic key must be provided.
69
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halInternalWatchDogEnabled#
bool halInternalWatchDogEnabled (void )
Determines whether the watchdog has been enabled or disabled.
N/A |
Returns
A bool value indicating if the watchdog is current enabled.
75
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halSleep#
void halSleep (SleepModes sleepMode)
Puts the microcontroller to sleep in a specified mode.
N/A | sleepMode | A microcontroller sleep mode |
Note
This routine always enables interrupts.
See Also
160
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halSleepPreserveInts#
void halSleepPreserveInts (SleepModes sleepMode)
Same as halSleep() except it preserves the current interrupt state rather than always enabling interrupts prior to returning.
N/A | sleepMode | A microcontroller sleep mode |
See Also
169
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halCommonDelayMicroseconds#
void halCommonDelayMicroseconds (uint16_t us)
Blocks the current thread of execution for the specified amount of time, in microseconds.
N/A | us | The specified time, in microseconds. Values should be between 1 and 65535 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.
186
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
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.
N/A |
Note
: Only used when DISABLE_INTERNAL_1V8_REGULATOR is defined.
206
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
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.
N/A |
Note
: Only used when DISABLE_INTERNAL_1V8_REGULATOR is defined.
217
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halBeforeEM4#
void halBeforeEM4 (uint32_t duration, RTCCRamData input)
N/A | duration | |
N/A | input |
228
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
halAfterEM4#
RTCCRamData halAfterEM4 (void )
N/A |
229
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
Macro Definition Documentation#
halGetEm2xxResetInfo#
#define halGetEm2xxResetInfoValue:
()
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.
Application Usage:\n 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.
98
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro.h
MICRO_DISABLE_WATCH_DOG_KEY#
#define MICRO_DISABLE_WATCH_DOG_KEYValue:
0xA5U
The value that must be passed as the single parameter to halInternalDisableWatchDog() in order to successfully disable the watchdog timer.
56
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
GPIO_MASK_SIZE#
#define GPIO_MASK_SIZEValue:
24
137
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
GPIO_MASK#
#define GPIO_MASKValue:
0xFFFFFF
138
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
WAKE_GPIO_MASK#
#define WAKE_GPIO_MASKValue:
GPIO_MASK
139
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
WAKE_GPIO_SIZE#
#define WAKE_GPIO_SIZEValue:
GPIO_MASK_SIZE
140
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
WAKE_MASK_INVALID#
#define WAKE_MASK_INVALIDValue:
(-1)
145
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
WAKE_EVENT_SIZE#
#define WAKE_EVENT_SIZEValue:
WakeMask
Note
The preprocessor symbol WAKE_EVENT_SIZE has been deprecated. Please use WakeMask instead.
150
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h
DEBUG_TOGGLE#
#define DEBUG_TOGGLE
188
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/platform/base/hal/micro/micro-common.h