Professional Documents
Culture Documents
Series 80
Forum.Nokia.com
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 – For MIDP - Installation Guide 2
Forum.Nokia.com
Contents
1 Introduction................................................................................................................................................ 5
1.1 System requirements..............................................................................................................................5
1.2 Optional Software Requirements .......................................................................................................6
1.3 Additional Installation Requirements ...............................................................................................6
2 Installing the Series 80 MIDP SDK.......................................................................................................... 7
2.1 Prerequisites..............................................................................................................................................7
2.2 Installing the Java™ 2 Platform SDK, Standard Edition................................................................7
2.3 Installing the IDE ......................................................................................................................................8
2.3.1 Installing the Sun J2ME™ Wireless Toolkit.....................................................................8
2.3.2 Installing the Sun Java Studio Mobility 6 2004Q3 .......................................................8
2.3.3 Installing the Borland JBuilder IDE ...................................................................................8
2.3.4 Installing the IBM WebSphere Studio Device Developer...........................................8
2.3.5 Installing the Eclipse 3.0......................................................................................................8
2.4 Installing the Nokia Developer’s Suite for J2ME .............................................................................8
2.5 Installing the SDK .....................................................................................................................................9
3 Uninstalling the Series 80 MIDP SDK...................................................................................................17
4 Getting started .........................................................................................................................................21
5 Configuring Emulator for Bluetooth hardware ...............................................................................22
6 Configuring Emulator for Network Connectivity.............................................................................23
6.1 Network configuration with DHCP................................................................................................... 23
6.2 Network configuration without DHCP............................................................................................ 24
6.3 Choosing an adapter ............................................................................................................................ 25
6.4 HTTP proxy configuration................................................................................................................... 25
6.5 Choosing MAC address manually...................................................................................................... 26
7 Configuring Emulator for CSD connection .........................................................................................27
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 3
Forum.Nokia.com
Change History
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 4
Forum.Nokia.com
1 Introduction
This document describes what you need to know and do to install the Series 80 Developer Platform
2.0 SDK for Symbian OS – For MIDP (referred to as ‘Series 80 MIDP SDK’ or ‘SDK’ later in this document).
The SDK enables MIDP application development for devices based on the Series 80 Platform. The SDK is
provided as a single, self-extracting executable file.
The following steps guide you through the installation of the Series 80 MIDP SDK software on your PC.
The installation package contains a phone emulator, Java class libraries, API reference documentation,
user documentation and an uninstaller.
This chapter defines the minimum hardware and software requirements for successfully installing and
running the SDK as a standalone application. If you plan to use the SDK with an integrated
development environment (IDE), make sure you have the requirements mandated by the IDE.
The minimum hardware requirements for installing and running the SDK are as follows:
• 1.0 GHZ Pentium 3 processor
• 256 MB RAM
• 500 MB available disc space
• Display supporting at least 16-bit color at 1024 by 768 resolution
• Microsoft Windows compatible sound card for audio support.
• Keyboard and mouse
See the IDE documentation for minimum hardware requirements for a specific IDE.
The minimum software requirements for installing and running the SDK are as follows:
• Microsoft® Windows® XP with Service Pack 2 or Microsoft® Windows® 2000 with Service Pack 3
• Java™ 2 Platform SDK, Standard Edition 1.4.1_02 or higher
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 5
Forum.Nokia.com
A network connection is needed to complete the installation if you do not have a Forum Nokia
account and/or a serial number for this product.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 6
Forum.Nokia.com
2.1 Prerequisites
All installations should be performed with an account that belongs to local administrators group. You
should close all other applications before starting the installer.
To be able to use this product you will need a serial number. This can be retrieved for free of charge
from the Forum Nokia website, Tools & SDKs section, or it can be received during the installation via e-
mail. During the installation, you must use the serial number you received from Forum Nokia. You
cannot use a serial number received by another user. The installation program describes how to get
the serial number for this product by using your current username if the serial number is not available
yet. The serial number will be sent to e-mail address designated in your Forum Nokia account.
To develop applications with the SDK you will also need to install the Java™ 2 Platform SDK, Standard
Edition. Note that you need to download and install the Java SDK before installing the SDK. You should
also have the IDE installed on you computer before installing the SDK.
Before you start the installation, you should check if your computer has the Java™ 2 Platform SDK,
Standard Edition already installed.
1. Open Windows command prompt
2. Type the following command: javac
If you get the command help with the options, javac works correctly. But if you see a message such as
'javac' is not recognized as an internal or external command,operable program or batch file, type the
java –version command to find out if Java is even installed on your computer.
If you get a message about Java version, Java is installed, but your PATH system variable is not
correctly set. If the command also gives a message about invalid command, you need to download
and install Java using the .exe file that can be downloaded from Sun website.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 7
Forum.Nokia.com
Once you have downloaded and installed the Java™ 2 Platform SDK, Standard Edition, you can proceed
to install the selected IDE.
Install Borland JBuilder from an installation media according the instructions. See Borland
documentation for more information.
Install IBM WebSphere Studio Device Developer from an installation media according the instructions.
See IBM documentation for more information.
You can download Eclipse 3.0 IDE from eclipse .org website www.eclipse.org. Follow the download
and installation instructions.
To install the Nokia Developer's Suite for J2ME (NDS), go to the Forum Nokia website
www.forum.nokia.com. The Tools and SDKs pages of the Resources section provide basic information
of the NDS and you can download it from there.
For detailed installing information of the NDS, see Installation and Configuration Guide of Nokia
Developer’s Suite for the JavaTM 2 Platform, Micro Edition Version 2.2 for Windows.
Note: The Release notes for Nokia Developer’s Suite for J2ME TM provides useful information.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 8
Forum.Nokia.com
With the Java™ 2 Platform SDK, Standard Edition installed to your PC you can now install the SDK. This
is done by running the Installation Wizard.
Warning: Before running the Installation Wizard, make sure that your system meets the hardware
and software requirements (as outlined in Section 1.1. System requirements).
To run the Installation Wizard and install the SDK, do the following:
1. In the Wndows Explorer, go to the folder where you have downloaded the installation package,
that is, the S80_DP2_0_MIDP_SDK.zip file.
2. Unzip the S80_DP2_0_MIDP_SDK.zip file.
3. Double-click the setup.exe file of the unzipped installation package.
The InstallAnywhere installation wizard Introduction dialog opens.
Step 1: Introduction
This panel displays general information about the Series 80 MIDP SDK to be installed. Press Next to
continue.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 9
Forum.Nokia.com
Read the terms of the license agreement. Accept the terms by selecting the appropriate option, an
press Next to proceed to with the installation.
Step 3: Welcome
a. If the Forum Nokia username or the product’s serial number is not available, leave both the
username field and the serial number field empty, and press Next. Go to step 4.
b. If both the Forum Nokia username and the correct product serial number are available, fill in both
fields and press Next. Go to step 8.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 10
Forum.Nokia.com
If the installation program succeeds in automatically detecting the current proxy settings, these
settings are suggested for use. Alternatively, specify the desired settings or select No proxy. If your
proxy needs a username and password, type them in the appropriate fields. Note that the registration
procedure requires an Internet connection. Press Next to continue.
Step 5: Registration
a. If you have a Forum Nokia account: Fill in your Forum Nokia username and password, and press the
Next button. You will be connected to to the Forum Nokia server, and the serial number will be sent to
the e-mail address specified in your Forum Nokia account.
b. If you do NOT have a Forum Nokia account: Press the Register button, and then register (at
forum.nokia.com/reg_form) as a Forum Nokia member using your web browser. After typing in your
new Forum Nokia username and password, press Next to continue.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 11
Forum.Nokia.com
Check your e-mail for the serial number. You must access your e-mail account using a separate
application. You cannot check your e-mail from the installation program.
Step 7: Licensing
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 12
Forum.Nokia.com
When prompted to choose a directory for the installation, click Next to accept the default installation
directory (C:\Nokia\Devices). If you want to select another installation directory for the SDK, click
Choose…, select the appropriate directory from the dialog that opens and click OK. Having selected the
directory of your choice, click Next. For example, if you are using the SDK with the Sun J2ME™ Wireless
Toolkit application environment, select <WTK directory>\wtklib\devices\ as the installation directory.
Note: As the installation directory must be same as the name of the device, the installer always
creates a Nokia\Devices\S80_DP2_0_MIDP_SDK directory under the selected directory.
In the Pre-installation summary dialog that appears, make sure that the information is correct, and
then click Install.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 13
Forum.Nokia.com
Series 80 MIDP SDK installation package includes the Nokia Connectivity Framework (NCF) Lite version.
NCF Lite is installed with Series 80 MIDP SDK installation by default and it provides a 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.
This indicates the installation’s progress when Nokia Connectivity Framework is installed.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 14
Forum.Nokia.com
For more information on how to use Nokia Connectivity Framework, the Series 80 Developer Platform
2.0 SDK for Symbian OS – For MIDP User’s Guide.
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 the Forum Nokia website.
The installer configures the Series 80 MIDP SDK for you system. Please wait.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 15
Forum.Nokia.com
Once the installation is complete, the installation wizard informs you of this with the Install Complete
dialog. Click Done.
See Chapter 5, Configuring Emulator for Bluetooth hardware for more information on how to
configure Bluetooth hardware for Series 80 MIDP SDK.
If you use Ethernet connections during application development, remember to configure it using the
Network Configuration tool provided with the Series 80 MIDP SDK, see Chapter 6, Configuring Emulator
for Network Connectivity
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 16
Forum.Nokia.com
Note: Always uninstall the SDK through the Add/Remove Programs application, as described above. Do
not attempt to uninstall the SDK manually in, for example, the Windows Explorer.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 17
Forum.Nokia.com
Next the Series 80 MIDP SDK uninstaller starts the Nokia Connectivity Framework Lite uninstaller.
Note: The uninstaller will not uninstall Nokia Connectivity Framework Lite if product integrations for
other Nokia products exist or if Nokia Connectivity Framework Full is installed.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 18
Forum.Nokia.com
This panel indicates the Nokia Connectivity Framework Lite uninstaller progress.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 19
Forum.Nokia.com
Step 5: Status
Once the SDK has been removed from your PC, Install Wizard informs you of this. Click Done to exit the
Install Wizard.
If the uninstaller cannot remove all items, it shows such items on this panel. Note that if you have
other Series 80 SDKs installed, the uninstaller reports “Unable to remove directory” for the Nokia
Developer Tools start menu item.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 20
Forum.Nokia.com
4 Getting started
Before you can start application development using the Series 80 MIDP SDK, you need to configure the
emulator for use with an Integrated Development Environment (IDE) tool. You can find information on
how to configure the SDK for Borland JBuilder, Sun Java Studio Mobility, Sun J2ME™ Wireless Toolkit,
and IBM WebSphere from the Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP User’s
Guide.
For further instructions on how to develop, build and run applications using these development tools,
see the User’s Guide and Example Applications section in the SDK Help. The SDK Help includes Java
docs, which provide needed reference information on the APIs used. You can open the SDK Help from
the Windows Start menu by selecting Start > Nokia Developer Tools > DP 2.0 SDKs > Series 80 > MIDP >
SDK Help.
If the Nokia Connectivity Framework has been installed with the SDK, the Found New Hardware Wizard
will appear the first time you start the Series 80 MIDP SDK emulator. The virtual COM that Nokia
Connectivity Framework uses for Bluetooth emulation is detected as new hardware.
For late-breaking information, please refer to the Release Notes, which you can open directly from the
installation package (S80_DP2_0_MIDP_SDK_ReleaseNotes.txt).
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 21
Forum.Nokia.com
Note: Only the COM ports 2, 3, 4, 5, and 6 can be used. If none of these are available, the port needs
to be changed. You can do this using Windows Control Panel > System > Hardware > Device
Manager. Expand the ports and click the properties of the installed COM port, the Port Settings tab,
and Advanced button. Change the COM port number to one of the allowed COM port numbers.
Note: Infrared uses port number 2 as a default COM port
Note: Nokia Connectivity Framework uses COM4 as the default port for Bluetooth connections. If you
use COM port 4, you need to shut down Nokia Connectivity Framework service. (see Chapter
“Integration with Other Nokia Products” in Series 80 Developer Platform 2.0 SDK for Symbian OS – For
MIDP User’s Guide).
2. Open C:\Nokia\Devices\S80_DP2_0_MIDP_SDK\bin\epoc32\wins\c\System\Data\bt.esk in a text editor.
3. Change the hcidllfilename setting in the [hcidll] section to hcidllfilename=hci.dl. The default
hcidllfilename=hci_h4.dll setting works with Nokia Connectivity Framework
4. Change the port setting in the [hcidll] section. Set the value between 1 and 5. The indexing of COM
port starts from zero, and therefore the port number must be one less than the actual port
number. The default value –1 disables Bluetooth.
Example Bluetooth settings in bt.esk for BCSP cards using COM port 3:
[sockman]
protocols= btlinkmanager,l2cap,rfcomm,sdp
[hci]
hcidllfilename= hci.dll
port= 2
Bluetooth is activated via the Bluetooth application in emulator control panel. You can also use ALT +
left arrow key on your PC keyboard to activate Bluetooth in the Series 80 MIDP SDK emulator.
More information on how Bluetooth can be used with the Series 80 MIDP SDK can be found on the
Forum Nokia website http://www.forum.nokia.com/.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 22
Forum.Nokia.com
If you have multiple network adapters available, you must select which network adapter to use. As a
default, the installer offers you settings where automatic IP and DNS server addresses are used. You
can change these settings with the Network Configuration tool. Series 80 MIDP SDK installer launches
this application during installation. You can also start the Network Configuration application from the
Windows Start menu by choosing Start > Nokia Developer Tools > DP 2.0 SDKs > Series 80 > MIDP >
Tools > Network Configuration.
The Nokia D211 WLAN card is tested with the Series 80 MIDP SDK. There is no guarantee that the
network connection in the SDK works correctly with other WLAN cards. Verification of the installed
network setup can be carried out by simply opening a web page in the emulator.
Configuring SDK when DHCP is used is easy. Simply leave the the IP address and DNS fields with the
default values. If your computer has several network adapters see Section 6.3 before clicking OK. If you
are planning to use a HTTP proxy server, set proxy settings as shown in Section 6.4 before clicking OK.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 23
Forum.Nokia.com
Before configuring your system, make sure you have a dedicated IP-address for this emulator. You
must not use the same IP-address as that which 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 the same MAC address as the
hosting PC.
If your computer has several network adapters see Section 6.3 before clicking OK. If you are planning
to use a HTTP proxy server, set the proxy settings as shown in Section 6.4 before clicking OK.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 24
Forum.Nokia.com
If you have several network adapters installed, you need to choose which one to use. Click the
Adapters button to list your network cards.
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 Series 80 MIDP SDK.
If you are planning to use a HTTP proxy in your application, select “Use proxy” and fill in the proxy
server, port and exceptions to proxy usage information.
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 – For MIDP - Installation Guide 25
Forum.Nokia.com
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 26
Forum.Nokia.com
############################################################
## ModemBearer
##
[ModemBearer]
ADD_SECTION
# COMMDB_ID = 1
Name=CSD
Agent=CSD.agt
IfName=PPP
PortName=COMM::3
TSYName=MM
CSYName=ECUART
DataBits=8
StopBits=1
Caution: ced.exe may cause problems if not used properly, for example running ced.exe without
the input file option set causes the CommDb database to be overwritten by a template database. If
this happens, you can copy C:\Nokia\Devices\S80_DP2_0_MIDP_SDK\bin\epoc32\wins\c\ced_npacket.cfg
to cedout.cfg. Make modifications to cedout.cfg and run the ced.exe –i cedout.cfg command again.
6. Start the emulator C:\Nokia\Devices\S80_DP2_0_MIDP_SDK\bin\epoc32\release\wins\udeb\epoc.exe.
Go to Tools > Control Panel.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 27
Forum.Nokia.com
9. Press Edit.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 28
Forum.Nokia.com
10. Select the Connection tab using the arrow keys on your keyboard.
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 29
Forum.Nokia.com
Series 80 Developer Platform 2.0 SDK for Symbian OS – For MIDP - Installation Guide 30