Professional Documents
Culture Documents
Sim Guideline Wib 1 3 Equipped Sim Cards PDF
Sim Guideline Wib 1 3 Equipped Sim Cards PDF
Contents
1 Introduction _______________________________________________________ 5
1.1 Target audience .................................................................................... 5
1.2 Purpose of the document ..................................................................... 5
1.3 Abbreviations ........................................................................................ 5
1.4 Terminology .......................................................................................... 6
1.5 References ............................................................................................. 7
3 Wib 1.3____________________________________________________________ 9
3.1 New features ......................................................................................... 9
3.1.1 Downloadable Wib plug-ins ....................................................... 9
3.1.2 Graphics ....................................................................................... 9
3.1.3 Enhanced wait for response state .............................................. 9
3.1.4 Unified menu file structure......................................................... 9
3.1.5 Addressing with script identifier .............................................. 10
3.1.6 Bookmarking ............................................................................. 10
3.1.7 Enhanced variable support ....................................................... 10
3.1.8 Timer management ................................................................... 10
3.2 Wib Plug-ins ........................................................................................ 10
3.2.1 Downloading of the plug-ins.................................................... 11
3.2.2 Keys for the security plug-ins.................................................... 11
3.2.3 Prompt texts .............................................................................. 11
3.2.4 Other plug-in parameters ......................................................... 11
3.3 Icons..................................................................................................... 11
3.3.1 Icons with menu items and bookmarks ................................... 12
3.4 Wib events .......................................................................................... 12
3.4.1 SIM Toolkit events ..................................................................... 12
3.4.2 SIM internal events .................................................................... 12
3.5 Menu ................................................................................................... 13
3.5.1 Menu structure .......................................................................... 13
3.5.2 Size of menu file ........................................................................ 14
3.6 Wib bytecode ...................................................................................... 14
3.7 Wib script ............................................................................................ 15
3.8 Script addressing ................................................................................. 15
3.8.1 Relative addressing mode ......................................................... 15
3.8.2 Absolute addressing mode ....................................................... 15
3.8.3 Wiblet-URI and timer expiration .............................................. 16
3.9 User interface during the server request and response.................... 16
3.9.1 Sending info .............................................................................. 16
3.9.2 Wait-for-response state ............................................................ 16
3.9.3 User alert during the Wait-For-Response state........................ 17
-2-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
-3-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
-4-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1 Introduction
1.1 Target audience
This document is meant to be used by G&D SmartTrust
customers to order SmartTrust Wib™ 1.3 equipped (U)SIM
cards.
G&D SmartTrust has specified Wib. The Wib specifications
are meant for SIM vendors only. All information G&D
SmartTrust customers need to know about Wib functionality
and configuration is included in this document and other
G&D SmartTrust Product Specifications.
This document requires some knowledge about the
functionality of SmartTrust Delivery Platform, DP.
Overview of the SmartTrust Delivery Platform is described
in the System Description [1].
1.3 Abbreviations
3DES2 3DES algorithm with 2 keys
DP SmartTrust Delivery Platform
IMSI International Mobile Subscriber Identity
-5-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1.4 Terminology
Script Synonymous to Wib script
Wib bytecode A compact sequence of Wib commands executed by
Wib
Wib command A Wib bytecode command
Wib command Several Wib commands that logically belong together
sequence and occur one after the other
Wiblet Synonym for Wib script
Wib script A Wib command sequence
-6-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1.5 References
[1] System Description - Delivery Platform, doc. no: 90-362
[2] Specification – RFM and RAM Implementation, doc. no: 90-074
[3] Specification - WIG WML v. 5, doc. no: SALC/UG/Spec/09:877776
[4] GSM 03.38, Alphabets and language-specific information, version 7.2.0
[5] GSM 03.40, Technical realization of the SMS-PP, version 7.4.0
[6] 3GPP TS 03.48, SIM Toolkit Secure Messaging, version 8.8.0
[7] GSM 04.11, Point-to-Point short message support on mobile radio
interface, version 7.0.0
[8] 3GPP TS 11.11, Specification of the Subscriber Identity Module – Mobile
Equipment (SIM – ME) interface, version 8.8.0
[9] 3GPP TS 11.14, Specification of the SIM Application Toolkit for the
Subscriber Identity Module – Mobile Equipment (SIM – ME) interface,
version 8.10.0
[10] Developer‟s Guide - Deployment of Wib Services – Wireless Internet
Gateway and Wireless Service Management, doc. no: 90-287
[11] References - Input File Format Specification, SIM Data Import, doc. no:
90-063
[12] Developer‟s Guide - Development of Wib Services - Universal Gateway
and Wireless Service Management, doc. no: 90-291
[13] Standard Event Specification – –SmartTrust Wib™, SmartTrust
[14] Specification - SmartTrust Wib™, Manufacturer Identity Allocation, doc.
no: 90-384
-7-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
-8-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
3 Wib 1.3
The development of Wib 1.3 services are defined detailed in
Guidelines – Development of Wib Services [12] and WIG
WML Specification – version 4 [3].
3.1.2 Graphics
Wib 1.3 has support for graphics through (U)SIM
application toolkit icons as defined in section “Icons” on
page 11.
-9-
SIM Guideline
Wib 1.3 equipped (U) SIM cards
3.1.6 Bookmarking
Bookmarking is an optional feature in Wib 1.3. With the
bookmarking feature the end-users can save service
bookmarks on the go when a service is executed and access
them later on from the “MyBookmarks” menu item.
- 10 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
3.3 Icons
It is possible to create graphical user interfaces with Wib 1.3
by using the SIM toolkit icon functionality. The used icons
are stored as images in the EFIMG and Image Instance data
files as defined in 3GPP TS 11.11 [8].
- 11 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 12 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Startup event
The startup event is generated after the SIM initialization as
defined in the Wib Event Specification Start-Up event
[13]. Startup event is used in the G&D SmartTrust‟s device
management solution as defined in section “G&D
SmartTrust device management” on page 27.
3.5 Menu
When the mobile is powered on the (U)SIM card collects
the information from Wib menu configuration files and
launches the SET UP MENU toolkit command with the
main menu title, top level menu items if at least one top
level menu item exist on the card.
Fun
Movies
Music
WIB menu
Sport
.
.
- 13 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1
The total size of data in SET UP MENU command is limited, e.g. for an average length of 10 bytes per
text string the maximum amount of items is 18.
- 14 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 15 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
waiting-for-response state
- 16 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Intermediate info
The intermediate info is shown to the user after the sending
info until Wib starts to receive the response message. The
default intermediate info text and/or icon are stored in the
EFText file.
Wiblet can replace the default text with a wiblet specific
intermediate info. Refer to WML specification [3] for the
details.
Receiving info
If the incoming server response consists of concatenated
short messages, Wib shall display the receiving info.
The receiving info is shown to the user when Wib is
receiving the server response messages. The default
receiving info text and/or icon is stored in the EFText file.
The receiving info is shown to the user when Wib is
receiving the server response messages. The default
receiving info text and/or icon is stored in the EFText file.
The receiving info can be displayed in fraction mode
“Receiving 1/3” or percentage mode “Received 33%”.
Recommended is to use the percentage mode to display the
receiving info.
- 17 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
3.10.1 TAR
In outgoing messages TAR, Toolkit Application Reference,
is used to address DP. In incoming messages TAR is used to
address Wib.
Administrative TAR
A separated administrative operation mode, indicated by a
Admin TAR type, is dedicated for the administrative
purposes.
Administrative mode enables an entity with administrator
privileges to perform tasks like adding new plug-ins and
perform menu management.
- 18 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 19 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 20 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 21 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 22 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
ME errors
Plug-in errors
Error code
(range 60-
7F)
'60'h Invalid input parameter(s)
'61'h Input out of bounds
'62'h Output overflow
'63'h RSA error
'64'h Illegal operation
'65'h Integrity error
'66'h PIN length error
- 23 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
3.15 Bookmarking
The bookmarking feature provides a way of storing the
wiblet bookmarks. Wiblet bookmarks are similar to the
bookmarks in the internet browsers.
Bookmarking is an optional feature in Wib 1.3. It is
configured in the EFMenu file weather the bookmarking
feature is available for the end user or not. The stored
bookmarks are available for the user in Wib menu. The
bookmarks are stored in a separate memory area. The size of
bookmarks memory area is defined by the operator. The size
of one bookmark can be up to 512 bytes, but normally one
bookmark requires much less memory. All Wib 1.3 cards,
that support the bookmarking feature, are able to support at
least 1.5kB memory area for the bookmarks. Larger
bookmarking storage can be requested from the (U)SIM
vendor.
Following bookmarking related text strings are configurable
and stored in EFText file.
- 24 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 25 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 26 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 27 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
GSM application
– 3k GSM network parameters.
– 5-20k phone book, service dialing numbers, short
messages and other corresponding data.
Wib implementation
–Wib functionality if not implemented in ROM (size
depends of SIM vendor).
–Wib parameters 1-2k, refer to section “Wib parameters
on the SIM card” on page 32.
–Bytecode file 8-12k for services without Unicode and
20-32k for Unicode services.
- 28 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
5.3.4 Wiblets
The wiblets to be stored on the card shall be defined
according to Guidelines - Deployment of Wib Services [10]
before ordering cards.
It is important to define enough large EFBytecode file for the
wiblets to be stored on the card.
It is also important to be able to address all wiblets in the
EFBytecode file. The EFScriptAddress file should include memory
for all needed Script Addresses.
- 29 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
5.3.5 Icons
The icon related files EFIMG and Image Instance data files
must be defined on the (U)SIM card that it is possible to use
the icons. Each icon is stored in an own Image Instance data
file.
If icons are downloaded over-the-air, EFIMG and Image
Instance data files shall already exist on the card.
It is important to ensure that the EFIMG file has enough many
records and Image Instance data files are enough big for the
icons to be downloaded.
Note that icon identifier „01‟h is used as default icon for the
menu items and bookmarks as defined in section “Icons
with menu items and bookmarks” on page 12.
- 30 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 31 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 32 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Coding:
- 33 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 34 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1 to A Error #1 M A
A+1 to Error #2 M B
A+B
: : : :
A+…+1 to Error #n M N
A+…+N
A+…+N+ End mark value '00'h M 1
1
A+…Z+1 Padding ('FF'…'FF') O Z
At least the generic error message with error code 'DF' shall
be defined in this file, unless all individual error codes used
by Wib implementation are defined.
Error message consist of an error text and detailed error
information, if included.
Detailed error information is included into the error message
with escape sequence "%D". To be able to use the actual '%'
in its original form it must be preceded with an extra '%', i.e.
"%%".
Detailed error information is displayed as a string of
hexadecimal numbers on the form “ErrorCode
WibCommand TerminalResponse/FileIdentifier”. Wib
command defines the function Wib was executing when
error happened. Terminal Response is displayed if the error
happened during executing a proactive SIM command and
File Identifier is displayed if Wib failed to access file.
Example 1:
- 35 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 36 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 37 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Coding:
- 38 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 39 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
1 to A SC #1 M A
A+1 to A+B SC #2 M B
… … M …
A+B+…+1 SC #n M N
to
A+…+N
A+B+…+N+ End mark M 1
1
The end mark is coded 'FF'h. The file contents after the end
mark is undefined.
Each SC shall be coded according to:
- 40 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 41 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 42 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 43 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Coding of counter:
- 44 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
over-the-air.
- 45 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 46 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
UPDATE ADM
INVALIDATE ADM
REHABILITATE ADM
Coding:
- 47 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
The end-mark is coded 'FF'h. The file contents after the end-
mark is undefined.
Coding of event handling mode:
Event handling mode defines if the event handling
functionality is enabled or disabled.
'FE 00 00'h Event handling is persistently enabled.
'FF 00 00'h Event handling is persistently disabled.
Coding of event entries #1…#n:
- 48 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
events
'A1'h…'FD'h:
reserved for
SmartTrust
'FE'h and 'FF':
Reserved
Item identifier Item identifier '00'h: Event is not 1
address to the active
script to be
executed when the Other values depend
event occurs. on the used
addressing mode as
described in sections
“Relative addressing
mode” on page 15
and “Absolute
addressing mode” on
page 15.
Length of event Length of the Length X. 1
specific following field
parameter
Event specific Event specific According to event X
parameters parameters description. Often
not used.
- 49 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
The end mark is coded 'FF'h. The file contents after the end-
mark is undefined.
The unused bytes after the end mark are set to 'FF…FF'h.
All text fields are coded according to the table below:
- 50 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
For UCS2 support only the coding scheme with first octet
set to '80'h is supported by Wib. Coding schemes with first
octet set to '81'h or '82'h may be supported by Wib.
- 51 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
'06'h Text and/or icon to inform the user that the bookmark can't
be stored as defined in section “Storing of bookmarks” on
page 25.
'07'h Text and/or icon to be used when positive answering text,
like "“Store", is required as defined in section “Storing of
bookmarks” on page 25.
'08'h Text and/or icon to be used when negative answering text,
like "Don‟t store", is required as defined in section
“Storing of bookmarks” on page 25.
'09'h Default text and/or icon to alert user that Wib is in the
wait-for-response state as defined in section “User alert
during the Wait-For-Response state” on page 17.
'0A'h Default text and/or icon to be used as receiving info as
defined in section “Receiving info” on page 17.
'0B'h Default text and/or icon to be used as intermediate info as
defined in section “Intermediate info” on page 17.
'0C'h Text and/or icon to inform the user that the bookmark
name is already reserved as defined in section “Storing of
bookmarks” on page 25.
'0D'h…'7F'h RFU
'80'h - 'FD'h Implementation specific texts.
'FE'h Non-used Text.
- 52 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Tag Text
'„01'‟h Sending request...
'‟02'h My Bookmarks
'03'h Do you want to store this as a bookmark?"„
'‟04'h Name of bookmark?"
'‟05'h Remove bookmark„
'‟06'h Error - bookmark cannot be stored„
'‟07'h Store
'‟08'h Don‟t store
'‟09'h Please wait„
'‟0A'h Receiving %P%% „
'‟0B'h Waiting for response„
'‟0C'h Bookmark name already exists. Please
choose another one.
The unused bytes after the end mark are set to 'FF FF'.
To be able to update the prompt texts over-the-air, the OTA
access condition for EFText file shall be set to “OTA
updateable”.
The minimum size of the text file is recommended to be 400
bytes if bookmark is enabled. For text in UCS2 the size of
the file is recommended to be at least 800 bytes.
It is recommended to use percentage format for progress
information in the receiving info prompt text. The
percentage format gives user much better understanding
about the status of downloading.
- 53 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Access Conditions:
READ ADM
UPDATE ADM
INVALIDATE ADM
REHABILITATE ADM
- 54 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 55 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 56 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Coding:
- 57 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
EFBytecode
Free space
Length bytes
Script
EFScriptAddress
EFEventConfig EFMenu
'0302'
'02' '02' ’0000061C0000’ ’02’ ”Balance”
’00003E0500C5’
- 58 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
EFBytecode
Free space
Length bytes
Script
EFScriptAddress
'XX02'
’0000061C0000’
’00001A0301A5’
’00003E0500C5’
- 59 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 60 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Coding:
- 61 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
7 OTA functionality
There are situations in the SIM card life cycle where there is
a need to update the card using OTA technology.
The recommended OTA protocol is RFM, Remote File
Management as defined in the RFM implementation
specification [2].
To allow download of wiblets on Wib, OTA access
conditions for the Menu files, EFBytecode file, EFScriptAddress
file and EFEventConfig file must be set to OTA updateable. To
ensure the flexibility of SmartTrust DP and Wib in the
future it is recommended to have all Wib files except key
files in DF2700 OTA updateable.
To allow ordinary OTA update for files in SIM and USIM
application on the card it is recommended to be able to
update all files on the cards except key files and probably
some other files like ICCID.
For all OTA updateable files, OTA access conditions shall
be chosen. Used key set, key length and algorithm depends
on the SIM vendor implementations. Refer to RFM
implementation specification [2] for details.
It is recommended to use a TAR value in range B0 00 10 to
B0 00 1F for the SIM updating and B0 00 01 and B0 00 20
to B0 01 1F for the USIM updating.
- 62 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 63 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
File Requirement
EFTAR 6F1A Pull TAR = BF FF 01
Push TAR = BF FF 02
Admin TAR = BF FF 03
2 empty records
Pull and Push TAR has the same security configuration
Pull TAR‟s security configuration in Rec 1 in EFSC
Push TAR‟s security configuration in Rec 1 in EFSC
Admin TAR‟s security configuration in Rec 2 in EFSC
EFError Text 6F02 Generic error code DF with detailed error information
EFBytecode 6F03 Size of EFBytecode file is 16kB
File is empty
EFSMS Header 6F04 Account number (destination address) is 12345
Service Centre address is +46 12 34 56 78 90
PID is 00
DCS is F6
Validity period is 1h
EFSC 6F1B SC #1 includes security configuration for Pull and Push TARs
with security level L1, SC2 #2 includes security configurations
for Admin TAR has with security level L2.
SC #3 includes security configuration with security level 3. It is
reserved for future usage.
EF03.48Counter 6F06 6 different counters.
- 64 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 65 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 66 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
Version 6F 07 Transparent 30 30 01 010301 02 04 454E4352 000001 04 Setec card, Wib version 1.3,
information 44454352 000002 FF FF FF FF FF FF ENCR and DECR plug-ins
FF FF FFh
- 67 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
- 68 -
SIM Guideline
Wib 1.3 equipped (U) SIM cards
79 20 65 78 69 73 74 73 2E 20 50 6C 56 characters
65 61 73 65 20 63 68 6F 6F 73 65 20
61 6E 6F 74 68 65 72 20 6F 6E 65 2E
FF Padding
FF FF FF FF FF FF FF FFh
Menu 6F 18 Linear fixed 13 22 286 Rec 1: 00 00 00 00 00 00 00…00h Bookmarking is enabled
Rec 2-13: FF …FFh The main menu is generated
No icons
No defined menu items
Script Address 6F 1D Transparent 800 800 03 02 FF … FFh Absolute addressing used for
menu and event management
Length of script address 2 bytes
Menu Title 6F 1E Linear fixed 19 19 00 00 08 53 49 4D 20 4D 65 6E 75 FF SIM Menu
FF FF FF FF FF FF FFh
- 69 -