Remote File Management (RFM) Operations.
The purpose of the RFM (Remote File Management) campaign is to manage values on the SIM’s files. Although Update and Custom RFM commands are the two most common operations, we can also do Read operations on our YateOTA interface.
In the image on the right side, you can see our interface OTA Server for our product YateOTA. With the help of this tool we can create and schedule new RFM campaigns for subscribers.
- In order to create a New Campaign, just select the tab “New Campaign” from OTA Server interface.
- For starters complete the mandatory fields and insert at least one MSISDN.
- Go to the last section of the page and select “RFM” for the “Campaign Type”
- After selecting the type of campaign to be RFM, the field below must be completed with one of the following operations:
1. Update
2. Read
3. Custom RFM Commands
Update is used to replace the values on the SIM files.
Read is used to retrieve the current values from the SIM. Usually the READ operation is used for only one subscriber at a time. But there might be exceptions as well.
Custom RFM Commands is used to send various commands (UICC reset, refresh, etc), that will be executed by the SIM. Commands must be sent in hexadecimal. It is recommended to use the commands as instructed from your SIM manufacturer or Applet vendor.
We’re going to give an example for each type of RFM campaign operation you can do with our YateOTA interface.
In order to have an example of both linear and transparent file we’re going to create a RFM campaign that will update two files on the SIM:
The SPN which is the Service Provider Name.
And the SMSP file which contains the Service Centre Address.
UPDATE Operation
Create Update Campaign
Follow these easy steps in order to get familiar with setting up on YateOTA interface the RFM Campaign – UPDATE operation. In this guide, we will update EF SPN and EF SMSP under USIM application.
- First, in the “Campaign Details“ section we set the title of the campaign. In our example “test_rfm_update” with the present date. (Using this title will make it easier for follow-ups on this campaign execution.)
- In the“Campaign Participants” section, “Range Type” by default is selected the MSISDN List.
- In the “MSISDN List” text box, we will insert the phone number of the subscriber that is going to receive the updates
- For updating values for more subscribers add each number separated by a comma.
- In the “Campaign Type” section, first field “Campaign Type”, select RFM from the drop-down.
- “RFM Operation” field will be UPDATE
- “SIM profile to use” we select an already generated SIM profile, in our case YateBTS. (The SIM profile is a JSON file where the SIM Structure is saved. SIM profiles can be generated using Local Mode of the Yate OTA Server)
- “SIM application” will be USIM, and after we selected it, the right of the screen will be populated with the fields for the selected application (in our case USIM). The fields are taken from the selected SIM profile.
Editing SIM files with YateOTA plug-in editor
Next, we are going to edit two files: SMSP and SPN with the help of our YateOTA built-in SIM file editor.
Pressing the Edit button, on the right side of the SIM files, makes a pop-up appear allowing you to insert the content in human readable form. YateOTA interface includes editors for the majority of the SIM fields making viewing/editing SIM fields a lot easier. After pressing Save the files will be encoded according to the standards.
Edit EF SMSP file
- Go to EF SMSP file > press on Edit, and a pop-up window will appear.
- We’re going to set a SCA(Service center address) that will start with + and the next digit should be between 1 to 9.
- Press on the Save button, and the new value is going to be overridden.
- The EF SMSP INPUT/UPDATE field will be automatically filled will the encoded value. In our case that will be:
FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 06 91 21 43 65 87 F9 FF FF FF FF FF FF FF FF
Edit EF SPN file
We’re going to do the same for the EF SPN file.
- Go to EF SPN file > press on Edit, and a pop-up window will appear.
- Put in the editable input a test value, as “Test SPN”
- Press Save button, and the new value is going to be overridden.
- The EF SPN INPUT/UPDATE field will be automatically filled will the encoded value. In our case that will be:
00 54 65 73 74 20 53 50 4E FF FF FF FF FF FF FF FF
Update selected SIM Files & Submit
- As in the image above, mark the “Update” checkbox for EF SPN & EF SMSP
- Go at the end of the page and press “Update Selected Files”.
- When you press “Update Selected Files”, you will see on the left side, the Remote File Management Command is going to be filled with a lot of hexadecimal commands.
- Then press on Submit, from the left side of the page.
The RFM campaign UPDATE is going to be created and the commands will be sent to the SIM using our Scheduler.
READ Operation
Create Read Campaign
Follow these easy steps in order to get familiar with setting up on YateOTA interface the RFM Campaign – READ operation. In this guide, we will read EF SPN and EF SMSP under USIM application.
- First, in the “Campaign Details“ section we set the title of the campaign. In our example “test_rfm_read” with the present date. (Using this title will make it easier for follow-ups on this campaign execution.)
- In the“Campaign Participants” section, “Range Type” by default is selected the MSISDN List.
- In the “MSISDN List” text box, we will insert the phone number of the subscriber that we need to READ information from.
- Usually the READ operation is used for only one subscriber at a time. But there might be exceptions as well.
- In the “Campaign Type” section, first field “Campaign Type”, select RFM from the drop-down.
- “RFM Operation” field will be READ
- “SIM profile to use” we select an already generated SIM profile, in our case YateBTS. (The SIM profile is a JSON file where the SIM Structure is saved. SIM profiles can be generated using Local Mode of the Yate OTA Server)
- “SIM application” will be USIM, and after we selected it, the right of the screen will be populated with the fields for the selected application (in our case USIM). The fields are taken from the selected SIM profile.
Select & Read SIM files
After finishing the initial set-up of the RFM campaign, the right side will be populated by the application files we have selected, in our case USIM files.
- Select the files that you want to Read from the checkbox in the read column:
- EF SMSP and EF SPN (are what we’re using in our example)
- Down below, go and press the Read Selected Files button.
- It should create a JSON on the left panel with the ‘smsp’ and the ‘spn’.
After pressing Submit, a confirmation that the campaign was created will appear on the screen. You can access the campaigns tab in order to see the status of the campaign or click on the link in the confirmation message.
Custom RFM Commands
Follow these easy steps in order to get familiar with setting up on YateOTA interface the Custom RFM Campaign Commands. In this guide, we will update EF SPN and EF SMSP under USIM application.
It is recommended to use the commands as instructed from your SIM manufacturer or Applet vendor.
- First, in the “Campaign Details“ section we set the title of the campaign. In our example “test_rfm_custom” with the present date. (Using this title will make it easier for follow-ups on this campaign execution.)
- In the“Campaign Participants” section, “Range Type” by default is selected the MSISDN List.
- In the “MSISDN List” text box, we will insert the phone number of the subscriber that is going to receive the updates
- For updating values for more subscribers add each number separated by a comma.
- In the “Campaign Type” section, first field “Campaign Type”, select RFM from the drop-down.
- “RFM Operation” field will be Custom RFM Commands
- “SIM profile to use” we select an already generated SIM profile, in our case YateBTS. (The SIM profile is a JSON file where the SIM Structure is saved. SIM profiles can be generated using Local Mode of the Yate OTA Server)
- “SIM application” will be USIM, and after we selected it, the right of the screen will be populated with the fields for the selected application (in our case USIM). The fields are taken from the selected SIM profile.
- In the RFM Commands text box, we’re going to copy paste the commands presented at the bottom:
00A40004026F46
00D60000110059617465425453FFFFFFFFFFFFFFFFFF
00A40004026F42
00DC010434FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFDFFFFFFFFFFFFFFFFFFFFFFFF069121436587F9FFFFFFFFFFFFFFFF
D009810301010082028182
- The first two commands are going to update the Service Provider Name
- The other two commands are going to update the SMSP
- The last command is an extra command. It’s used to do a reset for SIM initialization and for full file change notification. That means after the update of those elementary files, it’s going to give a command to the SIM to refresh the files and to apply the changes.
YateOTA
OTA gateway solution for remote updates
See the product here ››
Online documentation
-
Description