background image

FLASH_DATA_MEMORY=Flash data memory

FLASH_DATA=flash data

FRCINDEBUG_NEEDS_CLOCKSWITCHING=To use FRC in debug mode the clock switching configuration bits
setting must be enabled. Please enable clock switching and retry the requested operation.

FW_DOESNT_SUPPORT_DYNBP=The current PICkit 4 firmware does not support setting run time breakpoints for
the selected device. Please download firmware version %02x.%02x.%02x or higher.

GOOD_ID_MISMATCH=Target Device ID (0x%x) is a valid Device ID but does not match the expected Device ID
(0x%x) as selected.

HALTING=Halting...

HIGH=High

HOLDMCLR_FAILED=Hold in reset failed.

IDS_SELF_TEST_BOARD_PASSED=PICkit 4 is functioning properly. If you are still having problems with your
target circuit please check the Target Board Considerations section of the online help.

IDS_ST_CLKREAD_ERR=Test interface PGC clock line read failure.

IDS_ST_CLKREAD_NO_TEST=Test interface PGC clock line read not tested.

IDS_ST_CLKREAD_SUCCESS=Test interface PGC clock line read succeeded.

IDS_ST_CLKWRITE_ERR=Test interface PGC clock line write failure. Please ensure that the tester is properly
connected.

IDS_ST_CLKWRITE_NO_TEST=Test interface PGC clock line write not tested.

IDS_ST_CLKWRITE_SUCCESS=Test interface PGC clock line write succeeded.

IDS_ST_DATREAD_ERR=Test interface PGD data line read failure.

IDS_ST_DATREAD_NO_TEST=Test interface PGD data line read not tested.

IDS_ST_DATREAD_SUCCESS=Test interface PGD data line read succeeded.

IDS_ST_DATWRITE_ERR=Test interface PGD data line write failure.

IDS_ST_DATWRITE_NO_TEST=Test interface PGD data line write not tested.

IDS_ST_DATWRITE_SUCCESS=Test interface PGD data line write succeeded.

IDS_ST_LVP_ERR=Test interface LVP control line failure.

IDS_ST_LVP_NO_TEST=Test interface LVP control line not tested.

IDS_ST_LVP_SUCCESS=Test interface LVP control line test succeeded.

IDS_ST_MCLR_ERR=Test interface MCLR level failure.

IDS_ST_MCLR_NO_TEST=Test interface MCLR level not tested.

IDS_ST_MCLR_SUCCESS=Test interface MCLR level test succeeded.

IDS_TEST_NOT_COMPLETED=Interface test could not be completed. Please contact your local FAE/CAE to SAR
the unit.

INCOMPATIBLE_FW=The REAL ICE firmware in not compatible with the current version of MPLAB X software.

INVALID_ADDRESS=The operation cannot proceed because the %s address is outside the devices address range
of 0x%08x - 0x%08x.

JTAG_NEEDS_JTAGEN=The JTAG Adapter requires the JTAG enable configuration bit to be turned on. Please
enable this configuration bit before continuing.

 

Error Messages

©

 2020 Microchip Technology Inc.

 User Guide

DS50002751D-page 42

Summary of Contents for MPLAB PICkit 4

Page 1: ...icrochip com to obtain the latest documentation available Documents are identified with a DS number This number is located on the bottom of each page in front of the page number The numbering conventi...

Page 2: ...up 18 4 2 Debug Tutorial 18 4 3 Quick Debug Program Reference 18 4 4 Debugger Limitations 19 4 5 Common Debug Features 19 4 6 Connecting the Target Board 20 4 7 Setting Up the Target Board 20 4 8 Sett...

Page 3: ...58 11 4 Target Board Considerations 61 12 Revision History 63 12 1 Revision A May 2018 63 12 2 Revision B August 2018 63 12 3 Revision C October 2018 63 12 4 Revision D January 2020 63 13 Support 64...

Page 4: ...or messages and suggested resolutions 10 Debugger Function Summary A summary of debugger functions available in MPLAB X IDE when the MPLAB PICkit 4 In Circuit Debugger is chosen as the debug or progra...

Page 5: ...ensive help file for the MPLAB X IDE It includes an overview of embedded systems installation requirements tutorials details on creating new projects setting build properties debugging code setting co...

Page 6: ...install and use headers Headers are used to better debug selected devices without the loss of pins or resources See also the PEP and Header online Help file Introduction 2020 Microchip Technology Inc...

Page 7: ...debugger system executes code like an actual device because it uses a device with built in emulation circuitry instead of a special debugger chip All available features of a given device are accessib...

Page 8: ...d from power surges from the target VDD and VPP voltage monitors protect against overvoltage conditions all lines have over current protection Programming debugging pins with a programmable range of r...

Page 9: ...MPLAB processor extension paks 2 4 MPLAB PICkit 4 Block Diagram USB HS SYSTEM SIE I2C RGB LED uSD CARD HSMCI PGM IDENTIFIERS SPI SCALERS LOGIC BUFFER VDD MONITOR VPP MONITOR VDD GEN VPP GEN VPP ON VP...

Page 10: ...ections CAUTION Communication Failure Do not connect the hardware before installing the software and USB drivers CAUTION Debugger or Target Damage Do not change hardware connections while the debugger...

Page 11: ...e using as well as the application notes and the specific interface for additional information and diagrams 3 2 1 Standard Communication Target Connection USING SINGLE IN LINE CONNECTOR Use the single...

Page 12: ...d to be connected from the VPP MCLR line to VDD so that the line may be strobed low to reset the device Figure 3 4 Standard Connection to Target Circuitry 3 2 3 Target Powered In the following descrip...

Page 13: ...t floating Also devices with a VCAP line PIC18FXXJ for example should be connected to the appropriate capacitor or level Note The interconnection is very simple Any problems experienced are often caus...

Page 14: ...MPLAB PICkit 4 In Circuit Debugger system as a debugger The first requires that an application is programmed into the target device usually with the MPLAB PICkit 4 itself The second uses the internal...

Page 15: ...ust have its Configuration words programmed correctly These are set using the MPLAB X IDE The oscillator Configuration bits should correspond to RC XT etc depending on the target design For some devic...

Page 16: ...the instruction at the breakpoint address is executed the in circuit debug mechanism of the target device fires and transfers the device s program counter to the debug executive much like an interrup...

Page 17: ...memory for some target devices Special in circuit debug registers in the target device are disabled by MPLAB X IDE along with all debug features This means that a breakpoint cannot be set and registe...

Page 18: ...ol Help Contents MPLAB X IDE Help for detailed instructions on creating and setting up a new project and running and debugging code Items of note 1 Each debugger contains a unique identifier which whe...

Page 19: ...lable All for device breakpoints etc N A Serial Quick Time Programming SQTP N A Use the MPLAB IPE to generate the SQTP file Command line Operation Use MDB command line utility found by default in C Pr...

Page 20: ...ger For connection information see Debugger to Target Communication 4 7 2 Using ICE Devices Notice For header support see the latest Release Notes for MPLAB PICkit 4 in MPLAB X IDE v5 25 or greater Fo...

Page 21: ...n it has detected the target and has detected the device If you have not already done so connect the MPLAB PICkit 4 to the target board using the appropriate cables see 4 6 Connecting the Target Board...

Page 22: ...ion 4 11 1 Breakpoint Resources In 16 bit devices breakpoints data captures and run time watches use the same resources Therefore the available number of breakpoints is actually the available number o...

Page 23: ...dent on oscillator speed time to program Flash Memory and page size Breakpoint skidding Most devices See the online Help Limitations section for details No Where information about the breakpoint is wr...

Page 24: ...ode Figure 5 1 MPLAB PICkit 4 In Circuit Debugger Diagram Prerequisites for Programmer To Go MPLAB X IDE or MPLAB IPE v5 25 or greater must be installed on your computer MicroSDHC Card a formatted FAT...

Page 25: ...pack that supplies regulated 5V into the MPLAB PICkit 4 USB Micro B connector The USB power source used should meet the following minimum criteria Is able to supply at least 350 mA of current to the...

Page 26: ...ammer options should be set up for Programmer To Go operation In fact it is highly recommended to test programming a target device from the software first with all desired options to ensure the device...

Page 27: ...If both the Send image to tool and Program Device check boxes are unchecked see 5 3 3 Setting Up PTG Mode Without a Memory Card 8 Click Apply then OK Use the Make and Program Device Main Project icon...

Page 28: ...PICkit 4 2 Ensure that you have the appropriate connections to the device for Programmer To Go PICkit 4 is connected to the computer via the USB cable PICkit 4 is connected via the appropriate progra...

Page 29: ...cked the device connected to the MPLAB PICkit 4 is programmed Note If both the Send image to tool and Program Device check boxes are unchecked see 5 3 3 Setting Up PTG Mode Without a Memory Card 7 Cli...

Page 30: ...a microSDHC card inserted to the target board with the device specified in your project 2 Ensure that you have the appropriate connections to the device for Programmer To Go PICkit 4 is connected via...

Page 31: ...it tool does not detect Vdd from the target the LED will blink red to indicate an unexpected event Memory verify errors Device ID does not match If the data files for programming are not found or are...

Page 32: ...ation has somehow been interrupted Reconnect to the debugger in MPLAB X IDE or MPLAB IPE 6 Device not seated The device is not properly seated on the target board If the debugger is properly connected...

Page 33: ...igh for your circuit In MPLAB X IDE go to File Project Properties select PICkit 4 in Categories then Program Options Program Speed and select a slower speed from the drop down menu The default is Norm...

Page 34: ...downloaded When complete the LED is steady on blue and the debugger is ready for operation 6 3 3 How to Use the Hardware Tool Emergency Boot Firmware Recovery Utility WARNING Only use this utility to...

Page 35: ...success screen The MPLAB PICkit 4 will now be operational and able to communicate with the MPLAB X IDE If the procedure failed try it again If it fails a second time contact Microchip Support at https...

Page 36: ...at any device speed as specified in the data sheet Is it possible to debug a dsPIC DSC device running at any speed The MPLAB PICkit 4 In Circuit Debugger is capable of debugging at any device speed a...

Page 37: ...style code for example void __attribute__ __interrupt__ _OscillatorFail void void __attribute__ __interrupt__ _AltOscillatorFail void void __attribute__ __interrupt__ _OscillatorFail void INTCON1bits...

Page 38: ...g to debug 1 Deselect the debugger as the debug tool 2 Close your project and then close MPLAB X IDE or MPLAB IPE 3 Restart MPLAB X IDE or MPLAB IPE and reopen your project 4 Reselect the debugger as...

Page 39: ...REAS_TO_PROGRAM The following memory area s will be programmed AREAS_TO_READ The following memory area s will be read AREAS_TO_VERIFY The following memory area s will be verified BLANK_CHECK_COMPLETE...

Page 40: ...intMediator ToTarget DATA_FLASH_MEMORY Data Flash memory DATA_FLASH data flash DEBUG_INFO_PGM_FAILED Could not enter debug mode because programming the debug information failed Invalid combinations of...

Page 41: ...ying to load the program executive FAILED_GETTING_TEX Unable to obtain the ToolExecMediator FAILED_GETTING_TOOL_INFO Initialization failed Failed while retrieving tool database ri4 information FAILED_...

Page 42: ...IDS_ST_CLKWRITE_SUCCESS Test interface PGC clock line write succeeded IDS_ST_DATREAD_ERR Test interface PGD data line read failure IDS_ST_DATREAD_NO_TEST Test interface PGD data line read not tested...

Page 43: ...ddress boundary Please check the manual program ranges on the debug tool s Memories to Program property page MEM_RANGE_ERROR_UNKNOWN An unknown error has occurred while trying to validate the user ent...

Page 44: ...discharge delays POWER_ERROR_UNKNOWN An unknown power error has occurred POWER_ERROR_VDD_TOO_HIGH The VDD voltage desired is out of range It exceeds the maximum voltage of 5 5V POWER_ERROR_VDD_TOO_LO...

Page 45: ...gram property page PROGRAM_CFG_WARNING WARNING You have selected to program configuration memory Programming invalid values into any of the configuration fields may have unintended consequences Please...

Page 46: ...rting up properly UNKNOWN_MEMTYPE Unknown memory type UNLOAD_WHILE_BUSY PICkit 4 was unloaded while still busy Please unplug and reconnect the USB cable before using PICkit 4 again UPDATING_APP Updati...

Page 47: ...communicating with each other 1 Unplug and then plug in the debugger 2 Reconnect to the debugger 3 Try the operation again It is possible the error was a one time event 4 The version of MPLAB X IDE or...

Page 48: ...and should not happen They are used for internal Microchip development The most likely cause is a corrupted installation 8 2 4 Corrupted Installation Actions Another likely cause is exhausted system...

Page 49: ...Please see the product web page for details ETN37 MPLAB PICkit 4 VPP Overshoot Modification can be found on the MPLAB PICkit 4 product web page at https www microchip com Developmenttools ProductDeta...

Page 50: ...Tools find PICkit 4 and click on a serial number SN to select a debugger for use in the project then click Apply 10 2 Debugger Options Selection Debugger options are set in the Project Properties dial...

Page 51: ...below Program Memory Range s hex The range s of program memory to be programmed These are the starting and ending hex address range s in program memory for programming reading or verification Each ran...

Page 52: ...software breakpoints Table 10 2 Debug Option Category Use Software Breakpoints Check to use software breakpoints Uncheck to use hardware breakpoints See the following table to determine which type is...

Page 53: ...default is Normal If programming should fail using a slower speed may solve the problem 10 2 4 Freeze Peripherals Select from the list of peripherals to freeze or not freeze on program halt The availa...

Page 54: ...Firmware Check to use the latest firmware Uncheck to select the firmware version Firmware File Click in the right hand text box to search for a firmware file jam to associate with the debugger 10 2 9...

Page 55: ...do further programming the MPLAB PICkit 4 will have to use a high voltage pulse to reactivate the UPDI interface When using the high voltage pulse you must make sure that all circuits connected to the...

Page 56: ...ctor The target board is powered from its own supply Alternatively the debugger can power the target board only if the target consumes less than 50 mA Cable Length The computer to debugger cable shipp...

Page 57: ...proper connector alignment 7 Programming Connector The connector is an 8 pin SIL header 0 100 spacing that connects to the target device see 11 3 2 Pinouts for Interfaces 8 MicroSDHC Card Slot1 The m...

Page 58: ...ror Descriptions Bootloader Errors Description Red slow blink Power accessing the debugger s serial EEPROM Red fast blink Bootloader API commands cannot be processed White fast blink A runtime excepti...

Page 59: ...rcuit Debugger system Clock and data signals are protected from high voltages caused by faulty target systems or improper connections Clock and data signals are protected from high current caused from...

Page 60: ...IPS EJTAG CORTEX SWD AVR JTAG AVR ISP DW UPDI PDI AW DW IRE TPI 1 TVPP MCLR MCLR MCLR 2 TVDD VDD VIO_REF VTG VTG VTG VTG VTG VTG VTG VTG 3 GND GND GND GND GND GND GND GND GND GND GND 4 PGD DAT TDO SWO...

Page 61: ...his is a stress rating only and functional operation of the device at those or any other conditions above those indicated in the operation listings of this specification is not implied Exposure to max...

Page 62: ...3 2 5 Circuits That Will Prevent the Debugger From Functioning Hardware Specification 2020 Microchip Technology Inc User Guide DS50002751D page 62...

Page 63: ...d 3 2 Target Communication Connections 12 3 Revision C October 2018 Updated diagram in Figure 11 2 Updated information in TableTable 11 5 Added Figure 11 3 to provide pinout information for the debugg...

Page 64: ...gories of tools are listed below Compilers The latest information on Microchip C compilers assemblers linkers and other language tools These include all MPLAB C compilers all MPLAB assemblers includin...

Page 65: ...c characters and decimal digits 0 1 9 ANDed Breakpoints Set up an ANDed condition for breaking i e breakpoint 1 AND breakpoint 2 must occur at the same time before a program halt This can only be acco...

Page 66: ...language program which are used to describe machine specific properties Attribute Section GCC Characteristics of sections such as executable read only or data that can be specified as flags in the as...

Page 67: ...PIC MCU and dsPIC DSC modes of operation A Configuration bit may or may not be preprogrammed Control Directives Directives in assembly language code that cause code to be included or omitted based on...

Page 68: ...or is a microprocessor that is designed for use in digital signal processing Directives Statements in source code that provide control of the language tool s operation Download Download is the process...

Page 69: ...or symbols separated by arithmetic or logical operators Extended Microcontroller Mode In extended microcontroller mode on chip program memory as well as external memory is available Execution automat...

Page 70: ...from the stack based local variables Provides a convenient base from which to access local variables and other values for the current function Free Standing An implementation that accepts any strictly...

Page 71: ...side source such as from a hex file Initialized Data Data which is defined with an initial value In C int myVar 5 defines a variable which will reside in an initialized data section Instruction Set Th...

Page 72: ...the command files of a linker They define linker options and describe available memory on the target platform Listing Directives Listing directives are those directives that control the assembler list...

Page 73: ...Directives Directives that control the execution and data allocation within macro body definitions Makefile Export to a file the instructions to Make the project Use this file to Make your project out...

Page 74: ...Microchip s next generation in circuit emulator that works with MPLAB IDE MPLAB X IDE See ICE ICD MPLAB SIM Microchip s simulator that works with MPLAB IDE MPLAB X IDE in support of PIC MCU and dsPIC...

Page 75: ...Octal The base 8 number system that only uses the digits 0 7 The rightmost digit counts ones the next digit counts multiples of 8 then 82 64 etc Off Chip Memory Off chip memory refers to the memory se...

Page 76: ...gger Other names are Puck if the enclosure is round and Probe not be confused with logic probes Power on Reset Emulation A software randomization process that writes random values in data RAM areas to...

Page 77: ...ion or target board Psect The OCG equivalent of a GCC section short for program section A block of code or data which is treated as a whole by the linker PWM Signals Pulse Width Modulation Signals Cer...

Page 78: ...signed to a fixed location in memory Relocatable Section 16 bit assembler A section whose address is not fixed absolute The linker assigns addresses to relocatable sections through a process called re...

Page 79: ...a fetch during the execution of the previous instruction the source data address and value and the destination data address appear when the opcodes is actually executed and the destination data value...

Page 80: ...ne gets into an endless loop or does not return properly the next breakpoint will never be reached The Step Over command is the same as Single Step except for its handling of CALL instructions Step Ou...

Page 81: ...is uploaded to the MPLAB IDE MPLAB X IDE trace window Trace Memory Trace memory contained within the emulator Trace memory is sometimes called the trace buffer Trace Macro A macro that will provide tr...

Page 82: ...compiler applying optimizations that affect how the variable is accessed in memory Warning Warning MPLAB IDE MPLAB X IDE An alert that is provided to warn you of a situation that would cause physical...

Page 83: ...sentative or Field Application Engineer FAE for support Local sales offices are also available to help customers A listing of sales offices and locations is included in the back of this document Techn...

Page 84: ...KS Analog for the Digital Age Any Capacitor AnyIn AnyOut BodyCom CodeGuard CryptoAuthentication CryptoAutomotive CryptoCompanion CryptoController dsPICDEM dsPICDEM net Dynamic Average Matching DAM ECA...

Page 85: ...52 China Xiamen Tel 86 592 2388138 China Zhuhai Tel 86 756 3210040 India Bangalore Tel 91 80 3090 4444 India New Delhi Tel 91 11 4160 8631 India Pune Tel 91 20 4121 0141 Japan Osaka Tel 81 6 6152 7160...

Reviews: