Release Notes for MPLAB X RealICE/ICD3 Command Line Interface

 

MPLAB® X IDE vv2.20

 

September 2, 2014

 

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

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\MPLABX\mplab_ipe\

 

The ICD3CMD executable may be found, by default, in:

C:\Program Files\Microchip\MPLABX\mplab_ipe\

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

Microsoft Windows XP Professional SP3/ Windows 7 Professional/ Windows 8 Professional:

- Processor: 2.6 GHz Intel Pentium IV or equivalent

- Memory: 768 MB

- Disk space: 400 MB of free disk space

4.   What's New or Updated

        None.

5.   Known Problems

Specific memory regions cannot be exported into hex file.

6.   Important Notes

1.     RealICECMD/ICD3CMD will auto update the Firmware; this will cause a delay to the operation.

2.     Part name should be entered without the family information such as PIC/dsPIC.
Example. PIC18F67J50 should be entered as -P18F67J50

3.     Program and Verify Operation makes use of the selected Hex file using -F<file>.

4.     Only a single session of RealICE/ICD3 communication is allowed.

5.     Command line arguments are parsed alphabetically.

6.     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 a failure of operation or user request to stop.
Warning: Batch Mode is recommended for use only for the .bat or direct invocation of RealICECMD/ICD3CMD because it will enter into a wait state for the user input.

7.     To generate an SQTP file use MPLAB X IDE, select the REAL ICE’ or “ICD3”, then select 'Settings' and open 'SQTP' tab.

8.     Reprogram will enable the user to update the selected part of memory. The reprogram hex file should contain only data for the selected memory range that needs to be updated. This option first reads the device and updates the selected memory then writes it back to the device.

9.     Program Memory Range Address must be aligned to the device's program memory boundary size.

7.   Upgrading the Firmware

RealICECMD/ICD3CMD will automatically download the latest firmware if required.

8.   Command Line Options

The following commands are available in the command line interface.

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

 

Option

Description

B

Batch Mode Operation

C

Blank Check Device

E

Erase Flash Device

F<file>

Hex File Selection

H

Hold In Reset

L

Release from Reset

I

Use High Voltage MCLR

M<region>

Program Device 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.

N####,####

Program Memory Range

#### is a hexadecimal number representing Start and End Address in sequence.

P<part>

Part Selection. Example: 18F67J50

R<file>

Reprogram

S<file>

SQTP File Selection

V<Voltage>

Power Target (only for ICD3)

Y

Verify Device against selected HEX File

?

Help Screen

9.   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

10.       Troubleshooting

Failed to communicate to RealICE/ICD3:

·         Make sure only one session is communication with RealICE/ICD. If RealICE/ICD3 is already loaded in MPLAB X IDE, it will fail to communicate.

·         Make sure compatible firmware is loaded on RealICE/ICD3 for the selected device. To do that open MPLAB X IDE, select the specific device and select RealICE/ICD3. MPLAB X IDE will detect the firmware and if needed, it will update the RealICE/ICD3 (by default the RealICECMD/ICD3CMD will automatically update the firmware).

 

Programming Failed:

11.       Command Line Examples

Command

Operation

Command Line

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

Hold in Reset:

 

REALICECMD -P18F67J50 -H

ICD3CMD -P18F67J50 -H

Release from Reset:

 

REALICECMD -P18F67J50 -L

ICD3CMD -P18F67J50 -L

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

Power Target:

Power Target from ICD3:

ICD3CMD -P18F67J50 -V3.000 -B -C

Reprogram :

Reprogram with new Hex File:

REALICECMD -P18F67J50 -RF:\NewCode.hex -GFC:\OLDCode.Hex

ICD3CMD -P18F67J50 -RF:\NewCode.hex -GFC:\OLDCode.Hex

High Voltage MCLR :

Use High Voltage MCLR:

REALICECMD -P18F67J50  -I

ICD3CMD -P18F67J50  -I

Help:

Help for All commands:

REALICECMD -?

ICD3CMD -?