Admin at 17:17, 8 February 2013

2013-02-08T17:17:56Z

Admin: Created page with "= Action = Instruct compiler to start or stop debugging, or print variable to serial port
2013-02-08T17:16:53Z

Created page with "= Action = Instruct compiler to start or stop debugging, or print variable to serial port <spa..."

New page
= Action =

Instruct compiler to start or stop debugging, or print variable to serial port

 

 

= Syntax =

DEBUG ON | OFF | var

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
ON

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
Enable debugging

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
OFF

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
Disable debugging

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
var

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
A variable which values must be printed to the serial port

|}
</div>
 

During development of your program a common issue is that you need to know the value of a variable.

You can use PRINT to print the value but then it will be in the application as well.

You can use conditional compilation such as :

CONST TEST=1

#IF TEST

print var

#ENDIF

 

But that will result in a lot of typing work. The DEBUG option is a combination of conditional compilation and PRINT. Whenever you activate DEBUG with the ON parameter, all 'DEBUG var' statements will be compiled.

When you turn DEBUG OFF, all 'DEBUG var' statements will not be compiled.

 

You can not nest the ON and OFF. The last statements wins.

Typical you will have only one DEBUG ON statement. And you set it to OFF when your program is working.

 

An example showing nesting is NOT supported:

DEBUG ON

DEBUG ON ' it is still ON

DEBUG OFF' it is OFF now

 

 

An example showing multiple DEBUG:

DEBUG ON

DEBUG var   ' this is printed

DEBUG var2 ' this is also printed

 

DEBUG OFF

DEBUG var3  'this is NOT printed

DEBUG var4  ' this is not printed

 

DEBUG ON    ' turn DEBUG ON

If A = 2 Then

DEBUG A ' this is printed

End If

 

 

= See also =

[[DBG]]

 

 

= ASM =

NONE

 

 

= Example =

 <source lang="bascomavr">
DEBUG ON
Dim A As Byte
DEBUG A
End
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 49: / Line 49: @@
 CONST TEST=1
-#IF TEST
+<nowiki>#</nowiki>IF TEST
 print var
-#ENDIF
+<nowiki>#</nowiki>ENDIF
 <span style="font-family: Arial;">&nbsp;</span>