SourcePoint AMD Help
Table of Contents
- Using Help
- Contacting ASSET InterTech
- Introduction to SourcePoint
- SourcePoint Environment
- SourcePoint Overview
- SourcePoint Parent Window Introduction
- SourcePoint Icon Toolbar
- File Menu
- File Menu - Project Menu Item
- File Menu - Layout Menu Item
- File Menu - Program Menu Item
- File Menu - Macro Menu Item
- File Menu - Print Menu Items
- File Menu - Update Emulator Flash Menu Item
- File Menu - Program Target Device Menu Item
- File Menu - Other Menu Items
- Edit Menu
- View Menu
- Processor Menu
- Options Menu
- Options Menu - Preferences Menu Item
- Options Menu - Target Configuration Menu Item
- Options Menu - Load Target Configuration File Menu Item
- Options Menu - Save Target Configuration File Menu Item
- Options Menu - Emulator Configuration Menu Item
- Options Menu - Emulator Connection Menu Item
- Options Menu - Emulator Reset Menu Item
- Options Menu - Confidence Tests Menu Item
- Window Menu
- Help Menu
- How To -- SourcePoint Environment
- Add Emulator Connections
- Configure Custom Macro Icons
- Configure Autoloading Macros
- Display Text on the Icon Toolbar
- Edit Icon Groups to Customize Your Toolbars
- Modify a Defined Memory Region
- Refresh SourcePoint Windows
- Save a Program
- Start SourcePoint With Command Line Arguments
- Use the New Project Wizard
- Verify Emulator Network Connections
- SourcePoint Overview
- Breakpoints Window
- Code Window
- Command Window
- Command Window Overview
- Confidence Tests Window
- Descriptors Tables Window
- Devices Window
- Log Window
- Memory Window
- Page Translation Window
- Page Translation Windows Overview
- PCI Devices Window
- PCI Devices Window Overview
- How To - PCI Devices Window
- Registers Window
- Symbols Windows
- Viewpoint Window
- Watch Window
- Technical Notes
- SourcePoint Command Language
- Commands and Control Variables
- bell (beep)
- Character Functions
- cpubreak commands
- dbgbreak commands
- do while
- execution point ($)
- list, nolist
- log, nolog
- Memory Access
- print cycles
- Register Access
- softbreak, softremove, softdisable, softenable
- string [ ] (index into string)
- taskbreak, taskremove, taskdisable, taskenable
Command Window Introduction
The Command window provides a command line interface to SourcePoint. Commands may be typed one at a time, or multiple commands can be executed from a command file.
The Command window displays a history of previously executed commands and their responses.
This section describes the Command window itself. For a detailed description of the SourcePoint command language, refer to SourcePoint Command Language in the Table of Contents.
The Command Window
To open the Command window, select View | Command on the menu bar or click the Command window icon on the toolbar.
Commands are entered at the prompt. In single processor systems the prompt is the ’>’ character. In multi-processor systems the prompt is the current viewpoint processor name followed by the ’>’ character (e.g., P0>).
To execute a new command, type the command at the prompt and press Enter. If the command generates a response (e.g., a memory read operation) it will be displayed on the next line.
Commands are colored black, response data is colored blue, and errors are colored red. These colors can be changed by selecting Options | Preferences | Color.
The Command window displays a history of previously executed commands and their responses. There are two ways to execute a previously executed command:
Scroll to the command, left click anywhere in it, and press Enter.
While at the command prompt, use the up and down arrow keys to scroll through the command history. Pressing Enter will re-execute the displayed command.
Previously executed commands can also be edited to create new commands. Simply find the command, edit it, and press Enter. Command responses are not editable.
The Command window history can be cleared by selecting Clear Command Window from the context menu.
Following is a list of keys that can be used for editing or recalling commands.
At the command prompt moves back one command in the command history. Anywhere else in the window, moves the caret up one line.
At the command prompt moves ahead one command in the command history. Anywhere else in the window, moves the caret down one line.
At the command prompt recalls the oldest command in the command history. Anywhere else in the window, scrolls back one page.
At the command prompt recalls the newest command in the command history. Anywhere else in the window, scrolls forward one page.
Move one character to the right.
Move one character to the left
Move one word to the right
Move one word to the left
Move to the beginning of the current command
Move to the end of the current command
Move to the beginning of the Command window
Move to the end of the Command window
Erases the current command
Execute the current command
Erase the character prior to the caret
Erase the character at the caret
Copy the currently selected text to the clipboard
Delete the currently selected text and copy it to the clipboard
Paste the contents of the clipboard at the caret location
Exit line continuation mode, or cancel a currently running command file
Line continuation means that a command spans multiple lines. When in line continuation mode the prompt shows ’>>’ rather than ’>’. There are two types of line continuation:
When SourcePoint detects that a partial command has been entered, it will automatically enter line continuation mode (e.g., typing if (x), and then pressing Enter). As additional lines are typed, SourcePoint will determine if the command is complete, and then will automatically exit line continuation mode, and execute the command.
Typing ’\’ at the end of a line will force SourcePoint into line continuation mode. This is rarely used while typing commands, but is useful for long printf statements in command files.
Line continuation mode can be forced off by pressing Ctrl+Break.
Entering Multiple Commands as a Single Command
Multiple commands can be entered as a single command by using ’;’ as a delimiter (e.g., stop; ord4 0x1000; go).
Copy / Paste
The Command window supports cut, copy, and paste operations. These operations can be selected from the Edit menu, the Command window context menu, or by pressing Ctrl+X, Ctrl+C or Ctrl+V.
Text can be selected by left clicking and moving the mouse, or by double left clicking to select a word.
Pasting a command into the Command window causes it to be executed immediately. Pasting multiple commands executes all of the commands immediately.
Drag / Drop
The Command window supports two types of drag and drop operations:
If a command file is dragged from Windows Explorer, and dropped into the Command window, SourcePoint will execute the command file.
If a program file is dragged from Windows Explorer, and dropped into the Command window, SourcePoint will load the file as if the Load command had been used.
Command files are text files containing multiple commands. Creating command files helps to automate oft-repeated operations. Command files are also referred to as macro files, script files and include files. There are several ways to execute a command file:
Use the include command in the Command window (see Commands manual).
Drag and drop a command file from Windows Explorer to the Command window.
Select File | Macro | Load Macro from the main menu.
Select File | Macro | Configure Macros to attach a command file to a user-defined toolbar button, and then press the button.
Select File | Macro | Configure Macros to attach a command file to an event. Examples of events include: go, stop, project load, power cycle, etc. When the event occurs the macro will automatically execute.
Define a breakpoint and specify a command file to execute when the breakpoint hits.
Recently executed macro files are shown in File | Recent Macros. Selecting a command file from this list will re-execute the file. Breakpoint and event macros are excluded from this list.
When a command file is executing, the name of the file is shown in the SourcePoint Status bar (at the bottom of the SourcePoint window).
Aborting a Command File
Press Ctrl+Break to terminate a running command file.
Logging Commands and Responses to a File
There are two other ways to copy Command window commands and responses to a text file:
Use the mouse to select text in the Command window and then paste it into a text editor.
Select File | Save As from the main menu to save all or a portion of the Command window to a file.
Printing the Command Window
All or a portion of the Command window can be printed. Select File | Print from the main menu or press Ctrl+P in the Command window.
Searching the Command Window
The Command window supports searching for old commands or response data. Select Edit | Find from the main menu, or press Ctrl+F in the Command window.
Executing an Operating System Command
The Shell command is used to execute commands outside of SourcePoint. There are two ways to use the command:
Type Shell without any arguments to open an operating system command window. When the window closes, the focus switches back to the SourcePoint Command window.
Type Shell with a command to execute the command and return immediately to SourcePoint.
Refer to shell in the Commands manual for more information.
There are two ways to access help from the Command window:
Type Help or press F1 to open the SourcePoint Help window.
Type Help ”command name” to open the SourcePoint Help window with the command help topic already displayed.