sleep.h File Reference

Energy Modes management driver.


This is a energy modes management module consisting of sleep.c and sleep.h source files. The main purpose of the module is to ease energy optimization with a simple API. The module allows the system to always sleep in the lowest possible energy mode. Users could set up callbacks that are being called before and after each and every sleep. A counting semaphore is available for each low energy mode (EM2/EM3) to protect certain system states from being corrupted. This semaphore has limit set to maximum 255 locks.

The module provides the following public API to the users: SLEEP_Init() SLEEP_Sleep() SLEEP_SleepBlockBegin() SLEEP_SleepBlockEnd() SLEEP_ForceSleepInEM4()


Copyright 2016 Silicon Laboratories, Inc.

This file is licensed under the Silabs License Agreement. See the file "Silabs_License_Agreement.txt" for details. Before using this software for any purpose, you must agree to the terms of that agreement.

Definition in file sleep.h.

#include <stdint.h>
#include <stdbool.h>
#include "em_device.h"

Data Structures

struct  SLEEP_Init_t


#define SLEEP_FLAG_NONE   0x0


typedef void(* SLEEP_CbFuncPtr_t) (SLEEP_EnergyMode_t)


enum  SLEEP_EnergyMode_t {
  sleepEM0 = 0,
  sleepEM1 = 1,
  sleepEM2 = 2,
  sleepEM3 = 3,
  sleepEM4 = 4


void SLEEP_ForceSleepInEM4 (void)
 Force the device to go to EM4 without doing any checks.
void SLEEP_Init (SLEEP_CbFuncPtr_t pSleepCb, SLEEP_CbFuncPtr_t pWakeUpCb)
 Initialize the Sleep module.
void SLEEP_InitEx (const SLEEP_Init_t *init)
 Initialize the Sleep module.
SLEEP_EnergyMode_t SLEEP_LowestEnergyModeGet (void)
 Gets the lowest energy mode that the system is allowed to be set to.
SLEEP_EnergyMode_t SLEEP_Sleep (void)
 Sets the system to sleep into the lowest possible energy mode.
void SLEEP_SleepBlockBegin (SLEEP_EnergyMode_t eMode)
 Begin sleep block in the requested energy mode.
void SLEEP_SleepBlockEnd (SLEEP_EnergyMode_t eMode)
 End sleep block in the requested energy mode.