Getting Started with ez80 Developer Kit, FS2 debugger

Transcription

1 Getting Started with ez80 Developer Kit, FS2 debugger Issue /April/2003 1

2 GETTING STARTED WITH EZ80 DEVELOPER KIT, FS2 DEBUGGER... 1 INTRODUCTION... 2 ADDITIONAL TOOLS AVAILABLE... 3 REFERENCED DOCUMENTATION... 3 GETTING STARTED WITH IAR SYSTEMS EWEZ GETTING STARTED WITH IAR SYSTEMS EWEZ Installation... 5 Building the demo application... 6 Debugging the demo application PROGRAMMING THE LED DISPLAY Opening the evaluation.pew project First build Creating LED characters Adding new LED characters to the project files IAR MAKEAPP FOR ZILOG EZ RUNNING AND TESTING THE MPEZ Assumptions Starting MPeZ Testing MPeZ WEBSITE, PURCHASE, and DEMO CONTACT INFORMATION IAR Systems First Silicon Solutions ZiLOG Introduction This is a brief description of how to connect the ZiLOG ez80 Developer Kit to the EWeZ80 (IAR Systems Embedded Workbench for the ez80). We will guide you step by step to the point where you can start debugging your application on the ez80 Evaluation Board with the IAR Systems EWeZ80. To be able to set up and run the system according to this guide, you will need: ZiLOG ez80 Developer Kit. More information about this product can be found at: First Silicon Solutions (FS2) emulator. More information about this product can be found at: IAR Embedded Workbench for the ez80 (EWeZ80) More information about this product can be found at: 2

3 Additional Tools Available An excellent tool to speed up the development for your ez80 application is the IAR MakeApp for ZiLOG ez80. IAR MakeApp automatically creates device driver source code, allowing your application software to have instant access to ez80 peripherals. IAR MakeApp for ZiLOG ez80 helps you design and implement device drivers more quickly and easily than ever before. The tool is a true expert of the ZiLOG microprocessor, giving unprecedented power and providing a highly visual workspace for the configuration of the microprocessor. Just point and click, and IAR MakeApp generates a complete set of customized device driver functions for ZiLOG ez80, including initialization, run-time control, and interrupt handling functions. The drivers are ready to be used by your application software. At the end of this document there is a description of how to get started with the IAR MakeApp for ZiLOG ez80. Referenced Documentation ez80 IAR Embedded Workbench IDE User Guide for ZiLOG s ez80 Microprocessor Family, from IAR Systems. The purpose of this guide is to help you fully utilize the features in the ez80 IAR Embedded Workbench IDE with its integrated Windows development tools for the ez80. The IAR Embedded Workbench is a very powerful Integrated Development Environment that allows you to develop and manage a complete embedded application project. The user guide includes comprehensive information about installation and product overviews, as well as tutorials that can help you get started. This guide is located in the <EweZ80-installation-root>/eZ80/doc/ folder. Installation and Licensing Guide for the IAR Embedded Workbench, from IAR Systems. This guide contains detailed information about how to install an IAR Embedded Workbench product, how to activate and register the license, and how to install a product upgrade. This guide is located in the <EWeZ80-installation-root>/common/doc/ folder. Getting Started, In-Target System Analyzer for ZiLOG s ez80, from FS2. 3

4 This is a reference guide on how to set up the FS2 emulator for the ZiLOG ez80. This guide is located in the FS2 Programs folder located in the programs folder in the Windows Start menu. 4

5 Getting started with IAR Systems EWeZ80 Installation 1. Install the EWeZ80. It is important that you install the EWeZ80 before installing the FS2 emulator. The reason for this is that FS2 software will try to locate the EWeZ80 and, when found, set up the registry for seamless interaction. For more information about the EWeZ80, see: 2. Install FS2 emulator. Make sure that the hardware is working according to FS2 Getting Started, In-Target System Analyzer for ZiLOG s ez80. If the FS2 emulator is set up to use the parallel port, it should be in EPP mode for best performance. If you get a warning that the EPP mode is disabled, you might have to configure the BIOS to use EPP for the parallel port. For more information about the FS2 emulator, see: The latest FS2 emulator and documentation can be downloaded from Setup ZiLOG ez80 Developer Kit To run your application on the real target you have to set up the ez80 Developer Kit. Connect the host PC to the FS2 emulator and connect FS2 to the ez80 Evaluation Board. For more information about the ez80 Developer Kit, see: 5

6 Building the demo application 1. Start the EWeZ80. The EWeZ80 is located in the IAR Systems Programs folder located in the programs folder in the Windows Start menu. 2. Create a new project. In the EWeZ80 File menu, select New. In the New dialog box, select Project and click OK. 3. The New Project dialog box is displayed. Here you select the target CPU family (ez80 - Application) and the location of your new project. Enter the name of your project and click Create. 6

7 4. Add the tutor1.c and common.c files to the project. (Select Files in the EWeZ80 Project menu and add the files located in the Tutor directory. When finished, click Done.) 5. Now we set up the right options for our project. We will use the ez80 Development Platform with an ez80l92 module. You open the options dialog by selsecting Options in the Project menu. 7

8 Select ez80 ez80l92 in the Processor variant drop-down list box. 6. We set up the XLINK configuration file (XCL file) to match the ez80l92 module on the Development Platform that you are using. Select the XLINK category in the Options dialog box from the EWeZ80 Project menu. The XLINK configuration file is located in the Include tab. 8

9 In the config folder you will find a number for XLINK configuration files. In our example we will use the evbl92.xcl file that are the configuration file for the ez80l92 Development Platform (Crystal). Browse and include the evbl92.xcl in the Linker configuration file group. Click Open to make the selection. 7. To be able to reset the debugger with the right chip select values, we will need to include a C-SPY setup file. The setup file is a C-SPY macro file (*.MAC), located in the config directory of the EWeZ80 installation. Choose the C-SPY category in the Options dialog. Enable the "Use setup file" and browse for the corresponding C-SPY macro file. In our example we use the ez80 Development Platform with the ez80l92 module, so the setup file we use is evbl92.mac. Select Open and then click OK in the main option dialog. In this example C-SPY macro file we set the chip select registers before downloading the code and at reset of the debugger. (The C-SPY macro language is a very flexible C style language. Read more about it in the ez80 IAR Embedded Workbench IDE User Guide.) 9

10 The chip select (CS) values for this example is listed in the table below. SFR address SFR symbol Value 0xA8 CS0_LBR 0x00 0xA9 CS0_UBR 0x00 0xAA CS0_CTL 0x00 0xAB CS1_LBR 0x00 0xAC CS1_UBR 0x00 0xAD CS1_CTL 0x28 0xAE CS2_LBR 0x00 0xAF CS2_UBR 0x00 0xB0 CS2_CTL 0x00 0xB1 CS3_LBR 0x00 0xB2 CS3_UBR 0x00 0xB3 CS3_CTL 0x00 8. Build the application. Select Make in the Project menu or click the accelerator button. 10

11 Debugging the demo application We are now ready to debug the application. We can either run it through the simulator or through one of the emulators. Using the simulator. By default, the simulator is selected in the EWeZ80. To run the simulator, select Debugger in the Project menu, or click the C-SPY accelerator button in the EWeZ80. For more advanced examples of how to use the IAR Systems EWeZ80, see the ez80 IAR Embedded Workbench IDE User Guide for ZiLOG s ez80. You will find the manuals in the EWeZ80 Help menu. Using the FS2 emulator. To select the FS2 debugger, you change the debugger driver from simulator to FS2 ISA. Select the C-SPY category in the Options dialog box from the EWeZ80 Project menu. Change the Driver option from Simulator to the FS2 emulator, called FS2 ISA. This will select the FS2 emulator as the debugger. In order to set specific options to the FS2 emulator, you select the tab FS2 ISA in the C-SPY category and make sure that the option 11

12 Configure the FS2 debugger is checked. This will open the FS2 configuration dialog before the FS2 debugger is started. Click OK to save and exit the dialog. We are now ready to start the debugging session. To download the application, simply select the Debugger in the Project menu or click the accelerator button. The ISA-eZ80 Settings dialog appears. Here you can configure the ISA-eZ80 debugger before continue with the download. For information on configuring the FS2 debugger, see 12

13 Getting Started, In-Target System Analyzer for ZiLOG s ez80 manual accessible from the Start Menu, Programs, FS2. When the configuration is done, continue with the download by clicking OK. 13

14 Programming the LED display There is one example project included in this release where you can display messages on the ez80 family evaluation platform. The example project is called evaluation.pew. Together with this example project there is an Excel sheet where you can edit the character you want to display and that calculate the correct values for this character. Opening the evaluation.pew project Start by double click the evaluation.pew project located in the tutor directory. The Embedded Workbench should start and open the project. You should have a project Window that looks like this: If you look in the Project Window, Target list box you will se that this project has three different targets, L92, F91 and F92. Depending on your platform module you select the correct target. 14

15 First build Build the application and verify that there are no errors in the Message Window. In the Project Window, click the plus sign on the file init_led.c. This expands the files included. Open the file init_led.h by double clicking the file name. In this you can define the different characters you would like to display. In this example we display that sequence I, A and R with the following defines: unsigned char char_i[7] = { 17,27,27,27,27,27,17 }; unsigned char char_a[7] = { 17,4,14,14,0,14,14 }; unsigned char char_r[7] = { 1,14,14,1,11,13,14 }; Before we start the debugging, make sure that the right debugger is selected in the Option dialog, C-SPY category. Run the debugger and view the LED display as it shows the letters I, A and R. Creating LED characters With the help of the included Excel sheet we can easily display any character on the board. Open the Excel document called evaluation.xls. In the gray character boxes you can edit any character you want to display. The char_array column will automatically be updated with the values that should be used to display this character. As an example, if we want to display the sequence A, B, C and D, edit the gray boxes as shown below: 15

16 Adding new LED characters to the project files. In the project header file init_led.h create three new character arrays (you only need three since the letter A already exist). unsigned char char_b[7] = { }; unsigned char char_c[7] = { }; unsigned char char_d[7] = { }; Copy the values that are calculated for the character B (1,14,14,1,14,14,1) and copy the values into the array char_b. Do the same for the characters C and D. Now you should have three new arrays that looks something like: unsigned char char_b[7] = { 1,14,14,1,14,14,1 }; unsigned char char_c[7] = { 17,14,15,15,15,14,17 }; unsigned char char_d[7] = { 3,13,14,14,14,13,3 }; In the function main (init_led.c) you change the lines: output_led_letter( char_i, 150 ); output_led_letter( char_a, 150 ); output_led_letter( char_r, 150 ); to the lines: output_led_letter( char_a, 150 ); output_led_letter( char_b, 150 ); output_led_letter( char_c, 150 ); output_led_letter( char_d, 150 ); Build the project and start the debugger. On run the new sequence will be displayed. 16

17 IAR MakeApp for ZiLOG ez80 The IAR MakeApp for ZiLOG ez80 (MPeZ80) takes full advantage of the new IAR MakeApp technology. It provides a highly visual workspace for the configuration of ZiLOG ez80. For more information about the IAR MakeApp for ZiLOG ez80, see the website: Running and testing the MPeZ80 We will also introduce you to IAR MakeApp, which automatically creates device driver source code that gives your application software instant access to ez80 peripherals. Assumptions The MPeZ80 is installed according to the Quick Start Card and the Installation Guide that comes with the product. Starting MPeZ80 We suggest that you start IAR MakeApp, located in the IAR Systems program group in the Start menu, and open the IAR MakeApp User guide from the help menu. 17

18 The guide includes a tutorial chapter that gives a good introduction to the product. Testing MPeZ80 Double-click the ez80x chip symbol in the component library on the right. The component browser displays the chip information. Close the component browser window. Drag and drop the ez80x chip from the component library to the drawing editor. Now you can configure the device. 18

19 A configuration dialog box for each peripheral module can be opened from the module toolbox that is visualized when the graphical component figure is selected. The project explorer window displays a tree-view with a detailed project structure. Double-click the project report to view it. Double-click file names to preview them. Files include device driver source code (c/h). The files are tuned according to the current peripheral settings. Support files contain the ma_sfr.h (autogenerated sfr definitions) and ma_acc.h (autogenerated bitfield access macros) files. WEBSITE, PURCHASE, and DEMO The MakeApp for ez80 is available for purchase at our website and the demo product version is available for free distribution. 19

20 Contact information IAR Systems For more information about IAR Systems products, IAR Embedded Workbench, and IAR MakeApp: The product page contains product information, a datasheet, a purchase facility, and a demo download for IAR Systems MPeZ80. First Silicon Solutions For more information about the FS2 emulator, see the website: ZiLOG For more information about ZiLOG, see the website: 20