Microchip Technology MPLAB ICD 5 User Manual

Microchip Technology MPLAB ICD 5 User Manual

In-circuit debugger
Table of Contents

Advertisement

Quick Links

®
MPLAB
ICD 5 In-Circuit Debugger User's Guide

Notice to Development Tools Customers

Important: 
All documentation becomes dated, and Development Tools manuals are no exception. Our tools
and documentation are constantly evolving to meet customer needs, so some actual dialogs
and/or tool descriptions may differ from those in this document. Please refer to our website
(www.microchip.com/) to obtain the latest version of the PDF document.
Documents are identified with a DS number located on the bottom of each page. The DS format is
DS<DocumentNumber><Version>, where <DocumentNumber> is an 8-digit number and <Version>
is an uppercase letter.
For the most up-to-date information, find help for your tool at onlinedocs.microchip.com/.
User Guide
DS-50003529B -
1
©
2023 Microchip Technology Inc. and its subsidiaries

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MPLAB ICD 5 and is the answer not in the manual?

Questions and answers

Mike Rath
May 28, 2025

I am migrating from ICD 3 to ICD 5. What issues do I need to know to make it a successful migration?

1 comments:
Mr. Anderson
May 28, 2025

For a successful migration from MPLAB ICD 3 to MPLAB ICD 5, consider the following issues:

1. Firmware Compatibility: Ensure the firmware version on the ICD 5 supports the required features. Some features like runtime breakpoints may need a specific firmware version.

2. Device Support: Verify that the target device is supported by ICD 5 and that the Device ID matches the expected value.

3. MPLAB X IDE Version: Use MPLAB X IDE v6.10 or greater to access full features, including the Emergency Boot Firmware Recovery Utility.

4. Connection Checks: Ensure proper connections for test interfaces (PGC/PGD lines) and verify clock/data line read/write success.

5. Power and Self-Test: Perform initial power and self-tests to confirm hardware functionality.

6. LED Indicators: Use LED color indicators for status—cyan indicates recovery mode, purple indicates operational.

7. Emergency Recovery: Be prepared to use the emergency recovery tool if the device fails to communicate.

8. Debugger Features: Review updated debugger features such as USB CDC, Data Gateway Interface, and ARM trace support.

Addressing these points helps ensure a smooth transition to MPLAB ICD 5.

This answer is automatically generated

Summary of Contents for Microchip Technology MPLAB ICD 5

  • Page 1: Notice To Development Tools Customers

    Documents are identified with a DS number located on the bottom of each page. The DS format is DS<DocumentNumber><Version>, where <DocumentNumber> is an 8-digit number and <Version> is an uppercase letter. For the most up-to-date information, find help for your tool at onlinedocs.microchip.com/. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 2: Table Of Contents

    How Does It Work?............................64 7.2. What's Wrong?..............................64 Error Messages................................66 8.1. Types of Error Messages..........................66 8.2. General Corrective Actions..........................72 Debugger Function Summary............................74 9.1. Debugger Selection and Switching........................ 74 User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 3 Product Change Notification Service........................96 Customer Support...............................96 Product Identification System............................97 Microchip Devices Code Protection Feature......................97 Legal Notice..................................97 Trademarks.................................. 98 Quality Management System.............................99 Worldwide Sales and Service........................... 100 User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 4: Preface

    Preface Preface MPLAB ICD 5 documentation and support information is discussed in this section. Conventions Used in This Guide The following conventions may appear in this documentation: Table 1-1. Documentation Conventions Description Represents Examples Arial font: Italic characters Referenced books MPLAB ®...
  • Page 5 MPLAB ICD 5 In-Circuit Debugger Quick Start Guide Poster (DS50003240) ® This poster shows you how to connect the hardware and install the software for the MPLAB ICD 5 using a target board. User Guide DS-50003529B - ©...
  • Page 6: About The Debugger

    By default, the MPLAB ICD 5 connects to your PC through a high-speed USB 2.0 interface. However, you can also use Ethernet connections. The MPLAB ICD 5 connects to targets using a flat cable, connected at one end to the debugger, and at the other to the target device communication.
  • Page 7: Components

    The components of the MPLAB ICD 5 In-Circuit Debugger kit box are: • The rectangular MPLAB ICD 5 unit housed in a durable black and metallic case, which is accented with an LED indicator bar (see figure). On the sides of the unit are the USB connector, Ethernet connector, power connector, as well as the communication and debug connectors •...
  • Page 8: Block Diagram

    IF Tools USB Isolator HVC • HiFimeUSB Isolator • Topping HSO2 ISB Isolator Block Diagram Below is a block diagram of basic MPLAB ICD 5 unit operational capabilities. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 9: Using Mplab ® Icd 5 With Mplab X Ide And Mplab Ipe

    MPLAB X IDE webpage. Table 2-1. MPLAB X IDE Overview Use the desktop icon to launch the IDE. Create a new project or open an existing project. Select MPLAB ICD 5 as the hardware tool. User Guide DS-50003529B - ©...
  • Page 10 Table 2-2. MPLAB IPE Overview Use the desktop icon to launch the IPE. Select a device to program and then select MPLAB ICD 5 as the tool. Select on a button to Program, Erase, Read, Verify or Blank Check. For more on MPLAB IPE, including Advanced mode, see the MPLAB IPE User’s...
  • Page 11: Connections

    Power and Self Test MPLAB ICD 5 can be powered by USB-C power or Power over Ethernet (PoE). It does not use an external power supply. The MPLAB ICD 5 can provide power to the target with PoE. PoE also powers the tool if USB is unplugged.
  • Page 12: Pc Connections

    3.2.1 USB Default Connection The default connection between the PC and MPLAB ICD 5 unit is USB using a USB Type-C cable. It is recommended that you use the cable that comes with the kit to avoid communication issues. Note: Only USB communications can be used for trace.
  • Page 13 Note: A USB connection is required at first to setup Ethernet communication. Go to Tools> Manage Network Tools in MPLAB X IDE (see figure below). Under "Network Capable Tools Plugged into USB," select your debugger. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 14: Target Connections

    Power Debugging. Device and communication types, as well as an available adapter board, are discussed in the following sections. Note: MPLAB ICD 5 can power the target. For details, see 10.2. Power Specifications. Select powering the target in the Project Properties window, “ICD 5” category, “Power” option category.
  • Page 15 Connecting the Debugger to an RJ-45 Target via an RJ-45 Type Cable The MPLAB ICD 5 In-Circuit Debugger has an RJ-45 connector for communication to the target. Connect the RJ-45 type cable into the RJ-45 connector. Connect the other end of the cable to the RJ-45 connector on the target.
  • Page 16 Table 3-2. Pinouts for Debug Interfaces MPLAB ICD 5 DEBUG TARGET rotatethispage90 TTDI MOSI TVPP MCLR /Vpp MCLR RESET RESET TVDD VDD/VDDIO MISO SWCLK TAUX RESET RESET/dW RESET RESET TTMS SWDIO rotatethispage90 Black (8-pin) cable must be used for EJTAG, JTAG, SWD and ISP.
  • Page 17 RX pin moved because of wiring for other devices. These are example target connectors that are assumed similar to the debug unit (modular). Note: For 6-pin RJ11 into 8-pin RJ45 socket, pins 1 and 8 are lost. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 18 3.3.3 Debugger Adapter Board The Debugger Adapter Board is a connectivity board that gives MPLAB ICD 5 and MPLAB PICkit 5 Debuggers cable compatibility to demo boards with Atmel-ICE, Power Debugger and ARM style connectors. It supports JTAG, SWD and ICSP protocols in multiple connector formats. It is useful for debugging AVR Xplained demonstration boards with MPLAB PICkit 5 debuggers.
  • Page 19 Connections Figure 3-7. MPLAB ICD 5 Adapter Board (AC102015) Pinouts 3.3.4 SAM MCUs - JTAG/SWD Interfaces SAM devices feature the Serial Wire Debug (SWD) interface for programming and debugging and/or a JTAG interface with identical functionality. Check the device data sheet for supported interfaces of that device.
  • Page 20 Target voltage reference. Not used by MPLAB ICD 5. 3, 5, 9 Ground. All must be connected to ensure that the MPLAB ICD 5 and the target device share the same ground reference. Connected internally to the TRST pin on the AVR connector. Recommended as not connected.
  • Page 21 SWDIO Serial Wire Debug Data Input/Output Serial Wire Output (optional- not implemented on all devices) nSRST Reset Target voltage reference - not used by MPLAB ICD 5 3, 5, 9 Ground 3.3.5 AVR MCUs Connections AVR devices feature various programming and debugging interfaces. Check the device datasheet for supported interfaces of that device.
  • Page 22 Target voltage reference. The MPLAB ICD 5 samples the target voltage on this pin in order to power the level converters correctly. The MPLAB ICD 5 draws less than 1mA from this pin in this mode. 2, 10 Ground. All must be connected to ensure that the MPLAB ICD 5 and the target device share the same ground reference.
  • Page 23 Pin 2 (GND) Pin 3 (TDO) MISO Pin 4 (VTG) Pin 5 (TMS) Pin 6 (nSRST) /RESET Pin 7 (not connected) Pin 8 (nTRST) Pin 9 (TDI) MOSI User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 24 Consult the device data sheet for further information. When the UPDI interface is on a shared pin, the pin can be configured to be either UPDI, /RESET, or GPIO by setting the RSTPINCFG[1:0] fuses. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 25 Figure 3-15. UPDI Header Pinout Table 3-11. UPDI Pin Mapping AVR PORT Pin Target Pins Microchip STK600 UPDI Pinout Pin 1 (TCK) Pin 2 (GND) Pin 3 (TDO) UPDI_DATA Pin 4 (VTG) User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 26 The debugWIRE interface is for use on low pin-count devices. Unlike the JTAG interface which uses four pins, debugWIRE makes use of just a single pin (/RESET) for bidirectional half-duplex asynchronous communication with the debugger tool. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 27 When designing an application PCB which includes an Microchip AVR with the debugWIRE interface, the pinout shown in the figure below should be used. Figure 3-17. debugWIRE (SPI) Header Pinout PDO/MISO PDI/MOSI /RESET User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 28 PIC32M MIPS-based devices use EJTAG for debug and programming. 3.3.6.1 Connecting to a PIC32M EJTAG Target The MPLAB ICD 5 provides a direct connection for new designs or a legacy 14-pin 10-mil JTAG/EJTAG connection using the adapter board. 3.3.6.2 PIC32M EJTAG Pinout - 4-Wire JTAG PIC32M EJTAG pin names and descriptions are shown in the table below.
  • Page 29 6-pin and 8-pin ICSP interfaces. 3.3.7.2 ICSP Target Connection Circuitry The figure below shows the interconnections of the MPLAB ICD 5 In-Circuit Debugger to the ICSP connector on the target board. The diagram also shows the wiring from the connector to a device on the target PCB.
  • Page 30: Operation

    Operation Operation A simplified theory of operation of the MPLAB ICD 5 In-Circuit Debugger system is provided here. It is intended to provide enough information so that a target board can be designed that is compatible with the debugger for both debugging and programming operations. The basic theory of in-circuit debugging and programming is discussed so that problems, if encountered, are quickly resolved.
  • Page 31 • Change of flow, interrupt, and software breakpoints • Run-time read-out of Stack Pointer (SP) register, Program Counter (PC), and Status Register (SREG) • Register file read- and writable in Stopped mode User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 32 The megaAVR OCD is based on the JTAG physical interface. It supports the following features: • Complete program flow control • Full access to all registers and memory areas User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 33 If such code is already executing on the Microchip AVR device when starting a debug session, the MPLAB ICD 5 will assert the RESET line while connecting. If this line is wired correctly, it will force the target AVR device into Reset, thereby allowing a JTAG connection.
  • Page 34 When the application program in Run mode writes a byte of data to the OCDR register of the AVR device being debugged, the MPLAB ICD 5 reads this value out and displays it in the message window of the software front-end. The OCDR register is polled every 50 ms, so writing to it at a higher frequency will NOT yield reliable results.
  • Page 35 A bug existed on early versions of ATxmegaA1 devices that prevented the OCD from being enabled while the device was in certain sleep modes. There are two work-arounds to re-enable OCD: • Go into the MPLAB ICD 5. Options in the Tools menu and enable “Always activate external Reset when reprogramming device.”...
  • Page 36 Instead, the debugger must make use of the AVR BREAK instruction. This instruction can be placed in FLASH, and when loaded for execution, it will cause the AVR CPU to enter Stopped mode. To User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 37 • Set and clear DWEN manually (exercise caution, advanced users only!) Important: When manipulating DWEN manually, the SPIEN fuse must remain set to avoid having to use High-Voltage programming. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 38 IN operation. A NOP instruction must be placed between the OUT and the IN instruction to ensure that the correct value is present in the PIN register. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 39: Pic Mcu/Dspic Dsc - On-Chip Debugging

    To debug an application in MPLAB X IDE, you must create a project containing your source code so that the code may be built, programmed into your device, and executed as specified below: User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 40 4.4.1.3.2 Hardware or Software Breakpoint Selection To select hardware or software breakpoints: User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 41 3. Select Window>Debugging>Stopwatch. Click on the Properties icon on the left of the window and select the start and stop breakpoints. 4. Debug the program again to get the stopwatch timing result. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 42 4.4.2 ICSP Debugging There are two steps to using MPLAB ICD 5 In-Circuit Debugger as a debugger. The first requires that an application is programmed into the target device (MPLAB ICD 5 can be used for this). The second User Guide DS-50003529B - ©...
  • Page 43 For more information, refer to the MPLAB X IDE WebHelp. If the target device cannot be programmed correctly, the MPLAB ICD 5 will not be able to debug it. A simplified diagram of some of the internal interface circuitry of the MPLAB ICD 5 is shown in the figure below.
  • Page 44 • The target device is run in Debug mode. 4.4.2.3 Debugging Details The figure below illustrates the MPLAB ICD 5 In-Circuit Debugger system when it is ready to begin debugging. In the figure, Rpu=10 kΩ typical and Ric=4.7 kΩ. Note: There are programmable pullups and pulldowns instead of fixed resistor.
  • Page 45 If the device does not run, for whatever reason (no oscillator, faulty power supply connection, shorts on the target board, etc.), then the debug executive cannot communicate to the MPLAB ICD 5, and MPLAB X IDE will issue an error message.
  • Page 46 In the MPLAB X IDE, use the MPLAB ICD 5 as a programmer to program a non-ICE/-ICD device, that is, a device not on a header board. Set the MPLAB ICD 5 as the current tool (click the Debug Tool ICD 5 in the navigation window, then select File >...
  • Page 47: Debugger Features

    USB protocol, but every interface has its own configuration parameters and handling of communication. For details, refer to the interface-specific sections. Note that not all interfaces are User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 48 Select the Power interface beneath the debug tool DGI. Set up the interface using the controls under “Power Settings.” Table 5-4. Power Settings Controls Control Value Usage Enabled Channels Enable channel A only. Channel A is always enabled. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 49: Ci/Cd Support

    Output Voltage in mV Between 1600 mV and 5500 The MPLAB ICD 5 features an adjustable target supply that mV, or 0 can be used to power the target application. This setting enables and controls the output voltage of this supply. A selection of 0 disables the supply.
  • Page 50: Arm Itm/Swo Trace

    • trace OS and application events. • emit diagnostic system information. MPLAB ICD 5 is capable of streaming UART-format ITM trace to the host computer. Trace is captured on the TRACE/SWO pin of the 10-pin header (JTAG TDO pin). Data is buffered internally on the MPLAB ICD 5 and is sent over the trace interface to the host computer.
  • Page 51 5.4.4 Hardware Setup Preliminaries 1. Use USB communication between the PC and MPLAB ICD 5. Other communication types do not support trace. 2. Find devices that support ITM trace – see Help>Release Notes> Debug Features Support>Hardware Tool Debug Features by Device.
  • Page 52 (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) && /* ITM enabled */ ((ITM->TER & 1UL << port ) != 0UL) /* ITM Port enabled */ while (ITM->PORT[port].u32 == 0UL) User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 53 Note: This does not set the clock but informs the debugger of its value for runtime watch, data capture and trace. 5.4.5.4 Setup ITM Trace Select “Trace and Profiling” from “Option categories” drop down, 1. Select “ITM TraceUnder” from the “Data Collection Selection” drop down. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 54 ; Trace Clock Setup ; _WDWORD (0x400E064C, 0x4); // Select Master clock for ITM/ETM write,0x400E064C, 4 ;PMC->PMC_SCER = PMC_SCER_PCK3; // Enable PCK3 write,0x400E0600,0x800 User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 55 Note: There can be a delay in the display of data in the ITM Display window until there is enough data to fill the buffer. Some data can be lost during processing. Figure 5-5. Example Output in ITM Display Related Links 9.3.2. ITM Window and Related Dialogs User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 56: Sam (Arm) - Trace And Profiling

    When enabled, the bottom 32 KB system memory space is reserved for CoreSight ETB debug usage. The figure below shows an example where both error correction codes (ECC) and CoreSight ETB are enabled. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 57: Debugger Polling

    Figure 5-7. Memory with ECC and CoreSight ETB Debugger Polling MPLAB ICD 5 can be instructed by MPLAB Data Visualizer to repeatedly poll the Program Counter (PC) as fast as possible during active debug session with a target device. Though this will not yield a very high percentage of PC sampling or code trace, it can be useful in Code vs Power correlation to trap the areas of code which use more power than intended.
  • Page 58: Power Monitor

    For more on this software, see the MPLAB Data Visualizer Product Page. 5.7.1 About Power Monitoring When the MPLAB ICD 5 is connected to and powering the target, the following can be measured: User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 59 To open in MPLAB X IDE, select Window>Debugging>Data Visualizer. When the data visualizer opens, there will be a Power selection available under the MPLAB ICD 5 DGI list, as current sense is being used. Click on it to view Power Setting controls. For this use case, no power from the debugger will be used (Output Voltage = 0).
  • Page 60 Debugger Features Figure 5-9. MPLAB ICD 5 DGI Options Plot all power sources by clicking on the drop-down arrow and selecting Plot all sources. The plot data will start to stream. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 61: Troubleshooting First Steps

    Troubleshooting First Steps Troubleshooting First Steps If you are experiencing problems with MPLAB ICD 5 In-Circuit Debugger operation, the following sections are provided to help. Some Questions to Answer First 1. What device are you working with? Often an upgrade to a newer pack (DFP/TP) version for MPLAB X IDE is required to support newer devices.
  • Page 62: General Considerations

    6. There may be certain situations where the debugger is not operating properly and firmware may need to be downloaded or the debugger needs to be reprogrammed. See the following sections to determine additional actions. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 63: How To Use The Hardware Tool Emergency Boot Firmware Recovery Utility

    Debug>Hardware Tool Emergency Boot Firmware Recovery. Figure 6-2. Selecting Emergency Utility If the procedure was successful, the recovery wizard displays a success screen. The MPLAB ICD 5 will now be operational and able to communicate with the MPLAB X IDE, showing a purple LED color.
  • Page 64: Frequently Asked Questions (Faq)

    There is no cycle stealing with the MPLAB ICD 5. Is it possible to debug a dsPIC DSC device running at any speed? The MPLAB ICD 5 is capable of debugging at any device speed as specified in the device’s data sheet. What's Wrong? When MPLAB ICD 5 is not working as expected or not working, please see the sections below for help.
  • Page 65 __attribute__((__interrupt__)) _AltOscillatorFail(void); void __attribute__((__interrupt__)) _OscillatorFail(void) INTCON1bits.OSCFAIL = 0; //Clear the trap flag while (1); void __attribute__((__interrupt__)) _AltOscillatorFail(void) INTCON1bits.OSCFAIL = 0; while (1); • Use ASSERTs. For example: ASSERT (IPL==7) User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 66: Error Messages

    Error Messages Error Messages The MPLAB ICD 5 In-Circuit Debugger produces various error messages; some are specific, some are informational, and others can be resolved with general corrective actions. In general, read any instructions under your error message. If those fail to fix the problem or if there are no instructions, refer to the following sections.
  • Page 67 CORRUPTED_STREAMING_DATA=Invalid streaming data has been detected. Run time watch or trace data may no longer be valid. It is recommended that you restart your debug session. CPM_TO_TARGET_FAILED=An exception occurred during ControlPointMediator.ToTarget(). DATA_FLASH_MEMORY=Data Flash memory. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 68 FAILED_UPDATING_BP=Failed to update breakpoint:\nFile: %s\naddress: %08x. FAILED_UPDATING_FIRMWARE=Failed to properly update the firmware. FILE_REGISTER=file register. FIRMWARE_DOWNLOAD_TIMEOUT=ICD 5 timeout out during the firmware download process. FLASH_DATA_MEMORY=Flash data memory. FLASH_DATA=flash data. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 69 MEM_RANGE_OUT_OF_BOUNDS=The selected program range, %s, does not fall within the proper range for the memory area selected. Please check the manual program ranges on the debug tool's, "Memories to Program" property page. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 70 PRESERVE_MEM_RANGE_OUT_OF_BOUNDS=The selected preserve range, %s, does not fall within the proper range for the memory area selected. Please check the manual program ranges on the debug tool's, "Memories to Program" property page. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 71 Then go to the ICD5 node of the project properties and check the Enable Low Voltage Programming check box of the Program Options Option Category pane (low voltage programming is not valid for debugging operations). USERID_MEMORY=User Id Memory. USERID=user Id. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 72: General Corrective Actions

    2. Ensure that the cable(s) are of the correct length. 8.2.3 Debugger to Computer Communication Error Actions If the MPLAB ICD 5 In-Circuit Debugger and MPLAB X IDE are not communicating with each other: 1. Unplug and then plug in the debugger. 2. Reconnect to the debugger.
  • Page 73 6. Make sure the USB drivers are loaded. 8.2.6 Debug Failure Actions The MPLAB ICD 5 In-Circuit Debugger was unable to perform a debugging operation. There are numerous reasons why this might occur. See section Troubleshooting. 8.2.7 Internal Error Actions Internal errors are not expected nor should happen.
  • Page 74: Debugger Function Summary

    3. Select property pages from “Options categories.” Click on an option to see its description in the text box below it. Click to the right of an option to change it. Note: Options displayed may be different for different devices. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 75 The starting and ending hex address range in program memory for programming, reading, or (hex)* verification. Note: The address range does not apply to the Erase function. The Erase function will erase all data on the device. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 76 Check to not erase aux memory when programming. Uncheck to erase aux memory when programming. 9.2.4 ICD 5 Tool Options Set up MPLAB ICD 5 specific options. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 77 Enable and set up these features as specified in the following sections. 8-Bit and 16-Bit Devices Options available on this page depend on the trace/profiling features of the project device. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 78 If you are not capturing data, you may be missing samples (given your current interval). Try adjusting the unit selection and interval, for example, if you had 1 millisecond, try 990 microseconds. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 79 Enter the runtime clock (instruction) speed under this option category. This does not set the speed, but informs the debugger of its value for runtime watch, data capture and trace. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 80 For developers creating their own boards, ensure the Vdd rise time is less than 10 seconds. 9.2.9.2 Programming AVR Devices with UPDI MPLAB ICD 5 supports using the high-voltage mechanism to activate the AVR Unified Program and Debug Interface (UPDI). On low pin count AVR devices with UPDI, the UPDI pin can be configured as GPIO or RESET by configuring the RSTPINCFG configuration bits.
  • Page 81: Debugger Windows & Dialogs

    Right clicking in a column of the window shown above will pop up a menu with a list of functions. For more on these functions, see the MPLAB X IDE User’s Guide/Help file, “MPLAB X IDE Windows and Dialogs,” “Trace Window.” User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 82 Debugger Function Summary 9.3.2 ITM Window and Related Dialogs SAM ITM trace produces UART-format data that supports printf-style debugging on up to 32 ports. Figure 9-3. ITM Display User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 83 Debugger Function Summary Figure 9-4. ITM Select Ports Dialog Related Links 5.4. ARM ITM/SWO Trace User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 84: Hardware Specification

    3.1. Power and Self Test 10.3 Indicator Lights (LEDs) The top of MPLAB ICD 5 unit has two light pipes butted against to each other, each illuminated by an LED. The expected start-up sequence for the debugger is: 1. Purple - steady on for approximately 3 seconds.
  • Page 85: Pc Connection Specifications

    ® up to 480 Mbps Ethernet Direct or via network up to 100 Mbps Connectors available on the MPLAB ICD 5 unit for communication are described in the following sections. ® 10.4.1 USB Type-C Connector (J1) and Cable A USB Type-C connector and cable are provided for USB 2.0 communication between the debugger and a computer.
  • Page 86: 8-Pin Communication Hardware

    Hardware Specification Figure 10-1. Ethernet Connector on MPLAB ICD 5 Table 10-2. Ethernet Connector Pinout Pin Number Function EGND EGND EGND EGND EGND: Enclosure ground Table 10-3. Connector LEDs LED Location LED Color LED Function Top left Green LAN ACT...
  • Page 87 Pin numbering can be seen in the following diagram. Although the connectors are oriented differently on the tool and on the target, pin 1 is always pin 1 with relation to the connector. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 88 The modular cable plug pins are always numbered in the same order regardless of the plug orientation. Figure 10-4. Modular (RJ-45) Cable Transparent Plug The cable is reverse wiring based on the plugs view (see figure below.) User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 89: Communication Hardware

    10.6.1 Connecting an RJ-11 Type Cable to an RJ-45 Jack on the Debugger The MPLAB ICD 5 In-Circuit Debugger has an RJ-45 connector for communication to the target. Connect the RJ-11 type cable into the RJ-45 connector by simply inserting it into the center of the RJ-45 connector.
  • Page 90 The V sense connection draws very little current from the target processor. The actual power comes from the MPLAB ICD 5 In-Circuit Debugger system, as the V sense line is used as a reference only to track the target voltage. The V connection is isolated with an optical switch.
  • Page 91 Reserved Connector on Target Board Ground Target Bottom View of Modular Connector Pinout on Target Board 10.6.3.2 Modular Plug Specification • Manufacturer, Part Number – AMP Incorporated, 5-554710-3 User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 92: Recovery Specifications

    Recovery Specifications The MPLAB ICD 5 unit can be placed in Recovery mode - device reset and flash erase - using a paper clip or similar tool through a hole in the bottom of the unit to activate the hardware reset switch (see image below).
  • Page 93 Depending on the type of debugger-to-target communication that is used, there are some considerations for target board circuitry: • Target Connection Circuitry • Circuits That Will Prevent the Debugger From Functioning User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 94: Revision History

    – Compatible USB isolators – Image of ICD 5 box components – Description of box accessories • Post-initial release additions throughout the document that were non-gating for the release. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 95: Support

    To begin the registration process and select your preferences to receive personalized notifications, go to: www.microchip.com/pcn A FAQ and registration details are available on the webpage. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 96: Microchip Information

    Customers should contact their distributor, representative or ESE for support. Local sales offices are also available to help customers. A listing of sales offices and locations is included in this document. Technical support is available through the website at: www.microchip.com/support User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 97: Product Identification System

    It is your responsibility to ensure that your application meets with your specifications. Contact your local Microchip sales office for  User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 98: Trademarks

    The Adaptec logo, Frequency on Demand, Silicon Storage Technology, and Symmcom are registered trademarks of Microchip Technology Inc. in other countries. GestIC is a registered trademark of Microchip Technology Germany II GmbH & Co. KG, a subsidiary of Microchip Technology Inc., in other countries.
  • Page 99: Quality Management System

    2023, Microchip Technology Incorporated and its subsidiaries. All Rights Reserved. © ISBN: 978-1-6683-3390-7 Quality Management System For information regarding Microchip’s Quality Management Systems, please visit www.microchip.com/quality. User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...
  • Page 100: Worldwide Sales And Service

    Tel: 631-435-6000 Sweden - Stockholm San Jose, CA Tel: 46-8-5090-4654 Tel: 408-735-9110 UK - Wokingham Tel: 408-436-4270 Tel: 44-118-921-5800 Canada - Toronto Fax: 44-118-921-5820 Tel: 905-695-1980 Fax: 905-695-2078 User Guide DS-50003529B - © 2023 Microchip Technology Inc. and its subsidiaries...

Table of Contents

Save PDF