NU32v2: Using the Simulator - Revision history

Lynch at 11:19, 16 January 2016

2016-01-16T11:19:51Z

2011-01-12T22:07:44Z

Introduction to the MPLAB Simulator

2011-01-12T05:46:48Z

Working with the Debugger

2011-01-12T05:44:41Z

Debugging invest.c

2011-01-12T05:36:01Z

Setting up MPLAB SIM

2011-01-12T05:16:03Z

Setting up MPLAB SIM

2011-01-12T04:58:12Z

Debugging invest.c

2011-01-12T04:24:41Z

Setting up MPLAB SIM

2011-01-12T04:23:44Z

Setting up MPLAB SIM

2011-01-12T04:22:41Z

Setting up MPLAB SIM

@@ Line 1: / Line 1: @@
+'''THIS PAGE REFERS TO A PRE-RELEASE VERSION OF THE NU32 PIC32 DEVELOPMENT BOARD.  FOR INFORMATION, SAMPLE CODE, AND VIDEOS RELATED TO THE PRODUCTION VERSION (2016 AND LATER), AND TO THE CORRESPONDING BOOK "EMBEDDED COMPUTING AND MECHATRONICS WITH THE PIC32 MICROCONTROLLER," VISIT [[NU32|THE NU32 PAGE]].'''
 == Introduction to the MPLAB Simulator ==
 The MPLAB Simulator is a debugging tool that allows you to test code without programming it onto a PIC32.  Simple debugging, such as watching the values of variables or registers, can be performed, as well as advanced features, such as simulating inputs from a UART.  This tutorial will cover the basics of setting up the MPLAB simulator and how to run code inside a debugger using a slightly modified invest.c program that we saw in class.

@@ Line 1: / Line 1: @@
 == Introduction to the MPLAB Simulator ==
 The MPLAB Simulator is a debugging tool that allows you to test code without programming it onto a PIC32.  Simple debugging, such as watching the values of variables or registers, can be performed, as well as advanced features, such as simulating inputs from a UART.  This tutorial will cover the basics of setting up the MPLAB simulator and how to run code inside a debugger using a slightly modified invest.c program that we saw in class.
+Before running through this tutorial, make sure you have the MPLAB v8.xx software installed; see [[NU32v2: Software to Install|this page]].
 == Creating a New Project ==

@@ Line 120: / Line 120: @@
-The walkthrough will use the keyboard shortcuts, but the other methods can be substituted for the shortcuts.  Before we begin, make sure that invest.c is opened, line numbers are visible, and the debugger is not running and has been reset.
+The walkthrough will use the keyboard shortcuts, but the other methods can be substituted for the shortcuts.  Before we begin, make sure that invest.c is opened, line numbers are visible, and the debugger is not running and has been reset.  If you cannot see line numbers, go to ''Edit->Properties...'', and in the '' 'C' File Types'' tab, [[Media:ShowLineNumbers.png|select ''Line Numbers'']].
 === Debugging invest.c ===
-# Set a breakpoint at line 104 in invest.c (if you cannot see the line numbers, go to ''Edit->Properties...'', and in the '' 'C' File Types'' tab, [[Media:ShowLineNumbers.png|select ''Line Numbers'']])
+# Set a breakpoint at line 104 in invest.c
 #* A breakpoint allows you to stop a program mid-execution.  You can set breakpoints at any time, even while the program is running.  To set a breakpoint, double-click the gray side-pane on the number 104 or [[Media:DbgSetBrkPt.png|right-click the line of code at line 104 and select "Set Breakpoint"]].
 #* You should now see a [[Media:DbgRedB.png|red circle with the letter 'B' in it]].

@@ Line 123: / Line 123: @@
 === Debugging invest.c ===
-# Set a breakpoint at line 104 in invest.c (if you cannot see the line numbers, go the ''Edit -> Properties...'', and in the '' 'C' File Types'' tab, [[Media:ShowLineNumbers.png|select ''Line Numbers'']])
+# Set a breakpoint at line 104 in invest.c (if you cannot see the line numbers, go to ''Edit->Properties...'', and in the '' 'C' File Types'' tab, [[Media:ShowLineNumbers.png|select ''Line Numbers'']])
 #* A breakpoint allows you to stop a program mid-execution.  You can set breakpoints at any time, even while the program is running.  To set a breakpoint, double-click the gray side-pane on the number 104 or [[Media:DbgSetBrkPt.png|right-click the line of code at line 104 and select "Set Breakpoint"]].
 #* You should now see a [[Media:DbgRedB.png|red circle with the letter 'B' in it]].

@@ Line 50: / Line 50: @@
 <ol>
-<li> Either complete [[#Creating a New Project|Creating a New Project]] or download and unzip [[Media:MPLAB SIM Example_v2.zip|MPLAB_SIM_Example_v2.zip]] </li>
+<li> Either complete [[#Creating a New Project|Creating a New Project]] or download and unzip [[Media:MplabSimExample.zip|MplabSimExample.zip]] </li>
 <ol style="list-style-type:lower-roman">
   <li> with the latter option, verify that the following 4 files are in the folder: invest.c, pic32_additions.c, pic32_additions.h, and invest.mcp</li>

@@ Line 147: / Line 147: @@
 # Under the column "Value", double-click the field corresponding to the value of ''valid''
 #* [[Media:DbgChangeValidFrom1.png|You should now be able to enter text]]
-# [[Media:DbgChangeValidTo782.png|Change the value of valid from 1 to 782 and then press your enter key]].
+# [[Media:DbgChangeValidTo333.png|Change the value of valid from 1 to 333 and then press your enter key]].
 #* this won't affect the normal execution of the program because the value is still true
 # Set another breakpoint in ''calculateGrowth(...)'' at line 175
 # Press F9 to Run
 #* [[Media:DbgHaltCalculateGrowth.png|now you've skipped over a bunch of lines and stopped at the next breakpoint in the program]].
-#* depending on the update rate of your Outputs window, you might be able to see that the ouput "Valid inputs?  782" has made its way onto the screen.  We know from previous runs that the value is normally 1.
+#* depending on the update rate of your Outputs window, you might be able to see that the ouput "Valid inputs?  333" has made its way onto the screen.  We know from previous runs that the value is normally 1.
 # Press F9 twice
 #* the program has finished executing, but the debugger is still in the "Run" state

@@ Line 54: / Line 54: @@
   <li> with the latter option, verify that the following 4 files are in the folder: invest.c, pic32_additions.c, pic32_additions.h, and invest.mcp</li>
 </ol>
-<li> Open the MPLAB project, for example, invest.mcp </li>
+<li> Open the .mcp MPLAB project, for example, invest.mcp </li>
 <li>[[Media:MPLABSIMSetupStep3.png|Go to ''Debugger->Select Tool->MPLAB SIM'']]</li>
 <li> Go to ''Debugger->Settings...'' and click on the "Uart1 IO" tab </li>

@@ Line 52: / Line 52: @@
 <li> Either complete [[#Creating a New Project|Creating a New Project]] or download and unzip [[Media:MPLAB SIM Example.zip|MPLAB_SIM_Example.zip]] </li>
 <ol style="list-style-type:lower-roman">
-  <li> verify that the following 4 files are in the folder: invest.c, pic32_additions.c, pic32_additions.h, and invest.mcp</li>
+  <li> with the latter option, verify that the following 4 files are in the folder: invest.c, pic32_additions.c, pic32_additions.h, and invest.mcp</li>
 </ol>
 <li> Launch the invest MPLAB project, invest.mcp </li>