1 /*
2 * \ingroup MODULMACROS
3 *
4 * \file HaltArm.c
5 *
6 * \brief <FILEBRIEF>
7 *
8 *
9 * Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
10 *
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 *
16 * Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 *
19 * Redistributions in binary form must reproduce the above copyright
20 * notice, this list of conditions and the following disclaimer in the
21 * documentation and/or other materials provided with the
22 * distribution.
23 *
24 * Neither the name of Texas Instruments Incorporated nor the names of
25 * its contributors may be used to endorse or promote products derived
26 * from this software without specific prior written permission.
27 *
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 */
40
41 #include "arch.h"
42 #include "edt.h"
43 #include "hal.h"
44 #include "stream.h"
45 #include "JTAG_defs.h"
46 #include "error_def.h"
47 #include "global_variables.h"
48
49 /**
50 Halt: Halts the Core
51 */
52 #if defined(MSP430_UIF) || defined(MSP_FET)
53 extern ARMConfigSettings armConfigSettings;
54 #endif
55
HAL_FUNCTION(_hal_HaltArm)56 HAL_FUNCTION(_hal_HaltArm)
57 {
58 short retVal = 0;
59 #if defined(MSP430_UIF) || defined(MSP_FET)
60 unsigned short* syncWithRunVarAddress = getTargetRunningVar();
61 if(syncWithRunVarAddress)
62 {
63 *syncWithRunVarAddress = 0x0000;
64 }
65 // Set system and debug power up if cleared
66 if( powerUpArm() != 0)
67 {
68 return HALERR_UNDEFINED_ERROR;
69 }
70
71 if(checkWakeup() != 0)
72 {
73 retVal = HALERR_UNDEFINED_ERROR;
74 }
75
76 unsigned char retry = MAX_RETRY;
77
78 unsigned long data = DBGKEY | C_HALT | C_DEBUGEN;
79 IHIL_Write_Read_Mem_Ap(0, DHCSR, &data, WRITE);
80
81 do
82 {
83 IHIL_Write_Read_Mem_Ap(0, DHCSR, &data, READ);
84 } while(!(data & S_HALT) && --retry);
85
86 if(!retry)
87 {
88 retVal = HALERR_UNDEFINED_ERROR;
89 }
90
91 // Read out why did we halt?
92 IHIL_Write_Read_Mem_Ap(0, DFSR, &data, READ);
93 STREAM_put_long(data);
94 #endif
95 return retVal;
96 }
97