RAM campaigns introduction
The purpose of the Remote Applet Management (RAM) Campaigns are to manage the Applets that resides on the SIM and communicate with the Applets. Each Applet has its own Toolkit Application Reference (TAR), which is defined by the Applet Developer. We can also send custom commands to it by using TAR.
RAM operations
The RAM Campaign offers three primary operational options followed by combinations, custom option and listing operations:
Main Operations:
Load
Install
Delete
Combinations of the main operations:
Load+Install
Delete+Load+Install
Custom:
Custom Applet Commands
Listing Operations:
List ISD
List Applets
List Packages
LOAD is used to put all the Applets packages into the SIM, then the INSTALL operation is used to set the Applet parameters and create the instance of the Applet. Using the DELETE operation, it will remove either the whole Applet, or the Applet with everything related to it.
LOAD+INSTALL is a combination of the first two commands. By doing this, you configure a single campaign for both loading the packages and installing the applet.
Likewise you can perform a different combination of the above mentioned three actions — DELETE, LOAD, and INSTALL. Therefore, you can DELETE an old application and then LOAD and INSTALL the new application.
The Custom Applet Commands is used to send different commands to the SIM by targeting the Applet. As a result, such commands will be sent to a specific Applet, which will then carry them out.
The next operation type known as List has three different variants. LIST IDS – lists the Issuer Security Domain. LIST APPLETS – shows all of the Applets that are installed on the SIM. LIST PACKAGES – can list all the load components on the SIM.
RAM - Load & install
Load & Install - Basic configurations
How to LOAD and INSTALL an Applet on the SIM.
In the image on the right side, you can see our interface OTA Server, on the Scheduler mode. With the help of this tool we can create and schedule new RAM campaigns on the SIMs.
In order to Load an Install an Applet on the SIM follow these steps:
– From the Scheduler interface select the tab “New Campaign”
– Complete the mandatory fields: “Campaign Name“, add a “Description“ and insert at least one MSISDN
– Go to the last section of the page and select “RAM” for the “Campaign Type”
– Change the operation to LOAD + INSTALL.
We’re going to do both operations at once. Because the LOAD command will manage and transfer all the packages that contains the Applet to the SIM.
The final command will be INSTALL, which will create the Applet instance by specifying the install parameters and it will start the Applet.
A new set of fields will show when we choose LOAD + INSTALL, also the Advanced button for further configurations appears.
– The “Module AID” (Module Application Identifier) and “Instance AID” (Instance Application Identifier) fields will be populated with the information retrieved from the Applet Developer.
– For the field called “Applet” upload a file that is either CAP or IJC format type. (In our example we will select the CAP format.)
– Next, the “Nonvolatile Memory” and the “Volatile Memory”, those two fields are used to put a maximum memory that the Applet will need for the installation on the SIM. The creator of the Applet should offer this information in Bytes format. Completing those fields verifies if the SIM has the memory necessary for the operation. And if it’s not available, it’s going to return an error. If the SIM is new, you might skip this step by inserting zero as the numeric value.
– In this moment, if we press “Submit”, the command should be sent directly to the SIM and it will load and install the Applet.
Load & Install - Advanced configurations
For further configurations press on the “Advanced” green button.
The Toolkit Parameters and Application Parameters are used for creating an interface to the Applet.
– From the “Toolkit Parameters” field you should either choose the SIM Toolkit or the UICC Toolkit. The interface and options, such as the menu you will see on the phone, will be created using a different Java framework within. (For our example, we will select the SIM from the Toolkit Parameters.)
– The “Application Parameters“, the other field, allows you to enter hexadecimal commands that it will be sent to the Applet and executed once it has been installed.
– “Access Domain” is used to establish different security of the Applet.
– “Priority Level” determines how to prioritize this Applet in the menu.
– For the “Maximum Timers”, the “Maximum Menu Entry Texts” and the “Maximum Menu Entries” there are some default values already set-up, but you can modify according to the instructions received from the creator of the Applet.
– The next field is the “TAR Values” (Toolkit Application Reference). This field is very important because you will set the Toolkit Application Reference of this Applet, which will be used later on while performing different Applet custom commands that will be executed.
– Press “Submit” after filling up all the fields. All the commands will be generated and delivered to the SIM. When you check the phone, you’ll see a new application called SIM Toolkit. And if you open it you’re going to see the Applet.
RAM - How to delete an old Applet
How to Delete an old Applet on the SIM.
In the image below, you can see our interface OTA Server, on the Scheduler mode. With the help of this tool we can create and schedule new RAM campaigns on the SIMs.
In order to Delete an old Applet on the SIM follow these steps:
– From the Scheduler interface select the tab “New Campaign”
– Complete the mandatory fields: “Campaign Name“, add a “Description“ and insert at least one MSISDN
– Go to the last section of the page and select “RAM” for the “Campaign Type”
– Change the operation to DELETE
– Complete the filed “Applet ID” with the ID of the Applet
– If you want to delete the Applet and all of its related objects then check the box for “Delete related objects”.
RAM - How to Delete, Load & Install
How to DELETE + LOAD + INSTALL an Applet on the SIM.
With the combination of the three commands, we can delete an old Applet and install the new one. Using Delete + Load + Install will execute all three commands in a single campaign.
In the image on the left side, you can see our interface OTA Server, on the Scheduler mode. With the help of this tool we can create and schedule new RAM campaigns on the SIMs.
In order to Delete an old Applet on the SIM and then Load and Install a new Applet, follow these steps:
Delete, Load & Install - Basic configurations
– From the Scheduler interface select the tab “New Campaign”
– Complete the mandatory fields: “Campaign Name“, add a “Description“ and insert at least one MSISDN
– Go to the last section of the page and select “RAM” for the “Campaign Type”
– Change the operation to LOAD + INSTALL.
We’re going to do both operations at once. Because the LOAD command will manage and transfer all the packages that contains the Applet to the SIM.
The final command will be INSTALL, which will create the Applet instance by specifying the install parameters and it will start the Applet.
A new set of fields will show when we choose LOAD + INSTALL, also the Advanced button for further configurations appears.
– The “Module AID” (Module Application Identifier) and “Instance AID” (Instance Application Identifier) fields will be populated with the information retrieved from the Applet Developer.
– For the field called “Applet” upload a file that is either CAP or IJC format type. (In our example we will select the CAP format.)
– Next, the “Nonvolatile Memory” and the “Volatile Memory”, those two fields are used to put a maximum memory that the Applet will need for the installation on the SIM. The creator of the Applet should offer this information in Bytes format. Completing those fields verifies if the SIM has the memory necessary for the operation. And if it’s not available, it’s going to return an error. If the SIM is new, you might skip this step by inserting zero as the numeric value.
– In this moment, if we press “Submit”, the command should be sent directly to the SIM and it will load and install the Applet.
Delete, Load & Install - Advanced configurations
For further configurations press on the “Advanced” green button.
The Toolkit Parameters and Application Parameters are used for creating an interface to the Applet.
– From the “Toolkit Parameters” field you should either choose the SIM Toolkit or the UICC Toolkit. The interface and options, such as the menu you will see on the phone, will be created using a different Java framework within. (For our example, we will select the SIM from the Toolkit Parameters.)
– The “Application Parameters“, the other field, allows you to enter hexadecimal commands that it will be sent to the Applet and executed once it has been installed.
– “Access Domain” is used to establish different security of the Applet.
– “Priority Level” determines how to prioritize this Applet in the menu.
– For the “Maximum Timers”, the “Maximum Menu Entry Texts” and the “Maximum Menu Entries” there are some default values already set-up, but you can modify according to the instructions received from the creator of the Applet.
– The next field is the “TAR Values” (Toolkit Application Reference). This field is very important because you will set the Toolkit Application Reference of this Applet, which will be used later on while performing different Applet custom commands that will be executed.
– Press “Submit” after filling up all the fields. All the commands will be generated and delivered to the SIM. When you check the phone, you’ll see a new application called SIM Toolkit. And if you open it you’re going to see the Applet.
The first command is going to delete the old Applet with all of its ancestors. And then it’s going to install the new Applet with a new package.
RAM - How to list
List Operations
There are three List Operations and that is,
List ISD
List Applets
List Packages
The “List ISD” stands for Issue Security Domain. You’re going to receive some details about the Issue Security Domain. “List Applets” the Applets that are installed on the SIM. “List Packages”, if you list the packages, you’re going to receive a response with the packages that are on the SIM.
In order to LIST any item from the SIM follow these steps:
– From the Scheduler interface select the tab “New Campaign”
– Complete the mandatory fields: “Campaign Name“, add a “Description“ and insert at least one MSISDN
– Go to the last section of the page and select “RAM” for the “Campaign Type”
– Change the operation to LIST ISD/Applets/Packages
– You will see there are no other fields to be filled, you’re just going to submit and you’ll receive in the response.
How to send custom RAM commands
The Custom Applet Commands is used to send different commands to the SIM by targeting the Applet. As a result, such commands will be sent to a specific Applet, which will then carry them out.
In the image on the right side, you can see our interface OTA Server, on the Scheduler mode. With the help of this tool we can create and schedule new RAM campaigns on the SIMs.
In order to send Custom Applet Commands, follow these steps:
– From the Scheduler interface select the tab “New Campaign”
– Complete the mandatory fields: “Campaign Name“, add a “Description“ and insert at least one MSISDN
– Go to the last section of the page and select “RAM” for the “Campaign Type”
– Change the operation to Custom Applet Commands
– In the “Customer Applet Commands” text box, you’re going to put all the hexadecimal commands that will be sent to the SIM.
– In the “Applet TAR” field, as in the Applet Toolkit Application Reference insert the 6 hexadecimal characters. All those commands will be routed to this certain Toolkit Application by the SIM.
YateOTA
OTA gateway solution for remote updates
See the product here ››
Online documentation
-
Description