Debug Console
The following content has been imported from Legacy Help systems and is in the process of being checked for accuracy.
Function
The Debug Console panel provides a history of the current debug session, in terms of the commands issued and the lines of code executed. The panel also offers command-line debugging of the embedded code.
Content and Use
As you debug the source code for the active embedded project, the panel will 'keep track' of the debug commands as you issue them and the current execution point. For example, if you issue a Step Into command from the Debug menu or toolbar, the panel will show an entry that reflects this command (> s) followed by an entry that reflects the next line of code to be executed.
As can be seen in the example image above, the entry in the panel for the next executable line of code contains:
- The name of the current function or procedure
- The line number within the active source code document on which the next executable code statement resides
- The actual code statement.
The controls at the bottom of the panel allow you to drive the debug session from within the panel. Simply enter the syntax for the command you wish to issue to the Debugger and either click the Send button or press ENTER. The following table contains example command-line entries that correspond to common debugging commands available from the Debug menu or toolbar:
Panel command-line entry | Corresponding command on Debug menu | Corresponding entry onDebug toolbar |
C | Run |
|
C n (where n = line number) | Run to Cursor |
|
s | Step Into |
|
S | Step Over |
|
si | Step Into Instruction |
|
Si | Step Over Instruction |
|
.dxp resync | Resynchronize |
|
rst | Reset |
|
In addition, the HALT button at the bottom right of the panel behaves the same way as the Break command available on the Debug menu and toolbar.
Notes
- The field in which you enter the command to be sent to the debugger supports standard text editing features such as cut, copy and paste.
- If you press ENTER to send a command, rather than clicking SEND, the command syntax will be added to the drop-down history list for the field.
- The keyboard shortcuts Up Arrow (or Left Arrow) and Down Arrow (or Right Arrow) can be used to navigate through the content of the panel. Use the HOME and END keys to jump to the first and last entry respectively.