android.telephony.gsm
public class
public class
android.telephony.gsm.SimUtils
| java.lang.Object | ||
| android.telephony.gsm.SimUtils | ||
Various methods, useful for dealing with SIM data.
Summary
Public Constructors
| SimUtils() |
Public Methods
| static | String | adnStringFieldToString(byte[] data, int offset, int length) | |||
| Decodes a string field that's formatted like the EF[[]ADN] alpha identifier From TS 51.011 10.5.1: Coding: this alpha tagging shall use either - the SMS default 7 bit coded alphabet as defined in TS 23.038 [[]12] with bit 8 set to 0. | |||||
| static | int | bcdByteToInt(byte b) | |||
| Decodes a GSM-style BCD byte, returning an int ranging from 0-99. | |||||
| static | String | bcdToString(byte[] data, int offset, int length) | |||
| Many fields in GSM SIM's are stored as nibble-swizzled BCD Assumes left-justified field that may be padded right with 0xf values. | |||||
| static | String | bytesToHexString(byte[] bytes) | |||
| Converts a byte array into a String hexidecimal characters null returns null | |||||
| static | byte[] | hexStringToBytes(String s) | |||
| Converts a hex String to a byte array. | |||||
| static | String | networkNameToString(byte[] data, int offset, int length) | |||
| Convert a TS 24.008 Section 10.5.3.5a Network Name field to a string "offset" points to "octet 3", the coding scheme byte empty string returned on decode error | |||||
Methods inherited
from class
java.lang.Object
Details
Public Constructors
public SimUtils()
Public Methods
public static String adnStringFieldToString(byte[] data, int offset, int length)
Decodes a string field that's formatted like the EF[ADN] alpha
identifier
From TS 51.011 10.5.1:
Coding:
this alpha tagging shall use either
- the SMS default 7 bit coded alphabet as defined in
TS 23.038 [12] with bit 8 set to 0. The alpha identifier
shall be left justified. Unused bytes shall be set to 'FF'; or
- one of the UCS2 coded options as defined in annex B.
Annex B from TS 11.11 V8.13.0:
1) If the first octet in the alpha string is '80', then the
remaining octets are 16 bit UCS2 characters ...
2) if the first octet in the alpha string is '81', then the
second octet contains a value indicating the number of
characters in the string, and the third octet contains an
8 bit number which defines bits 15 to 8 of a 16 bit
base pointer, where bit 16 is set to zero and bits 7 to 1
are also set to zero. These sixteen bits constitute a
base pointer to a "half page" in the UCS2 code space, to be
used with some or all of the remaining octets in the string.
The fourth and subsequent octets contain codings as follows:
If bit 8 of the octet is set to zero, the remaining 7 bits
of the octet contain a GSM Default Alphabet character,
whereas if bit 8 of the octet is set to one, then the
remaining seven bits are an offset value added to the
16 bit base pointer defined earlier...
3) If the first octet of the alpha string is set to '82', then
the second octet contains a value indicating the number of
characters in the string, and the third and fourth octets
contain a 16 bit number which defines the complete 16 bit
base pointer to a "half page" in the UCS2 code space...
public static int bcdByteToInt(byte b)
Decodes a GSM-style BCD byte, returning an int ranging from 0-99.
In GSM land, the least significant BCD digit is stored in the most
significant nibble.
Out-of-range digits are treated as 0 for the sake of the time stamp,
because of this:
TS 23.040 section 9.2.3.11
"if the MS receives a non-integer value in the SCTS, it shall
assume the digit is set to 0 but shall store the entire field
exactly as received"
public static String bcdToString(byte[] data, int offset, int length)
Many fields in GSM SIM's are stored as nibble-swizzled BCD
Assumes left-justified field that may be padded right with 0xf
values.
Stops on invalid BCD value, returning string so far
public static String bytesToHexString(byte[] bytes)
Converts a byte array into a String hexidecimal characters
null returns null
public static byte[] hexStringToBytes(String s)
Converts a hex String to a byte array.
Parameters
| s | A string of hexadecimal characters, must be an even number of chars long |
|---|
Returns
- byte array representation
Throws
| RuntimeException | on invalid format |
|---|
public static String networkNameToString(byte[] data, int offset, int length)
Convert a TS 24.008 Section 10.5.3.5a Network Name field to a string
"offset" points to "octet 3", the coding scheme byte
empty string returned on decode error