NU32v2: Using the Simulator - Revision history

Lynch at 11:19, 16 January 2016

2016-01-16T11:19:51Z

← Older revision		Revision as of 06:19, 16 January 2016
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 ==		== 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.		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.

Lynch: /* Introduction to the MPLAB Simulator */

2011-01-12T22:07:44Z

Introduction to the MPLAB Simulator

← Older revision		Revision as of 17:07, 12 January 2011
Line 1:		Line 1:
	== Introduction to the MPLAB Simulator ==		== 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.		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 ==		== Creating a New Project ==

Nelson Rosa: /* Working with the Debugger */

2011-01-12T05:46:48Z

Working with the Debugger

← Older revision		Revision as of 00:46, 12 January 2011
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 ===		=== 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"]].		#* 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]].		#* You should now see a [[Media:DbgRedB.png\|red circle with the letter 'B' in it]].

Nelson Rosa: /* Debugging invest.c */

2011-01-12T05:44:41Z

Debugging invest.c

← Older revision		Revision as of 00:44, 12 January 2011
Line 123:		Line 123:

	=== Debugging invest.c ===		=== 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"]].		#* 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]].		#* You should now see a [[Media:DbgRedB.png\|red circle with the letter 'B' in it]].

Nelson Rosa: /* Setting up MPLAB SIM */

2011-01-12T05:36:01Z

Setting up MPLAB SIM

← Older revision		Revision as of 00:36, 12 January 2011
Line 50:		Line 50:

	<ol>		<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">		<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>		<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>

Nelson Rosa: /* Setting up MPLAB SIM */

2011-01-12T05:16:03Z

Setting up MPLAB SIM

← Older revision		Revision as of 00:16, 12 January 2011
Line 50:		Line 50:

	<ol>		<ol>
	<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>		<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>
	<ol style="list-style-type:lower-roman">		<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>		<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>

Nelson Rosa: /* Debugging invest.c */

2011-01-12T04:58:12Z

Debugging invest.c

← Older revision		Revision as of 23:58, 11 January 2011
Line 147:		Line 147:
	# Under the column "Value", double-click the field corresponding to the value of ''valid''		# 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: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		#* this won't affect the normal execution of the program because the value is still true
	# Set another breakpoint in ''calculateGrowth(...)'' at line 175		# Set another breakpoint in ''calculateGrowth(...)'' at line 175
	# Press F9 to Run		# 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]].		#* [[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		# Press F9 twice
	#* the program has finished executing, but the debugger is still in the "Run" state		#* the program has finished executing, but the debugger is still in the "Run" state

Nelson Rosa: /* Setting up MPLAB SIM */

2011-01-12T04:24:41Z

Setting up MPLAB SIM

← Older revision		Revision as of 23:24, 11 January 2011
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>		<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>		</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>[[Media:MPLABSIMSetupStep3.png\|Go to ''Debugger->Select Tool->MPLAB SIM'']]</li>
	<li> Go to ''Debugger->Settings...'' and click on the "Uart1 IO" tab </li>		<li> Go to ''Debugger->Settings...'' and click on the "Uart1 IO" tab </li>

Nelson Rosa: /* Setting up MPLAB SIM */

2011-01-12T04:23:44Z

Setting up MPLAB SIM

← Older revision		Revision as of 23:23, 11 January 2011
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>		<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>		</ol>
	<li> ~~Launch~~ the ~~invest~~ MPLAB project, invest.mcp </li>		<li> Open the MPLAB project, for example, invest.mcp </li>
	<li>[[Media:MPLABSIMSetupStep3.png\|Go to ''Debugger->Select Tool->MPLAB SIM'']]</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>		<li> Go to ''Debugger->Settings...'' and click on the "Uart1 IO" tab </li>

Nelson Rosa: /* Setting up MPLAB SIM */

2011-01-12T04:22:41Z

Setting up MPLAB SIM

← Older revision		Revision as of 23:22, 11 January 2011
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>		<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">		<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>		</ol>
	<li> Launch the invest MPLAB project, invest.mcp </li>		<li> Launch the invest MPLAB project, invest.mcp </li>