Table of contents
TOC
Collapse the table of content
Expand the table of content

Customize the SIM toolkit

Last Updated: 12/12/2016

OEMs can change the display duration for certain SIM toolkit UI dialogs or messages if the default values do not meet the requirements of the mobile operator.

The default display times for SIM toolkit commands are as follows:

  • GET INPUT: 120 seconds
  • DISPLAY TEXT: 60 seconds
  • SELECT ITEM: 60 seconds
  • GET INKEY: 60 seconds

See SIM toolkit and SIM toolkit commands for more information.

OEMs can modify the values for the following settings.

SettingDescription

UIDefaultDuration

Specifies the default time, in milliseconds, that the DISPLAY TEXT, GET INKEY, PLAY TONE, or SELECT ITEM dialog should be displayed.

The default value is 60000 milliseconds (60 seconds). The valid value range is 1-120000.

UIGetInputDuration

Specifies the default time, in milliseconds, that the GET INPUT dialog should be displayed.

The default value is 120000 milliseconds (120 seconds). The valid value range is 1-120000.

To customize these settings using MCSF, see the next section. If you're using Windows provisioning, use Windows Imaging and Configuration Designer (ICD) to customize the settings or write your own Windows provisioning answer file. Regardless of the framework that you use, you must determine if you need to use the per-device or per-IMSI setting.

Constraints: None
This customization supports: per-IMSI value, per-device value

Instructions:

  1. Create a customization answer file using the contents shown in the following code sample.

    <?xml version="1.0" encoding="utf-8" ?>  
    <ImageCustomizations xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate"  
                         Name="SIMToolkitCustomization"  
                         Description="Use to modify certain SIM toolkit UI dialogs and messages."  
                         Owner=""  
                         OwnerType="OEM"> 
    
      <!-- Define the Targets --> 
      <Targets>
         <Target Id="">
            <TargetState>
               <Condition Name="" Value="" />
               <Condition Name="" Value="" />
            </TargetState>
         </Target>
      </Targets>
    
      <Static>
        <Settings Path="Multivariant">
          <Setting Name="Enable" Value="1" />
        </Settings>
    
        <Settings Path="AutoDataConfig">
          <Setting Name="Enable" Value="0" />
        </Settings> 
      </Static>
    
      <!-- Specify the Variant -->
      <Variant Name=""> 
        <TargetRefs>
          <TargetRef Id="" /> 
        </TargetRefs>
    
    <!-- Use for the per-IMSI case
        <Settings Path="CellCore/PerIMSI/$(__IMSI)/UTK">  
          <Setting Name="UIDefaultDuration" Value="" />           
          <Setting Name="UIGetInputDuration" Value="" />  
        </Settings>  
    -->
    
    <!-- Use for the per-device case
        <Settings Path="CellCore/PerDevice/UTK">  
          <Setting Name="UIDefaultDuration" Value="" />           
          <Setting Name="UIGetInputDuration" Value="" />        
        </Settings>  
    -->
    
      </Variant>
    
    </ImageCustomizations>
    
  2. Specify an Owner.

  3. Define Targets or conditions for when a variant can be applied, such as keying off a SIM's MCC, MNC, and SPN.

  4. Define settings for a Variant, which are applied if the associated target's conditions are met.

  5. Set the values for UIDefaultDuration and UIGetInputDuration.

Testing:

  1. Flash the build containing this customization to a phone.

  2. Go to the Cellular & SIM > Advanced options settings screen to start the SIM toolkit UI app.

  3. Verify that the duration that the UI dialogs and messages are displayed match the default values that you've set.

Send comments about this topic to Microsoft

© 2017 Microsoft