Freescale Semiconductor Microcontrollers

839

Microcontrollers Debugger Manual

Book VIII - Environment

Variables

Book VIII Contents

Each section of the Debugger manual includes information to help you become more

familiar with the Debugger, to use all its functions and help you understand how to use the

environment. This book, the Debugger Environment Variables, defines the HC08 and

HC(S)08 environment variables, both those environment variables used by the debugger

engine and those specific to individual debugger connections.

This book is divided into the following chapters:

•Debugger Engine Environment Variables

•Connection-Specific Environment Variables

Contents

Main How to Contact Us Table of Contents Introduction Book I - Debugger Engine 1 Introduction 25 2 Debugger Interface 27 3 Debugger Components 61 4 Control Points 157 5 Real Time Kernel Awareness 185 6 How To... 199 7 CodeWarrior IDE Integration 215 8 Debugger DDE Capabilities 217 9 Synchronized Debugging Through DA-C IDE 219 Book II - HC08 Debug Connections 10 Microcontroller Debugging First Steps 239 11 HC08 Full Chip Simulation 253 12 MON08 Interface Connection 333 13 ICS MON08 Interface Connection 349 14 HC08 P&E Multilink/Cyclone Pro Connection 365 15 HC08 ICS P&E Multilink/Cyclone Pro Connections 381 16 SofTec HC08 Connection 395 17 HC08 FSICEBASE Emulator 401 Book III - HCS08 Debug Connections 18 HCS08 Full Chip Simulation 431 19 HCS08 P&E Multilink/Cyclone Pro Connection 467 20 HCS08 Open Source BDM Connection 477 21 HCS08 Serial Monitor Connection 487 22 SofTec HCS08 Connection 497 23 HCS08 On-Chip DBG Module 503 Book IV - RS08 Debug Connections 24 RS08 Full Chip Simulation 547 25 RS08 P&E Multilink/Cyclone Pro Connection 553 26 RS08 Open Source BDM Connection 561 27 SofTec RS08 Connection 567 Book V - ColdFire V1.0 Debug Connections 28 ColdFire V1 Full Chip Simulation Connection 577 29 ColdFire P&E Multilink/Cyclone Pro Connection 669 30 SofTec ColdFire Connection 677 31 ColdFire On-Chip DBG Module 687 Book VI - Connection Common Features 32 Flash Programming 699 33 Debugging Memory Map 715 Book VII - Commands 34 Debugger Engine Commands 731 Book VIII - Environment Variables 35 Debugger Engine Environment Variables 841 36 Connection-Specific Environment Variables 861 Book IX - Debugger Legacy 37 Legacy PEDebug Target Interface 865 Page Page Introduction Manual Contents Manual Contents Book I - Debugger Engine Book I Contents Page Introduction Freescale Debugger Debugger Application Introduction Debugger Features Debugger Features Demo Version Limitations on Components Debugger Interface Application Programs Starting the Debugger Starting from within the IDE Starting Debug from the Project Window Starting Debug from the Main Window Menu Bar Debugger Command Line Start Command Line Options -T=<time>: Test mode -Prod=c:\demoproject\test.pjt -Target=<targetname> - Target=sim Order of Commands Debugger Main Window Debugger Main Window Toolbar Debugger Main Window Status Bar Main Window Menu Bar File Menu Page Configuration Window Command Buttons: View Menu Customizing the Toolbar Examples of View Menu Options Page Run Menu Table 2.4 Run Menu Description Run > Halt Connection Menu Loading an Executable File Load Executable File Window Open Button Load Options Buttons Open and Load Code Options Area Connection Command File Window Startup Command File Reset Command File Preload Command File Postload Command File Component Menu Page Page Window Menu Help Menu Component Associated Menus About Box Component Associated Menus Component Main Menu Component Associated Menus Microcontrollers Debugger Manual Component Files Component Windows Object Info Bar Component Context Menu Highlights of the User Interface Activating Services with Drag and Drop Example: To Drag and Drop an Object Drag and Drop Combinations Dragging from Assembly Component Window Dragging from Data Component Window Dragging from Source Component Window Dragging from the Memory Component Window Dragging from Procedure Component Window Dragging from Register Component Window Dragging from Module Component Window Selection Dialog Box Page Debugger Components Component Introduction CPU Components Window Components Component Introduction Connection Components Loading Component Windows Page General Debugger Components Assembly Component Assembly Menu Setting Breakpoints Show PC Dialog Box Table 3.2 Assembly Context Menu Description Retrieving Source Statement Command Line Component Keying In Commands Recalling a Line from the Command Line History Scrolling the Command Component Window Content Clearing the Line or a Character of the Command Line Command Interpretation Command Menu Cache Size Coverage Component Coverage Operations Coverage Menu Output File Output File Filter Output File Save Split View Associated Context Menu DA-C Link Component DA-C Link Operation DA-C Link Menu Connection Specification Dialog Box Drag Out Data Component Data Operations Expression Editor Expression Command file Data Menu Scope Submenu Format Submenu Format Selected and All Sub Menu Mode Submenu Update Rate Dialog Box Options Submenu Pointer as Array Option Name Width Option Zoom and Sort Submenus Page SUBMENU Open Module Page Memory Component Microcontrollers Debugger Manual Memory Address Spaces Banked/Window Paged Memory: Physical/Local vs. Logical display Memory Operations Memory Menu Word Size Submenu Format Submenu Mode Submenu Display Submenu Fill Memory Display Address CopyMem Submenu Search Pattern Refresh Update Rate Memory Context Menu Page Module Component Module Operations Module Menu Procedure Component Procedure Operations Procedure Menu Page Profiler Component Profiler Operations Profiler Menu Split View Associated Context Menu Profiler Output File Functions Output File Filter Recorder Component Recorder Operations Terminal and TestTerm Record Recorder Menu Register Component Status Register Bits Editing Registers Register Menu (Format Submenu) Page Page Source Component Tool Tips Features On-Line Disassembling Setting Temporary Breakpoints Setting Permanent Breakpoints Folding and Unfolding Source Menus Figure 3.63 Source Associated Context Menu Table 3.33 Source Associated Context Menu Description Table 3.33 Source Associated Context Menu Description ( Open Source File Go to Line Find Operations Find Procedure Folding Menu Page Terminal Component Configure Terminal Connections Input and Output File File Control Commands Page How to Use Virtual SCI Trace Component Trace Operations Trace Menu Page Page Visualization Utilities Inspector Component Components Icon Stack Icon Symbol Table Events Icon Exceptions Icon Object Pool IO Registers Inspector Operations Page Inspector Menu Page Visualization Tool Component Edit Mode and Display Mode Add New Instrument Instrument Selection Move Instruments Resize Instruments VisualizationTool Menu Table 3.43 Visualization Tool Menu Description ( Table 3.44 VisualizationTool Context Menu Menu entry Context Description Table 3.44 VisualizationTool Context Menu ( Menu entry Context Description VisualizationTool Properties Instruments Table 3.46 Instruments Properties Attributes Attribute Description TargetObject.#210 PORTB.PORTB (check exact spelling using Inspector) counter Analog Instrument Bar Instrument Bitmap Instrument DILSwitch Instrument Knob Instrument LED Instrument 7-Segment Display Instrument Switch Instrument Text Instrument Page Page Page Page Control Points Breakpoints Page Breakpoints Tab Multiple Selections in List Box Checking Expressions Saving Breakpoints Breakpoint File (.BPT) Example Setting Breakpoints Positions Where a Breakpoint Is Definable Temporary Breakpoints Setting Temporary Breakpoints Holding down the left mouse button and pressing the T key: Permanent Breakpoints Setting Permanent Breakpoints Counting Breakpoints Setting Counting Breakpoints Holding down the left mouse button and pressing the S key: Using the Source Context Menu: Conditional Breakpoints Setting Conditional Breakpoints Holding down the left mouse button and pressing the S key: Deleting Breakpoints Using Delete Breakpoint from Source Context Menu Holding down the left mouse button and pressing the D key: Choosing Show Breakpoints from Source Context Menu Associate a Command with a Breakpoint In the Breakpoints tab of the Controlpoints Configuration window: Watchpoints Page Watchpoints Tab Multiple Selections Checking Syntax Setting Watchpoints Setting a Read Watchpoint Using the Left Mouse Button and Pressing the R Key: Setting a Write Watchpoint Using the Left Mouse Button and Pressing the W Key: Defining a Read/Write Watchpoint Using the Left Mouse Button and Pressing the B Key: Defining a Counting Watchpoint Using the Left Mouse Button and Pressing the S Key: Defining a Conditional Watchpoint Using the Left Mouse Button and Pressing the S Key: Deleting a Watchpoint Use Delete Breakpoint from Context Menu: Using the Left Mouse Button and Pressing the D Key: Choosing Show Watchpoints from Data Context Menu: Associate a Command with a Watchpoint Markpoints Page Page Setting Markpoints Setting Markpoints Setting a Source Markpoint Use the Source Context Menu: Setting Markpoints Microcontrollers Debugger Manual Setting a Data Markpoint Use the Data Context Menu: Setting a Memory Markpoint Use the Memory Context Menu: Halting on a Control Point Halting on a Control Point Counting Control Point Conditional Control Point Control Point with Command Real Time Kernel Awareness Task Description Language Inspecting Task State RTK Interface Task Description Language Task Description Language Microcontrollers Debugger Manual Application Example Application Example Inspecting Kernel Data Structures Microcontrollers Debugger Manual Inspecting Kernel Data Structures OSEK Kernel Awareness OSEK Run Time Interface ORTI File and Filename ORTI File Structure OSEK RTK Inspector Component Inspector Task Inspector Stack Inspector SystemTimer Inspector Alarm Inspector Message Page How To... How To Configure the Debugger For Use from Desktop Starting Debugger from CodeWarrior IDE Defining the Default Directory in the MCUTOOLS.INI Starting Debugger from CodeWarrior IDE Automating Debugger Startup Microcontrollers Debugger Manual Automating Debugger Startup How To Load an Application How To Load an Application How to Start an Application How to Stop an Application Microcontrollers Debugger Manual How to Stop an Application How to Step in the Application On Source Level How to Step in the Application On the Next Source Instruction Step Over a Function Call (Flat Step) Step Out from a Function Call Step on Assembly Level How to Work on Variables Display Local Variable from a Function Display Global Variable from a Module Opening Module Component Using Context Menu Change Format for Variable Value Display Modify a Variable Value Get the Address Where a Variable is Allocated Inspect Memory Starting at a Variable Location Address Load an Address Register with the Address of a Variable How to Work on the Register Change Format of Register Display Modify a Register Content Modify Index or Accumulator Register Content Modify Bit Register Content Start Memory Dump at Address Where Register is Pointing Using Drag and Drop Choose Address Modify Content of Memory Address Modify Content of Memory Address How to Consult Assembler Instructions Generated by a Source Statement Using Drag and Drop Holding down the left mouse button and pressing the R key How to View Code How to View Code Using Context Menu Using Assembly Menu How to Communicate with the Application How to Communicate with the Application CodeWarrior IDE Integration Debugger Configuration Page Debugger DDE Capabilities Introduction DDE Implementation Driving Debugger through DDE Debugger DDE Capabilities Synchronized Debugging Through DA-C IDE Configuring DA-C IDE for Freescale Tool Kit \Addons\DA-C Create New Project Configure Working Directories Project Root Directory Referential Project Root Directory Database Directory Configure File Types Configure Library Path Source Preprocessor - Header Directories Preprocessor - Preinclude File Adding Files to Project Building The Database Page Compiler Configuration Linker Configuration Maker Configuration Debugger Interface DA-C IDE and Debugger Communication Communication DLL Installation Debugger Properties Configuration Debugger Project File Configuration Synchronized Debugging Microcontrollers Debugger Manual Synchronized Debugging Troubleshooting Troubleshooting Troubleshooting Microcontrollers Debugger Manual Page Book II - HC08 Debug Book II Contents Page Microcontroller Debugging First Steps Technical Considerations Full Chip Simulation Considerations Technical Considerations HC08 Serial Monitor Considerations ICS MON08 Interface Connection P&E Multilink/Cyclone Pro Considerations ICS P&E Multilink/Cyclone Pro Considerations SofTec HC08 Considerations Debugging First Steps Using the Wizard Page Page Page Page Switching Connections Loading the Full Chip Simulation Connection Page Loading the P&E Multilink/Cyclone Pro Connection Page Page Loading the HC(S)08 or RS08 Open Source BDM Connection Page HC08 Full Chip Simulation Page Select Device Option Full Chip Simulation Module Commands Run Till Cycle Option Initialize Input Ports On Startup Peripheral Modules Options ADC Module Option ADC User Commands ADDI Command ADCLR Command Clock Generation Module Option CGM Commands XTAL Command High-Resolution PWM Module High-Resolution PWM Commands Page SHTDWN Command Input/Output (I/O) Ports Module Input/Output Ports Commands Page External Interrupt Module IRQ Commands Keyboard Interrupt Module Keyboard Interrupt Commands Page Multi-Master Inter-Integrated Circuit Page Multi-Master Inter-Integrated Circuit Module Commands IICDI Command Syntax: Page IICDO IICCLR FCSMSCAN Controller Module FCSMSCAN08 Background and Assembly Example FCSDemo CAN Program Page Page Page Page Page Page Page Page Page Page Page Page FCSMSCAN Commands CANCLR Command CANIN Command CANOUT Command FCS Programmable Timer Interrupt FCS Serial Communications Interface Page FCSSCI Commands SCCLR Command SCDI Command SCDO Command FCS Slave LIN Interface Controller Module Page FCSSLIC Commands SLCCLR Command SLCDI Command SLCOUT Command FCS Serial Peripheral Interface Module Page FCSSPI Commands SPCLR Command SPDI Command SPDO Command SPFREQ Command FCSTimer Interface Module Page Page FCS Timer Interface Module Commands Page FCS Universal Serial Bus (USB) Module Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page USB Commands USBCLR Command USBIN Command USBOUT Command USBRESET Command Page MON08 Interface Page Tpd and Tpu Timing Listboxes Target Has RESET Button MON08 Cable Connection Communications Type Page Turn Target Power Off and Leave Target Power On Radio Buttons Page STATUS Area Page Active Mode Connection Menu Options Page Start Expert Mode Programmer Option Page Class 1 Device Class 2 Device Class 3 Device Class 4 Device Page ICS MON08 Interface ICS Mode Page Page Tpd and Tpu Timing Textboxes Target Has RESET Button MON08 Cable Connection Communications Type Cycle Power Radio Button Page Page Page Active Mode Connection Menu Options Prompt on Flash Program Checkbox Trim Options Sync to PLL Change Checkbox Start Expert Mode Programmer Option Page Class 1 Device Class 2 Device Class 3 Device Class 4 Device Page Page HC08 P&E Multilink/Cyclone Pro Connection Page Page Tpd And Tpu Timing Textboxes Target Has RESET Button Checkbox MON08 Cable Connection Communications Type Cycle Power Down/Up Radio Button Page Page Page Connection (MultilinkCyclonePro) Menu Page Page Start Expert Mode Programmer Option Page Debugging Limitations Debugging Tips Class 5 Device Class 7 Device Class 8 Device HC08 ICS P&E Multilink/ Cyclone Pro Connections Page Page Page Tpu and Tpd Timing Textboxes Target has RESET Button MON08 Cable Connection Communications Type Power Up/Down Radio Buttons Cycle Power Up/Down Radio Buttons Page Page Page Page Page Class 5 Device Class 7 Device Class 8 Device SofTec HC08 Connection SofTec HC08 Technical Considerations CodeWarrior IDE and SofTec HC08 Using the Stationery Wizard Using the Stationery Wizard From Within an Existing Project inDart-HC08 Menu Options Users Manual Option Page About Dialog Box HC08 FSICEBASE Emulator FSICEBASE Overview System Requirements System Features System Components Basic Components Additional Components Setting Up the FSICEBASE System Microcontrollers Debugger Manual Setting Up the FSICEBASE System Setting Up the Hardware Setting Up the FSICEBASE System Establishing Communication Microcontrollers Debugger Manual Establishing Communication Communication Through Ethernet Port Establishing Communication Communication Through USB Port Setting Up the System Specifying A Connection Specifying Communication Information Page Assigning an IP Address to FSICEBASE installation_directory Page Specifying a Memory Map Page To Modify a Memory Map: Specifying the Clock Speed Page Setting Up Logic Cables and Connectors Microcontrollers Debugger Manual Emulation System Reset Setting Up Logic Cables and Connectors Setting Up Logic Cables and Connectors Bus State Analyzer (BSA) Using BSA Defining Events Page Page Recording Modes A -> B -> C -> D Nth Event: A+B+C+D Time Tag Clock Frequency Collecting Bus Data Viewing Data Page Page Book III - HCS08 Debug Book III Contents Page HCS08 Full Chip Simulation Page Full Chip Simulation Module Commands Run Till Cycle Command Initialize Input Ports On Startup View Register Files Command Peripheral Modules Commands ADC Module ADC Module Commands ADDI Command ADCLR Clock Generation Module Clock Generation Module Commands XTAL Command Inter-Integrated Circuit Module Page Inter-Integrated Circuit Module Commands IICDI Command Page IICDO Command IICCLR Command Input/Output (I/O) Ports Module Input/Output Ports User Commands Page External Interrupt (IRQ) Module Page IRQ Commands Keyboard Interrupt Module Keyboard Interrupt Commands Modulo Timer Interrupt Module Serial Communications Interface Module Page SCI Commands SCCLR Command SCDI Command SCDO Command Serial Peripheral Interface Module SPI Commands SPCLR Command SPDI Command SPDO Command SPFREQ Command Timer Interface Module Page Timer Module Commands Page Page Page HCS08 P&E Multilink/ Cyclone Pro Connection Page Trim Control Hotsync Button MultilinkCyclonePro Menu Description Debugging Memory Map Option Disable Interrupts while stepping Option Prompt on Flash Program Checkbox Trim Options Non-Volatile Memory Preservation Sync to PLL Change Checkbox Start Expert Mode Programmer Option Trigger Module Settings Option Bus Trace Option Page HCS08 Open Source BDM Page Page HCS08 Open Source BDM Menu Options Setup Option Page HCS08 Open Source BDM Setup Dialog Box Page Page Page Page HCS08 Serial Monitor Serial Monitor Technical Considerations CodeWarrior IDE and Serial Monitor Page Page Page Page MONITOR-HCS08 Menu Options Select Derivative Monitor Setup Window Monitor Communication Tab Vector Table Mirroring Tab Derivative Selection Dialog Box Page SofTec HCS08 Connection SofTec HCS08 Technical Considerations CodeWarrior IDE and SofTec HCS08 Connection Page Page SofTec HCS08 Menu Options Trigger Module Settings About Dialog Box HCS08 On-Chip DBG Module Reference Document DBG Features Specific Connection Menu Options Specific Connection Menu Options Context Menu Entries in Source, Data, Assembly and Memory Windows Source and Assembly Windows Page Page Trigger Stored as Markpoints Data and Memory Windows Page Page Expert Triggers Page Trigger Settings Trigger Module Usage DBG Support Status Bar Item Trigger Module Settings Window DBG Module Mode Setup Automatic Mode (Default) Expert Mode Expert Mode Tab Profiling and Coverage Mode Disabled Mode Memory Access Triggers Memory Access at Address A and Value on Data Bus Match Memory Access at Address A and Value on Data Bus Mismatch Instruction Triggers Instruction at Address A is Executed Page Page Capture Triggers Capture Read/Write Values at Address B Capture Read/Write Values at Address B After Access at Address A DBG Module Options Program Code Change of Flow Recording Data Recording Trigger Editing Trigger Module Settings Window - Display Information General Settings Tab Trace Component Window Instructions Display Graphical Display Textual Display Column Display and Moving Dumping Frames to File Goto Frame Clearing Frames DBG Module FIFO/Buffer Display Recorded Data Display Limitations Limitations HCS08 DBG V3 New Features MMU and Extended Address Space LOOP1 mode HCS08 DBG V3 New Features Ability to record until Reset and from Reset Recording until reset Page Recording from Reset Page Page Page Book IV - RS08 Debug Book IV Contents Page RS08 Full Chip Simulation Connection (RS08FCS) Menu Full Chip Simulation Module Commands Port Pins Module Modify MTIM TCLK Show Processor Pins Run Till Cycle Command View Register Files Command Peripheral Modules Commands RS08 P&E Multilink/Cyclone Pro Connection Page MultilinkCyclonePro Menu Description Page Page Show Processor Pins Page Page RS08 Open Source BDM Page Page RS08 Open Source BDM Menu Options Setup Option Select Derivative Option Reset to Normal Mode Option Show Status Option RS08 Open Source BDM Setup Dialog Box Page SofTec RS08 Connection SofTec RS08 Technical Considerations CodeWarrior IDE and SofTec RS08 Connection Page Page Page SofTec RS08 Menu Options Page Page Page Page Page ColdFire V1 Full Chip Simulation Connection Full Chip Simulation Menu Debugger Status Bar with Full Chip Simulation Open I/O Component Dialog Box Command Files Window Setcpu Command File Memory Configuration Memory Configuration Dialog Box Features Memory Configuration Modes Memory Configuration Settings Open Memory Block Save Memory Block Memory Check Options Memory Configuration Module Startup Memory Block Setting Memory Block Properties Memory Configuration Dialog Box Command Buttons Access Details Dialog Box Output Clock Frequency Setup Bus Trace Full Chip Simulation Warnings WARNING_SETUP Command Page MESSAGE_HIDE_ID Command MESSAGE_SHOW_ID Command MESSAGE_HIDE_RESET Command FCS and Silicon On-Chip Peripherals Simulation FCS and Silicon On-Chip Peripherals Simulation FCS Visualization Utilities Analog Meter Component Analog Meter Operations Analog Meter Menu IO_LED Component IO_LED Operations IO_LED Menu LED Component LED Operations LED Menu Phone Component Phone Operations ADC/DAC Component Description Signal Generator Visualization Screen ADC DAC ADC/DAC Menu ADC/DAC Setup Dialog Box Conversion Parameters Dialog Box Display Properties Dialog Box ADC/DAC Operations Drag Out: Drag Into: IT_Keyboard Component IT_Keyboard Menu Interruption Keyboard Setup LCD Component LCD Operation Sending Information to the Display Instruction Listing Cursor or Display Shift Set DDRAM Address Function Set The Initialization Step LCD Menus LCD Display Monitor Component Monitor Menu Add Channel Monitor Settings Change Colors Push Buttons Component Push Buttons Menu Page Drop Into: Programmable IO_Ports Component Programmable IO_Ports Menu Port Address 7-Segments Display Component 7-Segments Display Menu 7-Segments Display Setup Control Bits Configuration Drag Out: Stimulation Component Stimulation Context Menu Example of a Stimulation File TestTerm Component Output Redirection How to Redirect Using TestTerm TestTerm Menu Terminal Component Configure Terminal Connections Input and Output File File Control Commands Page Using the Virtual SCI Wagon Component Wagon Menu Wagon Setup Control Bits Configuration True Time I/O Stimulation Stimulation Program Examples Running an Example Program Without Stimulation Page Example Program with Periodic Variable Stimulation Example Program with Stimulated Interrupt Page Example of a Larger Stimulation File Detailed Explanation Stimulation Input File Syntax Remarks Electrical Signal Generators and Signals Application to Device Pins Signal IO Component Signal Description File EBNF Signal File Format Signal Block Description File Example 1 File Example 2 File Parameters Signal IO Usage Signal Commands SETSIGNALFILE Command CLOSESIGNALFILE Command Remarks Base Signal Files Provided Virtual Wire Connections with the Pinconn IO Component Pinconn IO Pinconn Commands CONNECT DISCONNECT CONNECT_STATE Command Set to Apply Signal on ATD Pin FCS Tutorials Guess the Number Step 1 - Environment Setup Step 2 - Create the project Page Step 3 - Target CPU Window Step 4 - Bean Selector Window Step 5 - Project Panel Window Step 6 - Bean Inspector AS1:AsynchroSerial Window Step 7 - Generation of Driver Code Step 8 - Verification of Files Created Step 9 - Entering User Code Step 10 - Run Page PWM Sample Step 1 - Environment Setup Step 2 - Creating Project Step 3 - Target CPU Window Step 4 - Creating PWM Bean Step 5 - Project Panel Window Step 6 - Bean Inspector PWM1.PWM Step 7 - Generate Driver Code Step 8 - Verification of Files Created Step 9 - Entering User Code Step 10 - Run VisualizationTool Properties Chart Properties Duty Time Bar Properties Page ColdFire P&E Multilink/ Cyclone Pro Connection Page Page Page P&E Multilink/Cyclone Pro Menu Options Trigger Module Settings Flash P&E Multilink/Cyclone Pro Setup Dialog Box Connection Manager Dialog Box Page SofTec ColdFire Connection SofTec ColdFire Technical Considerations CodeWarrior IDE and SofTec ColdFire Connection Page Page Page SofTec ColdFire Menu Options Flash SofTec Coldfire Setup Dialog Box Target Connection Dialog Box Page Set Derivative Dialog Box Page ColdFire On-Chip DBG Module DBG Features Context Menu Entries in Source, Data, Assembly and Memory Windows Trigger Module Settings Window Trigger Module Usage/DBG Module Setup Automatic Mode Sync PC DBG Feature User Triggers mode Page Expert Mode Enhanced setup General Settings Page Page Page Flash Programming Non-Volatile Memory Control Utility Automated Application Programming Automated Application Programming Setup Automated Application Programming Microcontrollers Debugger Manual Advanced Options: Erase Prevention NVMC Graphical User Interface Modules and Module States NVMC Dialog Box Page Flash Module Handling MCU Speed Information Configuration: FPP File Loading Page Loading an Application in Flash Hardware Considerations Microcontrollers Debugger Manual Hardware Considerations HCS08 CPU devices HCS08 CPU devices with banked/paged EEPROM ColdFire CPU devices NVMC Commands FLASH Short Description Microcontrollers Debugger Manual <fileName> <blockNo> blockNo Page Page Debugging Memory Map The DMM GUI Page Edition dialog and memory range edition Access kind Access Size Types Priorities Memory Read Caching Access while Running Remarks CPU Core Types and Priorities HCS08 CPU Priorities: Types: ColdFire CPU DMM Commands Debugging Memory Map Manager command set List of commands DMM command DMM ADD command DMM DEL command DMM SAVE command DMM DELETEALLMODULES command DMM RELEASECACHES command DMM CACHINGON command DMM CACHINGOFF command DMM WRITEREADBACKON command DMM WRITEREADBACKOFF command DMM HCS12MERHANDLINGON command DMM HCS12MERHANDLINGOFF command DMM OPENGUI command DMM SETAHEADREADSIZE command Book VII - Commands Book VII Contents Page Debugger Engine Commands Commands Overview Command Example: Command Syntax Syntax Example: Available Command Lists Kernel Commands Table 34.1 List of Kernel Commands ( Base Commands Page Environment Commands Component Commands Component Specific Commands Table 34.5 List of Component Specific Commands ( Command Syntax Terms address range fileName component Module Names Debugger Commands A ACTIVATE ADDXPR ATTRIBUTES Page In the Register Component Page In the Source Component In the Data Component Page In the Memory Component Page In the Inspector Component Page Page AT AUTOSIZE BASE BC Example1: BCKCOLOR BD BS Equivalent Operation Page More Examples: CALL CD CF Example Without ;C Option: Example With ;C Option: CLOCK CLOSE COPYMEM CMDFILE CR CYCLE DASM Page DB DDEPROTOCOL DECODE_SKIP DEFINE Page DETAILS DL DUMP DW E ELSE ELSEIF ENDFOCUS ENDFOR ENDIF ENDWHILE EXECUTE EXIT FILL FILTER FIND FINDPROC FOCUS FOLD FONT FOR FPRINTF FRAMES G GO GOTO GOTOIF GRAPHICS HELP IF INSPECTOROUTPUT INSPECTORUPDATE LF LOAD LOADCODE LOADSYMBOLS LOG More About Logging of IF, FOR, WHILE and REPEAT Example 1: Page Example 3: Example 4: LS MEM MS NB Table Example: NOCR NOLF OPEN OUTPUT P PAUSETEST PRINTF PTRARRAY RD Example 1: RECORD REPEAT RESET RESTART RETURN RS S SAVE SAVEBP SET SETCOLORS SLAY SLINE SMEM SMOD SPC SPROC SREC STEPINTO STEPOUT STEPOVER STOP T TESTBOX TUPDATE UNDEF Page Page UNFOLD UNTIL UPDATERATE VER WAIT WB WHILE WL WW ZOOM Page Page Debugger Engine Environment Variables Debugger Environment Debugger Environment The Current Directory Debugger Environment Microcontrollers Debugger Manual Global Initialization File Only) Local Co nfigur ation File Default Layo ut Configu ration Other Parameters Ini File Activation Environment Variable Paths Example: Line Continuation Environment Variables Environment Variables ABSPATH: Absolute Path Tools Synonym DEFAULTDIR: Default Current Directory ENVIRONMENT=: Environment File Specification GENPATH: #include File Path LIBRARYPATH: include <File> Path OBJPATH: Object File Path TMP: Temporary directory USELIBPATH: Using LIBPATH Environment Variable Search Order for Source Files Microcontrollers Debugger Manual Default See also: Search Order for Source Files In the Debugger for C Source Files (*.c, *.cpp) In the Debugger for Assembly Source Files (*.dbg) Debugger Files In the Debugger for Object Files (HILOADER) Debugger Files Debugger Files Table 35.2 Debugger File Extensions ( File Extension Description Microcontrollers Debugger Manual Page Page Page Book IX - Debugger Legacy Book IX Contents Page Legacy PEDebug Target Interface New P&E Connections for HC(S)08 Revert to Full Chip Simulator Feature Removed Page Page Page HC(S)08 Full-Chip Simulator Components No Longer Supported List of HC(S)08 FCS Components No Longer Supported Page Index A B C Page D Page E F G H I K L M N O P R S Page T U V W X Y Z