android 源码阅读之-----ADN实现

    技术2025-01-07  47

    ADN既是 Abbreviated Dialing Numbers 的缩写,就是常用的快速拨号功能。它在SIM或者USIM卡中存储的文件编号是6F3A,文件结果是线性文件结构(SIM卡中有线性、透明和循环等几种文件结构类型),具体的文件结构的定义如下(《GSM11-11协议》):

    EFadn(快速拨号)

    这个EF包含速拨号码与提供的服务控制字符串(SSC),它除了包含与网络/载波容量相关的识别符与扩展记录识别符外,还包含一个相关的字母标记。

    识别符:0x6F3A

    结构:线性

    可选

    记录长度:X+14个字节

    更新级别:低

    访问条件:

    读:CHV1

    更新:CHV1

            使无效:CHV2

            恢复:CHV2

    字节

    描述

    M/O(必须或可选)

    长度

    1-X

    字母识别符

    O

    X

    X+1

    内容长度的BCD

    M

    1

    X+2

    TONNPI

    M

    1

    X+3-X+12

    拨号号码字符串

    M

    10

    X+13

    容量/配置识别符

    M

    1

    X+14

    扩展1记录识别符

    M

    1

    字母识别符

    内容:相关拨号号码的字母标记。

    编码:这个字母标记将使用SMS默认的7位编码,第8位置0

    注解1X的值为0241,通过GET RESPONSE移动终端可以检测到这个值。

    BCD码格式的内容长度

    内容:这个字节给出了后面两个包含实际BCD格式信息的数据项的字节数。这意味着,即使实际的信息长度大于11,它的最大值也只能为11。当一个AND/SSC请求超过20个数字,它将由不等于FF的扩展1标示符表示。剩余部分在EFext1中,益出数据的长度由益出记录来编码。

    TONNPI

    内容:编号类型(TON)与编号识别(NPI)

    编码:参考TS GSM 04.08[14]。如果拨号字符串没有包含将拨的号码,例如,使一个服务失效的字符串,TON/NPI将被移动终端设置为FF

    注解2:如果缺少一个拨号号码,空中接口不会传输TON/NPI,因此,移动终端不会解析值FF,也不会通过空中接口来发送它。

    B1 B2 B3 B4NPI                          B5 B6 B7TON                    B81

    拨号/SSC字符串

    内容:20个数字的电话号码与SSC信息。

    编码:根据TS GSM 04.08[14]TS GSM 02.30[8]与扩展的BCD编码,如果电话号码或SSC超过20个数字,前面20个数字被保存到数据项里边,溢出的数据被保存到EFext1的一条相关记录里,这条记录由扩展1记录识别符识别。如果AND/SSC少于20个数字,数据项结尾剩余部分应设置为FF

    字节X+3

    B1 B2 B3 B4:数字1(左边第1个数字)                B5 B6 B7 B8:数字2

    字节X+4

    B1 B2 B3 B4:数字3                                                                      B5 B6 B7 B8:数字4

    等等。

    容量/配置识别符

    内容:容量/配置识别字节,这个字节识别EFccp文件的一条记录的记录号,这个文件包含呼叫要求的容量/配置参数相关的信息。这个字节的使用是可选的,如果没有使用将设置为FF

    编码:二进制。

     

    扩展1记录识别符

    内容:扩展1记录识别字节,这个字节识别EFext1文件的一条记录的记录号,这个EF文件包含呼叫相关的部分子地址与溢出信息。这个字节的使用是可选的,如果没有使用将设置为FF

    编码:二进制

    注解3:当EFadnDFtelecom的一部分时,它将被GSM与多应用卡的其它应用使用。如果非GSM应用不能识别TONNPI,那么国际拨号相关信息必须保留在拨号/SSC的数据项里,并且TONNPI必须设置为未知,格式必须符合GSM操作,同时也要符合忽略TONNPI域的非GSM应用。

    例子:含有国际号码的SIM,号码使用E.164[18]编码

                                                                                                               TON    NPI                 数字域

    GSM应用                                                                  001                  0001    abc

    另外一些GSM兼容的应用             000                  0000    xxx…abc…

    这里,abc表示用户号码(包括国家编码)xxx表示TONNPI代号的前缀。

    注解4:当移动终端为了识别字母标示符中字符串而采用SEEK命令来处理EFadn文件时,移动终端必须保证SEEK参数的值小于或等于MMI允许用户使用的最大值。

               扩展BCD编码

    BCD

    字符意义

    0

    0

    9

    9

    A

    *

    B

    #

    C

    DTMF控制数字分割符

    D

    Wild”值

    E

    扩展数字

    F

    结束标志,假如是一个奇偶数

    BCDCDE不会通过空中接口发送。

     

     

    ADN功能实现的底层数据读取主要由com.android.internal.telephony.AdnRecord.java和com.android.internal.telephony.AdnRecordLoader.java这两个类来完成;com.android.internal.telephony.AdnRecordCache.java 这个类主要是用来实现数据的缓存功能的,通过类名可以判断出来。

     

    AdnRecord.java

    在AdnRecord.java类主要是体现ADN的数据结构,包括 电话号码、email、附件号码记录编号;还有就是根据相应的协议标准(eg:51.011 10.5.1)实现数据编码格式的转换等。几个获取数据的方法列举如下:

     

    /** * Fetches all extra numbers. * * @return The extra numbers in a string array, null if no extra numbers * exists. */ public String[] getAllAnr() { String[] anrs = null; if (mAnrNumbers != null) { int size = mAnrNumbers.size(); anrs = new String[size]; for (int i = 0; i < size; i++) { anrs[i] = mAnrNumbers.get(i); } } return anrs; }  

    /** * @return All anr numbers as one long colon, ":", separated string, or null * if no anr numbers exist. */ public String getAllAnrAsOneString() { String anrString = null; if (mAnrNumbers != null) { StringBuilder strBuilder = new StringBuilder(); for (String singleAnr : mAnrNumbers) { strBuilder.append(singleAnr); strBuilder.append(":"); } anrString = strBuilder.toString(); } return anrString; } public String getNumber() { return number; } public String[] getEmails() { return emails; }

     

     

     

    AdnRecordLoader.java

    该类是一个Handler.java的一个子类,通过复写(重写)handleMessage()方法来实现具体的事件处理;具体的loader方法如下:

    /** * Resulting AdnRecord is placed in response.obj.result * or response.obj.exception is set */ public void loadFromEF(int ef, int extensionEF, int recordNumber, Message response) { this.ef = ef; this.extensionEF = extensionEF; this.recordNumber = recordNumber; this.userResponse = response; phone.mIccFileHandler.loadEFLinearFixed( ef, recordNumber, obtainMessage(EVENT_ADN_LOAD_DONE)); } /** * Resulting ArrayList<adnRecord> is placed in response.obj.result * or response.obj.exception is set */ public void loadAllFromEF(int ef, int extensionEF, Message response) { this.ef = ef; this.extensionEF = extensionEF; this.userResponse = response; phone.mIccFileHandler.loadEFLinearFixedAll( ef, obtainMessage(EVENT_ADN_LOAD_ALL_DONE)); } /** * Write adn to a EF SIM record * It will get the record size of EF record and compose hex adn array * then write the hex array to EF record * * @param adn is set with alphaTag and phone number * @param ef EF fileid * @param extensionEF extension EF fileid * @param recordNumber 1-based record index * @param pin2 for CHV2 operations, must be null if pin2 is not needed * @param response will be sent to its handler when completed */ public void updateEF(AdnRecord adn, int ef, int extensionEF, int recordNumber, String pin2, Message response) { this.ef = ef; this.extensionEF = extensionEF; this.recordNumber = recordNumber; this.userResponse = response; this.pin2 = pin2; phone.mIccFileHandler.getEFLinearRecordSize( ef, obtainMessage(EVENT_EF_LINEAR_RECORD_SIZE_DONE, adn)); }

     

     

     

    最新回复(0)