Home > Dev Tools > Developer Suite > Examples > SIM Toolkit Commands

SIM Toolkit Commands   

pdf Mail Impression

Purpose and description of the example

This example illustrates:

  • How to implement the most common proactive SIM Toolkit commands in an applet.
  • How Developer Suite Mobile Simulator supports the different proactive commands.

This applet is presented as a series of SIM Toolkit menus, each menu grouping a set of related proactive commands. The following commands and features are included:

Common STK features

  • Icon management (with self-explanatory icon and not self-explanatory icon qualifiers)
  • Help management

User interaction

  • Display text (with clear after delay and clear after user action qualifiers)
  • Select item (with choice of data values, choice of navigation options and soft key preferred qualifiers).
  • Get Input (with digit filter/hide input and SMS character/show input qualifiers)
  • Get Inkey (with character input and yes/no input qualifiers)

Mobile interaction

  • Play Tone
  • Provide Local Information (with local information qualifier)
  • Refresh (with SIM Initialization/File Change Notification and SIM reset qualifiers)
  • Timer Management (with start timer, get timer value and stop timer qualifiers)
  • Launch Browser (with ME default URL qualifier)

Network interaction

  • Send short message
  • Set up call

Card interaction

  • Get reader status
  • Power up card
  • Perform Card APDU
  • Power down card

 


Note: In order to test icon management on the Mobile Simulator the icon support options must be set.
a) To set the option:In the Mobile Simulator menu, choose Mobile Options.
b) In the Mobile Options dialog box, click the Icons tab and make sure that the Mobile Simulator supports icons and Black & white or colour icons options are selected.

How to download the applet?

To test the Mobile Simulator’s icon display abilities, some icons must be loaded in the card’s Graphics directory under DF Telecom (7F10\5F50).
The commands used to do this are included in the "AppletPerso3GV3.atf" file provided in the project directory.
In order to download and test the applet:

  • On a card simulator: Import the Project in Developer Suite and run it in debug mode. The Card Simulator is launched and the Applet automatically loaded. The "AppletPerso.atf" script is also automatically played.
  • On a real card: Import the Project in Developer Suite and run the STKCommandsExample_load.gxsc script on the card. Then, launch the Mobile Simulator from the Developer Suite menu. In this case, you may need to play the "AppletPerso.atf" personalisation script "manually" using JCard Manager.

How to test the applet

You can test the commands supported by the applet by navigating in the Mobile Simulator’s SIM Toolkit menu that is organised as outlined in the applet description above.

Files

Developer_Suite_-_Examples_-_STK_Commands.pdf

Developer_Suite_-_Examples_-_STK_Commands.zip