Dwest at 13:27, 29 June 2012

2012-06-29T13:27:09Z

Tfriez at 14:48, 14 May 2012

2012-05-14T14:48:15Z

Bfeher at 20:48, 11 May 2012

2012-05-11T20:48:19Z

Bfeher at 20:39, 11 May 2012

2012-05-11T20:39:44Z

Bfeher: Created page with "{{DISPLAYTITLE:328 Debug}} ARDUINO_MEGA_Functions_and_Variables|Functions and Variables
The debugger in ROBOTC al..."

2012-05-11T20:35:28Z

Created page with "{{DISPLAYTITLE:328 Debug}} <yambe:breadcrumb self="328 Debug">ARDUINO_MEGA_Functions_and_Variables|Functions and Variables</yambe:breadcrumb> The debugger in ROBOTC al..."

New page

{{DISPLAYTITLE:328 Debug}}
<yambe:breadcrumb self="328 Debug">ARDUINO_MEGA_Functions_and_Variables|Functions and Variables</yambe:breadcrumb>
 

The debugger in ROBOTC allows you to see all of your sensor, motor and variables while running your program. ROBOTC also has a debug terminal called the "Debug Stream" that you can use to output a terminal-like stream of information to have an additional way to monitor your program.

The debug stream is buffered directly in memory on the Arduino platform - You can store 300 bytes of debug stream data on the Arduino when running away from the PC. Once the Arduino is connected to the PC, you can open the debug stream and the entire buffer will be written to the "Debug Stream" debugger window.

You can open this debugger window from the "Robot -> Debugger Windows -> Debug Stream" window when in Expert or Super User mode.

[[File:DebugStream.png]]
{{tl|1|1}}
 

== writeDebugStream ==
{| style="color:black;" width="100%" cellpadding="5%" cellspacing="0" border="0"
|-
| class="functionType"| void writeDebugStream(const string sFormatString, ...)
|-
| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;"|([[Data_Types#dataType_void|void]]) The Debug Stream functionality allow the user to output formatted text to a debug terminal. This command works similar to a print to LCD command, but displays the information to the "Debug Stream" ROBOTC debugger window.
|-
|
{| class="parameterTable" cellpadding="5%" width="100%"
! width="20%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Parameter
! width="60%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Explanation
! width="20%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Data Type
|-
| style="border-style: solid; border-width: 1px 0px 1px 0px"|''sFormatString''
| style="border-style: solid; border-width: 1px 0px 1px 0px"|A formatted string following standard C-Style convention for showing data inline.
| style="border-style: solid; border-width: 1px 0px 1px 0px"|[[Data_Types#dataType_void|void]]
|-
|}
|-
|
{|
|-
|<syntaxhighlight lang="robotc">
int fooBarVar = 503; //Create a Variable to Display
writeDebugStream("Value: %d", fooBarVar); //Write the string "Value: 503" to the Debug Stream
</syntaxhighlight>
|-
|}
|-
|}
 

== writeDebugStreamLine ==
{| style="color:black;" width="100%" cellpadding="5%" cellspacing="0" border="0"
|-
| class="functionType"| void writeDebugStreamLine(const string sFormatString, ...)
|-
| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;"|([[Data_Types#dataType_void|void]]) The Debug Stream functionality allow the user to output formatted text to a debug terminal. This command works similar to a print to LCD command, but displays the information to the "Debug Stream" ROBOTC debugger window.

The only difference between this function and "writeDebugStream" is that a new line character is added after every call of "writeDebugStreamLine".
|-
|
{| class="parameterTable" cellpadding="5%" width="100%"
! width="20%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Parameter
! width="60%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Explanation
! width="20%" style="border-style: solid; border-width: 0px 0px 1px 0px"|Data Type
|-
| style="border-style: solid; border-width: 1px 0px 1px 0px"|''sFormatString''
| style="border-style: solid; border-width: 1px 0px 1px 0px"|A formatted string following standard C-Style convention for showing data inline.
| style="border-style: solid; border-width: 1px 0px 1px 0px"|[[Data_Types#dataType_void|void]]
|-
|}
|-
|
{|
|-
|<syntaxhighlight lang="robotc">
int fooBarVar = 503; //Create a Variable to Display
writeDebugStream("Value: %d", fooBarVar); //Write the string "Value: 503" to the Debug Stream
</syntaxhighlight>
|-
|}
|-
|}
 

== getAvailSpaceInDebugStream ==
{| style="color:black;" width="100%" cellpadding="5%" cellspacing="0" border="0"
|-
| class="variableType"| intrinsic short getAvailSpaceInDebugStream()
|-
| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;"|([[Data_Types#dataType_short|short]]) Variable will return the current amount of space available in the debug stream. For the Arduino platform, the maximum size of the debug stream is 300 bytes.
|-
|
{|
|-
|<syntaxhighlight lang="robotc">
while(true)
{
if(getAvailSpaceInDebugStream() == 0) //Check if there is still room available
wait1Msec(50); //No Room: Wait for a while.
else
writeDebugStream("Still Have Room!", fooBarVar); //Got room, let's write some data!
}
</syntaxhighlight>
|-
|}
|-
|}
 

== bFloatConversionErrors ==
{| style="color:black;" width="100%" cellpadding="5%" cellspacing="0" border="0"
|-
| class="variableType"| intrinsic bool bFloatConversionErrors
|-
| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;"|([[Data_Types#dataType_bool|bool]]) When true, this variable will generate an exception if an out of range error occurs when converting a "float" value to an integer. ROBOTC will convert out of range exceptions into the largest possible integer number.
|-
|}

@@ Line 3: / Line 3: @@
 <br />
-'''Due to the Arduino Uno only have 32kb of space, ROBOTC is not able to support String variables or Debug Stream (which requires Strings) on the Arduino Uno platform. Hopefully we can make this enhancement in a future version'''
+'''Due to the Arduino Uno only having 32kb of space, ROBOTC is not able to support String variables or Debug Stream (which requires Strings) on the Arduino Uno platform. Hopefully we can make this enhancement in a future version.'''
 ----

@@ Line 2: / Line 2: @@
 <yambe:breadcrumb self="328 Debug">ARDUINO_328_Functions_and_Variables|Functions and Variables</yambe:breadcrumb>
 <br />
 The debugger in ROBOTC allows you to see all of your sensor, motor and variables while running your program. ROBOTC also has a debug terminal called the "Debug Stream" that you can use to output a terminal-like stream of information to have an additional way to monitor your program.

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE:328 Debug}}
+{{DISPLAYTITLE:328 Debug Functions}}
 <yambe:breadcrumb self="328 Debug">ARDUINO_328_Functions_and_Variables|Functions and Variables</yambe:breadcrumb>
 <br />

ARDUINO 328 Functions Debug - Revision history

Dwest at 13:27, 29 June 2012

Tfriez at 14:48, 14 May 2012

Bfeher at 20:48, 11 May 2012

Bfeher at 20:39, 11 May 2012

Bfeher: Created page with "{{DISPLAYTITLE:328 Debug}} ARDUINO_MEGA_Functions_and_Variables|Functions and Variables The debugger in ROBOTC al..."

Bfeher: Created page with "{{DISPLAYTITLE:328 Debug}} ARDUINO_MEGA_Functions_and_Variables|Functions and Variables
The debugger in ROBOTC al..."