sleep.h File Reference

Energy Modes management driver.

Version
5.5.0

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()

License

Copyright 2016 Silicon Laboratories, Inc. www.silabs.com

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
 

Macros

#define SLEEP_EM4_WAKEUP_CALLBACK_ENABLED   true
 
#define SLEEP_FLAG_NO_CLOCK_RESTORE   0x1u
 
#define SLEEP_FLAG_NONE   0x0
 
#define SLEEP_HW_LOW_ENERGY_BLOCK_ENABLED   true
 
#define SLEEP_LOWEST_ENERGY_MODE_DEFAULT   sleepEM3
 

Typedefs

typedef void(* SLEEP_CbFuncPtr_t) (SLEEP_EnergyMode_t)
 

Enumerations

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

Functions

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.