MSP430 DLL API Documentation  3.12.0.004
MSP430_EEM.h
Go to the documentation of this file.
1 /*
2  * MSP430_EEM.h
3  *
4  * API for accessing EEM functionality of MSP430 library.
5  *
6  * Copyright (c) 2004 - 2016 Texas Instruments Incorporated - http://www.ti.com/
7  *
8  * All rights reserved not granted herein.
9  * Limited License.
10  *
11  * Texas Instruments Incorporated grants a world-wide, royalty-free,
12  * non-exclusive license under copyrights and patents it now or hereafter
13  * owns or controls to make, have made, use, import, offer to sell and sell ("Utilize")
14  * this software subject to the terms herein. With respect to the foregoing patent
15  * license, such license is granted solely to the extent that any such patent is necessary
16  * to Utilize the software alone. The patent license shall not apply to any combinations which
17  * include this software, other than combinations with devices manufactured by or for TI (“TI Devices”).
18  * No hardware patent is licensed hereunder.
19  *
20  * Redistributions must preserve existing copyright notices and reproduce this license (including the
21  * above copyright notice and the disclaimer and (if applicable) source code license limitations below)
22  * in the documentation and/or other materials provided with the distribution
23  *
24  * Redistribution and use in binary form, without modification, are permitted provided that the following
25  * conditions are met:
26  *
27  * * No reverse engineering, decompilation, or disassembly of this software is permitted with respect to any
28  * software provided in binary form.
29  * * any redistribution and use are licensed by TI for use only with TI Devices.
30  * * Nothing shall obligate TI to provide you with source code for the software licensed and provided to you in object code.
31  *
32  * If software source code is provided to you, modification and redistribution of the source code are permitted
33  * provided that the following conditions are met:
34  *
35  * * any redistribution and use of the source code, including any resulting derivative works, are licensed by
36  * TI for use only with TI Devices.
37  * * any redistribution and use of any object code compiled from the source code and any resulting derivative
38  * works, are licensed by TI for use only with TI Devices.
39  *
40  * Neither the name of Texas Instruments Incorporated nor the names of its suppliers may be used to endorse or
41  * promote products derived from this software without specific prior written permission.
42  *
43  * DISCLAIMER.
44  *
45  * THIS SOFTWARE IS PROVIDED BY TI AND TI’S LICENSORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
46  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
47  * IN NO EVENT SHALL TI AND TI’S LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
48  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
49  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
51  * POSSIBILITY OF SUCH DAMAGE.
52  */
53 
100 #ifndef MSP430_EEM_H
101 #define MSP430_EEM_H
102 
103 
104 #include <MSP430_Debug.h>
105 
106 #if defined(__cplusplus)
107 extern "C" {
108 #endif
109 
110 #ifndef MSP430_EEM_TYPES
111 #define MSP430_EEM_TYPES
112 
117 #define MAXHANDLE 20
118 
122 #define MAXTRIGGER 8
123 
127 #define N_TRACE_POS 8
128 
132 #define MAX_SEQ_TRIGGER 4
133 
137 #define MAX_SEQ_STATE 4
138 
146 typedef struct MESSAGE_ID {
152  uint32_t uiMsgIdStorage;
154  uint32_t uiMsgIdState;
156  uint32_t uiMsgIdWarning;
159 }
167 
168 
170 typedef enum WarningCodes {
187 } WarCode_t;
188 
189 
191 typedef enum BpMode {
193  BP_CLEAR = 0,
195  BP_CODE = 1,
197  BP_RANGE = 2,
202 } BpMode_t;
203 
204 
206 typedef enum BpType {
208  BP_MAB = 0,
210  BP_MDB = 1,
213 } BpType_t;
214 
244 typedef enum BpAccess {
246  BP_FETCH = 0,
258  BP_READ = 6,
260  BP_WRITE = 7,
264  BP_DMA = 9,
266  BP_NO_DMA = 10,
279 } BpAccess_t;
280 
281 
283 typedef enum BpAction {
285  BP_NONE = 0,
287  BP_BRK = 1,
289  BP_STO = 2,
293  BP_CC = 4
294 } BpAction_t;
295 
296 
301 typedef enum BpOperat {
303  BP_EQUAL = 0,
307  BP_LOWER = 2,
310 } BpOperat_t;
311 
312 
317 typedef enum BpRangeAction {
323 
324 
329 typedef enum BpCondition {
333  BP_COND = 1,
334 } BpCondition_t;
335 
340 typedef enum BpConditionValSize {
345 
350 typedef struct BREAKPOINT {
354  int32_t lAddrVal;
358  int32_t lReg;
366  int32_t lMask;
368  int32_t lRangeEndAdVa;
374  uint32_t lCondMdbVal;
378  int32_t lCondMask;
382  uint16_t wExtCombine;
385 }
393 
394 
399 typedef enum CbControl {
401  CB_SET = 0,
403  CB_CLEAR = 1,
404 } CbControl_t;
405 
406 
407 
408 
410 typedef enum TrControl {
416  TR_RESET = 2,
417 } TrControl_t;
418 
420 typedef enum TrMode {
426  TR_SHOT = 2,
429 } TrMode_t;
430 
432 typedef enum TrAction {
434  TR_FETCH = 0,
437 } TrAction_t;
438 
443 typedef struct TRACE_CTRL {
450 }
451 
459 
466 typedef struct TRACE_BUFFER {
468  int32_t lTrBufMAB;
470  int32_t lTrBufMDB;
472  uint16_t wTrBufCNTRL;
473 }
474 
481 
482 
483 
484 
486 typedef enum VwEnable {
491 } VwEnable_t;
492 
494 typedef enum VwControl {
496  VW_SET = 0,
498  VW_CLEAR = 1,
499 } VwControl_t;
500 
502 typedef enum VwDataType {
504  VW_8 = 0,
506  VW_16 = 1,
508  VW_32 = 2,
509 } VwDataType_t;
510 
515 typedef struct VARIABLE_WATCH {
519  uint32_t lAddr;
522 }
529 
530 
535 typedef struct VAR_WATCH_RESOURCES {
537  uint16_t vwHandle;
539  uint32_t lAddr;
542 }
549 
550 
552 typedef enum CcControl {
557 } CcControl_t;
558 
560 typedef enum CcModule {
564  CC_WDT = (1 << 1),
566  CC_TIMER_A = (1 << 2),
568  CC_TIMER_B = (1 << 3),
570  CC_BASIC_TIMER = (1 << 4),
572  CC_LCD_FREQ = (1 << 5),
574  CC_TIMER_COUNTER = (1 << 6),
576  CC_TIMER_PORT = (1 << 7),
578  CC_USART0 = (1 << 8),
580  CC_USART1 = (1 << 9),
582  CC_FLASH_CNTRL = (1 << 10),
584  CC_ADC = (1 << 11),
586  CC_ACLK = (1 << 12),
588  CC_SMCLK = (1 << 13),
590  CC_MCLK = (1 << 14),
591 } CcModule_t;
592 
593 
599 typedef enum CcGeneralCLK {
603  CC_STP_ACLK = (1 << 1),
605  CC_STP_SMCLK = (1 << 2),
607  CC_STP_MCLK = (1 << 3),
609  CC_STP_TACLK = (1 << 5),
611 
616 typedef struct CLOCK_CONTROL {
620  uint16_t ccModule;
622  uint16_t ccGeneralCLK;
623 }
631 
632 typedef struct CLOCK_CONTROL2 {
636  uint32_t ccModule;
638  uint16_t ccGeneralCLK;
639 }
647 
648 
650 typedef enum SeqControl {
655 } SeqControl_t;
656 
658 typedef enum SeqState {
667 } SeqState_t;
668 
674 typedef struct SEQUENCER {
678  uint16_t wHandleRstTrig;
681  // State X:
683  SeqState_t seqNextStateX[MAX_SEQ_STATE];
685  uint16_t wHandleStateX[MAX_SEQ_STATE];
687  SeqState_t seqNextStateY[MAX_SEQ_STATE];
689  uint16_t wHandleStateY[MAX_SEQ_STATE];
690 }
697 
698 
700 typedef enum {
706 
708 typedef enum {
724 
726 typedef enum {
736 
738 typedef enum
739 {
749 
751 typedef enum
752 {
760 
765 typedef struct
766 {
775 }
781 
782 
783 //==============================================================================
784 //==============================================================================
785 
793 typedef void (* MSP430_EVENTNOTIFY_FUNC) (uint32_t MsgId, uint32_t wParam, int32_t lParam, int32_t clientHandle);
794 
795 //==============================================================================
796 #endif /* MSP430_EEM_TYPES */
797 
867 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_Init(MSP430_EVENTNOTIFY_FUNC callback, int32_t clientHandle, const MessageID_t* pMsgIdBuffer);
868 
899 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetBreakpoint(uint16_t* pwBpHandle, const BpParameter_t* pBpBuffer);
900 
901 
902 
903 
922 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetBreakpoint(uint16_t wBpHandle, BpParameter_t* pBpDestBuffer);
923 
924 
925 
926 
960 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetCombineBreakpoint(CbControl_t CbControl, uint16_t wCount, uint16_t* pwCbHandle, const uint16_t* pawBpHandle);
961 
962 
963 
964 
988 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetCombineBreakpoint(uint16_t wCbHandle, uint16_t* pwCount, uint16_t* pawBpHandle);
989 
990 
991 
992 
1013 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetTrace(const TrParameter_t* pTrBuffer);
1014 
1015 
1016 
1017 
1035 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetTrace(TrParameter_t* pTrDestBuffer);
1036 
1037 
1038 
1039 
1060 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadTraceBuffer(TraceBuffer_t* pTraceBuffer);
1061 
1062 
1063 
1086 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadTraceData(TraceBuffer_t* pTraceBuffer, uint32_t* pulCount);
1087 
1088 
1089 
1101 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_RefreshTraceBuffer(void);
1102 
1103 
1104 
1105 
1129 
1130 
1131 
1132 
1154 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetVariable(uint16_t* pVwHandle, const VwParameter_t* pVwBuffer);
1155 
1156 
1157 
1158 
1180 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetVariableWatch(VwEnable_t* pVwEnable, VwResources_t* paVwDestBuffer);
1181 
1182 
1183 
1184 
1210 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetClockControl(const CcParameter_t* pCcBuffer);
1211 
1212 
1213 
1239 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetClockControl2(const CcParameter2_t* pCcBuffer);
1240 
1241 
1242 
1243 
1261 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetClockControl(CcParameter_t* pCcDestBuffer);
1262 
1263 
1264 
1282 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetClockControl2(CcParameter2_t* pCcDestBuffer);
1283 
1284 
1285 
1286 
1313 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetSequencer(const SeqParameter_t* pSeqBuffer);
1314 
1315 
1316 
1317 
1335 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetSequencer(SeqParameter_t* pSeqDestBuffer);
1336 
1337 
1338 
1339 
1357 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadSequencerState(SeqState_t* pSeqState);
1358 
1359 
1360 
1361 
1380 
1381 
1382 
1383 
1403 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ConfigureCycleCounter(uint32_t wCounter, CycleCounterConfig_t pCycConfig);
1404 
1405 
1406 
1407 
1427 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadCycleCounterValue(uint32_t wCounter, uint64_t* value);
1428 
1429 
1430 
1431 
1450 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_WriteCycleCounterValue(uint32_t wCounter, uint64_t value);
1451 
1452 
1453 
1454 
1472 DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ResetCycleCounter(uint32_t wCounter);
1473 
1474 
1475 #if defined(__cplusplus)
1476 }
1477 #endif
1478 
1479 #endif // MSP430_EEM_H
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetSequencer(const SeqParameter_t *pSeqBuffer)
Stop clock for LCD frequency on emualtion halt.
Definition: MSP430_EEM.h:572
Read & no DMA access.
Definition: MSP430_EEM.h:272
Break on trigger.
Definition: MSP430_EEM.h:287
Write.
Definition: MSP430_EEM.h:260
forbidden old API call
Definition: MSP430_EEM.h:186
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetTrace(const TrParameter_t *pTrBuffer)
Stop clock for TimerA on emualtion halt.
Definition: MSP430_EEM.h:566
Trace information only at instruction Fetch.
Definition: MSP430_EEM.h:434
CycleCounterStartMode_t
Cycle counter start mode.
Definition: MSP430_EEM.h:726
struct SEQUENCER SeqParameter_t
Sequencer parameter structure: The data structure contains the configuration settings of the sequence...
CycleCounterClearMode_t clearMode
Condition to clear/reset counter.
Definition: MSP430_EEM.h:774
SeqState
Sequencer: Select next state when selected trigger occurs.
Definition: MSP430_EEM.h:658
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ResetCycleCounter(uint32_t wCounter)
Reset counter value to 0.
Trace information on all MCLK clocks.
Definition: MSP430_EEM.h:436
Outside range.
Definition: MSP430_EEM.h:321
Stop clock for Basic Timer on emualtion halt.
Definition: MSP430_EEM.h:570
WarningCodes
WarCode_t contains the warning codes that are sent as an event.
Definition: MSP430_EEM.h:170
CcControl_t ccControl
Extended emulation clock control (enable/disable clock control)
Definition: MSP430_EEM.h:634
Stop clock for ADC on emualtion halt.
Definition: MSP430_EEM.h:584
Definition: MSP430_EEM.h:632
CycleCounterMode_t
Cycle counter operation mode.
Definition: MSP430_EEM.h:700
uint32_t uiMsgIdStorage
Message identification for "Storage on trace buffer" event.
Definition: MSP430_EEM.h:152
Trace parameter structure: The data structure contains the configuration settings of the EEM trace fu...
Definition: MSP430_EEM.h:443
struct BREAKPOINT BpParameter_t
The breakpoint structure contains the settings which are required to set, modify or clear a breakpoin...
Break and trigger state storage on trigger.
Definition: MSP430_EEM.h:291
CcModule
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock c...
Definition: MSP430_EEM.h:560
Switch in state 3.
Definition: MSP430_EEM.h:666
uint16_t ccModule
Switch clock for modules off (1 bit per clock module, 1: stop clock module while CPU halted) ...
Definition: MSP430_EEM.h:620
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetVariableWatch(VwEnable_t VwEnable)
This function configures the EEM State Storage Module to work as a Real Time Monitor for a variable...
CcControl_t ccControl
Extended emulation clock control (enable/disable clock control)
Definition: MSP430_EEM.h:618
Clock control parameter structure: The data structure contains the settings of the clock control feat...
Definition: MSP430_EEM.h:616
Reset device.
Definition: MSP430_EEM.h:178
BpRangeAction
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT ...
Definition: MSP430_EEM.h:317
DMA access (read or write)
Definition: MSP430_EEM.h:264
No instruction fetch & write.
Definition: MSP430_EEM.h:256
Stored trace trigger action is enabled.
Definition: MSP430_EEM.h:182
Cycle counter.
Definition: MSP430_EEM.h:293
enum BpAccess BpAccess_t
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure...
uint32_t uiMsgIdWarning
Message identification for "Warning" event.
Definition: MSP430_EEM.h:156
Stop clock for Flash Control on emualtion halt.
Definition: MSP430_EEM.h:582
Address/value greater MAB/MDB.
Definition: MSP430_EEM.h:305
Enable the variable watch function.
Definition: MSP430_EEM.h:488
Trigger stops the Trace.
Definition: MSP430_EEM.h:422
No intruction fetch & no DMA access.
Definition: MSP430_EEM.h:262
int32_t lTrBufMAB
Trace buffer MAB.
Definition: MSP430_EEM.h:468
Enable state storage.
Definition: MSP430_EEM.h:412
Read & DMA access.
Definition: MSP430_EEM.h:274
int32_t lReg
Breakpoint register (used for complex breakpoints with register-write trigger)
Definition: MSP430_EEM.h:358
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetClockControl2(const CcParameter2_t *pCcBuffer)
This file contains the DLL function headers and definitions to support the debugging functions of the...
int32_t lCondMask
Complex breakpoint: Mask Value(used for complex breakpoints)
Definition: MSP430_EEM.h:378
Stop clock for TimerB on emualtion halt.
Definition: MSP430_EEM.h:568
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_WriteCycleCounterValue(uint32_t wCounter, uint64_t value)
Set counter value.
Inside range.
Definition: MSP430_EEM.h:319
Count on all bus cycles (CPU or DMA)
Definition: MSP430_EEM.h:718
Event message identification structure: This structure contains the message identifications for the d...
Definition: MSP430_EEM.h:146
struct TRACE_BUFFER TraceBuffer_t
Trace buffer readout structure: The data structure is a copy of one position of the hardware trace bu...
Stop clock for Watch Dog Timer on emualtion halt.
Definition: MSP430_EEM.h:564
Reasd & Write.
Definition: MSP430_EEM.h:278
struct MESSAGE_ID MessageID_t
Event message identification structure: This structure contains the message identifications for the d...
enum BpType BpType_t
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure.
CycleCounterCountMode_t countMode
Condition to increase counter.
Definition: MSP430_EEM.h:768
BpCondition_t bpCondition
Complex breakpoint: Condition available.
Definition: MSP430_EEM.h:372
enum VwEnable VwEnable_t
Variable watch: Enable.
All module clocks are running on emualtion halt.
Definition: MSP430_EEM.h:562
Stop counter on debug halt.
Definition: MSP430_EEM.h:741
Stop MCLK on emulation halt (not for extended clock control)
Definition: MSP430_EEM.h:607
Reset counter on counter trigger reaction (only counter 1)
Definition: MSP430_EEM.h:756
enum CcModule CcModule_t
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock c...
uint16_t vwHandle
Handle of the variable trigger.
Definition: MSP430_EEM.h:537
Clear breakpoint.
Definition: MSP430_EEM.h:193
Enable.
Definition: MSP430_EEM.h:556
enum BpRangeAction BpRangeAction_t
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT ...
enum BpCondition BpCondition_t
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structur...
Switch in state 1.
Definition: MSP430_EEM.h:662
Never stop counter.
Definition: MSP430_EEM.h:747
Address/value lower MAB/MDB.
Definition: MSP430_EEM.h:307
int32_t lRangeEndAdVa
Range breakpoint end address (used for range breakpoints)
Definition: MSP430_EEM.h:368
enum BpMode BpMode_t
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure.
enum CcGeneralCLK CcGeneralCLK_t
Clock control: Switch general clock off (logic AND operation)
BpConditionValSize_t bpCondValSize
Complex breakpoint: Size of the value to be matched.
Definition: MSP430_EEM.h:384
CycleCounterClearMode_t
Cycler counter clear mode.
Definition: MSP430_EEM.h:751
TrAction_t trAction
Store on instruction fetch or on all cycles (see enumerations of TR_Action) (only trControl = ST_ENAB...
Definition: MSP430_EEM.h:449
Basic mode (default): counter 0 is reserved for legacy behavior.
Definition: MSP430_EEM.h:702
BpType_t bpType
Breakpoint type (used for range and complex breakpoints)
Definition: MSP430_EEM.h:356
Variable watch parameter structure: The data structure contains the settings of one variable...
Definition: MSP430_EEM.h:515
uint32_t uiMsgIdCPUStopped
Message identification for "Device CPU stopped" event.
Definition: MSP430_EEM.h:158
TrControl_t trControl
Enable/disable/reset trace buffer (see enumerations of TR_Control)
Definition: MSP430_EEM.h:445
BpConditionValSize
BpConditionValSize_t defines the data size of the value to be matched. Used inside the BREAKPOINT str...
Definition: MSP430_EEM.h:340
Count on DMA bus cycles.
Definition: MSP430_EEM.h:722
Start counter when released from debug halt.
Definition: MSP430_EEM.h:728
BpMode_t bpMode
Breakpoint modes.
Definition: MSP430_EEM.h:352
Set MAB breakpoint.
Definition: MSP430_EEM.h:208
enum TrMode TrMode_t
Trace: Mode.
Set software breakpoint.
Definition: MSP430_EEM.h:201
enum CbControl CbControl_t
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetComb...
enum SeqControl SeqControl_t
Sequencer: Control.
uint16_t ccGeneralCLK
Switch general clock off (1 bit per clock, 1: stop clock while CPU halted)
Definition: MSP430_EEM.h:638
Switch in state 2.
Definition: MSP430_EEM.h:664
Set code breakpoint.
Definition: MSP430_EEM.h:195
BpOperat_t bpCondOperat
Complex breakpoint: Operator (used for complex breakpoints)
Definition: MSP430_EEM.h:380
Clear a watched variable.
Definition: MSP430_EEM.h:498
Collect data only at trigger event - stops if buffer is full.
Definition: MSP430_EEM.h:428
int32_t lTrBufMDB
Trace buffer MDB.
Definition: MSP430_EEM.h:470
int32_t lAddrVal
Breakpoint address/value (ignored for clear breakpoint)
Definition: MSP430_EEM.h:354
Disable state storage.
Definition: MSP430_EEM.h:414
enum BpOperat BpOperat_t
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT stru...
No instruction fetch.
Definition: MSP430_EEM.h:250
All general clocks running on emulation halt.
Definition: MSP430_EEM.h:601
BpType
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure.
Definition: MSP430_EEM.h:206
uint16_t wTrBufCNTRL
Trace buffer control signals.
Definition: MSP430_EEM.h:472
uint16_t ccGeneralCLK
Switch general clock off (1 bit per clock, 1: stop clock while CPU halted)
Definition: MSP430_EEM.h:622
Definition: MSP430_EEM.h:341
Count on instruction fetch.
Definition: MSP430_EEM.h:716
TrControl
Trace: Control.
Definition: MSP430_EEM.h:410
VwDataType_t vwDataType
Data type of the variable (ignored for VW_CLEAR)
Definition: MSP430_EEM.h:521
Never automatically reset counter.
Definition: MSP430_EEM.h:754
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadTraceData(TraceBuffer_t *pTraceBuffer, uint32_t *pulCount)
This function reads the content of the Trace Buffer of the EEM. No change or other action on the trac...
Breakpoint removed from combination.
Definition: MSP430_EEM.h:174
Instruction fetch & hold trigger.
Definition: MSP430_EEM.h:248
BpAccess_t bpCondAccess
Complex breakpoint: Access (used for complex breakpoints)
Definition: MSP430_EEM.h:376
Start immediately - stops if buffer is full.
Definition: MSP430_EEM.h:426
Read.
Definition: MSP430_EEM.h:258
No intruction fetch & read.
Definition: MSP430_EEM.h:254
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_Init(MSP430_EVENTNOTIFY_FUNC callback, int32_t clientHandle, const MessageID_t *pMsgIdBuffer)
Advanced mode: counter 0 is available for manual configuration.
Definition: MSP430_EEM.h:704
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetBreakpoint(uint16_t wBpHandle, BpParameter_t *pBpDestBuffer)
This function reads back the settings of a breakpoint. No change or other action on the breakpoint is...
Set MDB breakpoint.
Definition: MSP430_EEM.h:210
Stop clock for Timer Port on emualtion halt.
Definition: MSP430_EEM.h:576
Variable watch resource structure: The data structure contains the resources of one variable trigger...
Definition: MSP430_EEM.h:535
Instuction fetch.
Definition: MSP430_EEM.h:246
uint32_t uiMsgIdBreakpoint
Message identification for "Breakpoint hit" event.
Definition: MSP430_EEM.h:150
Set range breakpoint.
Definition: MSP430_EEM.h:197
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetCombineBreakpoint(uint16_t wCbHandle, uint16_t *pwCount, uint16_t *pawBpHandle)
This function reads back the number and list of combined breakpoints.
VwDataType
Variable watch: Data type of the variable (ignored for VW_CLEAR)
Definition: MSP430_EEM.h:502
uint32_t lAddr
Address of the watched variable (ignored for VW_CLEAR)
Definition: MSP430_EEM.h:519
BpAction
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure...
Definition: MSP430_EEM.h:283
Trace buffer readout structure: The data structure is a copy of one position of the hardware trace bu...
Definition: MSP430_EEM.h:466
No DMA access.
Definition: MSP430_EEM.h:266
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadTraceBuffer(TraceBuffer_t *pTraceBuffer)
This function reads the content of the Trace Buffer of the EEM. No change or other action on the trac...
VwEnable
Variable watch: Enable.
Definition: MSP430_EEM.h:486
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetTrace(TrParameter_t *pTrDestBuffer)
This function reads back the settings of a Trace Configuration Register. No change or other action on...
enum TrControl TrControl_t
Trace: Control.
uint16_t wExtCombine
Combine breakpoint: Reference of a combination handle.
Definition: MSP430_EEM.h:382
BpAction_t bpAction
Breakpoint action (break/storage) (used for range and complex breakpoints)
Definition: MSP430_EEM.h:362
struct CLOCK_CONTROL CcParameter_t
Clock control parameter structure: The data structure contains the settings of the clock control feat...
enum SeqState SeqState_t
Sequencer: Select next state when selected trigger occurs.
enum WarningCodes WarCode_t
WarCode_t contains the warning codes that are sent as an event.
Condition available.
Definition: MSP430_EEM.h:333
Stop MCLK on extern pin on emualtion halt.
Definition: MSP430_EEM.h:590
Start counter on counter trigger reaction (only counter 1)
Definition: MSP430_EEM.h:730
Count on all IFCLKs (used and unused by CPU or DMA)
Definition: MSP430_EEM.h:714
Write & DMA access.
Definition: MSP430_EEM.h:276
Stop TACLK on emulation halt (only for standard clock control)
Definition: MSP430_EEM.h:609
Counter is stopped.
Definition: MSP430_EEM.h:710
SeqControl_t seqControl
Trigger sequencer Control (enable/disable)
Definition: MSP430_EEM.h:676
int32_t lMask
Breakpoint mask (used for complex breakpoints)
Definition: MSP430_EEM.h:366
Reset state storage.
Definition: MSP430_EEM.h:416
Set complex breakpoint.
Definition: MSP430_EEM.h:199
BpAccess_t bpAccess
Breakpoint access (used only for range and complex breakpoints)
Definition: MSP430_EEM.h:360
BpAccess
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure...
Definition: MSP430_EEM.h:244
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_RefreshTraceBuffer(void)
This function will reset the trace and clear the content of the Trace Buffer of the EEM...
Stop clock for USART0 on emualtion halt.
Definition: MSP430_EEM.h:578
Address/value unequal MAB/MDB.
Definition: MSP430_EEM.h:309
struct CLOCK_CONTROL2 CcParameter2_t
The type CcParameter2_t is used by the functions:
Disable the variable watch function.
Definition: MSP430_EEM.h:490
Start when other counter starts (only targets with 2 counters)
Definition: MSP430_EEM.h:732
BpOperat
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT stru...
Definition: MSP430_EEM.h:301
Cycle counter parameter structure: The data structure contains the configuration settings for a cycle...
Definition: MSP430_EEM.h:765
Sequencer parameter structure: The data structure contains the configuration settings of the sequence...
Definition: MSP430_EEM.h:674
uint32_t lAddr
Address of the watched variable.
Definition: MSP430_EEM.h:539
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadSequencerState(SeqState_t *pSeqState)
Read out the state of the sequencer and store the result in the passed destination buffer...
Stop counter on counter trigger reaction (only counter 1)
Definition: MSP430_EEM.h:743
CycleCounterStartMode_t startMode
Condition to start counter.
Definition: MSP430_EEM.h:770
BpOperat_t bpOperat
Breakpoint operator (used for complex breakpoints)
Definition: MSP430_EEM.h:364
TrAction
Trace: Action (ignored for collect data mode)
Definition: MSP430_EEM.h:432
enum TrAction TrAction_t
Trace: Action (ignored for collect data mode)
Set register breakpoint.
Definition: MSP430_EEM.h:212
No instruction fetch & read & no DMA access.
Definition: MSP430_EEM.h:270
CcGeneralCLK
Clock control: Switch general clock off (logic AND operation)
Definition: MSP430_EEM.h:599
Stop ACLK on emulation halt.
Definition: MSP430_EEM.h:603
TrMode_t trMode
Stores history, future, one snap shot or collect data on trigger (see enumerations of TR_Mode) (only ...
Definition: MSP430_EEM.h:447
Switch in state 0.
Definition: MSP430_EEM.h:660
CycleCounterCountMode_t
Cycle counter count mode.
Definition: MSP430_EEM.h:708
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ConfigureCycleCounter(uint32_t wCounter, CycleCounterConfig_t pCycConfig)
Set configuration for a cycle counter.
Polling thread is active - function call not allowed at the moment.
Definition: MSP430_EEM.h:184
CbControl
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetComb...
Definition: MSP430_EEM.h:399
BpRangeAction_t bpRangeAction
Range breakpoint action (inside/outside) (used for range breakpoints)
Definition: MSP430_EEM.h:370
int32_t STATUS_T
this is the definition for the DLL functions return value
Definition: MSP430.h:180
struct TRACE_CTRL TrParameter_t
Trace parameter structure: The data structure contains the configuration settings of the EEM trace fu...
Stop clock for 8 bit Timer/Counter on emualtion halt.
Definition: MSP430_EEM.h:574
CycleCounterStopMode_t
Cycle counter stop mode.
Definition: MSP430_EEM.h:738
The breakpoint structure contains the settings which are required to set, modify or clear a breakpoin...
Definition: MSP430_EEM.h:350
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetClockControl(const CcParameter_t *pCcBuffer)
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetSequencer(SeqParameter_t *pSeqDestBuffer)
This function reads back the settings of the sequencer configuration. No change or other action on th...
VwControl_t vwControl
Set/clear variable.
Definition: MSP430_EEM.h:517
Clears existing combination of two or several breakpoints.
Definition: MSP430_EEM.h:403
SeqControl
Sequencer: Control.
Definition: MSP430_EEM.h:650
VwControl
Variable watch: Control.
Definition: MSP430_EEM.h:494
Stop SMCLK on emulation halt.
Definition: MSP430_EEM.h:605
BpCondition
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structur...
Definition: MSP430_EEM.h:329
Enable sequencer state machine.
Definition: MSP430_EEM.h:654
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetClockControl(CcParameter_t *pCcDestBuffer)
This function reads back the settings of the clock control. No change or other action on the settings...
Disable sequencer state machine.
Definition: MSP430_EEM.h:652
enum BpAction BpAction_t
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure...
Properties of combination changed.
Definition: MSP430_EEM.h:176
CycleCounterStopMode_t stopMode
Condition to stop counter.
Definition: MSP430_EEM.h:772
Disable.
Definition: MSP430_EEM.h:554
TrMode
Trace: Mode.
Definition: MSP430_EEM.h:420
BpAction_t bpAction
Select action on entering final state.
Definition: MSP430_EEM.h:680
Stop ACLK on extern pin on emualtion halt.
Definition: MSP430_EEM.h:586
Count on cycle counter trigger reaction (only counter 1)
Definition: MSP430_EEM.h:712
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetCycleCounterMode(CycleCounterMode_t mode)
Configures the global cycle counter operation mode.
Write & no DMA access.
Definition: MSP430_EEM.h:268
uint32_t lCondMdbVal
Complex breakpoint: MDB value (used for complex breakpoints)
Definition: MSP430_EEM.h:374
struct VAR_WATCH_RESOURCES VwResources_t
Variable watch resource structure: The data structure contains the resources of one variable trigger...
Definition: MSP430_EEM.h:343
Address/value equal MAB/MDB.
Definition: MSP430_EEM.h:303
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetBreakpoint(uint16_t *pwBpHandle, const BpParameter_t *pBpBuffer)
Combines two or several available breakpoints.
Definition: MSP430_EEM.h:401
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetVariable(uint16_t *pVwHandle, const VwParameter_t *pVwBuffer)
No action on trigger (necessary for sequencer mechanism)
Definition: MSP430_EEM.h:285
Trigger starts the Trace - stops if buffer is full.
Definition: MSP430_EEM.h:424
Trigger state storage (trace mechnism) on trigger.
Definition: MSP430_EEM.h:289
Combination removed.
Definition: MSP430_EEM.h:172
Stop counter when other counter stops (only targets with 2 counters)
Definition: MSP430_EEM.h:745
uint32_t uiMsgIdState
Message identification for "Change in new state of the sequencer" event.
Definition: MSP430_EEM.h:154
Count on CPU bus cycles.
Definition: MSP430_EEM.h:720
Set a variable to watch.
Definition: MSP430_EEM.h:496
void(* MSP430_EVENTNOTIFY_FUNC)(uint32_t MsgId, uint32_t wParam, int32_t lParam, int32_t clientHandle)
Type definition for a callback function which must be available in the application which calls the MS...
Definition: MSP430_EEM.h:793
CcControl
Clock control: Extended emulation.
Definition: MSP430_EEM.h:552
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_ReadCycleCounterValue(uint32_t wCounter, uint64_t *value)
Read current counter value.
Stop SMCLK on extern pin on emualtion halt.
Definition: MSP430_EEM.h:588
Don&#39;t care.
Definition: MSP430_EEM.h:252
enum VwDataType VwDataType_t
Variable watch: Data type of the variable (ignored for VW_CLEAR)
No condition available.
Definition: MSP430_EEM.h:331
enum VwControl VwControl_t
Variable watch: Control.
Start counter immediately.
Definition: MSP430_EEM.h:734
Definition: MSP430_EEM.h:342
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetVariableWatch(VwEnable_t *pVwEnable, VwResources_t *paVwDestBuffer)
This function reads back the settings and the resources of the variable watch configuration.
BpMode
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure.
Definition: MSP430_EEM.h:191
enum CcControl CcControl_t
Clock control: Extended emulation.
uint16_t wHandleRstTrig
Select breakpoint as a reset trigger to set start state 0 (0 = off)
Definition: MSP430_EEM.h:678
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_SetCombineBreakpoint(CbControl_t CbControl, uint16_t wCount, uint16_t *pwCbHandle, const uint16_t *pawBpHandle)
Trace trigger action is disabled and stored.
Definition: MSP430_EEM.h:180
Long.
Definition: MSP430_EEM.h:508
uint32_t uiMsgIdSingleStep
Message identification for "Single step complete" event.
Definition: MSP430_EEM.h:148
Byte.
Definition: MSP430_EEM.h:504
Stop clock for USART1 on emualtion halt.
Definition: MSP430_EEM.h:580
DLL430_SYMBOL STATUS_T WINAPI MSP430_EEM_GetClockControl2(CcParameter2_t *pCcDestBuffer)
This function reads back the settings of the clock control. No change or other action on the settings...
struct VARIABLE_WATCH VwParameter_t
Variable watch parameter structure: The data structure contains the settings of one variable...
uint32_t ccModule
Switch clock for modules off (1 bit per clock module, 1: stop clock module while CPU halted) ...
Definition: MSP430_EEM.h:636
VwDataType_t vwDataType
Data type of the variable.
Definition: MSP430_EEM.h:541
enum BpConditionValSize BpConditionValSize_t
BpConditionValSize_t defines the data size of the value to be matched. Used inside the BREAKPOINT str...
Reset counter when other counter automatically resets (only targets with 2 counters) ...
Definition: MSP430_EEM.h:758
Word.
Definition: MSP430_EEM.h:506