Difference between revisions of "Programming HID Bootloader on PIC32"

From Mech
Jump to navigationJump to search
 
(76 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The HID (Human Interface Device) bootloader is used to install programs on the PIC32 without using an external programmer like ICD2 and does not require any drivers on the computer. The HID bootloader is supplied with the [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2680&dDocName=en537044 Microchip Applications Library].
The bootloader is used to install programs on the PIC32 without using an external programmer like an ICD2 and does not require any drivers on the computer. The PC software for the bootloader for the PC has already been installed with the [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2680&dDocName=en537044 Microchip Applications Library].


= Software =
= Software =
== PIC software ==
== PIC Source Code ==


For each new program, you will need to make a folder that will contain the source code files and the ''project'' file, which keeps all the details about your program that are not in the source code files.
You can download the PIC32 hex file [[Media:HID_Bootloader_PIC32.hex | here]].


- I recommend making a folder called PIC32_Code to hold all of your project folders.
You can download the full MPLAB project for the PIC32 program [[Media:HID_Bootloader_PIC32_MPLAB.zip | here]].

- Create a new folder in your PIC32_Code folder and call it Bootloader.

- Download the PIC32 bootloader zip file [[Media:HID_Bootloader_PIC32.zip | here]].

- Extract this zip file into the Bootloader folder. Copy and paste the files located inside this folder into the Bootloader folder. When you are done the Bootloader folder will have 7 files in addition to the zip file and folder.

These files were tested with the Applications Library updated on November 18, 2009. If you are using a different library, these files may not work.


== PC software ==
== PC software ==
If you downloaded the Microchip Applications Library, the PC HID Bootloader program is located under the start menu Programs -> Microchip -> MCHPFSUSB v2.5 -> Tools -> HIDBootLoader
You can also download the executable [[Media:HIDBootLoader_PIC32_PC.zip | here]].
Running this requires a sufficiently recent version of the .NET Framework, which you may not have if you are running XP or earlier versions of Windows. You can download a sufficiently recent version here (the install takes a while): [http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework download].


In order to load files with the bootloader, you will have to run a PC application called HID Bootloader. This bootloader should have been installed with the applications library.
= Required circuitry =
For the UBW32 and NU32 board, this circuitry is already on the board. This information is for people who are interested in making their own board.


- Verify that there is a HID Bootloader located under the Start menu Programs -> Microchip -> MCHPFSUSB v2.6 -> Tools -> HIDBootLoader. '''Do not run this program now, just verify that it is there.'''
A button must be wired to a pin that has been initialized as a digital input (similar to the RESET button). This PROGRAM button is used to put the PIC in Bootloading Mode. The UBW32 and NU32 board has the button wired to PIN E7 and PIN E3, respectively. The button can be put on any pin that supports digital output, but the bootloading program will have to be modified accordingly.
The PIC goes into Bootloading Mode when the PROGRAM button is held down when a RESET is called (ie hold down both PROGRAM and RESET and then release RESET). LEDS on the boards will flash to indicate that the PIC is in Bootloading Mode.


Running the HIDBootLoader requires a sufficiently recent version of the .NET Framework, which you may not have if you are running XP or earlier versions of Windows. This issue should have been resolved when installing the Applications Library. You can download a sufficiently recent version here (the install takes a while): [http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework download].
= Installing a Bootloader on the PIC32 =

These directions detail how to install the HID Bootloader on the PIC32. Before starting, [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en019469&redirects=mplab Microchip MPLAB], [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en536656 Microchip C32 Compiler] and the [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2680&dDocName=en537044 Microchip Applications Library] must be installed.
= Installing a Bootloader on the PIC32 with ICD2=
These directions detail how to start a new MPLAB project and program the HID Bootloader on the PIC32 with the [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en010046 Microchip MPLAB ICD 2] (In-Circuit Debugger).

We are going to create a project to install the bootloader on the PIC32. This code only needs to be loaded to the PIC32 once. After this, you will no longer need the ICD2 to program the PIC.


==Starting a New MPLAB Project==
* Open MPLAB IDE.
* Open MPLAB IDE.
<br clear=all>
<br clear=all>
* Choose <i>Configure>Select Device</i>. In the Device dialog, select the PIC you are using from the list if it’s not already selected. The lights show which software is supported for that PIC.
* Choose <i>Configure>Select Device</i> to select the PIC32MX460F512L (the PIC you are working with). In the Device dialog, select the PIC you are using from the list if it’s not already selected. The lights show which software is supported for that PIC.
[[Image:MPLAB_DeviceConfigure.bmp|thumb|300 px|left]]
[[Image:MPLAB_DeviceConfigure.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Choose <i>Project>Project Wizard</i>. Click <b>Next</b>
* Choose <i>Project>Project Wizard</i> to start a new project. Click <b>Next</b>
[[Image:MPLAB_ProjectWizardStart.bmp|thumb|300 px|left]]
[[Image:MPLAB_ProjectWizardStart.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Select the device from the drop down menu. Click <b>Next</b>
* Select the PIC32MX460F512L from the drop down menu. (It might already be selected) Click <b>Next</b>
[[Image:MPLAB_ProjectWizardDevice.bmp|thumb|300 px|left]]
[[Image:MPLAB_ProjectWizardDevice.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Select the Microchip PIC32 C-Compiler Toolsuite from the drop down menu. Click <b>Next</b>
* Select the Microchip PIC32 C-Compiler Toolsuite from the drop down menu. Click <b>Next</b>
[[Image:MPLAB_ProjectWizardToolsuite.bmp|thumb|300 px|left]]
[[Image:MPLAB_ProjectWizardToolsuite.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Create a new project in the folder where you want the project and c files to be stored. Click <b>Next</b>
* Create a new project (I called it Bootloader) in the Bootloader folder.
Click <b>Next</b>
[[Image:MPLAB_ProjectWizardNewProject.bmp|thumb|300 px|left]]
[[Image:MPLAB_ProjectWizardNewProject.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Add the c files (if you already have some) in the folder to your project. Click <b>Next</b>
* Add the following C files to the project. These files should already be located in the Bootloader folder.
**HardwareProfile.h (generic header file for many different boards)
[[Image:MPLAB_ProjectWizardAddFiles.bmp|thumb|300 px|left]]
**HardwareProfile_NU32.h (hardware profile for the NU32, if you have your own hardware profile you will need to add it to the generic HardwareProfile.h)
**main.c (the main source file)
**main.h
**procdefs.ld (a linker file)
**usb_config.h (header file to configure usb communication)
**usb_descriptors.c (source file for usb communication)
Click <b>Next</b>
[[Image:MPLAB_ProjectWizardAddFiles.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
* Click <b>Finish</b>
* Click <b>Finish</b>
[[Image:MPLAB_ProjectWizardFinish.bmp|thumb|300 px|left]]
[[Image:MPLAB_ProjectWizardFinish.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
We have now created the Bootloader Project.


==Creating Bootloader Hex File==
The project has now been created. It will not compile because it does not know where the common header files of the Microchip Framework are located.
After clicking finish, MPLAB should appear as below. The project window contains all of the files you have added to the project. The procdefs.ld file is located under the linker file folder. This file is not the only linker file, so it needs to be moved (dragged) to the 'Other Files' folder. The procdefs.ld file tells the programmer or bootloader where to put the files. The bootloader will have a different procdefs file than the files you will load with the bootloader because you want the new programs to be put in a different spot than the bootloader on the PIC. If you use the same procdefs file as the bootloader procdefs, the bootloader will try to put the new program where the bootloader code is stored, essentially erasing the bootloader and not installing the new program. If you accidentally use the bootloader procdefs file, you will have to reinstall the bootloader on the PIC.
[[Image:MPLAB_StartWindow.jpg|thumb|500 px|left]]
<br clear=all>

MPLAB needs to be pointed to the location of the header files of the Microchip Applications Library.
* Choose <i>Project>Build Options>Project</i>.
* Choose <i>Project>Build Options>Project</i>.
* In the directories tab, choose the Include Search Path.
* In the directories tab, choose the Include Search Path from the drop down menu.
* Add a New path - Browse to find the include folder (<Installation Folder> \pic32_solutions\Microchip\Include)
* Add a New path - Browse to find the include folder (C:\Microchip Solutions\Microchip\Include)
* Add a New path - type a period '.' (this will search the project folder)
* Add a New path - Browse to find the folder where you have the project
* Click <b>Apply</b> and then <b>OK</b>
* Click <b>OK</b>
[[Image:MPLAB_IncludeSearchPath.bmp|thumb|300 px|left]]
[[Image:MPLAB_IncludeSearchPath.jpg|thumb|300 px|left]]
<br clear=all>
<br clear=all>
[[Image:MPLAB_USBFiles.jpg|thumb|300 px|right]]
Since the bootloader uses the USB source files of the Microchip Framework, we need to add the source files and some USB header files to the project. I put these files in sub-folders in the project window as noted below.
* In the project window, right click on 'Source Files' and click 'Create Subfolder'. I called the folder 'USB Framework'
* Right click on the new folder and select 'Add Files'
* Add the following files
**usb_device.c from ... -> Microchip Solutions -> Microchip -> USB
**usb_function_hid.c from ... -> Microchip Solutions -> Microchip -> USB -> HID Device Driver
* In the project window, right click on 'Header Files' and click 'Create Subfolder'. I called the folder 'USB Framework'
* Right click on the new folder and select 'Add Files'
* Add the following files from ... -> Microchip Solutions -> Microchip -> Include -> USB
**usb.h
**usb_ch9.h
**usb_common.h
**usb_device.h
**usb_function_hid.h
**usb_hal.h
**usb_hal_pic32.h
<br clear=all>
Since we have a generic HardwareProfile we need to tell MPLAB which board we are using. We are essentially going to give MPLAB a constant that indicates which board to use.
*Choose Project -> Build Options -> Project and click on the MPLAB PIC32 C Compiler Tab
*The window for preprocessor macros is currently empty. We want to create a variable that is defined for our board. Click Add and type PIC32_NU32 if using the Northwestern PIC32 board.
*Click OK
*Click OK

We want the Bootloader Hex file to be as small as possible to occupy the least space on the PIC. Therefore, we want to optimize the compiler to have the smallest code size. If you do not minimize the code size, the bootloader will not work.
*Click Project -> Build Options and click on the MPLAB PIC32 C Compiler Tab as before
*Click on the Category "Optimization"
*Select the dot 's' for smallest size as shown below (if this is not available, choose the smallest code size available)
[[Image:MPLAB_Optimize.jpg|thumb|300 px|left]]
*Click OK
<br clear=all>

If you are using the PIC32_NU32, you are ready to compile the project. If you are using a board other than the PIC32_NU32, make sure you follow all the directions in Notes for Loading Bootloader with Own Board at the bottom of this page.
*Choose Project -> Build All
This compiles and creates a Hex File in the project folder to be loaded on to the PIC. There may be some warnings about the academic version, but as long as the Build is Successful you can continue.
<br clear=all>

==Loading Bootloader on PIC with ICD2==
[[Image:ICD2.jpg|thumb|100 px|right]]
These directions detail how to load a file (in this case a bootloader) on the PIC with [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en010046 ICD2] (In Circuit-Debugger)

These directions assume the following things:
*Circuit capable of programming the PIC already exists (discussed below)
*You have an ICD2
*You already have a hex file to load (the bootloader hex file was created with the above instructions)
===Hardware Setup===
The ICD2 comes with a 6 pin modular cable (we only need 5 of the pins).

For ME 333, this cable has already been modified.

This is essentially a telephone wire with 2 extra wires. This tutorial assumes that your board only has 5 pins and not the jack for this cable. The pins on the cable are arranged as shown in the picture
[[Image:modJack.jpg|thumb|200 px|center]]
<br clear=all>
Take note of the colors for each pin (i.e. pin 1 is blue, pin 2 is yellow, etc.).
Cut one jack off, so that the wires are free. Solder these wires into a 5-pin header (do not solder the 6th pin) in the correct order. This will make it easier to connect the pins from the board to the cable.
[[Image:modJackHeader.jpg|thumb|400 px|center]]
<br clear=all>

The NU32 has the pins necessary for programming with ICD next to each other. Connect the pins to the correct pin of the header as detailed below
*MCLR - Pin 1
*3.3V - Pin 2
*GND - Pin 3
*PGD - Pin 4
*PGC - Pin 5

===PC Setting Up ICD2===
This instructions assume you have already installed MPLAB, but have not installed the ICD2 on your computer yet.

*Connect the ICD2 to your PC with the USB cable.

*Do not allow Windows to pick a USB driver. When the found new hardware wizard pops up, select "Install from a List or Specific Location (Advanced)". Make sure the "Search for Best Driver" is Selected and unselect "Search Removable Media". Also select "Include this location in the search". Browse to the following directory "C:\Program Files\Microchip\MPLAB IDE\ICD2\Drivers" and click Next.
[[Image:ICD2_driver.jpg|thumb|400 px|center]]
<br clear=all>

*Click finish on the "Completing the Found New Hardware Wizard"

* Get the ICD2 and Cable from the TA.

*Connect the ICD2 with the modified jack to your board. The pins are shown again below
**MCLR - Pin 1
**3.3V - Pin 2
**GND - Pin 3
**PGD - Pin 4
**PGC - Pin 5


If you have a program running on the PIC it will be interrupted when you connect the ICD2 to the board.

You program with the ICD2 in MPLAB. If MPLAB is not open, open MPLAB. You need to configure MPLAB to use the ICD2 programmer.
*Select Programmer -> Select Programmer -> MPLAB ICD 2.
*If a window doesn't appear, click Programmer -> MPLAB ICD2 Setup Wizard. I used the following set up features.
**USB com port
**ICD2 does NOT automatically connect
**ICD2 automatically downloads OS

You are now ready to program.
<br clear=all>

===Programming with ICD2===
These instructions assume you already have installed and connected the ICD2 to the board and have a hex file created.

* Connect your NU32 board to your computer with the USB cable and switch the board ON (red LED should be on). '''Note: the USB cable is merely providing 5V power to your NU32 board; no data is being transmitted back and forth on the cable.''' So you should now have the NU32 board connected directly to one USB port on the PC (for power); and the NU32 board should also be connected to the ICD2 programmer, which is in turn connected to a second USB port on your PC.

* With the board connected to the ICD2, click Programmer -> Connect.

The output window should say something similar to this:
Connecting to MPLAB ICD 2
...Connected
Setting Vdd source to target
Target Device PIC32MX460F512L found, revision = Rev 0x50900053
...Reading ICD Product ID
Running ICD Self Test
...Passed
If it says:
Connecting to MPLAB ICD 2
...Connected
Setting Vdd source to target
ICD0042: API: Error response (Device not ready (0x12))
ICD0042: API: Error response (Device not ready (0x12))
MPLAB ICD 2 ready for next operation
try turning the board off and then back on, and while holding the cable tight to the board, click Programmer->Connect. The connection may be loose.

*Click File ->Import and find the hex file you created above.
This imports the hex file that you want to load on to the PIC.

*Click Programmer -> Program
The output window will say something similar to this:
Programming Target...
...Validating configuration fields
...Erasing Part
...Loading Program Executive
...Programming Boot Config (0x1FC00000 - 0x1FC003FC)
...Verifying Boot Config memory (0x1FC00000 - 0x1FC003FC)
...Programming Program Memory (0x1D000000 - 0x1D0001FC)
...Verifying Program memory (0x1D000000 - 0x1D0001FC)
...Programming Program Memory (0x1D001400 - 0x1D0017FC)
...Verifying Program memory (0x1D001400 - 0x1D0017FC)
...Programming Program Memory (0x1D002000 - 0x1D005FFC)
...Verifying Program memory (0x1D002000 - 0x1D005FFC)
...Programming Configuration Bits
...Verifying Config memory
...Programming succeeded

The programmer is still attached to the PIC, so the PIC will not be running the program you just loaded.
*Click Programmer ->Release from Reset

Unfortunately, the ICD2 sometimes crashes MPLAB with PIC32. If we had ICD3 in the lab, I would use that one instead.

The bootloader is now installed on the PIC.

To test that the bootloader was installed correctly,
* Hold down the RESET and PROGRAM buttons.
* Release the RESET button
* Release the PROGRAM button
The LEDs should be alternating. You can now disconnect the ICD2 from the PC and from the NU32 board. You should not need the ICD2 again, unless you accidentally overwrite the bootloader.

If getting started click [[Getting Started with PIC32|here]] to return to the instructions.

= Notes for Loading Bootloader with Own Board =
These directions are for the case that you are putting a bootloader on a board that is not included in the HardwareProfile header file. You will need to do the following tasks.
*Define a board constant in MPLAB PIC32 C Compiler Tab in Project -> Build options (ex. PIC32_NU32)
*Put the following line in the HardwareProfile under the correct compiler (ex __C32__) and PIC (ex __32MX460F512L__)
#elif defined(YOUR_BOARD_CONSTANT)
#include "YOUR_HARDWAREPROFILE.h"
where YOUR_BOARD_CONSTANT is the constant you put in the compiler tab and YOUR_HARDWAREPROFILE.h is the profile header file for your board.
*In main.c, you will need to add a section for the configuration bits for your board as shown below:
#elif defined(YOUR_BOARD_CONSTANT)
the configuration...

Latest revision as of 00:31, 18 December 2009

The bootloader is used to install programs on the PIC32 without using an external programmer like an ICD2 and does not require any drivers on the computer. The PC software for the bootloader for the PC has already been installed with the Microchip Applications Library.

Software

PIC Source Code

For each new program, you will need to make a folder that will contain the source code files and the project file, which keeps all the details about your program that are not in the source code files.

- I recommend making a folder called PIC32_Code to hold all of your project folders.

- Create a new folder in your PIC32_Code folder and call it Bootloader.

- Download the PIC32 bootloader zip file here.

- Extract this zip file into the Bootloader folder. Copy and paste the files located inside this folder into the Bootloader folder. When you are done the Bootloader folder will have 7 files in addition to the zip file and folder.

These files were tested with the Applications Library updated on November 18, 2009. If you are using a different library, these files may not work.

PC software

In order to load files with the bootloader, you will have to run a PC application called HID Bootloader. This bootloader should have been installed with the applications library.

- Verify that there is a HID Bootloader located under the Start menu Programs -> Microchip -> MCHPFSUSB v2.6 -> Tools -> HIDBootLoader. Do not run this program now, just verify that it is there.

Running the HIDBootLoader requires a sufficiently recent version of the .NET Framework, which you may not have if you are running XP or earlier versions of Windows. This issue should have been resolved when installing the Applications Library. You can download a sufficiently recent version here (the install takes a while): .NET Framework download.

Installing a Bootloader on the PIC32 with ICD2

These directions detail how to start a new MPLAB project and program the HID Bootloader on the PIC32 with the Microchip MPLAB ICD 2 (In-Circuit Debugger).

We are going to create a project to install the bootloader on the PIC32. This code only needs to be loaded to the PIC32 once. After this, you will no longer need the ICD2 to program the PIC.


Starting a New MPLAB Project

  • Open MPLAB IDE.


  • Choose Configure>Select Device to select the PIC32MX460F512L (the PIC you are working with). In the Device dialog, select the PIC you are using from the list if it’s not already selected. The lights show which software is supported for that PIC.
MPLAB DeviceConfigure.jpg


  • Choose Project>Project Wizard to start a new project. Click Next
MPLAB ProjectWizardStart.jpg


  • Select the PIC32MX460F512L from the drop down menu. (It might already be selected) Click Next
MPLAB ProjectWizardDevice.jpg


  • Select the Microchip PIC32 C-Compiler Toolsuite from the drop down menu. Click Next
MPLAB ProjectWizardToolsuite.jpg


  • Create a new project (I called it Bootloader) in the Bootloader folder.

Click Next

MPLAB ProjectWizardNewProject.jpg


  • Add the following C files to the project. These files should already be located in the Bootloader folder.
    • HardwareProfile.h (generic header file for many different boards)
    • HardwareProfile_NU32.h (hardware profile for the NU32, if you have your own hardware profile you will need to add it to the generic HardwareProfile.h)
    • main.c (the main source file)
    • main.h
    • procdefs.ld (a linker file)
    • usb_config.h (header file to configure usb communication)
    • usb_descriptors.c (source file for usb communication)

Click Next

MPLAB ProjectWizardAddFiles.jpg


  • Click Finish
MPLAB ProjectWizardFinish.jpg


We have now created the Bootloader Project.

Creating Bootloader Hex File

After clicking finish, MPLAB should appear as below. The project window contains all of the files you have added to the project. The procdefs.ld file is located under the linker file folder. This file is not the only linker file, so it needs to be moved (dragged) to the 'Other Files' folder. The procdefs.ld file tells the programmer or bootloader where to put the files. The bootloader will have a different procdefs file than the files you will load with the bootloader because you want the new programs to be put in a different spot than the bootloader on the PIC. If you use the same procdefs file as the bootloader procdefs, the bootloader will try to put the new program where the bootloader code is stored, essentially erasing the bootloader and not installing the new program. If you accidentally use the bootloader procdefs file, you will have to reinstall the bootloader on the PIC.

MPLAB StartWindow.jpg


MPLAB needs to be pointed to the location of the header files of the Microchip Applications Library.

  • Choose Project>Build Options>Project.
  • In the directories tab, choose the Include Search Path from the drop down menu.
  • Add a New path - Browse to find the include folder (C:\Microchip Solutions\Microchip\Include)
  • Add a New path - Browse to find the folder where you have the project
  • Click OK
MPLAB IncludeSearchPath.jpg


MPLAB USBFiles.jpg

Since the bootloader uses the USB source files of the Microchip Framework, we need to add the source files and some USB header files to the project. I put these files in sub-folders in the project window as noted below.

  • In the project window, right click on 'Source Files' and click 'Create Subfolder'. I called the folder 'USB Framework'
  • Right click on the new folder and select 'Add Files'
  • Add the following files
    • usb_device.c from ... -> Microchip Solutions -> Microchip -> USB
    • usb_function_hid.c from ... -> Microchip Solutions -> Microchip -> USB -> HID Device Driver
  • In the project window, right click on 'Header Files' and click 'Create Subfolder'. I called the folder 'USB Framework'
  • Right click on the new folder and select 'Add Files'
  • Add the following files from ... -> Microchip Solutions -> Microchip -> Include -> USB
    • usb.h
    • usb_ch9.h
    • usb_common.h
    • usb_device.h
    • usb_function_hid.h
    • usb_hal.h
    • usb_hal_pic32.h


Since we have a generic HardwareProfile we need to tell MPLAB which board we are using. We are essentially going to give MPLAB a constant that indicates which board to use.

  • Choose Project -> Build Options -> Project and click on the MPLAB PIC32 C Compiler Tab
  • The window for preprocessor macros is currently empty. We want to create a variable that is defined for our board. Click Add and type PIC32_NU32 if using the Northwestern PIC32 board.
  • Click OK
  • Click OK

We want the Bootloader Hex file to be as small as possible to occupy the least space on the PIC. Therefore, we want to optimize the compiler to have the smallest code size. If you do not minimize the code size, the bootloader will not work.

  • Click Project -> Build Options and click on the MPLAB PIC32 C Compiler Tab as before
  • Click on the Category "Optimization"
  • Select the dot 's' for smallest size as shown below (if this is not available, choose the smallest code size available)
MPLAB Optimize.jpg
  • Click OK


If you are using the PIC32_NU32, you are ready to compile the project. If you are using a board other than the PIC32_NU32, make sure you follow all the directions in Notes for Loading Bootloader with Own Board at the bottom of this page.

  • Choose Project -> Build All

This compiles and creates a Hex File in the project folder to be loaded on to the PIC. There may be some warnings about the academic version, but as long as the Build is Successful you can continue.

Loading Bootloader on PIC with ICD2

ICD2.jpg

These directions detail how to load a file (in this case a bootloader) on the PIC with ICD2 (In Circuit-Debugger)

These directions assume the following things:

  • Circuit capable of programming the PIC already exists (discussed below)
  • You have an ICD2
  • You already have a hex file to load (the bootloader hex file was created with the above instructions)

Hardware Setup

The ICD2 comes with a 6 pin modular cable (we only need 5 of the pins).

For ME 333, this cable has already been modified.

This is essentially a telephone wire with 2 extra wires. This tutorial assumes that your board only has 5 pins and not the jack for this cable. The pins on the cable are arranged as shown in the picture

ModJack.jpg


Take note of the colors for each pin (i.e. pin 1 is blue, pin 2 is yellow, etc.). Cut one jack off, so that the wires are free. Solder these wires into a 5-pin header (do not solder the 6th pin) in the correct order. This will make it easier to connect the pins from the board to the cable.

ModJackHeader.jpg


The NU32 has the pins necessary for programming with ICD next to each other. Connect the pins to the correct pin of the header as detailed below

  • MCLR - Pin 1
  • 3.3V - Pin 2
  • GND - Pin 3
  • PGD - Pin 4
  • PGC - Pin 5

PC Setting Up ICD2

This instructions assume you have already installed MPLAB, but have not installed the ICD2 on your computer yet.

  • Connect the ICD2 to your PC with the USB cable.
  • Do not allow Windows to pick a USB driver. When the found new hardware wizard pops up, select "Install from a List or Specific Location (Advanced)". Make sure the "Search for Best Driver" is Selected and unselect "Search Removable Media". Also select "Include this location in the search". Browse to the following directory "C:\Program Files\Microchip\MPLAB IDE\ICD2\Drivers" and click Next.
ICD2 driver.jpg


  • Click finish on the "Completing the Found New Hardware Wizard"
  • Get the ICD2 and Cable from the TA.
  • Connect the ICD2 with the modified jack to your board. The pins are shown again below
    • MCLR - Pin 1
    • 3.3V - Pin 2
    • GND - Pin 3
    • PGD - Pin 4
    • PGC - Pin 5


If you have a program running on the PIC it will be interrupted when you connect the ICD2 to the board.

You program with the ICD2 in MPLAB. If MPLAB is not open, open MPLAB. You need to configure MPLAB to use the ICD2 programmer.

  • Select Programmer -> Select Programmer -> MPLAB ICD 2.
  • If a window doesn't appear, click Programmer -> MPLAB ICD2 Setup Wizard. I used the following set up features.
    • USB com port
    • ICD2 does NOT automatically connect
    • ICD2 automatically downloads OS

You are now ready to program.

Programming with ICD2

These instructions assume you already have installed and connected the ICD2 to the board and have a hex file created.

  • Connect your NU32 board to your computer with the USB cable and switch the board ON (red LED should be on). Note: the USB cable is merely providing 5V power to your NU32 board; no data is being transmitted back and forth on the cable. So you should now have the NU32 board connected directly to one USB port on the PC (for power); and the NU32 board should also be connected to the ICD2 programmer, which is in turn connected to a second USB port on your PC.
  • With the board connected to the ICD2, click Programmer -> Connect.

The output window should say something similar to this:

  Connecting to MPLAB ICD 2
  ...Connected
  Setting Vdd source to target
  Target Device PIC32MX460F512L found, revision = Rev 0x50900053
  ...Reading ICD Product ID
  Running ICD Self Test
  ...Passed

If it says:

  Connecting to MPLAB ICD 2
  ...Connected
  Setting Vdd source to target
  ICD0042: API:  Error response (Device not ready (0x12))
  ICD0042: API:  Error response (Device not ready (0x12))
  MPLAB ICD 2 ready for next operation

try turning the board off and then back on, and while holding the cable tight to the board, click Programmer->Connect. The connection may be loose.

  • Click File ->Import and find the hex file you created above.

This imports the hex file that you want to load on to the PIC.

  • Click Programmer -> Program

The output window will say something similar to this:

  Programming Target...
  ...Validating configuration fields
  ...Erasing Part
  ...Loading Program Executive
  ...Programming Boot Config (0x1FC00000 - 0x1FC003FC)
  ...Verifying Boot Config memory (0x1FC00000 - 0x1FC003FC)
  ...Programming Program Memory (0x1D000000 - 0x1D0001FC)
  ...Verifying Program memory (0x1D000000 - 0x1D0001FC)
  ...Programming Program Memory (0x1D001400 - 0x1D0017FC)
  ...Verifying Program memory (0x1D001400 - 0x1D0017FC)
  ...Programming Program Memory (0x1D002000 - 0x1D005FFC)
  ...Verifying Program memory (0x1D002000 - 0x1D005FFC)
  ...Programming Configuration Bits
  ...Verifying Config memory
  ...Programming succeeded

The programmer is still attached to the PIC, so the PIC will not be running the program you just loaded.

  • Click Programmer ->Release from Reset

Unfortunately, the ICD2 sometimes crashes MPLAB with PIC32. If we had ICD3 in the lab, I would use that one instead.

The bootloader is now installed on the PIC.

To test that the bootloader was installed correctly,

  • Hold down the RESET and PROGRAM buttons.
  • Release the RESET button
  • Release the PROGRAM button

The LEDs should be alternating. You can now disconnect the ICD2 from the PC and from the NU32 board. You should not need the ICD2 again, unless you accidentally overwrite the bootloader.

If getting started click here to return to the instructions.

Notes for Loading Bootloader with Own Board

These directions are for the case that you are putting a bootloader on a board that is not included in the HardwareProfile header file. You will need to do the following tasks.

  • Define a board constant in MPLAB PIC32 C Compiler Tab in Project -> Build options (ex. PIC32_NU32)
  • Put the following line in the HardwareProfile under the correct compiler (ex __C32__) and PIC (ex __32MX460F512L__)
  #elif defined(YOUR_BOARD_CONSTANT)
     #include "YOUR_HARDWAREPROFILE.h"

where YOUR_BOARD_CONSTANT is the constant you put in the compiler tab and YOUR_HARDWAREPROFILE.h is the profile header file for your board.

  • In main.c, you will need to add a section for the configuration bits for your board as shown below:
  #elif defined(YOUR_BOARD_CONSTANT)
     the configuration...