Diff: targets/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_assert.c

Revision:

150:02e0a0aed4ec

Parent:

149:156823d33999

Child:

161:2cc1468da177

--- a/targets/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_assert.c	Fri Oct 28 11:17:30 2016 +0100
+++ b/targets/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_assert.c	Tue Nov 08 17:45:16 2016 +0000
@@ -1,10 +1,10 @@
 /***************************************************************************//**
  * @file em_assert.c
  * @brief Assert API
- * @version 4.2.1
+ * @version 5.0.0
  *******************************************************************************
  * @section License
- * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
+ * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b>
  *******************************************************************************
  *
  * Permission is granted to anyone to use this software for any purpose,
@@ -30,11 +30,20 @@
  *
  ******************************************************************************/
 
+#include "em_assert.h"
+#include <stdbool.h>
 
-#include "em_assert.h"
+/***************************************************************************//**
+ * @addtogroup emlib
+ * @{
+ ******************************************************************************/
+
+/***************************************************************************//**
+ * @addtogroup ASSERT
+ * @{
+ ******************************************************************************/
 
 #if defined(DEBUG_EFM)
-
 /***************************************************************************//**
  * @brief
  *   EFM internal assert handling.
@@ -42,19 +51,20 @@
  *   This function is invoked through EFM_ASSERT() macro usage only, it should
  *   not be used explicitly.
  *
- *   Currently this implementation only enters an indefinite loop, allowing
+ *   This implementation simply enters an indefinite loop, allowing
  *   the use of a debugger to determine cause of failure. By defining
  *   DEBUG_EFM_USER to the preprocessor for all files, a user defined version
  *   of this function must be defined and will be invoked instead, possibly
  *   providing output of assertion location.
  *
- *   Please notice that this function is not used unless DEBUG_EFM is defined
+ * @note
+ *   This function is not used unless @ref DEBUG_EFM is defined
  *   during preprocessing of EFM_ASSERT() usage.
  *
- * @par file
+ * @param[in] file
  *   Name of source file where assertion failed.
  *
- * @par line
+ * @param[in] line
  *   Line number in source file where assertion failed.
  ******************************************************************************/
 void assertEFM(const char *file, int line)
@@ -62,8 +72,11 @@
   (void)file;  /* Unused parameter */
   (void)line;  /* Unused parameter */
 
-  while (1)
-    ;
+  while (true)
+  {
+  }
 }
+#endif /* DEBUG_EFM */
 
-#endif /* DEBUG_EFM */
+/** @} (end addtogroup ASSERT) */
+/** @} (end addtogroup emlib) */