6
CodeWarrior
™
Development Studio
for Motorola HC08 Microcontrollers
Quick Start for Windows
®
PC Hardware
BASIC SYSTEM REQUIREMENTS
Operating System
Disk Space Required
200 MHz Pentium ® II or AMD-K6 ® class processor, 64 MB of
RAM, Parallel Port, 9-pin Serial Port, and CD-ROM drive
Microsoft ® Windows ® 98/2000/XP/NT
330 MB (Service pack downloads may require more)
This Quick Start explains how to: install the CodeWarrior IDE for HC08 V2.1 software, install service packs that support additional HC08 derivatives, use the IDE to create and debug a project.
Note: Advanced users may use the numbered steps; substeps are expanded descriptions.
Section A - Installing CodeWarrior IDE for HC08 V2.1
1. Install CodeWarrior IDE a. Insert CodeWarrior for HC08 CD into CD-ROM drive – CW Auto Install begins
Note - If Auto Install does not start, run setup.exe,which is located in the root directory of the CD.
b. Follow setup program’s on-screen instructions
Note - You can run the
MWRegister.exe
program as the last step of the installation.
You can also register later, as explained in Section B.
2. Restart your computer
Note - Restarting ensures that the newly installed drivers are available to the CodeWarrior IDE.
Section B - Registering CodeWarrior Software
1. Run
MWRegister.exe
program a. Click Windows desktop, click Start > Programs > Metrowerks > CodeWarrior CW08 V2.1 – menu appears b. Select Register CodeWarrior for CW08_V2.1 – Register CodeWarrior Window appears
2. Select New Purchase or Renewal from License Type pull-down menu
3. Complete all fields
1
4. Click Register button – Registration Method dialog box appears
Register CodeWarrior Window c. Select E-Mail option button d. Click OK button – the
MWRegister.exe
program sends an email to Metrowerks
Note - If you encounter difficulty with the licensing server, you can e-mail your registration file. the registration file is a text file. The filename begins with MWRegistration.
the registration file is located in the following directory:
{install_directory}/Metrowerks/CodeWarrior
CW08_V2.1/Other Metrowerks
Tools/MWRegister/CW08_V2.1
You can email the registration file to:
[email protected]
or
[email protected]
Registration Method Dialog Box
Section C - Installing CodeWarrior License Key
Note - You should receive a license key by e-mail. You must install this key in your license file
( license.dat
) to use the CodeWarrior IDE. No separate license is necessary for service pack software.
If you need a Special Edition license, select Start > Programs > Metrowerks > CodeWarrior
CW08 V2.1 > get HC08 Special Edition license - a web page opens in your web browser with instructions on obtaining a Special Edition license.
2
5. Click on Start/Continue icon – Program execution resumes
6. In the Debugger Simulator Window tool bar, select File > Exit to exit the CodeWarrior IDE
7. In the IDE Main Window tool bar, select File > Exit to exit the CodeWarrior IDE
Congratulations!
You have created and debugged a program using CodeWarrior for HC08 V2.1 software!
7
Section F - Debugging your program
1. Start debugger a. From IDE main menu bar, select Project b. Select Debug – Debugger Simulator window opens
Note - Source and Assembly panes display the qt4.asm
program and code.
1. Open license file a. Click Start > Programs > Metrowerks > CodeWarrior CW08 V2.1 – menu appears b. Select License File – Notepad starts and opens license.dat
file
2. Copy license key to new line at the bottom of license.dat
file
Note - If you are adding a license key for an upgrade, paste the new license key above the other keys in the license.dat
file.
3. Save license.dat
file – License is installed
4. Close license.dat
file – License is installed
Debugger Simulator Window
2. Right click the mouse in the Source pane to set breakpoints in program code
3. From the Debugger Simulator main menu, select Run – Run menu appears
4. Click on Start/Continue – Program executes until encountering the first breakpoint
Note - The Debugger Window’s Command pane displays Program status.
Debugger Simulator Window Source and Command Panes
6
Finding the License File
Note - Do not move or delete the license.dat file. You can append future keys to the bottom of this file.
Section D - Software suppport for additional HC08 derivatives
Note - You can find software support (service packs) for additional HC08 derivatives on the
Metrowerks website or on the documentation CD.
1. Determine if you need service pack a. Insert User Documentation CD into CD-ROM drive b. Click My Computer on WIndows desktop c. Click CD ROM drive – List of documentation CD contents appears d. If no CodeWarrior_HC08_V2.1_SPx.exe file is listed, no patch is needed, go to Section E of this document. If a service pack is listed, go to Step 2.
Note - http://www.metrowerks.com/MW/download contains a link for CodeWarrior for
Motorola HC08, which directs you to a page that lists the processors served by each service pack. If your target processor is not listed, you do not need a service pack.
2. Install service pack
Note - CodeWarrior IDE for HC08 V2.1 must be installed before you can install a service pack.
a. In CD contents list, click CodeWarrior_HC08_V2.1 SPx.exe icon – InstallShield Wizard starts b. Follow the Wizard’s on-screen instructions - service pack installs
3
Section E - Creating an HC08 program in assembler
1. Launch CodeWarrior IDE a. From Windows desktop click Start > Programs > Metrowerks > CodeWarrior CW08 V2.1 – menu appears b. Select CodeWarrior IDE – IDE starts, and CodeWarrior window appears
2. Create new project a. From main menu bar, select File > New – New window appears e. Click + to display the QT_QY stationery f. Click + to display the QT4 stationery g. Select Assembly – the IDE will base the new project on this stationery h. Click OK button – IDE creates projects, and opens Project window, which displays your named project
Project (HC08QS.mcp) Window i. Click + to display contents of Sources folder j. Double click on qt4.asm – Editor window opens displaying the main program contents k. Make changes to contents of qt4.asm
file if desired
New Window b. Select HC08 Stationery c. Enter a name for your project in Project name text box – IDE automatically adds
.mcp
extension when you save project d. Click OK button – New Project window appears
New Project Dialog Window
4 qt4.asm
in Editor Window l. If you made changes to source code, from IDE main menu bar, select File > Save – IDE saves changes m. From IDE main menu bar, select Project > Make – IDE compiles the project
5
