SDK Configurator - User manual

How to configure the emulator and SDK device with the graphical tool.

Instead of learning the perl scripts that follows with the SDK to configure the Emulators settings and device settings, this graphical tool can be used.

It uses the perl scripts uiqenv and devices to handle changes in Ethernet settings and default device among other functions.

The tool is installed with the UIQ3SDK installation and is accessible from the start menu. No configuration is required.

The tool uses scripts from Symbian tools which are installed with the UIQ3SDK. Make sure the path to the Symbian tools folder is included in the system path:

C:\Program Files\Common Files\Symbian\Tools

or similar if non-English version of windows is used. The path is set by the installer.

A script called uiqenv.pl is located in epoc32\tools and handles different settings for the emulator. This script is used by the tool and installed with the SDK. Make sure it is in place.

The tool can be run from anywhere on the local computer.

In this tab the device set as default is shown. If there is more than one selectable device in the list the default device can easily be changed. Select a new device in the list and press the OK button to set the new device as default.

This tab allows the user to quickly change the UI setting for the emulator.

3.2.1 Styles

A Style is basically an image with a layout configuration file together with a UI style configuration file.

3.2.2 Create style

Create a new folder in \epoc32\data\styles\<New Style> and put a file named style.ini in this folder defined as:

---------------- File: style.ini --------------------
STYLE

UI_STYLE: 16961
UI_STYLE_NAME: SoftKey Touch Small

END

Now create a new folder in \epoc32\data\styles\<New Style>\<Skin Name> and place a bitmap file of the wanted telephone device epoc.bmp and a configuration file epoc.ini in this new folder.

This new skin will show up in the styles list in the SDK configurator.

3.2.3 Change style

Select a style in the styles list

Select a skin in the skins list. The first skin is selected when present.

Now click the Apply style button.

3.2.4 Start the emulator

The emulator can be started from this tab. Just press the Start Emulator button. The SDK Configurator tool will be locked when the emulator is started this way.

When an extension is installed it adds one or more styles to the styles list in the SDKConfig tool.

To activate an extension, simply select that extensions style in the SDKConfig tool and apply it. The extension will be activated, which can take a few minutes.

To deactivate an extension, apply one of the styles not belonging to the current extension.

To switch extensions, change to a style with another extension.

The extension belonging to a style is shown in the styles information window.

In this tab the user can change the Bluetooth and IrDA ports for the emulator an set the Ethernet settings.

3.4.1 Change ports

Use DHCP settings for the emulator or set the IP-address and the tool sets the rest of the configurations such as Gateway and Subnet. It can be a good idea to enter an IP-number to get control over which IP is set in the emulator. Just make sure the IP is not used anywhere else in your local network. You may have to look over the settings of your swhich/router if you have one.

Modify MAC-address is used for setting the MAC-address for the emulator to the same as the computers MAC-address or a modified MAC-address based on the computers MAC-address.

3.4.2 Ethernet settings

Use DHCP settings for the emulator or set the IP-address and the tool sets the rest of the configurations such as Gateway and Subnet.

Modify MAC-address is used for setting the MAC-address for the emulator to the same as the computers MAC-address or a modified MAC-address based on the computers MAC-address.