APN:
一,简介
APN全称是Access Point Name,是手机上网必须要配置的一个参数,用来决定手机是通过哪一种接入方式来访问网络。
接入方式:在国外,接入方式有很多,比如:gprs;hscsd;WAP;edge等等。国内的接入方式目前一般只有gprs。而gprs在运营
商那里被人为的划分为几种。
国内分类:
移动:cmwap 和 cmnet。
联通:分为UNIWAP/3GWAP,UNINET/3GNET,对应划分的G网,W网(即2G,3G网)
(注:彩信之所以单独配置接入点是因为彩信服务需要连接专用的服务器)
那么为什么会有两个接入点呢?
WAP:采用的实现方式是“终端+WAP网关+WAP服务器”的模式,通过WAP网关完成WAP-WEB的协议转换以达到节省网络流量和兼容现有WEB应用的目的。
Internet:“终端+服务器”的工作模式。
Cmwap: 对网络接入作了一定的限制,只能访问WAP业务。
Cmnet: 直连Internet。
国内接入点的分类一般是这几个,但是海外的接入点各不相同,一个运营商可以有好几个不同的接入点,这个跟运营商有关。
二.使用路径
了解了有关于接入方式的分类,我们来看看APN的使用。apn和spn在手机里的路径为:
System/etc/apn-conf.xml
System/etx/spn-conf.xml
apn和spn一般会直接存入数据库中,数据库的位置在:
/data/data/com.android.providers.telephony/databases/ telephony.db/Carriers表
在每一个项目的开始时,都需要配置一下,平台上默认的spn和apn的一般是在/device/sprd/scx35l/device.mk中配置:
APN_VERSION := $(shell cat frameworks/base/core/res/res/xml/apns.xml|grep "<apns version"|cut -d \" -f 2)
PRODUCT_COPY_FILES += vendor/sprd/overlay/apn/apns-conf_$(APN_VERSION).xml:system/etc/apns-conf.xml
当然,也有可能不是在这个地方配置,apn的位置也不一定在vendor/sprd/overlay/apn/下,我们可以执行grep -rin "spn-conf*.xml" ./搜索一下,然后在我们项目的mk中配置就好了。如下:
PRODUCT_COPY_FILES += $(BOARDDIR)/apns-conf.xml:system/etc/apns-conf.xml
PRODUCT_COPY_FILES += $(BOARDDIR)/spn-conf.xml:system/etc/spn-conf.xml
三.apn配置详解
Apn配置的几个关键字段:
Apn type的5种类型:
1.default(默认网络连接),
2.supl(Secure User Plane Location安全用户面定位),
3.mms(彩信专用连接),
4.hipri(高优先级网络),
5.dun(Dial Up Networking拨号网络)
注意:此表中的数据连接优先级是由低到高,即default数据连接的优先级最低,而hipri数据连接的优先级最高。比如:手机上网聊天,建立的是default数据连接。如果此时接到一条彩信,由于彩信的数据连接是mms,优先级比default高,所以会先断开default数据连接,建立mms数据连接,让手机先收到彩信。所以收发彩信的同时不能上网。
在启动手机时,需要初始化telephony.db数据库,这时候会读取手机目录System/etc/apn-conf.xml并把其中的内容加入到Carriers表中。以后查询有关apn的配置参数都是从Carriers表中取出。
创建并初始化Carriers表:packages/providers/TelephonyProvider/src/com/android/providers/telephony/TelephonyProvider.java
内部类:DatabaseHelper.java
public void onCreate(SQLiteDatabase db) { // Set up the database schema // SPRD : for multi-sim for (int i = 0; i < TelephonyManager.getPhoneCount(); i++) { db.execSQL("CREATE TABLE " + (CARRIERS_TABLE + i) + "(_id INTEGER PRIMARY KEY," + "name TEXT," + "numeric TEXT," + "mcc TEXT," + "mnc TEXT," + "apn TEXT," + "user TEXT," + "server TEXT," + "password TEXT," + "proxy TEXT," + "port TEXT," + "mmsproxy TEXT," + "mmsport TEXT," + "mmsc TEXT," + "authtype INTEGER," + "type TEXT," + "current INTEGER," + "protocol TEXT," + "preload TEXT," + "roaming_protocol TEXT," + "carrier_enabled BOOLEAN," + "bearer INTEGER," + "mvno_type TEXT," + "mvno_match_data TEXT);"); } /* SPRD : for multi-sim @{ */ // initDatabase(db); SharedPreferences sharedPreferences = mContext.getSharedPreferences(NEED_INSERT_CONFIG, Context.MODE_PRIVATE); Editor editor = sharedPreferences.edit(); editor.putBoolean(NEED_INSERT, true); editor.commit(); /* @} */ } private void initDatabase(SQLiteDatabase db, int phoneId) { … XmlPullParser confparser = null; File confFile = new File(Environment.getRootDirectory(), PARTNER_APNS_PATH); FileReader confreader = null; confreader = new FileReader(confFile); confparser = Xml.newPullParser(); confparser.setInput(confreader); XmlUtils.beginDocument(confparser, "apns"); loadApns(db, confparser, phoneId); … } private void loadApns(SQLiteDatabase db, XmlPullParser parser ,int phoneId) { if (parser != null) { db.beginTransaction(); XmlUtils.nextElement(parser); while (parser.getEventType() != XmlPullParser.END_DOCUMENT) { ContentValues row = getRow(parser); if (row == null) { throw new XmlPullParserException("Expected 'apn' tag", parser, null); } /* SPRD : for multi-sim @{ */ //insertAddingDefaults(db, CARRIERS_TABLE, row); insertAddingDefaults(db, getTableNameByPhoneId(phoneId), row); /* SPRD : for multi-sim @{ */ XmlUtils.nextElement(parser); } db.setTransactionSuccessful(); } } private void insertAddingDefaults(SQLiteDatabase db, String table, ContentValues row) { // Initialize defaults if any if (row.containsKey(Telephony.Carriers.AUTH_TYPE) == false) { row.put(Telephony.Carriers.AUTH_TYPE, -1); } if (row.containsKey(Telephony.Carriers.PROTOCOL) == false) { row.put(Telephony.Carriers.PROTOCOL, "IPV4V6"); } if (row.containsKey(Telephony.Carriers.ROAMING_PROTOCOL) == false) { row.put(Telephony.Carriers.ROAMING_PROTOCOL, "IPV4V6"); } if (row.containsKey(Telephony.Carriers.CARRIER_ENABLED) == false) { row.put(Telephony.Carriers.CARRIER_ENABLED, true); } if (row.containsKey(Telephony.Carriers.BEARER) == false) { row.put(Telephony.Carriers.BEARER, 0); } if (row.containsKey(Telephony.Carriers.MVNO_TYPE) == false) { row.put(Telephony.Carriers.MVNO_TYPE, ""); } if (row.containsKey(Telephony.Carriers.MVNO_MATCH_DATA) == false) { row.put(Telephony.Carriers.MVNO_MATCH_DATA, ""); } /* SPRD : for multi-sim @{ */ //db.insert(CARRIERS_TABLE, null, row); db.insert(table, null, row); /* @} */ } } 设置APN: packages/apps/Settings/src/com/android/settings/ApnSettings.java @Override protected void onResume() { super.onResume(); registerReceiver(mMobileStateReceiver, mMobileStateFilter); /** SPRD: Bug 327811 title add phoneId @{ */ if (TelephonyManager.isMultiSim()) { this.setTitle(getResources().getString( R.string.apn_settings_ex, mPhoneId + 1)); } /** @} */ if (!mRestoreDefaultApnMode) { fillList(); } else { showDialog(DIALOG_RESTORE_DEFAULTAPN); } } private void fillList() { String where; Uri contentUri = Telephony.Carriers.getContentUri(mPhoneId,null); if (TelephonyManager.isMultiSim()) { where = "numeric=\"" + android.os.SystemProperties.get(TelephonyManager.getProperty( TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC, mPhoneId), "") + "\""; } else { where = "numeric=\"" + android.os.SystemProperties.get( TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC, "") + "\""; } where += " and name!='CMCC DM'"; Log.d(TAG,"where = " + where); Cursor cursor = getContentResolver().query(contentUri, new String[] { "_id", "name", "apn", "type" }, where, null, null); /* @} */ if (cursor != null) { PreferenceGroup apnList = (PreferenceGroup) findPreference("apn_list"); apnList.removeAll(); ArrayList<Preference> mmsApnList = new ArrayList<Preference>(); /* SPRD: add by spreadst @{ */ String firstKey = null; boolean hasKey = false; ApnPreference firstPref = new ApnPreference(this); /* @} */ mSelectedKey = getSelectedApnKey(); Log.d(TAG, "mSelectedKey = " + mSelectedKey); cursor.moveToFirst(); while (!cursor.isAfterLast()) { String name = cursor.getString(NAME_INDEX); String apn = cursor.getString(APN_INDEX); String key = cursor.getString(ID_INDEX); String type = cursor.getString(TYPES_INDEX); Log.d(TAG, "name = " + name + "apn = " + apn + "key = " + key + "type = " + type); ApnPreference pref = new ApnPreference(this); pref.setKey(key); pref.setTitle(name); pref.setSummary(apn); pref.setPersistent(false); pref.setOnPreferenceChangeListener(this); /* SPRD: for multi-sim @{*/ // boolean selectable = ((type == null) || !type.equals("mms")); boolean selectable = ((type == null) || (type.indexOf("default") != -1) || (type.equals("*"))); /* @} */ pref.setSelectable(selectable); if (selectable) { if ((mSelectedKey != null) && mSelectedKey.equals(key)) { pref.setChecked(); hasKey = true; Log.d(TAG, "mSelectedKey has a value: firstKey = " + firstKey + " hasKey = " + hasKey + " firstPref = " + firstPref); } else if (mSelectedKey == null) { pref.setChecked(); hasKey = true; Log.d(TAG, "mSelectedKey is null: firstKey = " + firstKey + " hasKey = " + hasKey + " firstPref = " + firstPref); setSelectedApnKey(key); } apnList.addPreference(pref); // if mSelectedKey dose not match with the operator, // remember the first key as firstKey if (firstKey == null) { firstPref = pref; firstKey = key; } } else { mmsApnList.add(pref); } cursor.moveToNext(); } cursor.close(); for (Preference preference : mmsApnList) { apnList.addPreference(preference); } /* SPRD: add by spreadst @{ */ // set firstKey to be SelectedApnKey if (!hasKey) { firstPref.setChecked(); setSelectedApnKey(firstKey); } Log.d(TAG, "Final: firstKey = " + firstKey + " hasKey = " + hasKey + " firstPref = " + firstPref); Log.d(TAG,"apnList = " + apnList); /* @} */ } }
直接替换system/etc中的apn-config.xml。然后在APN Setting中点击Reset to default,这个动作会重新读取apn-config.xml并把数据重新写入数据库中。proxy是WAP网
关,亲测如果没写也可上网,但是apn不可写错,否则无法上网。
<apn carrier="中国联通 Wap 网络 (China Unicom)"
mcc="460"
mnc="01"
apn="uniwap"
proxy="10.0.0.172"
port="80"
/>
上面的Carrier是数据库表carriers中的name字段,这个字段只运用在APN Settings中的名字显示。而下拉状态栏和SIM卡管理中的名字显示则与SIM卡中携带的名字与SPN共同决定。参见以下SPN的说明,以下信息都是来自MTK的Mediatek On-Line,有条件的可以去看看。
SPN:
一:Background & 相关flow
MTK Operator name display在手机中分成两种类型:
1. Sim卡名称:
根据开机从SIM卡中读取的EF_SPN文件的内容(如果EF_SPN为空,则看EF_SPN_CPHS/EF_SPN_SHORT_CPHS)来设定,如果都为空,则设定默认名字CARD01/CARD02(L0上是SUB01/SUB02) ;然后会保存在SIMInfo这个database中,后续sim卡的名称就从此database中取得
(L之前的版本:
根据开机从SIM卡中读取的IMSI去到Spn-conf.xml中(如果是MVNO的卡则是Virtual-spn-conf-by-***.xml中)匹配得到的name来设定)
关于MVNO可以参考如下FAQ:
ID: FAQ09811
[NW]如何区分MNO和MVNO
使用场景:
Setting下SIM cards中SIM cards(L之前的版本:SimMangement中SIMInfo)等
2. 注册上的网络的名称:
这部分显示所用string的主要来源有如下这些,且他们之间最终显示哪个source的string是根据网络和这些source的内容所最终确定的rule决定的(如当前是否roaming,当前注册的plmn是否在EF_SPDI中,EF_SPN中有相关flag标识要不要显示spn…)
关于rule:
请参考Gsm sec 51.011 EF_SPN的部分还有cphs spec;
code的部分,请参考SIMRecords. getDisplayRule和GsmServiceStateTracker. updateSpnDisplay:
(1) Sim卡中文件,如EF_SPN, EF_OPN, EF_SOPN, EF_OPL, EF_PNN, EF_SPDI…
(2) 注册到的网络的plmn,对应Spn-conf.xml
(3) NITZ,即网络下发的名字
Spec 51.011中EF_SPN定义的rule 总结就是:
1. 名称分为 SPN 和 Registered plmn(包括EONS, CPHS (即ONS), S-CPHS, NITZ, PLMN;优先级依次降低)
2. 如果没有SPN文件,那么就显示Registered plmn
3. 若有SPN,注册的plmn是HPLMN或者注册的plmn在SIM卡文件EF_SPDI中,那么
(1) 如果有SPN就要显示SPN
(2) 如果SPN的bit1 = 1, 则需要同时显示Registered plmn,如果SPN的bit1=0,则不需要同时显示Registered plmn
4. 若有SPN,注册的plmn是Roaming plmn且注册的plmn也不在SIM卡文件EF_SPDI中,那么
(1) 显示Registered plmn
(2) 如果SPN的bit2=0,则需要同时显示SPN,如果SPN的bit2=1,则不需要同时显示SPN
上图中的PLMN的取值如下:
使用场景:
Keyguard,Notification list,...
其中客户可以客制化的部分是Spn-conf.xml/Virtual-spn-conf-by-***.xml;换句话说,如果你修改了相关xml没有生效,应该是按照spec显示了更高优先级的名字(EONS, CPHS, NITZ…)
如果按照spec显示了更高优先级的名字,而不是xml配置的,那么想要显示xml的名字必然要修改code flow而导致破坏spec定义的rule(由于这是spec定义的通用rule,所以SIM卡在实做时也需要follow spec rule)------这样的客制化很可能会导致CTA/FTA等测试fail,且遵循spec的SIM卡显示也会出问题;建议跟客户说明这部分是有spec规定的,不要进行除xml的客制化
二:遇到问题时的处理方式
如果有些Operator不follow GSM Spec,而定义自己的rule,请按照如下方式处理:
(1)如果operator有出正式spec,请提供详细的技术说明文档;
(2)把此卡在同一时间同一地点(确保网络状况相同)放到Samsung,HTC等对比机中复现问题,提供对比机表现
(3)将此卡放到MTK手机中复现问题并提供复现问题的开机mobile log