Release Notes for MPLAB RealICE/ICD3 Command Line Interface
MPLAB(R) IDE v8.30
Executable Version 1.0.3

Feb. 13, 2009

-----------------------------------------------------------------------------
Table of Contents
-----------------------------------------------------------------------------
1.  Tool Definition
2.  Device Support List
3.  Operating System Support List
4.  What's New or Updated
5.  Known Problems
6.  Important Notes
7.  Upgrading the Firmware
8.  Command Line Options
9.  Exit codes
10. Troubleshooting
11. Command Line Examples
12. Customer Support

----------------------------------------------------------------------------
1. Tool Definition
----------------------------------------------------------------------------
     RealICECMD/ICD3CMD is a 32 bit command-line interface to
MPLAB RealICE/ICD3 device programming support.

The REALICECMD executable may be found, by default, in:
C:\Program Files\Microchip\MPLAB IDE\Programmer Utilities\RealICE

The ICD3CMD executable may be found, by default, in:
C:\Program Files\Microchip\MPLAB IDE\Programmer Utilities\ICD3

Note:  RealICECMD/ICD3CMD will only work with MPLAB IDE v8.30 and older
-----
----------------------------------------------------------------------------
2. Device Support List
----------------------------------------------------------------------------
- PICmicro devices: drop "PIC", e.g., PIC16F877 becomes 16F877
- dsPIC devices:    drop "dsPIC", e.g., dsPIC30F6014 becomes 30F6014


----------------------------------------------------------------------------
3. Operating System Support List
----------------------------------------------------------------------------
Windows 98, Windows 2000 SP4, Windows XP SP2 and Windows Vista (32-Bit)* OSs

* Only initial testing has been performed on 32-bit Vista for this release. 

NOTE: Windows NT and Windows ME OSs are NOT supported.


----------------------------------------------------------------------------
4. What's New or Updated
----------------------------------------------------------------------------
 1.0.2	Auto Update Firmware
 1.0.3  SQTP Support and Batch mode Operation

----------------------------------------------------------------------------
5. Known Problems
----------------------------------------------------------------------------



----------------------------------------------------------------------------
6. Important Notes
----------------------------------------------------------------------------
   a. RealICECMD/ICD3CMD will auto update Firmware, it will add delay to the operation
   b. Part name should be mentioned without Family Information like PIC/dsPIC
      Example. PIC18F67J50 should be mentioned as -P18F67J50
   c. Program and Verify Operation makes use of Selected Hex File using -F<file>
   d. Only Single session of RealICE/ICD3 communication is allowed
   e. Some family of device require Erase before programming, use E option before 
      the programming options Ex. RealICECMD P18F67J50 E FD:\DemoCode.hex -M
   f. Batch Mode Operation will Initialize the RealICE/ICD3 once and perform the 
      same operations repeatedly. On each repeat operation user intervention is required.
      Batch Mode will exit on following condition, Failure of operation or user request to stop.
      Warning: Batch Mode is suggested to use only for the .bat or direct invocation of 
               RealICECMD/ICD3CMD as because it will enter into wait state for the user input.
   g. To generate SQTP file use MPLAB IDE, Select 'Programmer' under that 'MPLAB PM3', then 
      select 'Settings' and open 'SQTP' tab.

 

----------------------------------------------------------------------------
9.  Upgrading the Firmware
----------------------------------------------------------------------------
    RealICECMD/ICD3CMD will automatically download the latest firmware if required

----------------------------------------------------------------------------
10. Command Line Options
----------------------------------------------------------------------------
The following commands are available in the command line interface.


 Description			Options
----------------------------------------------------------------------------
 Part/Device			-P<Part name>
 Batch Mode Operation		-B 	 	 
 Blank Check			-C			  
 Erase Flash			-E			  
 Hex File Selection		-F<file>		  
 Read to file			-GF<file>	  
 Program			-M<Memory Region>
				   P - Program Memory
				   E= EEPROM	
				   I= ID Memory
				   C= Configuration Memory
				   B= Boot Flash Memory
				   If no region is entered, the entire device will be programmed
 SQTP File Selection		-S<file>		 	
 Verify				-Y
 Help				-?	
 Exit Code			-?E

Note: Commands are not case sensitive. Escape character can be a - or  /.  
-----

----------------------------------------------------------------------------
11. Exit Codes
----------------------------------------------------------------------------

     0 - All of the selected operations complete successfully
     1 - Invalid Command Line Argument
     2 - RealICE/ICD3 Communication Failed
     3 - Selected Operation Failed
     4 - Unknown Runtime Failure
     5 - Invalid Device Detected
     6 - SQTP Failed

----------------------------------------------------------------------------
12. Troubleshooting
----------------------------------------------------------------------------
I. Failed to communicate to RealICE/ICD3:
   a. Make sure only one session is communication with RealICE/ICD3, 
      If RealICE/ICD3 is already loaded in MPLAB this will fail to communicate.
   b. Make sure computable Firmware type loaded on RealICE/ICD3 for the selected Device.
      To do that open MPLAB select the specific Device and Select RealICE/ICD3,
      MPLAB will detect the FW if need it will update the RealICE/ICD3.
      (By Default RealICECMD/ICD3CMD will automatically update Firmware)

II. Programming Failed:
   a. Make sure the Selected Hex file computable with the current device
   b. Check the selected Memory Region it available in the Device 
   c. Check the selected device requires Erase before programming


----------------------------------------------------------------------------
11. Command Line Examples
----------------------------------------------------------------------------

Program:
--------
	Program Entire Device:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -M
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -M	
	
	Program Entire device with SQTP file loaded	
		REALICECMD -P18F67J50 -Sc:\IdSQTP.NUM -FC:\DemoCode.Hex -M
		ICD3CMD	   -P18F67J50 -Sc:\IdSQTP.NUM -FC:\DemoCode.Hex -M	
			
	Program PROGRAM Memory:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -MP
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -MP		

	Program CONFIG Memory:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -MC
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -MC		

	Program EEPROM Memory:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -ME
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -ME		

	Program USER ID Memory:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -MI
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -MI		

	Program BOOT Memory:	
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -MB
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -MB		


Read:
-----
	Read to File:
		REALICECMD -P18F67J50 -GFC:\DemoCode.Hex 
		ICD3CMD	   -P18F67J50 -GFC:\DemoCode.Hex 		


Verify:
-------	
	Verify Data from File:
		REALICECMD -P18F67J50 -FC:\DemoCode.Hex -Y
		ICD3CMD	   -P18F67J50 -FC:\DemoCode.Hex -Y	


Erase:
------
	Erase Entire Device:
		REALICECMD -P18F67J50 -E
		ICD3CMD	   -P18F67J50 -E	


Blank Check:
-----------
	Blank Check Entire Device:
		REALICECMD -P18F67J50 -C
		ICD3CMD	   -P18F67J50 -C	

Batch Mode Operation:
---------------------
	Batch Mode can be combined with any operation:
		REALICECMD -P18F67J50 -B -C
		ICD3CMD	   -P18F67J50 -B -C	

Help:
-----
	Help for All commands
		REALICECMD -?
		ICD3CMD	   -?

	Help for Exit Code	
		REALICECMD -?E
		ICD3CMD	   -?E


		
----------------------------------------------------------------------------
12. Customer Support
----------------------------------------------------------------------------
The Microchip Web Site
----------------------

Microchip provides online support via our web site at www.microchip.com.
This web site is used as a means to make files and information easily
available to customers. Accessible by using your favorite Internet browser,
the web site contains the following information:

* Product Support - Data sheets and errata, application notes and sample
  programs, design resources, user's guides and hardware support documents,
  latest software releases and archived software

* General Technical Support - Frequently Asked Questions (FAQs), technical
  support requests, online discussion groups, Microchip consultant program
  member listing

* Business of Microchip - Product selector and ordering guides, latest
  Microchip press releases, listing of seminars and events, listings of
  Microchip sales offices, distributors and factory representatives

Development Systems Customer Change Notification Service
--------------------------------------------------------

Microchip's customer notification service helps keep customers current on
Microchip products. Subscribers will receive e-mail notification whenever
there are changes, updates, revisions or errata related to a specified
product family or development tool of interest.

To register, access the Microchip web site at www.microchip.com, click
on Customer Change Notification and follow the registration instructions.

The Development Systems product group categories are:

* Compilers - The latest information on Microchip C compilers and other
  language tools. These include the MPLAB C18 and MPLAB C30 C compilers;
  MPASM(TM) and MPLAB ASM30 assemblers; MPLINK(TM) and MPLAB LINK30 object
  linkers; and MPLIB(TM) and MPLAB LIB30 object librarians.

* Emulators - The latest information on Microchip in-circuit emulators.
  This includes the MPLAB ICE 2000, MPLAB ICE 4000 and Real ICE.

* In-Circuit Debuggers - The latest information on the Microchip
  in-circuit debugger, MPLAB ICD 2 and ICD 3.

* MPLAB IDE - The latest information on Microchip MPLAB IDE, the Windows(R)
  Integrated Development Environment for development systems tools. This
  list is focused on the MPLAB IDE, MPLAB IDE Project Manager, MPLAB Editor
  and MPLAB SIM simulator, as well as general editing and debugging features.

* Programmers - The latest information on Microchip programmers. These
  include the MPLAB PM3 and PRO MATE(R) II device programmers and the
  PICSTART(R) Plus and PICkit(TM) 1 development programmers.

Additional Support
------------------

Users of Microchip products can receive assistance through several
channels:

* Distributor or Representative
* Local Sales Office
* Field Application Engineer (FAE)
* Technical Support

Customers should contact their distributor, representative or field
application engineer (FAE) for support. Local sales offices are also
available to help customers. A listing of sales offices and locations
is available on our website.

Technical support is available through the web site at:
http://support.microchip.com

