Difference between revisions of "NU32v2: Software to Install"

From Mech
Jump to navigationJump to search
 
(32 intermediate revisions by 3 users not shown)
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]].'''
'''**THIS PAGE IS UNDER CONSTRUCTION AND IS NOT COMPLETE**'''


'''**NDM 12/27/2010**'''


In addition to Matlab, the software below is necessary or useful to use with your PIC32 board.
== MPLABv8.63 ==

This is the latest version (as of Dec 2010) and will work on Windows only.
== Processing ==
Download and install [http://www.processing.org/download/ Processing], free software that will allow you to develop GUIs and communicate with your PIC microcontroller. (Make sure you download the Windows version, so you can program your PIC and interact with it through Processing under the same OS.)

== FTDI Serial Communication Drivers ==
Download and install the '''"setup executable"''' version (second row, right column in table) of the [http://www.ftdichip.com/Drivers/VCP.htm FTDI drivers] to allow your PC to communicate with your microcontroller through a serial port. (You can ignore the bug fix release.)

== PuTTY Terminal Emulator ==
Download and save [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY], a free terminal program (putty.exe) that will allow you to communicate with your microcontroller through the serial port. (You don't need to run PuTTY now, and can click "Cancel" if you happen to run it.)

== Serial Bootloader for NU32v2 PC Application ==
Download, save and unzip [[Media:NU32v2_Serial_Bootloader.zip|the Serial Bootloader for NU32v2]]. '''New for Feb 14 2011- Should crash less. Email Nick if you repeatedly get Error # in the message area.''' Inside of this folder is NU32v2_serial_bootloader.exe. This program is used to put code that you have compiled onto your NU32v2. It must remain in a folder with the folders called "lib" and "source", and rxtxSerial.dll. You will use this program very often, so it may be helpful to make a shortcut on your desktop, adding it to your quick launch bar, or adding it to the Start menu. This can be done by right-clicking the .exe and selecting "Pin to Start Menu", "Add to Quick Launch", or "Create Shortcut".

NU32v2_serial_bootloader.exe requires that Java be installed on your computer. Usually you will already have Java installed, but if you try to run the .exe and get an error related to Java, then go to [http://www.java.com/en/download/index.jsp the Java download page], download and install Java and try again.

To learn more about the bootloader code installed on your NU32v2, how NU32v2_serial_bootloader.exe works, or get the source code for either, take a look at [[NU32v2: A Detailed Look at Programming the PIC32]].

== MPLAB v8.63 ==
This software will allow you to program your PIC microcontroller. This is the latest version (as of Jan 2011) and will work on Windows only.

Go to [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en019469&part=SW007002 the Microchip IDE download page] and download MPLAB IDE v8.63. Extract MPLAB_IDE_v8_63.zip and run setup.exe. Accept the licensing conditions and do a '''Complete''' installation in the default location. You do not have to install HI-TECH C (a pop-up at the end of the MPLAB installation process). You may be asked to restart your computer after installation completes.

'''Note''': This will also install the C32 compiler. In December of 2010, you downloaded two separate files: the IDE and the C32 compiler. Now you just need to download the IDE and do a '''complete''' install.

If you've already installed the MPLAB IDE but don't have the C32 Toolsuite option when you make a new project, follow the instructions above to do a complete new install.


== MPLAB X Beta ==
== MPLAB X Beta ==
This is the cross-platform version of MPLAB (will work on MAC/Windows/Linux, based on NetBeans) but is still in Beta.
This is the cross-platform version of MPLAB (will work on MAC/Windows/Linux, based on NetBeans) but is still in Beta as of January 2011, and has some bugs. It will not be used in ME 333 in Winter 2011, unless you want to experiment with it.


To download and install MPLAB X Beta, go to the [http://ww1.microchip.com/downloads/mplab/X_Beta/index.html MPLAB X page.]
To download and install MPLAB X Beta, go to the [http://www.microchip.com/en_US/family/mplabx/index.html MPLAB X page.] Click Download on the upper left.
[[Image:mplabx_downloadpage_1.jpg|thumb|200px|MPLAB X Beta page.|center]]
[[Image:mplabx_downloadpage_1.jpg|thumb|200px|MPLAB X Beta page.|center]]


Line 19: Line 42:
Select your platform, the MPLAB X IDE, and the MPLAB C32 Lite Compiler for PIC32 MCUs and click Download Now.
Select your platform, the MPLAB X IDE, and the MPLAB C32 Lite Compiler for PIC32 MCUs and click Download Now.
[[Image:mplabx_downloadpage_3.jpg|thumb|200px|MPLAB X download.|center]]
[[Image:mplabx_downloadpage_3.jpg|thumb|200px|MPLAB X download.|center]]


When the downloads are complete, run mplabxidebeta.exe on Windows, or MPLABX-betaxxxx.dmg on Mac OSX to get to the MPLABX installer. Follow the instructions to install the program on your computer in the default location. On a Mac, it will install in Applications/microchip.

Now run mplabc32.exe on Windows, or the mplabc32 installer on Mac OSX. Follow the instructions to install the compiler on your computer in the default location.

You are now ready to write code to run on the PIC32.

'''Some mac-specific instructions:'''

I use a mac, and the first time I tried to run mplab_ide, I got the error

Java 6 Standard Edition or newer required
Cannot run on older versions of Java than Java 6 Standard Edition. Please install Java 6 Standard Edition or newer or use --jdkhome switch to point to its installation directory.

To fix this, go to Applications/Utilities and open Java Preferences. Under the General tab, you'll see different versions of Java. Java applications go down this list and use the first checked version that is compatible with the application. For me, the checked versions were

J2SE 5.0 32-bit

Java SE 6 64-bit

J2SE 5.0 64-bit

in that order. I just clicked on Java SE 6 and dragged it to the top of the list and closed the window. Then MPLAB finds this version first and runs just fine. If you don't have Java 6 on your list, you need to update your software. One way to do this is by going to Apple>Software Update.

Now you should be able to run mplab_ide, which we will use as our C project development environment. But I was unable to "build" any projects at first. According to Microchip: "On the Mac it is a requirement to install the Mac XTools developers Studio that comes with the shipped CD. This contains the 'make' utility which is used to build ALL embedded projects under MPLAB X." I was unable to compile programs with the MPLAB IDE because I didn't have xtools installed (it is not installed by default on your mac, so if you're not sure if you have it, you probably don't).

To get xtools (if you don't have it already), you can register with Apple as a developer. Go to

[http://developer.apple.com/programs/start/register/create.php http://developer.apple.com/programs/start/register/create.php]

and choose the free option (don't pay $99!). After you've registered, you can go to the Mac Dev Center and download Xcode 3.2.5 if you are running Mac OSX 10.6.x (this is big, > 3 GB!). If, like me, you're running Mac OSX 10.5.8, you should download the older xcode 3.1.4 (less than 1 GB). I found it at

[http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wo/5.1.17.2.1.3.3.1.0.1.1.0.3.3.3.3.1 http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wo/5.1.17.2.1.3.3.1.0.1.1.0.3.3.3.3.1]

about 1/3 of the way down the page (search for 3.1.4).

Latest revision as of 06:25, 16 January 2016

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 THE NU32 PAGE.


In addition to Matlab, the software below is necessary or useful to use with your PIC32 board.

Processing

Download and install Processing, free software that will allow you to develop GUIs and communicate with your PIC microcontroller. (Make sure you download the Windows version, so you can program your PIC and interact with it through Processing under the same OS.)

FTDI Serial Communication Drivers

Download and install the "setup executable" version (second row, right column in table) of the FTDI drivers to allow your PC to communicate with your microcontroller through a serial port. (You can ignore the bug fix release.)

PuTTY Terminal Emulator

Download and save PuTTY, a free terminal program (putty.exe) that will allow you to communicate with your microcontroller through the serial port. (You don't need to run PuTTY now, and can click "Cancel" if you happen to run it.)

Serial Bootloader for NU32v2 PC Application

Download, save and unzip the Serial Bootloader for NU32v2. New for Feb 14 2011- Should crash less. Email Nick if you repeatedly get Error # in the message area. Inside of this folder is NU32v2_serial_bootloader.exe. This program is used to put code that you have compiled onto your NU32v2. It must remain in a folder with the folders called "lib" and "source", and rxtxSerial.dll. You will use this program very often, so it may be helpful to make a shortcut on your desktop, adding it to your quick launch bar, or adding it to the Start menu. This can be done by right-clicking the .exe and selecting "Pin to Start Menu", "Add to Quick Launch", or "Create Shortcut".

NU32v2_serial_bootloader.exe requires that Java be installed on your computer. Usually you will already have Java installed, but if you try to run the .exe and get an error related to Java, then go to the Java download page, download and install Java and try again.

To learn more about the bootloader code installed on your NU32v2, how NU32v2_serial_bootloader.exe works, or get the source code for either, take a look at NU32v2: A Detailed Look at Programming the PIC32.

MPLAB v8.63

This software will allow you to program your PIC microcontroller. This is the latest version (as of Jan 2011) and will work on Windows only.

Go to the Microchip IDE download page and download MPLAB IDE v8.63. Extract MPLAB_IDE_v8_63.zip and run setup.exe. Accept the licensing conditions and do a Complete installation in the default location. You do not have to install HI-TECH C (a pop-up at the end of the MPLAB installation process). You may be asked to restart your computer after installation completes.

Note: This will also install the C32 compiler. In December of 2010, you downloaded two separate files: the IDE and the C32 compiler. Now you just need to download the IDE and do a complete install.

If you've already installed the MPLAB IDE but don't have the C32 Toolsuite option when you make a new project, follow the instructions above to do a complete new install.

MPLAB X Beta

This is the cross-platform version of MPLAB (will work on MAC/Windows/Linux, based on NetBeans) but is still in Beta as of January 2011, and has some bugs. It will not be used in ME 333 in Winter 2011, unless you want to experiment with it.

To download and install MPLAB X Beta, go to the MPLAB X page. Click Download on the upper left.

MPLAB X Beta page.


Read the conditions, check the box and click Accept.

MPLAB X license.


Select your platform, the MPLAB X IDE, and the MPLAB C32 Lite Compiler for PIC32 MCUs and click Download Now.

MPLAB X download.


When the downloads are complete, run mplabxidebeta.exe on Windows, or MPLABX-betaxxxx.dmg on Mac OSX to get to the MPLABX installer. Follow the instructions to install the program on your computer in the default location. On a Mac, it will install in Applications/microchip.

Now run mplabc32.exe on Windows, or the mplabc32 installer on Mac OSX. Follow the instructions to install the compiler on your computer in the default location.

You are now ready to write code to run on the PIC32.

Some mac-specific instructions:

I use a mac, and the first time I tried to run mplab_ide, I got the error

Java 6 Standard Edition or newer required Cannot run on older versions of Java than Java 6 Standard Edition. Please install Java 6 Standard Edition or newer or use --jdkhome switch to point to its installation directory.

To fix this, go to Applications/Utilities and open Java Preferences. Under the General tab, you'll see different versions of Java. Java applications go down this list and use the first checked version that is compatible with the application. For me, the checked versions were

J2SE 5.0 32-bit

Java SE 6 64-bit

J2SE 5.0 64-bit

in that order. I just clicked on Java SE 6 and dragged it to the top of the list and closed the window. Then MPLAB finds this version first and runs just fine. If you don't have Java 6 on your list, you need to update your software. One way to do this is by going to Apple>Software Update.

Now you should be able to run mplab_ide, which we will use as our C project development environment. But I was unable to "build" any projects at first. According to Microchip: "On the Mac it is a requirement to install the Mac XTools developers Studio that comes with the shipped CD. This contains the 'make' utility which is used to build ALL embedded projects under MPLAB X." I was unable to compile programs with the MPLAB IDE because I didn't have xtools installed (it is not installed by default on your mac, so if you're not sure if you have it, you probably don't).

To get xtools (if you don't have it already), you can register with Apple as a developer. Go to

http://developer.apple.com/programs/start/register/create.php

and choose the free option (don't pay $99!). After you've registered, you can go to the Mac Dev Center and download Xcode 3.2.5 if you are running Mac OSX 10.6.x (this is big, > 3 GB!). If, like me, you're running Mac OSX 10.5.8, you should download the older xcode 3.1.4 (less than 1 GB). I found it at

http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wo/5.1.17.2.1.3.3.1.0.1.1.0.3.3.3.3.1

about 1/3 of the way down the page (search for 3.1.4).