Diff: targets/hal/TARGET_ONSEMI/TARGET_NCS36510/assert_onsemi.h

Revision:

144:ef7eb2e8f9f7

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/targets/hal/TARGET_ONSEMI/TARGET_NCS36510/assert_onsemi.h	Fri Sep 02 15:07:44 2016 +0100
@@ -0,0 +1,68 @@
+/**
+ ******************************************************************************
+ * @file assert.h
+ * @brief Defines an assertion for debugging purposes.
+ * @internal
+ * @author ON Semiconductor
+ * $Rev: 3823 $
+ * $Date: 2015-10-23 16:21:37 +0530 (Fri, 23 Oct 2015) $
+ ******************************************************************************
+ * @copyright (c) 2012 ON Semiconductor. All rights reserved.
+ * ON Semiconductor is supplying this software for use with ON Semiconductor
+ * processor based microcontrollers only.
+ *
+ * THIS SOFTWARE IS PROVIDED "AS IS".  NO WARRANTIES, WHETHER EXPRESS, IMPLIED
+ * OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE.
+ * ON SEMICONDUCTOR SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL,
+ * INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.
+ * @endinternal
+ *
+ * @details
+ * While debugging, the ASSERT macro can be used to verify the expected behaviour
+ * of the source code. If the condition that is passed as a parameter to the ASSERT
+ * macro evaluates to False, execution stops.
+ *
+ * The user has the possibility to hook into the assertion through the assertCallback
+ * callback function. Note though that the callback function must not use any
+ * functionality of the RTOS, or rely on interrupts being called. Once the function
+ * returns, it's done.
+ *
+ * @ingroup debug
+ */
+
+#ifndef ASSERT_H_
+#define ASSERT_H_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifdef DEBUG
+
+/** Executes when an assertion condition evaluates to false.
+ * @param filename The name of the current file (normally the __FILE__ macro).
+ * @param line The current line number (normally the __LINE__ macro).
+ */
+void fOnAssert(const char *filename, unsigned int line);
+
+/** Can be assigned to hook into the assertion. */
+extern void (*assertCallback)(const char *filename, unsigned int line);
+
+#define ASSERT(test)		((test) ? (void)0 : fOnAssert(__FILE__, __LINE__))
+
+#define VERIFY(test)		ASSERT(test)
+
+#else
+
+#define ASSERT(test)		((test) ? (void)0 : 1)
+
+#define VERIFY(test)		((void)(test))
+
+#endif // DEBUG
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* ASSERT_H_ */