File Menu - Macro Menu Item

Select the Macro menu item from the File menu to access the following options: Load Macro and Configure Macros.

Load Macro Option

Select the Load Macro option to load an existing macro file.

1.      Select the Load Macro option.

2.      A standard Open file dialog box displays.

3.      Select the desired macro by clicking on it to highlight it or browse for it.

4.      Click the Open button. The macro loads, and the Open file dialog box closes.

Configure Macros Option

Select Configure Macros to open the Configure Macros dialog. There are two types of macros: User-defined macros and Event macros. User-defined macros are macros that you create and link to the buttons in the Macro toolbar. Event macros are macros that run when a specific event occurs (e.g., target reset, project load, etc.).

User-Defined Macros Tab

 

Configure Macros dialog box

Select macro. Use this drop down list to select a user-defined macro number. Up to 20 user-defined macros can be specified.

Note: You must add the macro icons to the icon toolbar prior to adding user-defined macros 4 - 19. If you do not, the select macros drop down text box shows only Macros 0 - 3. To add macros to the toolbar, right-click on the Macro toolbar and select Customize.

Cmd/macro file. Use this box to specify the macro file to execute. Select the Browse button to find the file.  Clearing this field removes the macro definition.

Alternatively, you can specify a command to execute.  If the text entered in this box begins with a "#" character, then it is considered to be a command and is executed directly.  Multiple commands can be separated by semicolons.

Echo file to command window. Enabling this option causes the contents of the macro file to be echoed to the Command window.

Button text. By default user-defined macro buttons are labeled ”Macro 0,” "Macro 1,” etc.  This field can be used to display more descriptive text. The text is visible on the toolbar only when you choose to display both the icon and text.

Clear All. Use this button to remove all macros definitions.  

Note: User-defined macros are saved in target configuration files. See Option Menu - Save Target configuration File Menu Item in SourcePoint Environment for more information.

Event Macros Tab

Event Macros dialog box

Select event. Choose the event to link a macro with.  When the event occurs, the macro file will be executed.  See Event descriptions below.

Cmd/macro filename. Use this box to specify the macro file to execute. Select the Browse button to find the file.

Alternatively, you can specify a command to execute.  If the text entered in this box begins with a "#" character, then it is considered to be a command and is executed directly.  Multiple commands can be separated by semicolons.

Echo file to command window. Enabling this option causes the contents of the macro file to be echoed to the Command window.

Disable macro.  Enabling this option temporarily disables an event macro from running.

Clear All. Use this button to remove all macros definitions.  

Note: Event macros are saved in target configuration files. See Option Menu - Save Target configuration File Menu Item in SourcePoint Environment for more information.

 

Event	Description
Breakpoint (any)	Macro executes after any breakpoint is hit. This macro is in addition to any individual breakpoint macros that have been set.
Emulator Connected	Macro executes after SourcePoint connects to the emulator, but before target configuration occurs.
Go	Macro executes just prior to sending the Go command to the emulator.
Project Load	Macro executes immediately after loading or reloading a project.
Project Unload	Macro executes immediately after unloading a project (which includes closing SourcePoint).
Reset (before)	Macro executes just prior to sending the Reset command to the emulator.
Reset detected	Macro executes when the emulator detects a target reset initiated by either SourcePoint or the target.  If the target requires security unlocking, this event can be used to run an unlock macro.
Reset complete	Macro executes immediately after target reset has completed.
Reset (after)	Macro executes after a user-initiated reset completes.  This event does not occur if Run after reset is enabled.
Startup	Macro executes when SourcePoint starts.
Stop (user)	Macro executes after the Stop button is pressed, and the emulator signals the target has stopped
Target configure	Macro executes after target power on and before project load.  This macro provides the discover/configure functions and any custom target security unlocking procedures (when required).  See the Target Configuration Technical note for more information.
Target power on detected	Macro executes when the emulator detects a power on transition.  If the target requires security unlocking, this event can be used to run an unlock macro.
Target power on complete	Macro executes when the emulator signals that the target power cycle is complete.
Target stop	Macro executes whenever the target stops (either because of a breakpoint or the stop key being pressed). Macro executes before SourcePoint does any automatic memory or register reads to refresh state.