Building and Debugging Source Code
118
NetLinx Studio - Instruction Manual
13. CALL 'SEND DECIMAL TO DEBUG' (dvDEBUG,STR1[],STR2[],nLine,nMode)
dvDEBUG is the destination device for the string. It could be the local master, a virtual device on the local
system (see TN435), an IP device, serial device, etc.…
STR1 is a header sent with each line - this is a good place to use DEV_TO_STRING.
STR2 is data. All data bytes are formatted as 3 digit decimal and separated by commas. Note that a space
($20) is not added between STR1 and STR2.
nLine is the line length. This may need to be changed if a terminal with a line length other than the typical
80 characters is being used. If not, just leave it as 0 for the defaults.
If nMode is 2, nLine defaults to 80, else nLine defaults to 67 to allow 13 characters for the tic time.
nMode is the mode, if "MSG ON 2" mode is being used to set it to 2; otherwise, use 0 for the defaults.
14. CALL 'SEND INTEGER TO DEBUG' (dvDEBUG,STR1[],STR2[],nLine,nMode)
dvDEBUG is the destination device for the string. It could be the local master, a virtual device on the local
system (see TN435), an IP device, serial device, etc.…
STR1 is a header sent with each line - this is a good place to use DEV_TO_STRING.
STR2 is data. Data bytes are not formatted. Note that a space ($20) is not added between STR1 and STR2.
nLine is the line length. This may need to be changed if a terminal with a line length other than the typical
80 characters is being used. If not, just leave it as 0 for the defaults.
If nMode is 2, nLine defaults to 80, else nLine defaults to 67 to allow 13 characters for the tic time.
nMode is the mode, if "MSG ON 2" mode is being used to set it to 2; otherwise, use 0 for the defaults.
15. CALL 'SEND ITOHEX TO MASTER' (STR1[],STR2[])
SEND_STRING 0's are formatted into 67 character lines. Since the tic time sent with MSG ON mode 81(default)
and mode 3 prepends 13 characters to the string, each line fills the typical 80 character line (67 + 13 = 80).
STR1 is a header sent with each line - this is a good place to use DEV_TO_STRING.
STR2 is data. All data bytes are formatted as hex and separated by commas. Note that a space ($20) is not
added between STR1 and STR2.
16. CALL 'STRING TO DEV' (Txt[], dvDEV)
Takes ASCII string Txt[] of the form '<dev>' or '<dev>:<port>:<sys>' and stores this as a DEV. The dev
data in Txt[] can be embedded in other non-numeric characters. If Txt[] does not contain any numerals, dvDEV
will default to 0:1:0 (the local master).
In order to use these subroutines, debug.axi must be in the compile path. It is suggested that an "AXIs" folder in the
My Documents folder be created, save debug.axi there, then add that path to NetLinx Studio "Edit/Preferences/
NetLinx Compiler Options/Include Files". Then add the line:
#INCLUDE 'debug.axi'
to the source code.
"Debug.axi" and example code are attached to Tech Note #461. To access AMX Tech Notes, go to www.amx.com, log in
as a dealer and go to Tech Center > Tech Notes.
To Next Page
Loading...
Need help?
General
