-

F O R U M

N O K I A

Series 80 Developer Platform 2.0 SDK for Symbian OS Supporting CodeWarrior Installation Guide
Version 1.0; December 14, 2004

Series 80

Forum.Nokia.com

Copyright 2004 Nokia Corporation. All rights reserved. Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. Disclaimer The information in this document is provided as is, with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed substantially prior to final release. This document is provided for informational purposes only. Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to implementation of information presented in this document. Nokia Corporation does not warrant or represent that such use will not infringe such rights. Nokia Corporation retains the right to make changes to this specification at any time, without notice. License A license is hereby granted to download and print a copy of this specification for personal use only. No other license to any other intellectual property rights is granted herein.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

Contents
1 2 3 4 5 Introduction................................................................................................................................................ 5 1.1 System requirements..............................................................................................................................5 Installing program .................................................................................................................................... 6 Getting started .........................................................................................................................................13 Uninstalling program .............................................................................................................................14 Maintenance mode..................................................................................................................................15 5.1 5.2 5.3 Appendix A Modify........................................................................................................................................................ 15 Repair ........................................................................................................................................................ 17 Remove..................................................................................................................................................... 19 Using Network Configuration tool...................................................................................24

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

Change History
December 14, 2004 Version 1.0 Initial document release

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

1 Introduction
This document guides you through the installation of the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior. 1.1 System requirements Basic requirements: Microsoft Windows XP with Service Pack 2 or Microsoft Windows 2000 with Service Pack 3 800 MHz or faster processor 256 MB of RAM 500 MB disk space. Display supporting at least 16 bit color at 1024 by 768 resolution Microsoft Windows compatible sound card for audio support Keyboard and mouse

Additional requirements: Active Perl Version 5.6.1 or later for Symbian build tools Java 2 Runtime Environment, Standard Edition 1.4.2 or later for Symbian development tools

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior supports the following development environments: CodeWarrior Development Studio for Symbian OS 2.5 or later

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

2 Installing program
Start the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior installation by running the installation executable (setup.exe). Step 1: Preparing to Install

This panel is shown while the installer is preparing the installation.

Step 2: General requirements

If Active Perl or Java Runtime environment are not installed, the installer asks to install them to ensure the functionality of the Series 80 Developer Platform SDK.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

Step 3: General information

This panel displays general information about the software to be installed. Click Next to continue.

Step 4: License Agreement panel

This panel displays the License Agreement information about the software to be installed. To install the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior, you must accept the agreement. Click Yes to accept the terms of the preceding License Agreement.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

Step 5: Setup Type

In this panel you can select the type of setup you prefer: In Typical the program will be installed with the most common options. In Compact the program will be installed with the minimum required options. This selection does not install examples, documentation nor Nokia Connectivity Framework. In Custom you may choose the options you want to install. See Step 7 for more information on SDK features.

Click Next to continue after selection.

Step 6: Choose Destination Location

You can change the destination directory by clicking the Browse button. Click Next to continue.

Note: The destination folder name should not contain space characters.
Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide 8

Forum.Nokia.com

Step 7: Select Features

If you chose the Custom installation, the Select Features window opens. Now you can select the features you want to install. After selecting the features, click Next to continue. Epoc32 contains the core of the Series 80 Developer Platform SDK Series80Doc contains the Series 80 Developer Platform SDK documentation Series80Ex contains the Series 80 Developer Platform SDK examples Examples contains Symbian examples and sample codes Series80Tools contains different Series 80 Developer Platform SDK tools Nokia Connectivity Framework Lite (* provides a communication environment with Bluetooth, SMS and MMS technologies. You can use Nokia Connectivity Framework to communicate with other Nokia Terminal SDKs and Nokia products that support this type of connectivity. CommonFile Tools contains common scripts for the Series 80 Developer Platform SDKs (* If Java Runtime Environment is not installed, this feature is not visible.

Note:

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

Forum.Nokia.com

Step 8: Start copying files

The installer displays the installation information. Click Next to continue.

Step 9: Setup Status

This panel indicates the installation progress. You can cancel the installation by clicking the Cancel button.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

10

Forum.Nokia.com

Step 10: Nokia Connectivity Framework Lite Installation Status The Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior installation package includes the Nokia Connectivity Framework (NCF) Lite version. NCF Lite is installed with the Series 80 Developer Platform SDK installation by default and it provides communication environment with Bluetooth, SMS and MMS technologies. You can use NCF to communicate with other Nokia Terminal SDKs and Nokia products that support NCF connectivity.

Note: If Java Runtime Environment is not installed, the installer does not install Nokia Connectivity Framework. You can add the Nokia Connectivity Framework Lite version as a new SDK feature using the Modify option in Series 80 Developer Platform SDK Maintenance mode, see Chapter 5.

This panel indicates the installations progress while the Nokia Connectivity Framework is being installed. You can cancel the installation by clicking the Cancel button.

Tip:

The Nokia Connectivity Framework Full version provides support for hardware components, such as Nokia D211 and Bluetooth cards. It contains a full communication environment with features like run-time communication monitoring and visualization of environments. You can download the Nokia Connectivity Framework Full version from Forum Nokia website.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

11

Forum.Nokia.com

Step 11: Select a Device

In this panel you can select one of the installed devices to be the default device after the installation is complete. Select Series80_DP2_0_SDK_CW and click Next to continue.

Step 12: Installation complete

Click Finish to complete the installation. You may need to restart you computer before you can use the Series 80 Developer Platform SDK.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

12

Forum.Nokia.com

3 Getting started
For more information about the use of the SDK, see the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior Users Guide. The Series 80 Developer Platform SDKUsers Guide describes how to configure various connectivity features in Series 80 Developer Platform SDK. This allows modems, ports and ISP settings on the emulator to be configured to match the hardware and settings available on the PC, see Chapter 4 Series 80 Developer Platform SDK Configuration in the Users Guide.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

13

Forum.Nokia.com

4 Uninstalling program
You can uninstall the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior in two different ways: 1. 2. Use Add/Remove Programs in Windows Control Panel. Select the S80 DP 2.0 SDK Supporting CodeWarrior from the list and click the Change/Remove button. Restart Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior installer. The installation program starts in maintenance mode. Now you can select the Remove function. For more information please see the Chapter 5, Maintenance mode.

The uninstall program will guide you through the uninstallation procedure.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

14

Forum.Nokia.com

5 Maintenance mode
Restart the installer (setup.exe). The installer starts in maintenance mode and opens the Welcome panel. Now you can modify, repair or remove the installed program. 5.1 Modify Step 1: Modify

By selecting Modify, you can install new program features or remove currently installed features of the Series 80 Developer Platform SDK. Step 2: Select Features

Select the features you want to install and deselect the features you do not want to install.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

15

Forum.Nokia.com

Step 3: Setup Status

This panel indicates the maintenance installer progress.

Step 4: Modify Complete

Click the Finish button to complete maintenance.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

16

Forum.Nokia.com

5.2

Repair Step 1: Repair

By selecting Repair, you can reinstall possibly missing components of the Series 80 Developer Platform SDK.

Step 2: Setup Status

This panel indicates the maintenance installers progress.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

17

Forum.Nokia.com

Step 3: Select a Device

In this panel you can select one of the installed devices to be the default device after the installation is complete. Select Series80_DP2_0_SDK_CW and click Next to continue.

Step 4: Repair Complete

Click the Finish button to complete maintenance.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

18

Forum.Nokia.com

5.3

Remove Step 1: Remove

To remove all installed features of the Series 80 Developer Platform SDK select Remove.

Step 2: Remove Confirmation

The uninstall program requires confirmation before the program can continue. If you want to remove the Series 80 Developer Platform SDK, click the OK button to confirm.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

19

Forum.Nokia.com

Step 3: Setup Status

This panel indicates the maintenance installers progress.

Step 4: Nokia Connectivity Framework Lite Uninstaller

Next the Series 80 Developer Platform SDK uninstaller starts the Nokia Connectivity Framework Lite uninstaller.

To remove the installed Nokia Connectivity Framework Lite, select Uninstall. Note: The uninstaller will not uninstall Nokia Connectivity Framework Lite if product integrations for other Nokia products exist or Nokia Connectivity Framework Full is installed.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

20

Forum.Nokia.com

Step 5: Nokia Connectivity Framework Lite - Uninstall Status

This panel indicates the Nokia Connectivity Framework Lite unistaller progress.

Step 6: Nokia Connectivity Framework Lite - Uninstall Complete

Click the Done button to complete the Nokia Connectivity Framework Lite uninstallation.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

21

Forum.Nokia.com

Step 7: Setup Status

This panel indicates the maintenance installer progress.

Step 8: Select a Device

In this panel you can select one of the installed devices to be the default device after the removal is complete. Select a device and click Next to continue. Note that the installer does not show this panel if you have no other SDKs installed.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

22

Forum.Nokia.com

Step 8: Maintenance Complete

Click the Finish button to complete maintenance. You need to manually remove the installation directory after uninstalling the Series 80 Developer Platform SDK. Some files and directories may remain on the disk.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

23

Forum.Nokia.com

Appendix A Using Network Configuration tool

Network settings can be modified using the Network Configuration tool. The Network Configuration is a tool designed to help developers to set IP and DNS server addresses. The Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior installer launches this application. You can also start the Network Configuration application from the Windows Start menu by choosing Programs > Nokia Developer Tools > DP 2.0 SDKs > Series 80 > C++ CodeWarrior >Tools > Network Configuration. A.1 Network configuration with DHCP Configuring SDK when DHCP is used is easy. Simply leave the IP-address and DNS fields with the default values. If your computer has several network adapters, see section A.3 before clicking OK. If you are planning to use a HTTP proxy server, set the proxy settings as shown in section A.4 before clicking OK.

Figure 1: Network settings when DHCP is used

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

24

Forum.Nokia.com

A.2

Network configuration without DHCP Before configuring your system, make sure you have a dedicated IP-address for this emulator. You must not use the same IP-address as your Windows is using. If you are not planning to run several SDKs at the same time, you can configure the same IP-address for all emulators. Since you are not using DHCP, you can choose whether to set your network adapter to promiscuous mode or not: If you choose promiscuous mode, your emulator will use a MAC-address of its own. This is useful when troubleshooting connections with a network analyzer. If you do not choose promiscuous mode, your emulator will use same MAC address as the hosting PC.

If your computer has several network adapters, see Section A.3 before clicking OK. If you are planning to use a HTTP proxy server, set proxy settings as shown in Section A.4 before clicking OK.

Figure 2: Network setting when DHCP is not used

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

25

Forum.Nokia.com

A.3

Choosing an adapter If you have several network adapters installed, you need to choose which one to use. Click the Adapters button to list your network cards.

Figure 3: Choosing network adapter

Type the number of the network adapter you want to use and press Enter. Note: The only adapters listed are those that can be used with the Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior. A.4 HTTP proxy configuration If you are planning to use a HTTP proxy in your application, select Use proxy and fill in proxy server, port and exceptions to proxy usage information.

Figure 4: HTTP proxy settings

Note: Your application has to support connections via proxy. These proxy settings are simply a centralized storage for this information.

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

26

Forum.Nokia.com

A.5 1. 2. 3.

Choosing MAC address manually Start the Command prompt Go to SDK directory \epoc32\tools in your Series 80 Developer Platform SDK installation directory Type the following command: netcards MAC <desired_mac_address> Where <desired_mac_address> is: Vendor ID of the MAC address e.g. 004043 Full MAC address e.g. 00404352b4a6

Series 80 Developer Platform 2.0 SDK for Symbian OS - Supporting CodeWarrior - Installation Guide

27