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==

===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

[[Image:1.jpg]]
*Go to Control Panel \ Device Manager

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

====Get the Dspic Programmer====
*Download [http://chungyan5.no-ip.org/open_data/electronic_computer/platforms/dspic/dsPicProgrammer/dsPicProgrammer1.5.5.zip dsPic_Programmer.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]
*Save to a directory.
::e.g. desktop
*Unzip the dsPic_Programmer.zip, then you have an unziped file.
[[Image:prog_guid_dl.JPG]]

----

*Drag the unzip file to a directory.
::e.g. USB memory devices
[[Image:prog_guid_drag.JPG]]

----

*Save your .hex file(foo.hex) to your directory location  
::e.g. X:\dsPic_Programmer\ ---> X:\ is the driver where the dsPic_Programmer located
[[Image:prog_guid_hex.JPG]]

====Download Firmware====
*Start a Command Prompt
**Start -> Run<br>[[Image:2 1 run.JPG]]<br>
**Enter cmd<br>[[Image:2 2 cmd.JPG]]<br>
*Run dsPicProgrammer
**Make sure your device is connected through a "Direct RS232 Cable" to PC Serial Port. 
**Change to the directory where dsPicProgrammer.jar is located and run the command, for example: 
***Windows
****'''jre\bin\java -Djava.library.path=.\rxtx\bin -jar dspicProgrammer.jar COM1 115200 foo.hex''' or 
****'''dsPicProgrammer.bat COM1 115200 foo.hex'''
***Linux
****'''java -Djava.library.path=./rxtx/bin -jar dsPicProgrammer.jar /dev/ttyS0 115200 foo.hex''' or
****'''dsPicProgrammer.sh /dev/ttyS0 115200 foo.hex'''
**Legend:
:::COM1 is your COM Port ID
:::115200 is communication speed [in bps]
:::foo.hex is your firmware new file
::[[Image:5.jpg]]
:*When the program prompt you for an input, press y:<br>[[Image:2 4 prompt.JPG]]<br>
:*If communication can be established, you should see something like this:<br>[[Image:2 5 progress.JPG]]<br>
:*Wait until programming is completed.<br>[[Image:2 6 complete.JPG]]<br>
:*after all completed, power OFF your device, then power ON again, enjoy your new updated.


===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'''