1 /***************************************************************************//**
2 * @file
3 * @brief Debug (DBG) API
4 * @author Energy Micro AS
5 * @version 3.0.0
6 *******************************************************************************
7 * @section License
8 * <b>(C) Copyright 2012 Energy Micro AS, http://www.energymicro.com</b>
9 *******************************************************************************
10 *
11 * Permission is granted to anyone to use this software for any purpose,
12 * including commercial applications, and to alter it and redistribute it
13 * freely, subject to the following restrictions:
14 *
15 * 1. The origin of this software must not be misrepresented; you must not
16 * claim that you wrote the original software.
17 * 2. Altered source versions must be plainly marked as such, and must not be
18 * misrepresented as being the original software.
19 * 3. This notice may not be removed or altered from any source distribution.
20 *
21 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Energy Micro AS has no
22 * obligation to support this Software. Energy Micro AS is providing the
23 * Software "AS IS", with no express or implied warranties of any kind,
24 * including, but not limited to, any implied warranties of merchantability
25 * or fitness for any particular purpose or warranties against infringement
26 * of any proprietary rights of a third party.
27 *
28 * Energy Micro AS will not be liable for any consequential, incidental, or
29 * special damages, or any other relief, or for any claim by any third party,
30 * arising from your use of this Software.
31 *
32 ******************************************************************************/
33 #ifndef __EM_DBG_H
34 #define __EM_DBG_H
35
36 #include <stdbool.h>
37 #include "em_part.h"
38
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42
43 /***************************************************************************//**
44 * @addtogroup EM_Library
45 * @{
46 ******************************************************************************/
47
48 /***************************************************************************//**
49 * @addtogroup DBG
50 * @{
51 ******************************************************************************/
52
53 /*******************************************************************************
54 ***************************** PROTOTYPES **********************************
55 ******************************************************************************/
56
57 /***************************************************************************//**
58 * @brief
59 * Check if a debugger is connected (and debug session activated)
60 *
61 * @details
62 * Used to make run-time decisions depending on whether a debug session
63 * has been active since last reset, ie using a debug probe or similar. In
64 * some cases special handling is required in that scenario.
65 *
66 * @return
67 * true if a debug session is active since last reset, otherwise false.
68 ******************************************************************************/
DBG_Connected(void)69 __STATIC_INLINE bool DBG_Connected(void)
70 {
71 if (CoreDebug->DHCSR & CoreDebug_DHCSR_C_DEBUGEN_Msk)
72 {
73 return true;
74 }
75
76 return false;
77 }
78
79
80 void DBG_SWOEnable(unsigned int location);
81
82 /** @} (end addtogroup DBG) */
83 /** @} (end addtogroup EM_Library) */
84
85 #ifdef __cplusplus
86 }
87 #endif
88
89 #endif /* __EM_DBG_H */
90