EMUL IP2K PC. User Guide. Edition 1, July 13, Nohau Corporation. All rights reserved worldwide.

Transcription

1 EMUL IP2K PC User Guide Edition 1, July 13, Nohau Corporation. All rights reserved worldwide.

2 EMUL IP2K PC User Guide Contents About This Guide vi Overview of the EMUL IP2K PC Emulator System 1 Hardware 1 Software 1 Installing the EMUL IP2K PC/USB JTAG 3 USB Driver 3 Power Supply 3 Installation Instructions 4 Installing the Seehau Software 7 Installing the Seehau Software From the CD 7 Downloading and Installing the Seehau Software From the Internet 7 Configuring the Seehau Software 9 Selecting to Automatically Start the Seehau Configuration Program 9 Configuring the Communications Interface 10 Connect Tab 10 Hardware Configuration Tab 11 Configuring the Emulator Options From Within Seehau 14 Hdw Config Tab 14 Miscellaneous Setup Tab 17 Starting Seehau 18 Demo Mode 18 Edition 1, July 2001, Nohau Corporation i

3 Non-Demo Mode 18 Running Program Examples 21 Using the Nohau Project Manager 23 Overview 23 Accessing the Nohau Project Manager 23 Working with Workspaces 23 Adding a New Workspace 23 Opening a Workspace 24 Saving a Workspace 24 Working with Projects 24 Adding a New Project 24 Removing a Project 25 Adding a File to the Project 25 Removing a File from the Project 25 Changing the Workplace Settings 25 Changing the File Settings 26 Building a Project 27 Building a Single Project 27 Building All Projects 27 Forcing a Build of a Single Project 27 Forcing a Build of All Projects 27 Forcing a Build of a Selected File 27 ii Preliminary EMUL IP2K PC User Guide

4 EMUL IP2K PC User Guide Product Notes Warranty Information The emulator board, trace board, pod board, and emulator cable are sold with a one-year warranty starting from the date of purchase. Defective components under warranty will either be repaired or replaced at Nohau s discretion. Pod boards that use a bondout processor are also warranted for one year from the date of purchase except for the processor. The bondout processor will be replaced once if Nohau determines that the failure in the bondout processor was not due to the user s actions. This replacement limit does not apply to the rest of the pod board. Each optional adapter, cable, and extender is sold with a 90-day warranty, except that it may be subject to repair charges if damage was caused by the user s actions. Nohau s Seehau software is sold with no warranty, but upgrades can be obtained to all customers at the Nohua Web site: Nohau makes no other warranties, express or implied, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose. In no event will Noahu be liable for consequential damages. Third-party software sold by Nohau carries the manufacturer s warranty. License Key Readme Important! The following information is needed for your Seehau software to work correctly with the IP2K PC/USB JTAG emulator: The EMUL IP2K PC/USB JTAG emulator requires a license file (key) to enable it to work correctly. The license file (Nohaulic.bin) is contained on the floppy shipped with the Seehau software CD. Copy this file to the SeehauIP2K subdirectory. The SeehauIP2K subdirectory already contains a license file place holder (also called Nohaulic.bin). When copying the Nohaulic.bin file from the floppy disk you will be prompted as to whether you want to replace the license file place holder. Select Yes. Edition 1, July 2001, Nohau Corporation iii

5 European CE Requirements Nohau has included the following information in order to comply with European CE requirements. User Responsibility The in-circuit debugger application, as well as all other unprotected circuits need special mitigation to ensure Electromagnetic Compatibility (EMC). The user has the responsibility to take required measures in the environment to prevent other activities from disturbances from the debugger application according to the user and installation manual. If the debugger is used in a harsh environment (field service applications for example), it is the user s responsibility to control that other activities cannot be disturbed in such a way that there might be risk for personal hazard/injuries. Special Measures for Electromagnetic Emission Requirements To reduce the disturbances to meet conducted emission requirements it is necessary to place a ground plane on the table under the pod cable and the connected processor board. The ground plane shall have a low impedance ground connection to the host computer frame. The insulation sheet between the ground plane and circuit boards shall not exceed 1mm of thickness. System Requirements CAUTION Like all Windows applications, the Seehau software requires a minimum amount of free operating system resources. The recommended amount is at least 40%. (This is only a guideline. This percentage might vary depending on your PC.) If your resources are dangerously low, Seehau might become slow, unresponsive or even unstable. If you encounter any of these conditions, check your free resources. If they are below 40%, reboot and limit the number of concurrently running applications. If you are unable to free at least 40% of your operating system resources, contact your system administrator or Nohau Technical Support at support@nohau.com. The following are minimum system requirements: Pentium 200 (Pentium II or faster is recommended) Single-Processor System Windows 95, 98, NT, 2000, or 2000 ME Random Access Memory (RAM) For Windows 95/98: 64 MB For Windows NT/2000/2000ME: 128 MB iv Preliminary EMUL IP2K PC User Guide

6 EMUL IP2K PC User Guide Warnings To avoid damage to the pod or to your target, do not connect the pod to your target when the target power is on. Do not apply power to your system unless you are sure the target adapter is correctly oriented. Failing to do so can cause damage to your target. When using the pod with a target, disable all pod resources that are duplicated on the target. Failure to disable the pod s resources can damage the pod or the target or both. When installing a controller into a pod, never press on the chip body. Press only on the carrier or cover. Pressing on the chip might bend pins and cause short circuits. Edition 1, July 2001, Nohau Corporation v

7 About This Guide The EMUL IP2K PC/USB JTAG is a PC-based debugger for the Ubicom (Scenix) family of microprocessors. This guide helps you to get started with the basics of setting up, configuring, and running the Seehau software and debugger. The EMUL IP2K-PC User Guide is intended for both novice and advanced users. This guide introduces the following tasks: Installing and configuring the Seehau software Installing the pod board Starting the pod board and Seehau software Shutting down Seehau Creating Macros Troubleshooting To download an electronic version of this guide, do the following: 1. Open Nohau s home page at 2. Click Publications/Documents. 3. Click Nohau Manuals. 4. Scroll down to EMUL IP2K PC. Then select EMUL IP2K PC to download a PDF version of this guide. vi Preliminary EMUL IP2K PC User Guide

8 EMUL IP2K PC User Guide Overview of the EMUL IP2K PC Emulator System Hardware The basic hardware for the EMUL IP2K debugger system is the EMUL IP2K PC/USB JTAG. At present, Seehau IP2K supports the IP2022 chip. Refer to Chapter 2, Installing the Hardware for detailed hardware information. Software Note Because there is only one pod selection, the Connect tab in the Emulator Configuration window is informational only. The Hdw Config tab offers options you can select or clear. However, when you load your program a dynamic change to the selected items can occur if programmed with these selections. The debugger is configured and operated by the Seehau IP2K user interface. Seehau is a high-level language user interface that allows you to perform many useful tasks, for example: Loading Flash RAM, running, and stopping programs based on the open source GNUpro C- compiler and linker platform (not supplied by Nohau Corporation). The GNUPro tools and documentation for programming the IP2022 processor are available from Red Hat. This special version of the assembler outputs in ELF format specifically for the Nohau debugger. Contact Nohau Technical Support if you have questions. Modifying and viewing memory contents including general-purpose registers. Setting one hardware breakpoint and multiple software breakpoints that can be placed in RAM or Flash. Edition 1, July 2001, Nohau Corporation 1

9 Chapter 1. Overview of the EMUL IP2K PC Emulator System 2 Preliminary EMUL IP2K PC User Guide

10 EMUL IP2K PC User Guide Installing the EMUL IP2K PC/USB JTAG USB Driver When installing the USB device, you must install the Seehau software first before connecting the Nohau hardware (Refer to Chapter 3, Installing the Seehau Software. ). This allows the computer to recognize the proper driver for the hardware. The USB option is not supported by Windows NT. The USB drivers are loaded when the Seehau software is installed. The driver is located in the root directory of the installation CD. After installation, the driver is also located in the Seehau IP2K subdirectory on your hard drive (C:\Nohau\SeehauIP2K\). The system software should find and load the USB driver without your intervention. If your system does not find the driver, it should prompt you for the path if the software does not find the driver on the CD. Power Supply The EMUL IP2K PC/USB JTAG uses power supplied by the USB cable and the target board. The amount of power used by the??? from the target board is less than 100 µa. When drawing power from the taget board, the??? must draw from a 2.3V to 3.6V range. The power supplied by the target board drives the signal from the buffer on the??? through the BERG connector to the target board. The??? draws power from the target board through Pin 9 (Vdd). Figure 1. EMUL IP2K PC/USB JTAG Edition 1, July 2001, Nohau Corporation 3

11 Chapter 2. Installing the EMUL IP2K PC/USB JTAG Note The EMUL IP2K-PC/USB JTAG is a dual power???. For the dual power to initialize correctly the Ubicom target board has a three-pin jumper (JP24) which must have pins +3.3 and TOOL selected (IN). The following table shows the signal layout of the connector: Pin Name Description 1 KEY Key 2 /TSS Target slave select 3 GND Ground 4 TSCK Target data clock 5 OSC Target clock oscillator 6 Reserved Reserved 7 /SRST System reset 8 TSI Target serial input 9 Vdd Power 10 TSO Target serial output Installation Instructions Refer to Figure 2 for a diagram of the connectors while following the installation instructions. 1. Make sure your target is powered off. 2. Plug the 10-pin EMUL IP2K PC/USB JTAG BERG connector into your target s pro-gramming interface. This connector, supplies the signals needed to communicate with the EMUL IP2K PC/USB JTAG. 3. Power on your target. Note Exit Seehau and shut down the power to the target when the target is not in use. In addition to the red wire indicating the number one wire, the BERG connector has the hole for the number one pin plugged to ensure the correct connection. Also, pin one on the demo board is missing. 4 Preliminary EMUL IP2K PC User Guide

12 EMUL IP2K PC User Guide Figure 2. EMUL IP2K PC/USB JTAG with BERG Connector Edition 1, July 2001, Nohau Corporation 5

13 Chapter 2. Installing the EMUL IP2K PC/USB JTAG 6 Preliminary EMUL IP2K PC User Guide

14 EMUL IP2K PC User Guide Installing the Seehau Software Installing the Seehau Software From the CD To install the Seehau software, do the following: 1. Locate your Seehau CD and insert the CD into your CD ROM drive. The installation process will start automatically. 2. Follow the instructions that appear on your screen. If the installation does not start automatically, you probably have your Windows Autorun feature disabled. You will then need to do one of three things: Use Windows Explorer and navigate to the CD root directory. Double-click Autorun.exe. The Windows Install Shield will start the installation process. Right-click on the CD ROM symbol while running Windows Explorer and select AutoPlay to start the installation process. From the taskbar, select Start, then Settings. Click on Control Panel, then Add/Remove Programs, and then Install. The installation process will start when you select the correct path to the CD. Downloading and Installing the Seehau Software From the Internet 1. Go to the Nohau web site ( Click Downloads. The Nohau Software Downloads page opens. 2. Click Current Seehau Software. The Seehau Software Status page opens. 3. Locate the EMUL IP2K PC/USB JTAG product listing. There will be two listings, one for documentation and one for software. 4. Click Information and Download (Seehau). 5. Review the information on the page. 6. Click Yes I Want to Download. A Customer Information Form page opens. Complete this form, then click Proceed. (You have the option to download more than one product.) Edition 1, July 2001, Nohau Corporation 7

15 Chapter 3. Installing the Seehau Software 7. A verification page opens with the information you have just entered. If all information is correct, select SEND at the bottom of the page. A message will open that verifies your information has been sent. 8. Click Go to Download. The Available Download Areas page opens. 9. Click either option for a download site. The Nohau Software Updates page opens. 10. Click the EMUL IP2K PC link. 11. Click the ip2k.exe link. The application will start downloading. Remember which directory has this downloaded file. 12. Following the download, go to the directory, which has the downloaded file. Click the Ip2k.exe file and follow the installation instructions. After installing the Seehau software, the Setup Complete dialog box appears that allows you to view the Readme.txt file and/or launch the Seehau IP2K configuration. Note You must launch the Seehau IP2K configuration before running the Seehau software. 8 Preliminary EMUL IP2K PC User Guide

16 EMUL IP2K PC User Guide Configuring the Seehau Software Selecting to Automatically Start the Seehau Configuration Program After installing Seehau, it is recommended that you automatically start the Seehau Configuration program. Do the following steps before starting Seehau: 1. From the Setup Complete dialog box, select Launch Seehau IP2K Configuration. 2. Click Finish. If you do not select to automatically start the Seehau Configuration Program, do the following: From the Start menu, selct Programs. Select Seehau IP2K. Then click Config to open the Emulator Configuration window displaying the Connet tab (Figure 3). Figure 3. Emulator Configuration Window Displaying the Connect Tab Edition 1, July 2001, Nohau Corporation 9

17 Chapter 4. Configuring the Seehau Software Note You do not need the hardware connected at this time Configuring the Communications Interface Connect Tab The graphical user interface for this tab is divided into four regions. Do the following in each region: 1. Region 1 Communications Interface: Displays the USB-SPI communications interface for the IP2K pod. 2. Region 2 Select Emulator Connection: No action required. Default is Universal Serial Bus. 3. Region 3 Select Processor: No action required. Default is POD IP Region 4 What is your Trace Type?: No action required. Default is None. 5. Click Next. The Hdw Config tab opens (Figure 4). Figure 4. Emulator Configuration Window Displaying the Hdw Config Tab 10 Preliminary EMUL IP2K PC User Guide

18 EMUL IP2K PC User Guide Hardware Configuration Tab Note Only Mask Interrupt on Step is a debugger configuration parameter. The rest are chip configuration parameters stored in the configuration block. The initial configuration settings are read from the Startup.bas file when the debugger initializes. These are default values and should not be changed. If a program, containing new settings for the FUSE registers is loaded, the Hdw Config tab is updated with the new values. After the initial startup and configuration of Seehau, the configuration parameters are saved in the Startup.bas file (located in the Macro subdirectory). The next time the emulator is started, the configuration parameters are read in from the Startup.bas file and compared with the default parameters on the chip. If the parameters on the chip and the file are different, you will be prompted by a message box to load the application program for the configuration parameters to be sent to the chip. If you want to load the default chip parameters, select the CFG button on the Speedbar after loading the Startup.bas file. You can also choose to upload the current configuration parameters from the chip at any time using the Speedbar (CFG) button. If you save the settings after loading the parameters from the chip, these settings will become the default values on the next startup. If configuration parameters using Config menu items (Config/Emulator) are changed, you will be prompted to load a program (load code) for the new parameters to be loaded into the chip. Note When you load code the current configuration parameters change to the values read from the code file. These new parameters are then programmed to the IP2K chip. The following values for the chip are currently used: Processor: Shown for reference only. This is the selected processor. Clock(MHz): Shown for reference only. Enables you to change the clock speed. Dividers PLL Pre Divider: Shown for reference only. 1 = (000b) 2 = (001b) 3 = (010b) 4 = (011b) 5 = (100b) 6 = (101b) 7 = (110b) 8 = (111b) Edition 1, July 2001, Nohau Corporation 11

19 Chapter 4. Configuring the Seehau Software PLL Post Divider: Shown for reference only. 1 = (00b) 2 = (01b) 3 = (10b) 4 = (11b) Watch Dog Divider: Shown for reference only. 1:1 = 16 ms = (000b) 1:2 = 32 ms = (001b) 1:4 = 64 ms = (010b) 1:8 = 128 ms = (011b) 1:16 = 256 ms(100b) 1:32 = 512 ms = (101b) 1:64 = 1024 ms = (110b) 1:128 = 2048 ms = (111b) Delay Reset Time: Shown for reference only. A 2-bit field in the FUSEx register can be used to specify the Delay Reset Timer timeout period that results in an automatic wake-up from the power-down mode. 60 ms = (00b) 960 ms = (01b) 0.06 ms = (10b) 18.4 ms = (11b) Brown-out Reset (BOR): Shown for reference only. Sets the Brown-Out Reset threshold voltage (detects low Vdd condition). BOR timeout period 2.30 V = (000b) 2.25 V = (001b) 2.20 V = (010b) 2.15 V = (011b) 2.10 V = (100b) 2.05 V = (101b) 2.00 V = (110b) Disabled = (111b) PLL Wakeup Delay 60 us(000b) 120 us(001b) 240 us(010b) 480 us(011b) 960 us(100b) 1.92 ms(101b) 3.84 ms(101b) 7.68 ms(111b) 12 Preliminary EMUL IP2K PC User Guide

20 EMUL IP2K PC User Guide XTAL Wakeup Delay 60 us(000b) 960 us(001b) 3.84 ms(010b) 7.68 ms(011b) 15:36 ms(100b) 60 ms(101b) 480 ms(110b) 960 ms(111b) Miscellaneous Watch dog disable: Shown for reference only. Select this option to disable the watchdog timer when programming the chip. (If you select the debug option, the watchdog is automatically disabled.) Mask Interrupt on step: Affects the flag register so no interrupts can be performed during the following single-step, and then restores the flag register. Enable OSC2: Enables Oscillator 2. Enable RTCLK2: Enables Real Time Clock 2. Synchronous Inputs: Shown for reference only. Select to synchronize the input pin signal to the internal clock. Code Protect Mode: Shown for reference only. Select to enable security to protect your code. Debug Mode: Shown for reference only. Select this option to enable the debug feature. When debug mode is enabled, Seehau merges the user and debug monitor code and then writes this code into the chip. Seehau disables the watchdog and sets the oscillator to the external clock to make sure the target is in debug mode. Debug mode also requires that some memory be set aside for the debug monitor. Clear this option to disable the debug feature. When disabled, Seehau operates as an IDE and Flash programmer. ID String (1-16char): Shown for reference only. Identifies the software currently loaded. Host: Shown for reference only. This option is no longer valid. When you click Finish, Seehau starts to load. For more information about starting Seehau, see the Starting Seehau section at the end of this chapter. Edition 1, July 2001, Nohau Corporation 13

21 Chapter 4. Configuring the Seehau Software Figure 5. Emulator Configuration Window Displaying the Hdw Config Tab Configuring the Emulator Options From Within Seehau From Seehau open the Emulator Configuration window. Select the Config menu and click Emulator. The Emulator Configuration window opens displaying the Hdw Config tab (Figure 5). Hdw Config Tab Processor: Shown for reference only. This is the selected processor. Clock(MHz): Shown for reference only. Enables you to change the clock speed. Dividers PLL Pre Divider: Shown for reference only. 1 = (000b) 2 = (001b) 3 = (010b) 4 = (011b) 5 = (100b) 6 = (101b) 7 = (110b) 8 = (111b) 14 Preliminary EMUL IP2K PC User Guide

22 EMUL IP2K PC User Guide PLL Post Divider: Shown for reference only. 1 = (00b) 2 = (01b) 3 = (10b) 4 = (11b) Watch Dog Divider: Shown for reference only. 1:1 = 16 ms = (000b) 1:2 = 32 ms = (001b) 1:4 = 64 ms = (010b) 1:8 = 128 ms = (011b) 1:16 = 256 ms(100b) 1:32 = 512 ms = (101b) 1:64 = 1024 ms = (110b) 1:128 = 2048 ms = (111b) Delay Reset Time: Shown for reference only. A 2-bit field in the FUSEx register can be used to specify the Delay Reset Timer timeout period that results in an automatic wake-up from the power-down mode. 60 ms = (00b) 960 ms = (01b) 0.06 ms = (10b) 18.4 ms = (11b) Brown-out Reset (BOR): Shown for reference only. Sets the Brown-Out Reset threshold voltage (detects low Vdd condition). BOR timeout period 2.30 V = (000b) 2.25 V = (001b) 2.20 V = (010b) 2.15 V = (011b) 2.10 V = (100b) 2.05 V = (101b) 2.00 V = (110b) Disabled = (111b) PLL Wakeup Delay 60 us(000b) 120 us(001b) 240 us(010b) 480 us(011b) 960 us(100b) 1.92 ms(101b) 3.84 ms(101b) 7.68 ms(111b) Edition 1, July 2001, Nohau Corporation 15

23 Chapter 4. Configuring the Seehau Software XTAL Wakeup Delay 60 us(000b) 960 us(001b) 3.84 ms(010b) 7.68 ms(011b) 15:36 ms(100b) 60 ms(101b) 480 ms(110b) 960 ms(111b) Miscellaneous Watch dog disable: Shown for reference only. Select this option to disable the watchdog timer when programming the chip. (If you select the debug option, the watchdog is automatically disabled.) Mask Interrupt on step: Affects the flag register so no interrupts can be performed during the following single-step, and then restores the flag register. Enable OSC2: Enables Oscillator 2. Enable RTCLK2: Enables Real Time Clock 2. Synchronous Inputs: Shown for reference only. Select to synchronize the input pin signal to the internal clock. Code Protect Mode: Shown for reference only. Select to enable security to protect your code. Debug Mode: Shown for reference only. Select this option to enable the debug feature. When debug mode is enabled, Seehau merges the user and debug monitor code and then writes this code into the chip. Seehau disables the watchdog and sets the oscillator to the external clock to make sure the target is in debug mode. Debug mode also requires that some memory be set aside for the debug monitor. Clear this option to disable the debug feature. When disabled, Seehau operates as an IDE and Flash programmer. ID String (1-16char): Shown for reference only. Identifies the software currently loaded. Host: Shown for reference only. This option is no longer valid. OK: Saves the settings for the tabs and exits the Emulator Configuration window. Apply: Saves the settings for this tab. Cancel: Exits without saving the settings for the Emulator Configuration window. Help: Displays the Seehau Help file. Refresh: Allows you to retrieve and view the current trace and emulator hardware configuration settings. 16 Preliminary EMUL IP2K PC User Guide

24 EMUL IP2K PC User Guide Figure 6. Emulator Configuration Window Displaying the Misc Setup Tab Miscellaneous Setup Tab The Misc Setup tab (Figure 6) is accessible only after the initial software configuration. Brown-out Trim: Parts are shipped out of the factory untrimmed. Watch Dog Timer Trim: TBD PLL VCO Trim: TBD Flash Page Erase Trim: TBD Comparator Trim: TBD Always Use Bulk Erase : Allows you to erase Flash programming all at once. Try to keep this to a minimum as this version of the chip only allows for 1000 erase cycles. In the newer version of this processor, there will be 100,000 erase cycles. Multiple Breakpoints in Flash: This option is connected with the Always Use Bulk Erase option. To use this option, you need the newer version of the processor. Software breakpoints work by the break instruction. Software is executed until it hits the first break. When you program load the software into RAM there is little concern. You can place these breakpoints throughout your program, remove them and replace them. In Flash, you do not normally want to do this because you have to erase the Flash each time and the number of times you can do this is limited. If this option is checked then the Flash will Edition 1, July 2001, Nohau Corporation 17

25 Chapter 4. Configuring the Seehau Software be handled just as if it is RAM except that it has to be erased each time it is loaded. This option can only be used if you the have the newer processor with 100,000 erase cycles available. For further details about hardware settings, you can obtain data sheets from the Nohau EMUL IP2K PC Installation CD, the Nohau web site ( or from the Ubicom web site ( WARNING When the target is powered on, the EMUL IP2K PC/USB JTAG pod is powered by the target through a diode. When powering down, turn off the target first and then the pod (the pod receives its power through the USB cable so the PC must be powered down to power off the pod.) Starting Seehau Demo Mode After you configure the Seehau software, you have the option of starting Seehau. Click Yes to start Seehau. After Seehau is loaded, a box with the message This is a Demo version of Seehau. This Demo is not a simulator. opens. This demo offers limited simulation. Aftr clicking OK, you need to load code. Non-Demo Mode To start Seehau in the non-demo mode, double-click the Seehau IP2K icon. The Seehau main window opens (Figure 7). Seehau will load its configuration from the Startup.bas file. Notice that the macro is displayed in red at the bottom of the main window while Startup.bas is running. When the software startup is complete, you can position and resize the main window to your preference. At this time, you will need to load code. To open new windows, go to the New menu and click a window option. For further information, refer to Troubleshooting Tips in Appendix A in this guide or contact Nohau Technical Support (support@nohau.com. 18 Preliminary EMUL IP2K PC User Guide

26 EMUL IP2K PC User Guide Figure 7. Seehau for EMUL IP2K PC Edition 1, July 2001, Nohau Corporation 19

27 Chapter 4. Configuring the Seehau Software 20 Preliminary EMUL IP2K PC User Guide

28 EMUL IP2K PC User Guide Running Program Examples Nohau provides three program examples: Assembly Test (C:\Nohau\SeehauIP2K\Examples\Asm\Stackdump.exe C Test (C:\Nohau\SeehauIP2K\Examples\C\Cproject\Debug.exe) C Timer Test (C:\Nohau\SeehauIP2K\Examples\C\Timer\Timer.exe) Note The C programs are missing the jump instruction at address 0xFFF0! Using the register window, manually set the PC to zero before stepping into the C programs. Once you have done this, step into the C source code by pressing the Source Step Into button on the Seehau Speedbar. Start Seehau by following the instructions in the Starting Seehau section in Chapter 4. Then do the following to run the test program: 1. Resize the windows on your screen, but do not add the Watch window. 2. From the File menu select Load Code. The Open dialog box opens (Figure 8). Select one of the program example files for your controller. Figure 8. Open Dialog Box Displaying the Program Example Directories Edition 1, July 2001, Nohau Corporation 21

29 Chapter 5. Running Example Programs Figure 9. Program Example in Source Only 3. Highlight the program example file and click Open. The source file automatically displays the program example in source only (Figure 9). 4. To single-step in mixed mode, click the Assembly Step Into or Step Over button. You will seethe assembly code mixed in with the associated source lines (Figure 10). 5. To single-step in source only mode, first click the Source window. Select the time.c tab. Right-click to verify that mixed mode is cleared. Then point to the Setting sub-menu item, and select Lock Tabs. Figure 10. Program Example in Mixed Mode 22 Preliminary EMUL IP2K PC User Guide

30 EMUL IP2K PC User Guide Using the Nohau Project Manager Overview The Nohau Project Manager is an external application that allows you to launch compilers and linkers for processing source files and linker command files as specified in the workspace. The Project Manager gives you different options of how to build the source files and automatically load the final object file into the emulator. This chapter describes how to: Create a workspace. Add a project to the workspace. Add files to the project. Specify file settings for each of the source files (can be done as a group or individually). Test the project settings. Open the source file in the Seehau Source Window. Accessing the Nohau Project Manager Accessing the Nohau Project Manager can be done in one of the following ways: Start the Windows Explorer utility and go to C:\Nohau\SeehauIP2K. Double-click NPrjMngr.exe. Within Seehau, from the Tools menu, select Open Project Manager. The Nohau Project Manager window opens. Working with Workspaces Adding a New Workspace 1. From the File menu, select New Workspace. (You can also click the New Workspace button on the toolbar).this opens the New Workspace dialog box. 2. Type in the name of the new workspace in the Workspace name text field. 3. Click OK. The new workspace name appears in the left side of the Nohau Project Manager window. (In Figure 11 the example is My Workspace.) Edition 1, July 2001, Nohau Corporation 23

31 Chapter 6. Using the Nohau Project Manager Figure 11. Nohau Project Manager Window Opening a Workspace 1. To open a workspace from the File menu, select Open Workspace. (You can also click the Open Workspace button on the toolbar).this opens the Open dialog box. 2. When you have selected your workspace file, click Open. The name of your selected file appears in the left side of the Nohau Project Manager window. Saving a Workspace 1. To save a workspace from the File menu, select Save Workspace. (You can also click the Save Workspace button on the toolbar.) This opens the Select Directory dialog box. 2. When you have placed your workspace file where you want it, click OK to save the file and exit the dialog box. Working with Projects Adding a New Project 1. Click on the workspace name in the left side of the Nohau Project Manager window. (In Figure 11 the example is My Workspace.) 2. From the File menu, select Add New Project. (You can also click the New Project button on the toolbar).this opens the New Project dialog box. 3. Type in the name of the new project in the Project Name text field. 4. Click OK. The new project name appears in the left side of the Nohau Project Manager window. (In Figure 11 the example is My Project.) 24 Preliminary EMUL IP2K PC User Guide

32 EMUL IP2K PC User Guide Removing a Project 1. Select (highlight) the project name. 2. From the File menu select Remove Project. (You can also click the Remove Project button on the toolbar). 3. A message box opens asking you Do you want to remove project (file name)? Click Yes to remove the selected file, or Cancel to close this box. Adding a File to the Project 1. Select (highlight) the project name. (In Figure 11 My Project is highlighted.) 2. From the File menu select Add File to Project. (You can also click the Add File to Project button on the toolbar). This opens the Open dialog box. 3. When you have located the.c file you want to add, click Open. The name of your selected file appears in the right side of the Nohau Project Manager window. (In Figure 11 the example is C:\Nohau\SeehauIP2K\Examples\C\Timer\time.c.) Removing a File from the Project 1. Select (highlight) the file name. (In Figure 11 the example is C:\Nohau\SeehauIP2K\Examples\C\Timer\time.c.) 2. From the File menu select Remove File from Project. (You can also click the Remove File from Project button on the toolbar). 3. A message box opens asking you Do you want to remove file (file name)? Click Yes to remove the selected file, or Cancel to close this box. Changing the Workplace Settings 1. From the Settings menu select Workspace Settings. The Workspace Settings dialog box opens. 2. Select one of the compiler-specific tools (xxx.exe). (This file translates the errors generated by the compiler into a format that allows you to view the errors in the Source window. If your compiler does not have a Nohau error-translating tool, contact Nohau Technical Support at support@nohau.com. You can also write your own error-translating tool. The.exe file that you create reads the file as a command line parameter when you launch the tool. This file name is displayed in the Report File text Field in the File Settings dialog box (Figure 12). To open this dialog box from the Settings menu, select File Settings. Edition 1, July 2001, Nohau Corporation 25

33 Chapter 6. Using the Nohau Project Manager Figure 12. File Settings Dialog Box The error-translating tool parses the file for error messages. It then appends them to the Cmperror.log file for Seehau to read it. The.log file should be in the following format: Filename#linenumber#the original error text With this convention, the Nohau tool supports most compilers and message outputs. Changing the File Settings 1. Select (highlight) the file name. (In Figure 12 the example is C:\Nohau\SeehauIP2K\Examples\C\Timer\time.c.) 2. From the Settings menu select File Settings. (You can also click the File Settings button on the toolbar.)this opens the File Settings dialog box (Figure 12). You can now choose the functions you wish to perform, such as entering post parameters, creating an executable path to process the file, creating an output file name and a report file name. You can also choose to load the output file into Seehau, exclude the file from the build, or specify if it should be the default file. Selecting the Build option ensures the source file will be built if the date of the output file is older than the date of the source file. 26 Preliminary EMUL IP2K PC User Guide

34 EMUL IP2K PC User Guide For example, if you want to compile a.c file that is called Test.c, the executable field should contain the path to the compiler. The Pre Parameter field contains command line parameters to the compiler that appear before the file name Test.c. The Post Parameter field specifies command line parameters that appear after the file name Test.c. The Output File filename is Test.obj. The Report File filename is Test.lst. If the file settings are specified for the linker command file, the Output File name is Test.omf or Test.hex and the Load Into Seehau option should be selected. This instructs Seehau to load the linked output file into the emulator. Building a Project Building a Single Project 1. Select (highlight) the project. 2. From the Build menu select Build Selected Project(Make). (You can also click the Build Selected Project(Make) button on the toolbar.) Building All Projects From the Build menu select Build All Projects (Make). (You can also click the Build All button on the toolbar.) Forcing a Build of a Single Project 1. Select (highlight) the project. 2. From the Build menu select Rebuild Selected Project. (You can also click the Rebuild Selected Project button on the toolbar.) Forcing a Build of All Projects From the Build menu select Rebuild All Projects. (You can also click the Rebuild All button on the toolbar.) Forcing a Build of a Selected File 1. Select (highlight) the file. 2. From the Build menu select Build Selected File. (You can also click the Build Selected File button on the toolbar.) Edition 1, July 2001, Nohau Corporation 27

35 Chapter 6. Using the Nohau Project Manager 28 Preliminary EMUL IP2K PC User Guide

36 EMUL IP2K PC User Guide Edition 1, July 2001, Nohau Corporation 29