The DLL provides the following functionalities
Go to the source code of this file.
Data Structures | |
struct | MESSAGE_ID |
Event message identification structure: This structure contains the message identifications for the different event messages sent by the DLL. Events are sent by the DLL to inform the caller of a change of state (e.g. breakpoint hit) or to provide data to the caller. More... | |
struct | BREAKPOINT |
The breakpoint structure contains the settings which are required to set, modify or clear a breakpoint. More... | |
struct | TRACE_CTRL |
Trace parameter structure: The data structure contains the configuration settings of the EEM trace function. More... | |
struct | TRACE_BUFFER |
Trace buffer readout structure: The data structure is a copy of one position of the hardware trace buffer. They consist of data in a 40 bit buffer. The 40 bits are divided in 16 bit MAB, 16 bit MDB and 8 bit control signals. More... | |
struct | VARIABLE_WATCH |
Variable watch parameter structure: The data structure contains the settings of one variable. More... | |
struct | VAR_WATCH_RESOURCES |
Variable watch resource structure: The data structure contains the resources of one variable trigger. More... | |
struct | CLOCK_CONTROL |
Clock control parameter structure: The data structure contains the settings of the clock control features. More... | |
struct | SEQUENCER |
Sequencer parameter structure: The data structure contains the configuration settings of the sequencer. To select no trigger provide zero as handle. More... | |
Typedefs | |
typedef MESSAGE_ID | MessageID_t |
Event message identification structure: This structure contains the message identifications for the different event messages sent by the DLL. Events are sent by the DLL to inform the caller of a change of state (e.g. breakpoint hit) or to provide data to the caller The type MessageID_t enables the caller of the function MSP430_EEM_Init(LONG lhWnd, MessageID_t* pMsgIdBuffer) to set dedicated message IDs for the different events. Using Windows user events normaly start at WM_USER (please refer to MSDN help). | |
typedef enum WarningCodes | WarCode_t |
WarCode_t contains the warning codes that are sent as an event. | |
typedef enum BpMode | BpMode_t |
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpType | BpType_t |
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpAccess | BpAccess_t |
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpAction | BpAction_t |
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpOperat | BpOperat_t |
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpRangeAction | BpRangeAction_t |
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT structure. | |
typedef enum BpCondition | BpCondition_t |
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structure. | |
typedef BREAKPOINT | BpParameter_t |
The breakpoint structure contains the settings which are required to set, modify or clear a breakpoint. The type BpParameter_t is used as a source parameter to the function MSP430_EEM_SetBreakpoint(WORD* pwBpHandle, BpParameter_t* pBpBuffer) and as a destination parameter to the function MSP430_EEM_GetBreakpoint(WORD wBpHandle, BpParameter_t* pBpDestBuffer). | |
typedef enum CbControl | CbControl_t |
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetCombineBreakpoint(). | |
typedef enum TrControl | TrControl_t |
Trace: Control. | |
typedef enum TrMode | TrMode_t |
Trace: Mode. | |
typedef enum TrAction | TrAction_t |
Trace: Action (ignored for collect data mode). | |
typedef TRACE_CTRL | TrParameter_t |
Trace parameter structure: The data structure contains the configuration settings of the EEM trace function. The type TrParameter_t is used by the functions:
| |
typedef TRACE_BUFFER | TraceBuffer_t |
Trace buffer readout structure: The data structure is a copy of one position of the hardware trace buffer. They consist of data in a 40 bit buffer. The 40 bits are divided in 16 bit MAB, 16 bit MDB and 8 bit control signals. The type TraceBuffer_t is used by the function:
| |
typedef enum VwEnable | VwEnable_t |
Variable watch: Enable. | |
typedef enum VwControl | VwControl_t |
Variable watch: Control. | |
typedef enum VwDataType | VwDataType_t |
Variable watch: Data type of the variable (ignored for VW_CLEAR). | |
typedef VARIABLE_WATCH | VwParameter_t |
Variable watch parameter structure: The data structure contains the settings of one variable. The type VwParameter_t is used by the function:
| |
typedef VAR_WATCH_RESOURCES | VwResources_t |
Variable watch resource structure: The data structure contains the resources of one variable trigger. The type VwResources_t is used as a array of 8 by the function:
| |
typedef enum CcControl | CcControl_t |
Clock control: Extended emulation. | |
typedef enum CcModule | CcModule_t |
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock control, else ignored). | |
typedef enum CcGeneralCLK | CcGeneralCLK_t |
Clock control: Switch general clock off (logic AND operation). | |
typedef CLOCK_CONTROL | CcParameter_t |
Clock control parameter structure: The data structure contains the settings of the clock control features. The type CcParameter_t is used by the functions:
| |
typedef enum SeqControl | SeqControl_t |
Sequencer: Control. | |
typedef enum SeqState | SeqState_t |
Sequencer: Select next state when selected trigger occurs. | |
typedef SEQUENCER | SeqParameter_t |
Sequencer parameter structure: The data structure contains the configuration settings of the sequencer. To select no trigger provide zero as handle. The type SeqParameter_t is used by the functions:
| |
typedef void(* | MSP430_EVENTNOTIFY_FUNC )(UINT MsgId, UINT wParam, LONG lParam, LONG clientHandle) |
Type definition for a callback function which must be available in the application which calls the MSP430.dll. The callback function handles notify events which are sent from the DLL to the calling application. A handle to the callback function is passed to the DLL by calling MSP430_EEM_Init(). | |
Enumerations | |
enum | WarningCodes { WAR_CLR_COMBINE = 0, WAR_CLR_BP_COMBINE = 1, WAR_MOD_COMBINE = 2, WAR_RESET = 3, WAR_DIS_TR_TRIGGER = 4, WAR_EN_TR_TRIGGER = 5, WAR_EEM_THREAD_ACTIVE = 6, WAR_EEM_CONFLICT = 7 } |
WarCode_t contains the warning codes that are sent as an event. More... | |
enum | BpMode { BP_CLEAR = 0, BP_CODE = 1, BP_RANGE = 2, BP_COMPLEX = 3 } |
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpType { BP_MAB = 0, BP_MDB = 1, BP_REGISTER = 2 } |
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpAccess { BP_FETCH = 0, BP_FETCH_HOLD = 1, BP_NO_FETCH = 2, BP_DONT_CARE = 3, BP_NO_FETCH_READ = 4, BP_NO_FETCH_WRITE = 5, BP_READ = 6, BP_WRITE = 7, BP_NO_FETCH_NO_DMA = 8, BP_DMA = 9, BP_NO_DMA = 10, BP_WRITE_NO_DMA = 11, BP_NO_FETCH_READ_NO_DMA = 12, BP_READ_NO_DMA = 13, BP_READ_DMA = 14, BP_WRITE_DMA = 15 } |
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpAction { BP_NONE = 0, BP_BRK = 1, BP_STO = 2, BP_BRK_STO = 3 } |
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpOperat { BP_EQUAL = 0, BP_GREATER = 1, BP_LOWER = 2, BP_UNEQUAL = 3 } |
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpRangeAction { BP_INSIDE = 0, BP_OUTSIDE = 1 } |
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | BpCondition { BP_NO_COND = 0, BP_COND = 1 } |
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structure. More... | |
enum | CbControl { CB_SET = 0, CB_CLEAR = 1 } |
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetCombineBreakpoint(). More... | |
enum | TrControl { TR_ENABLE = 0, TR_DISABLE = 1, TR_RESET = 2 } |
Trace: Control. More... | |
enum | TrMode { TR_HISTORY = 0, TR_FUTURE = 1, TR_SHOT = 2, TR_COLLECT = 3 } |
Trace: Mode. More... | |
enum | TrAction { TR_FETCH = 0, TR_ALL_CYCLE = 1 } |
Trace: Action (ignored for collect data mode). More... | |
enum | VwEnable { VW_ENABLE = 0, VW_DISABLE = 1 } |
Variable watch: Enable. More... | |
enum | VwControl { VW_SET = 0, VW_CLEAR = 1 } |
Variable watch: Control. More... | |
enum | VwDataType { VW_8 = 0, VW_16 = 1, VW_32 = 2 } |
Variable watch: Data type of the variable (ignored for VW_CLEAR). More... | |
enum | CcControl { CC_DISABLE = 0, CC_ENABLE = 1 } |
Clock control: Extended emulation. More... | |
enum | CcModule { CC_ALLRUN = 0, CC_WDT = (1 << 1), CC_TIMER_A = (1 << 2), CC_TIMER_B = (1 << 3), CC_BASIC_TIMER = (1 << 4), CC_LCD_FREQ = (1 << 5), CC_TIMER_COUNTER = (1 << 6), CC_TIMER_PORT = (1 << 7), CC_USART0 = (1 << 8), CC_USART1 = (1 << 9), CC_FLASH_CNTRL = (1 << 10), CC_ADC = (1 << 11), CC_ACLK = (1 << 12), CC_SMCLK = (1 << 13), CC_MCLK = (1 << 14) } |
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock control, else ignored). More... | |
enum | CcGeneralCLK { CC_STP_NONE = 0, CC_STP_ACLK = (1 << 1), CC_STP_SMCLK = (1 << 2), CC_STP_MCLK = (1 << 3), CC_STP_TACLK = (1 << 5) } |
Clock control: Switch general clock off (logic AND operation). More... | |
enum | SeqControl { SEQ_DISABLE = 0, SEQ_ENABLE = 1 } |
Sequencer: Control. More... | |
enum | SeqState { SEQ_STATE0 = 0, SEQ_STATE1 = 1, SEQ_STATE2 = 2, SEQ_STATE3 = 3 } |
Sequencer: Select next state when selected trigger occurs. More... | |
Functions | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_Init (MSP430_EVENTNOTIFY_FUNC callback, LONG clientHandle, MessageID_t *pMsgIdBuffer) |
Initialisation to enable and use the functionality of the Enhanced Emulation Module (EEM). This function resets and intitializes the EEM. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetBreakpoint (WORD *pwBpHandle, BpParameter_t *pBpBuffer) |
This function is used to set, modify or clear breakpoints. A breakpoint handle is returned via the pointer pBpHandle. Is a cleared or modified breakpoint combined the combinations are updated and a warning message with the warning code and the combination handle will be sent. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_GetBreakpoint (WORD wBpHandle, BpParameter_t *pBpDestBuffer) |
This function reads back the settings of a breakpoint. No change or other action on the breakpoint is performed. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetCombineBreakpoint (CbControl_t CbControl, WORD wCount, WORD *pwCbHandle, WORD *pawBpHandle) |
This function sets or clears combinations of breakpoints. The parameter wCount includes the number of breakpoints to combine or clear. The breakpoint handles are delivered via the pointer pwBpHandle. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_GetCombineBreakpoint (WORD wCbHandle, WORD *pwCount, WORD *pawBpHandle) |
This function reads back the number and list of combined breakpoints. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetTrace (TrParameter_t *pTrBuffer) |
This function configures the EEM state storage feature to trace the selected information into the internal Trace buffer which has a depth of 8x40 bit (F449). | |
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 the trace is performed. | |
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 trace is performed. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_ReadTraceData (TraceBuffer_t *pTraceBuffer, ULONG *pulCount) |
This function reads the content of the Trace Buffer of the EEM. No change or other action on the trace is performed. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_RefreshTraceBuffer (void) |
This function refreshes the content of the Trace Buffer of the EEM. No change or other action on the trace is performed. | |
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. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetVariable (WORD *pVwHandle, VwParameter_t *pVwBuffer) |
This function sets one variable to watch. | |
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. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetClockControl (CcParameter_t *pCcBuffer) |
This function configures the Clock Control settings of the EEM at emulation stop. It is possible to control the general clock signals (MCLK, SMCLK, ACLK) and the clock signals on extern pins. For devices with the extended clock control it is possible to control the clock for each module. | |
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 is performed. | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_EEM_SetSequencer (SeqParameter_t *pSeqBuffer) |
This function will be used to configure the trigger sequencer feature. When disabling the sequencer all further parameters will be ignored. For each state two of four different sequencer triggers can be set as condition to switch to two selectable states. To select no trigger provide zero as handle. The action trigger must be provided. | |
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 the sequencer is performed. | |
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. |
|
Event message identification structure: This structure contains the message identifications for the different event messages sent by the DLL. Events are sent by the DLL to inform the caller of a change of state (e.g. breakpoint hit) or to provide data to the caller The type MessageID_t enables the caller of the function MSP430_EEM_Init(LONG lhWnd, MessageID_t* pMsgIdBuffer) to set dedicated message IDs for the different events. Using Windows user events normaly start at WM_USER (please refer to MSDN help).
|
|
WarCode_t contains the warning codes that are sent as an event.
|
|
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure. The following table shows the relation of the access mode to the signals Fetch, R/W and DMA.
|
|
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT structure.
|
|
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structure.
|
|
The breakpoint structure contains the settings which are required to set, modify or clear a breakpoint. The type BpParameter_t is used as a source parameter to the function MSP430_EEM_SetBreakpoint(WORD* pwBpHandle, BpParameter_t* pBpBuffer) and as a destination parameter to the function MSP430_EEM_GetBreakpoint(WORD wBpHandle, BpParameter_t* pBpDestBuffer).
|
|
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetCombineBreakpoint().
|
|
Trace: Control.
|
|
Trace: Mode.
|
|
Trace: Action (ignored for collect data mode).
|
|
Trace parameter structure: The data structure contains the configuration settings of the EEM trace function. The type TrParameter_t is used by the functions:
|
|
Trace buffer readout structure: The data structure is a copy of one position of the hardware trace buffer. They consist of data in a 40 bit buffer. The 40 bits are divided in 16 bit MAB, 16 bit MDB and 8 bit control signals. The type TraceBuffer_t is used by the function:
|
|
Variable watch: Enable.
|
|
Variable watch: Control.
|
|
Variable watch: Data type of the variable (ignored for VW_CLEAR).
|
|
Variable watch parameter structure: The data structure contains the settings of one variable. The type VwParameter_t is used by the function:
|
|
Variable watch resource structure: The data structure contains the resources of one variable trigger. The type VwResources_t is used as a array of 8 by the function:
|
|
Clock control: Extended emulation.
|
|
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock control, else ignored).
|
|
Clock control: Switch general clock off (logic AND operation).
|
|
Clock control parameter structure: The data structure contains the settings of the clock control features. The type CcParameter_t is used by the functions:
|
|
Sequencer: Control.
|
|
Sequencer: Select next state when selected trigger occurs.
|
|
Sequencer parameter structure: The data structure contains the configuration settings of the sequencer. To select no trigger provide zero as handle. The type SeqParameter_t is used by the functions:
|
|
Type definition for a callback function which must be available in the application which calls the MSP430.dll. The callback function handles notify events which are sent from the DLL to the calling application. A handle to the callback function is passed to the DLL by calling MSP430_EEM_Init().
|
|
|
BpMode_t gives the supported modes for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpType_t gives the supported types for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpAccess_t gives the supported access modes for a breakpoint. Used inside the BREAKPOINT structure. The following table shows the relation of the access mode to the signals Fetch, R/W and DMA.
|
|
BpAction_t gives the supported actions for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpOperat_t gives the supported comparison operators for a breakpoint. Used inside the BREAKPOINT structure.
|
|
BpRangeAction_t gives the supported range control for a range breakpoint. Used inside the BREAKPOINT structure.
|
|
BpCondition_t gives the exist condition for a complex breakpoint. Used inside the BREAKPOINT structure.
|
|
CbControl_t gives the supported control options for a combined breakpoint. Used in MSP430_EEM_SetCombineBreakpoint().
|
|
Trace: Control.
|
|
Trace: Mode.
|
|
Trace: Action (ignored for collect data mode).
|
|
Variable watch: Enable.
|
|
Variable watch: Control.
|
|
Variable watch: Data type of the variable (ignored for VW_CLEAR).
|
|
Clock control: Extended emulation.
|
|
Clock control: Clock for selected modules switch off (logic AND operation) (only for extended clock control, else ignored).
|
|
Clock control: Switch general clock off (logic AND operation).
|
|
Sequencer: Control.
|
|
Sequencer: Select next state when selected trigger occurs.
|
|
Initialisation to enable and use the functionality of the Enhanced Emulation Module (EEM). This function resets and intitializes the EEM.
|
|
This function is used to set, modify or clear breakpoints. A breakpoint handle is returned via the pointer pBpHandle. Is a cleared or modified breakpoint combined the combinations are updated and a warning message with the warning code and the combination handle will be sent.
|
|
This function reads back the settings of a breakpoint. No change or other action on the breakpoint is performed.
|
|
This function sets or clears combinations of breakpoints. The parameter wCount includes the number of breakpoints to combine or clear. The breakpoint handles are delivered via the pointer pwBpHandle.
|
|
This function reads back the number and list of combined breakpoints.
|
|
This function configures the EEM state storage feature to trace the selected information into the internal Trace buffer which has a depth of 8x40 bit (F449).
|
|
This function reads back the settings of a Trace Configuration Register. No change or other action on the trace is performed.
|
|
This function reads the content of the Trace Buffer of the EEM. No change or other action on the trace is performed.
|
|
This function reads the content of the Trace Buffer of the EEM. No change or other action on the trace is performed.
|
|
This function refreshes the content of the Trace Buffer of the EEM. No change or other action on the trace is performed.
|
|
This function configures the EEM State Storage Module to work as a Real Time Monitor for a variable.
|
|
This function sets one variable to watch.
|
|
This function reads back the settings and the resources of the variable watch configuration.
|
|
This function configures the Clock Control settings of the EEM at emulation stop. It is possible to control the general clock signals (MCLK, SMCLK, ACLK) and the clock signals on extern pins. For devices with the extended clock control it is possible to control the clock for each module.
|
|
This function reads back the settings of the clock control. No change or other action on the settings is performed.
|
|
This function will be used to configure the trigger sequencer feature. When disabling the sequencer all further parameters will be ignored. For each state two of four different sequencer triggers can be set as condition to switch to two selectable states. To select no trigger provide zero as handle. The action trigger must be provided.
|
|
This function reads back the settings of the sequencer configuration. No change or other action on the sequencer is performed.
|
|
Read out the state of the sequencer and store the result in the passed destination buffer.
|