AMX NETLINX STUDIO V2.4, Instruction Manual

Page: 108 / 200

Programming
96
NetLinx Studio (v2.4 or higher)
Master Controller Debug Options
The Watch window is displayed when Start Debugging is selected from the Debug menu (or the
Debug Watch toolbar). The Watch window is a dockable window that allows you to view and edit
the contents of variables within a compiled Axcess or NetLinx program. Also, you can control the
execution through each pass of the mainline of a compiled Axcess or NetLinx program.
Once Start Debugging has been selected, the other options in the Debug menu become available:
The following options are only needed for debugging code located on a NetLinx master controller:
Changing The Value Of A Watched Variable
Once you have entered Debug mode, you can change the name and/or value of any watched
variable, via the Value column in the Watch window:
1.
Select a watched variable in the Watch window.
2.
To change the variable's value, double-click on the desired variable's value to change the value
to an edit field, which you can modify as desired.
Debug Mode Error Messages
The most common warnings that you may get when entering Debug Mode (Debug > Start
Debugging) are:
1. No Debug Symbols:
The source code file was not compiled with debug symbols - this can usually be ignored if you're
only watching variables, but if you're getting weird behavior, recompile with "Compile with Debug
Info" enabled (in the NetLinx Compiler tab of the Preference dialog).
You will always need debug symbols for breakpoint debugging.
Start/Stop Debugging Ability to toggle the debug state of the application. There is no limitation
on then number of NetLinx variables that can be watched in the Debug
Watch windows. A maximum of 10 watch variables are allowed when
debugging an Axcess master controller.
Step Mode Enable/Disable Step mode causes the Interpreter to break after each
execution of the mainline. Watch variables are always updated after each
pass through mainline. To continue program execution while in Step
mode, you must invoke the "Step" command again.
Single Step Execute one line of a source code file at a time for a NetLinx master con-
troller or execute one pass through the mainline code for an Axcess con-
troller.
Run To continue execution after a Single Step operation or from a toggled break
point.
Run To Cursor Execute the program and break on the line of code where the cursor is
residing on the screen.
Break Stop execution of the program and highlight the line of code on the screen.
Edit Breakpoints A dialog box appears listing all the break points within the code.
Toggle Break Point Toggle a break point on the screen where the cursor is residing. A red dia-
mond appears next to the line of code to signify a break point.
Clear Break Points Clears all the break points within the source code file.