This document outlines requirements for an ESN tracking application on RUIM-based CDMA handsets for Tata Teleservices Limited (TTL). The application sends SMS messages containing the handset's ESN/MEID and RUIM ID when triggered by certain events, like power-up, calls, SMS, or from a UTK menu option. It must send SMS to a predefined number in a predefined format. The application runs hidden from the user interface and retries sending up to 3 times if the initial SMS fails. The document also provides details on parameters stored in the RUIM and handset, SMS triggers and formats, and sample logs.
This document outlines requirements for an ESN tracking application on RUIM-based CDMA handsets for Tata Teleservices Limited (TTL). The application sends SMS messages containing the handset's ESN/MEID and RUIM ID when triggered by certain events, like power-up, calls, SMS, or from a UTK menu option. It must send SMS to a predefined number in a predefined format. The application runs hidden from the user interface and retries sending up to 3 times if the initial SMS fails. The document also provides details on parameters stored in the RUIM and handset, SMS triggers and formats, and sample logs.
This document outlines requirements for an ESN tracking application on RUIM-based CDMA handsets for Tata Teleservices Limited (TTL). The application sends SMS messages containing the handset's ESN/MEID and RUIM ID when triggered by certain events, like power-up, calls, SMS, or from a UTK menu option. It must send SMS to a predefined number in a predefined format. The application runs hidden from the user interface and retries sending up to 3 times if the initial SMS fails. The document also provides details on parameters stored in the RUIM and handset, SMS triggers and formats, and sample logs.
This document outlines requirements for an ESN tracking application on RUIM-based CDMA handsets for Tata Teleservices Limited (TTL). The application sends SMS messages containing the handset's ESN/MEID and RUIM ID when triggered by certain events, like power-up, calls, SMS, or from a UTK menu option. It must send SMS to a predefined number in a predefined format. The application runs hidden from the user interface and retries sending up to 3 times if the initial SMS fails. The document also provides details on parameters stored in the RUIM and handset, SMS triggers and formats, and sample logs.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
2 Table of Content
1. OBJECTIVE ......................................................................................................................................... 4 2. TERMS USED ...................................................................................................................................... 5 3. FEW IMPORTANT PARAMETERS ................................................................................................ 6 4. ESN TRACKING RELATED REQUIREMENTS............................................................................ 7 4.1 ESN TRACKING APPLICATION STEPS ............................................................................................ 7 4.2 SMS FORMAT ................................................................................................................................. 8 5. TRIGGERS EXPLAINED..................................................................................................................11 5.1 POWER-UP EVENT .........................................................................................................................11 5.2 MOBILE ORIGINATED SMS/VOICE CALL/DATA CALL EVENT ........................................................11 5.3 MOBILE TERMINATED SMS/VOICE CALL EVENT ..........................................................................11 5.4 UTK MENU SELECTION EVENT .....................................................................................................11 5.5 NETWORK INITIATED SMS EVENT ................................................................................................11 5.6 UTK MENU OPTION FROM RUIM CARD EVENT ............................................................................12 7. APPENDIX I: RUIM EF DETAILS ..................................................................................................14 7.1 EF_RUIM_ID ...............................................................................................................................14 7.2 EF_ME_ESN ...............................................................................................................................15 7.3 EF_SF_EUIMID...........................................................................................................................15 8. APPENDIX II: SAMPLE LOG FOR CATEGORY 1 TRIGGERS ...............................................16 9. APPENDIX III: SAMPLE LOGS FOR CATEGORY 2 TRIGGERS ............................................20 10. APPENDIX IV: ESN TRACKING APPLICATION FLOW ......................................................26
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
3 Revision History
Date Version Description 15 th January 2007 1.0 Initial release 16 th January 2007 2.0 Changed the SMS format
12 th April 2007 3.0 Added MEID support Added SMS Trigger for First MT Voice/SMS after activation Flowchart added ESN Tracking SMS version changed to V2
6 th March 2009 3.1 Destination number changed from 3751 to 9223053751 Modification to Send SMS at invalid MIN check Updated Logs 8 th April 2009 3.2 Destination number changed from 9223053751 to 09223053751 Updated Sample Logs 24 th February, 2011
3.3 Added additional triggers
References
Sr. No Version Standard 1 TTL Specification for ESN Tracking for RUIM Card TTL Document 2. TTL_Phone_Lock_Spec_Ver4.3 TTL Document 3. TIA-EIA/IS-637A 4. C.S0023 (Removable User Identity Module for Spread Spectrum Systems)
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
4 1. Objective
The objective is to capture the serial number i.e. ESN/Pseudo-ESN/MEID of the RUIM based devices so as to have a database of the RUIM_ID and ESN/Pseudo-ESN/MEID pair.
Few of the applications of this database are
To be able to identify a handset model Identify user handset buying trend Inventory management and other logistics
ESN tracking is a mandatory requirement for all RUIM based TTL devices.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
5 2. Terms Used
EF 6F38 (ESN_ME): This EF stores the (up to) 56-bit Electronic Serial Number or MEID or pseudo-ESN of the Mobile Equipment (ME) to which the RUIM is attached. This number is transferred to the RUIM when the Mobile Equipment determines that the RUIM has been inserted. EF 6F31 (UIMID): This is the ID of the RUIM. EF 6F42 (UIMID indicator): This indicator dictates whether ESN_ME or UIMID will be used for CAVE. The value 0 indicates ESN_ME will be used, and the value 1 similarly indicates UIMID will be used. EF 6F74 (SF_EUIMID): This EF stores the 56-bit electronic identification number (ID) unique to the R-UIM. EF 6F22 (IMSI_M): This EF stores the five components of IMSI_M.( TIA-EIA/IS-820A) Handset MEID Mobile Equipment Identifier (MEID). A 56-bit number assigned by the mobile station manufacturer, uniquely identifying the mobile station equipment. Pseudo-ESN - A 32 bit number derived from MEID and used in place of ESN.
Imp Note: ESN & RUIM_ID have been used generically throughout the document for MEID/pESN & RUIM_MEID/pRUIM_ID. Depending on the handset support appropriate unique identity MEID or pESN or RUIM_MEID or pRUIM_ID should be used.
Refer to Appendix for detailed description of the above-mentioned terms.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
6 3. Few Important Parameters Stored in the RUIM RUIM_ID/RUIM_MEID/pRUIM_ID IMSI_M A-Key (Not accessible by the ME) SSD (Not accessible by the ME) COUNT (Not used currently) Stored in the ME ESN/MEID/pESN
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
7 4. ESN tracking related requirements
The TTL Handsets shall have a trigger based preloaded application residing on the terminal software that will send the SMS with ME_ESN upon receipt of triggers. TTL has employed five methods of triggering this ESN application to obtain ESN_ME.
Category 1:- Automatic A) Power Up Event B) Mobile Originated Voice call/SMS/Data call C) Mobile Terminated Voice Call/SMS D) UTK Menu Selection Event
Category 2:- On demand A) UTK menu option from RUIM card B) Network Initiated SMS
The application shall be a masked application (not visible on device UI) on the handset software which will pick up the handset ESN/pESN/MEID & RUIM_ID/pRUIM_ID/MEID pair and send it as a pre-formatted SMS to a pre-defined location. These SMSs will be sent when triggered by particular events like Power Up, UTK Menu Selection, Mobile Originated Call/SMS/data call, Mobile Terminated Call/SMS and Network Initiated SMS.
The UTK menu option from RUIM card will reside in RUIM card as UTK menu option Send MEID which will be similar to other UTK menu option. On selection of UTK menu option by user, the RUIM card will send ESN tracking sms with type UM which shall be blocked by MS application and MS shall originate ESN tracking sms with the type UM.
The Tracking SMS shall be sent on all mentioned triggers. In case of failure, the application shall try as per retry logic mentioned below.
The network-initiated trigger is independent of the other triggers and device shall send track SMS as and when it receives NW trigger.
4.1 ESN Tracking Application Steps
Steps of execution of ESN Tracking application are as follow:
User switches ON the handset.
Device shall write its ESN/MEID during power on procedure on to RUIM EF ESN_ME.
The handset software shall read the IMSI_M check if its a valid MIN as defined in TATA MIN range (TTL_Phone_Lock_Spec_Ver6.0).
a) If the MIN is ABOVE RANGE the terminals shall send the SMS. b) If the MIN is BELOW RANGE the terminals shall send the SMS. c) If the phone has a default MIN the phone shall not send an SMS until the phone gets proper valid min after activation.
If any card with non-default MIN is inserted in the terminal then on Power-UP
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
8 a) The ESN Tracking Application will read the RUIM_ID and ESN_ME pair and compare it to the previously stored RUIM_ID and ESN_ME pair. AND ONLY IF the pair is not identical; the application shall send the ESN tracking message. Upon receipt of L3 ACK, the PU flag shall be set. b) If the SMS is not sent successfully i.e. the phone does not receive Layer 3 Acknowledgment the application should try to resend the SMS 3 times with an interval of 20 sec for 2 nd retry and a 30 sec delay for 3 rd retry. If failed thrice the application shall be disabled for this session and MS shall not set the PU flag and shall try to send the PU ESN tracking SMS on next power on. c) Application shall wait for other mentioned triggers and shall send ESN tracking sms with respective type upon occurrence of respective event. The retry mechanism in case of failure shall be same as for PU (refer point b).
4.2 SMS Format
Format and behavior of the SMS to be sent to the pre-defined location is described below.
The Terminal should send an SMS with the necessary information to the server without end users knowledge.
The ME shall not display
1. The SMS message being sent to the server 2. Any Acknowledgement of the SMS received from the server. Even if Delivery acknowledgement is on in sms setting, it shall not send Dack=1 while sending ESN track sms.
The SMS shall be sent to 09223053751 and the encoding technique used shall be 7 bit ASCII, independent of the ME language mode.
The format of the SMS shall be as follows:
Keyword TRACK<space>Card Vendor code XXXXXX<space>Handset Vendor name ABCDEFGHIJ<space>Handset Vendor Model No.KLMNOPQRST<space>Type of SMS UV<space>RUIM_IDRUIM_ID:<space>xxxxxxxxxxxxxx<space>HandsetESNESN_ME: <space>xxxxxxxxxxxxxx<space>SoftwareversionofhandsetXXXXXXXXXXXXXXX<space>Versio n YZ
Keywor d Card Vendor code Handset Vendor name Handset Vendor Model No. Type of SMS RUIM_ID/ RUIM_M EID ESN_ME Software Version of handset Versi on
5 digits 6 digits 10 digits 10 digits 2 digits 14 digits 14 digits 15 digits 2 digits TRACK XXXX XX ABCDEFGHIJ KLMNOPQR ST UV xxxxxxxxx xxxxx xxxxxxxx xxxxxx xxxxxxx xxxxxxx x YZ
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
9 TRACK FFFFFF MOTOROLAF F MOTO123FF F PU A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3 TRACK FFFFFF SAMSUNGFF F SCHB529FFF OS/O V/OD A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3 TRACK FFFFFF OLIVEFFFFF OLC2040 FFF TS/T V A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3 TRACK FFFFFF HUAWEIFFF F HWC2830 FFF UT A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3 TRACK FFFFFF ZTEFFFFFFF ZTES185FFF UM A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3 TRACK FFFFFF SAMSUNGFF F SCHB529 FFF NW A1000AB5 600002 A1000AB 5600000 HAC500 MRT01F FFF V3
XXXXXXX Card Vendor code Keep this as FFFFFF by default.
ABCDEFGHIJ Handset Vendor name This should be Handset manufacturer name. If Vendor name less than 10 characters please suffix FF. For e.g. Olive is 5 characters so the vendor name will be OLIVEFFFFF
KLMNOPQRST Handset Vendor Model No. - This should be 10 characters Model name of device. If less than 10 characters please suffix FF For instance MOTOW210FF, SCHB529FFF etc
UV Type of SMS PU signifies-- Power Up OS/OV/OD signifiesMobile Originated SMS (OS) /Voice call (OV)/ Data Call (OD) TS/TV signifiesMobile Terminated SMS (TS)/Voice call (TV) UT signifiesUTK Menu selection NW signifies-- Network Initiated UM signifies-- UTK Menu option from RUIM card
RUIM_ID: Device shall read RUIM_ID from EF 6F74 of RUIM card. Length shall be 8 digits for ESN and 14 Hex digits for MEID. In case of ESN FF shall be padded to make the length of 14 hex digits.
ESN_ME: ESN/ MEID of the device. Length shall be 8 digits for ESN and 14 Hex digits for MEID. In case of ESN FF shall be padded to make the length of 14 hex digits.
Software version of handset: This should be 15 characters software version of handset. If less than 15 characters please suffix FF. e.g: HAC500MRT01FFFF.
YZ Version e.g. V1, V2, V3
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
10
For e.g. SMS that will be sent out
In case of power up would be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF PU RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC500MRT01FFFF V3
In case of Network Initiated SMS shall be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF NW RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC6000DT01FFFF V3
In case of MO SMS/CALL/DATA SMS shall be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF OS/OV/OD RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC6000DT01FFFF V3
In case of MT SMS/CALL SMS shall be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF TS/TV RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC6000DT01FFFF V3
In case of UTK Menu selection shall be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF UT RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC6000DT01FFFF V3
In case of UTK Menu option from RUIM card shall be: TRACK FFFFFF SAMSUNGFFF SCHB529FFF UM RUIM_ID: A1000AB5600002 ESN_ME: A1000AB5600000 HAC6000DT01FFFF V3
Note: The format of the ESN & RUIM ID should be in HEX. The order of the ESN & RUIM ID should be as displayed on the Handset & RUIM Card (The ESN and UIM_ID are stored in reversed order in RUIM Elementary Files) i.e. should be sent in proper order. The Number of characters to be sent in SMS shall be 103 characters i.e. NUM FIELD of the User Data in Data Burst message should be 103. The whole content of ESN track SMS shall be in capitals.
Responsibility for re-trying lies with the Application. If a valid response is not received within stipulated time or receives negative acknowledgement the Application should re-send the SMS three times and set the counter or flag internally to indicate that SMS sending had failed and will be re-sent on next power on. Separate flags for all triggers shall be maintained independently.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
11 5. Triggers Explained
Following are the triggers:
A) Power Up Event B) Mobile Originated SMS/Voice call/Data Event C) Mobile Terminated SMS/Voice call Event D) UTK Menu selection Event E) Network Initiated SMS Event F) UTK Menu option from RUIM card Event
Details are described as below:
5.1 Power-up Event
The Power-Up event shall be used as the trigger to the application to send the ESN tracking sms with type PU.
5.2 Mobile Originated SMS/Voice call/Data Call Event
The device shall use first MO SMS/Voice call/Data call event as trigger with SMS tyoe as below: MO SMS shall use keyword as OS, MO voice shall use keyword as OV, MO Data call shall use keyword as OD. Any of the above event (whichever occurs first) shall be used as trigger and if sent successfully device shall set the flag as sms sent else shall retry thrice and set the flag as not sent and shall wait for remaining Mobile originated events.
5.3 Mobile Terminated SMS/Voice call Event
The device shall use first MT SMS/Voice call event as trigger with SMS type as below: MT SMS shall use keyword as TS, MT voice shall use keyword as TV.
Any of the above event (whichever occurs first) shall be used as trigger and if sent successfully device shall set the flag as sms sent else shall retry thrice and set the flag as not sent and shall wait for remaining Mobile terminated events.
5.4 UTK Menu Selection Event
Whenever the User selects UTK Menu, this Event shall be used as a trigger to send ESN tracking sms with type UT. If sent successfully device shall set the flag as sms sent else shall follow retry mechanism. The ESN tracking application from RUIM card must be blocked by device.
5.5 Network Initiated SMS Event
In this event the handset receives an SMS from network (Refer APPENDIX III) requesting the ESN.
On receiving this SMS the Handset shall check the originating address ending with 121, user data ESN and Message Display sub parameter to send NW initiated ESN tracking SMS.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
12
The ME shall not display
1. SMS message received from the server. 2. SMS shall not be saved in the Inbox.
RESERVED - The RSERVED bits can have following values:
MSG_DISPLAY_MODE (2 Bits) RESERVED (6 Bits) Remarks 11 10 00 00 SMS PP-Download (VAS) 11 11 00 00 PRL UPDATE are enabled by PP- Download 11 01 00 00 PRL UPDATE are enabled
The Backend server shall use RESERVED value 10 00 00 to indicate to the ME that it is a Network Initiated ESN Tracking trigger.
5.6 UTK Menu option from RUIM card Event
On selection of SEND MEID menu from UTK, the RUIM card will initiate the SMS with type UM, the device shall treat this SMS as a trigger to send UM type ESN tracking SMS from its application. If sent successfully device shall set the flag as sms sent else shall follow retry mechanism.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
13 6. Conflict
TTL RUIM Cards also have the same trigger based ESN Tracking preloaded application residing on the card, which will send the SMS to an 11 Digit Destination Number 09223053751 with ESN_ME upon receipt of the similar triggers. The device shall parse the PDU from RUIM card to detect the SMS with destination address as 09223503751 and content TRACK to block the RUIM initiated ESN Tracking SMS.
Simultaneous events may occur which can also result in trigger conflict, In such case the triggers shall be handled on first come first serve basis.
The delay between SMSs of 2 triggers shall be 30 sec.
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
14 7. Appendix I: RUIM EF details
7.1 EF_RUIM_ID
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
15 7.2 EF_ME_ESN
7.3 EF_SF_EUIMID
CDMA Terminals ESN Tracking Application Document CTT/Specifications/ESN Tracking/v3.3 Revision Version 3.3 Date
24th February, 2011
16 8. Appendix II: Sample log for Category 1 triggers
SMS Sent from Handset on triggers (Power-up /Menu Selection/SMS PP)