Editing Programming the Device

Description on how to use dsPicProgrammer to download firmware to [{{SERVER}}/DsPIC30F_5011_Development_Board DsPIC30F 5011 Development Board]

==Loading Bootloader (Once only)==

===Hardware Requirement===
#PC with USB port (with Windows)
#ICD2 Programmer
#Target Board
#5V Power Supply

===Software Requirement===
#[http://ww1.microchip.com/downloads/en/DeviceDoc/MP750.zip MPLAB IDE v7.50]: v7.60 is not compatible with our current [http://www.sure-electronics.com/ ICD2 Programmers]. There are consistent "Devices cannot be founded" warnings. See [http://www.sureelectronics.net/pdfs/DB-DP003.pdf manual] for details.

===Files===
#[http://chungyan5.no-ip.org/vc/?root=dspic_bootloader dsPicBootloader] ('''bl_$(MODEL).hex''').

===Procedure===
{|border="1" cellspacing="0" cellpadding="5"
|+ Loading Bootloader
! Step !! Remarks 
|-valign="top"
| Install [http://ww1.microchip.com/downloads/en/DeviceDoc/MP750.zip MPLAB IDE] || 
*Do '''NOT''' connect ICD 2 (via USB) to PC
*Execute '''MPLAB vX.XX Install.exe'''
|-valign="top"
| Install USB Driver ||
*Follow the instruction in (C:\Program Files\Microchip\MPLAB IDE\ICD2\Drivers\Ddicd2.htm)
|-valign="top"
| Select Target Chip ||
*Run MPLAB IDE on PC
*Select: Configure>Select Devices...
*Choose the correct dsPic model
|-valign="top"
| Load Bootloader ||
*Select: File>Import...
*Select '''bl_$(MODEL).hex'''
|-valign="top"
| ICD 2 <-> PC ||
*Plug-in ICD 2 to PC via USB cable
|-valign="top"
| Target <-> ICD 2  ||
*Connect six pin cable to target board. Beware of the pin assignments. Only pin 1 - 5 are used.
*Power-up the target.
|-valign="top"
| ICD 2 <-> PC ||
*Select: Programmer>Select Programmer>MPLAB ICD 2
*If this is the first time the ICD 2 is connected to PC, MPLAB IDE will automatically download the required OS to ICD 2, wait until it has finished
*If you have not connected and powered up the target, you might see Warnings on invalid device IDs, and/or running self tests.
*See results of self test if necessary: Programmer>Settings, Status Tab. Refer to [http://ww1.microchip.com/downloads/en/DeviceDoc/51331B.pdf ICD2 User's Guide] Chapter 7.
|-valign="top"
| Start Programming ||
*Select: Programmer>Program
*Wait until finishes
|-valign="top"
| Finishing ||
*Power-down the Target
*Select: Programmer>Select Programmer>None
*Unplug USB cable
|-
|}


==Download and Loading Firmware==
===dsPicProgrammer User Guide===
[http://chungyan5.no-ip.org/open_data/electronic_computer/platforms/dspic/dsPicProgrammer/dsPicProgrammerUserGuide_V2.0.0.pdf dsPicProgrammerUserGuide_V2.0.0]
===Hardware Requirement===
#PC (Linux/Windows) with COM Port OR USB-COM converter cable
#Target Board (with bootloader)
#5V Power Supply

===Software Requirement===
#[http://java.sun.com/javase/downloads/index.jsp JAVA JDK or JRE]
#[http://users.frii.com/jarvi/rxtx/download.html RXTX Driver]: Download rxtx-2.1-7-bins-r2.zip or later
#[http://chungyan5.no-ip.org/vc/?root=dspicProgrammer dsPicProgrammer] ('''dsPicProgrammer.jar''')

===Files===
#Application hex file (e.g. '''app.hex''')

===Procedure===

====Setup COM Port====
:[[Image:DSC00921.JPG]]
*Connect your USB-COM converter cable to your computer
*Or Using a real COM PORT



----
=====Find out your COM port Number=====
[[Image:1.jpg]]
*Go to Control Panel \ Device Manager



----
[[Image:2.jpg]]
*Find out your Device COM Port Number




----
====Get the Dspic Programmer====
[[Image:programmer_3.jpg]]
*Download [http://chungyan5.no-ip.org/open_data/electronic_computer/platforms/dspic/dsPicProgrammer/dsPicProgrammer3.00.01s.zip dsPicProgrammer.zip], from [http://chungyan5.no-ip.org/open_data/electronic_computer/platforms/dspic/dsPicProgrammer/ws/ updated directory] or [http://chungyan5.no-ip.org/vc svn server]
*Unzip the dsPicProgrammer.zip, then you have an unziped file.




----
====Download Firmware====
[[Image:programmer_4.jpg]]
*Save your .hex file(foo.hex) to the folder called firmware.
*Run dsPicProgrammer.bat (Windows) / dsPicProgrammer.sh (linux)
**Make sure your device is connected through a "Direct RS232 Cable" to PC Serial Port. 




----
[[Image:programmer_6.jpg]]
*Choose a COM port
*Choose a braudrate 
::115200 is communication speed [in bps]




----
[[Image:programmer_7.jpg]]
*Choose a .hex file





----
[[Image:programmer_8.jpg]]
*Press start 
*Then press Yes to confirm programming the device




----
[[Image:programmer_9.jpg]]
*The status during programming




----
[[Image:programmer_10.jpg]]
*The the programming have been completed, press OK the close the message box



----
===Troubleshooting===
====Invalid COM Port====
*In case of selecting an invalid COM port, you should see the error message:<br>''gnu.io.NoSuchPortException: Choosing COM Port Error''<br>[[Image:3 1 com err.JPG]]<br><br>
*Solution: check the COM port ID, or close any programs that are using the COM Port
====Missing firmware file====
*In case of selecting a firmware file that does not exist, you should see the error message:<br>''java.io.FileNotFoundException: foo1.hex <The system cannot find the file specified>''<br>[[Image:3 2 file err.JPG]]<br><br>
*Solution: check the file path
====Missing RXTX driver====
*In case of missing the RXTX driver, you should see the error message:<br>''Exception in thread “main” java.lang.NoClassDefFoundError: gnu/io/UnsupportedCommOperationException''<br>[[Image:3 3 rxtx err.JPG]]<br><br>
*Solution: 
**Copy '''RXTXcomm.jar''' to '''/dsPicProgrammer/rxtx/lib'''
**Copy '''rxtxSerial.dll''' to '''/dsPicProgrammer/rxtx/bin''' (Window)
**Copy '''librxtxSerial.so''' to '''/dsPicProgrammer/rxtx/bin''' (Linux)
====Missing JAVA====
*In case of missing JAVA JDK or JRE, an error message will be prompted.
*Solution:
**Copy the contents under directory '''C:/Program Files/Java/jre$(VERSION)/''' to '''/dsPicProgrammer/jre'''

== Further reading ==

* [[PIC Programmers, In Circuit Programming and BootLoaders]]