Diff: targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_int.c

Revision:

50:a417edff4437

Parent:

0:9b334a45a8ff

Child:

144:ef7eb2e8f9f7

--- a/targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_int.c	Wed Jan 13 12:45:11 2016 +0000
+++ b/targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_int.c	Fri Jan 15 07:45:16 2016 +0000
@@ -1,10 +1,10 @@
 /**************************************************************************//**
  * @file em_int.c
  * @brief Interrupt enable/disable unit API
- * @version 3.20.12
+ * @version 4.2.1
  ******************************************************************************
  * @section License
- * <b>(C) Copyright 2014 Silicon Labs, http://www.silabs.com</b>
+ * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
  *******************************************************************************
  *
  * Permission is granted to anyone to use this software for any purpose,
@@ -30,7 +30,6 @@
  *
  ******************************************************************************/
 
-
 #include <stdint.h>
 #include "em_int.h"
 
@@ -41,15 +40,17 @@
 
 /***************************************************************************//**
  * @addtogroup INT
- * @brief Safe nesting interrupt disable/enable API
+ * @brief Safe nesting of interrupt disable/enable API
  * @{
  * @details
  *  This module contains functions to safely disable and enable interrupts
- *  at cpu level. INT_Disable() disables interrupts and increments a lock
- *  level counter. INT_Enable() decrements the lock level counter and enable
- *  interrupts if the counter was decremented to zero.
+ *  at CPU level. INT_Disable() disables interrupts globally and increments a lock
+ *  level counter (counting semaphore). INT_Enable() decrements the lock level 
+ *  counter and enable interrupts if the counter reaches zero.
  *
- *  These functions would normally be used to secure critical regions.
+ *  These functions would normally be used to secure critical regions, and 
+ *  to make sure that a critical section that calls into another critical 
+ *  section does not unintentionally terminate the callee critical section.
  *
  *  These functions should also be used inside interrupt handlers:
  *  @verbatim
@@ -68,6 +69,5 @@
  * main with interrupts enabled  */
 uint32_t INT_LockCnt = 0;
 
-
 /** @} (end addtogroup INT) */
 /** @} (end addtogroup EM_Library) */