【笔记】KaiOS OTA APN 方案（OMADM）

2024-01-17 22:12
文章标签 笔记 方案 ota apn kaios omadm

本文主要是介绍【笔记】KaiOS OTA APN 方案（OMADM），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

一、【需求】功能逻辑

OMADM 机制根据节点信息修改对应的APN，因此代码也通过Node消息管控实现。

  1. _listenOpApnSettings
  2. opCheckIsInProgressAndSaveNodeValue
  3. saveAndUpdateApnValue
    1. this.operatorVariantHandlers[simslot.index].applySettings(mcc, mnc/*, false*/, apnEnabledStateChange)
  4. applySettings(mcc, mnc, updateAPN)
  5. applyOperatorVariantSettings(result)
  6. buildApnSettings(allApnList)
    1. 初始化APN数组 var apnSettings = [] 和tmpApnSettings
    2. 根据APN_TYPES.length长度遍历赋值tmpApnSettings，
    3. 再将数组拷贝给apnSettings 保存 apnSettings = this.convertApnSettings(tmpApnSettings); this.buildPreferredApnSettings(apnSettings);
  7. buildPreferredApnSettings(apnSettings) 
  8. navigator.b2g.engmodeManager.setDataProfileByType(JSON.stringify(apnSettings[index]), 1);

二、【设计】接口说明 

总体接口流程

InterfaceModuleComment
_listenOpApnSettings(simslot) operator_variant_manager.js
opCheckIsInProgressAndSaveNodeValue(node, value, simslot)operator_variant_manager.js
saveAndUpdateApnValue(node, value, simslot)operator_variant_manager.js
applySettings(mcc, mnc, updateAPN)operator_variant_handler.jsupdateAPN是OMADM对应的APN class 类型
applyOperatorVariantSettings(result)operator_variant_handler.js
buildApnSettings(allApnList)operator_variant_handler.js
buildPreferredApnSettings(apnSettings)operator_variant_handler.js此接口只会被调用一次，因此在manager里面循环传参updateAPN调用applySettings()执行卡的时候，不能下发全部类型的全部APN。（存疑）
setDataProfileByTypeEngmodeManager.jsm

Manager通过发消息触发服务执行：

1.Services.cpmm.sendAsyncMessage("Engmode:setDataProfileByType",

2.内部收到消息在receiveMessage(aMessage)匹配case 执行

case "Engmode:setDataProfileByType:Return":
    request = this.requestMsgHdl(msg);

3.

_setDataProfileByTypeEngmodeService.jsm

在 buildPreferredApnSettings定制的类型会触发dataprofile下发MD，在engmode中实现。

（一）System模块-运营商管理OperatorVariantHandler (gaia)

Manager中update创建OperatorVariantHelper，Handler start创建OperatorVariantHelper。

  • OperatorVariantHandler
    • 在operator_variant_manager.js创建，在operator_variant_handler.js实现自身功能逻辑。
    • OperatorVariantHandler 是一个管理运营商变体的对象，用于存储和处理与运营商变体相关的信息。
  • OperatorVariantHelper
    • 在OperatorVariantHandler  start 时new OperatorVariantHelper，创建对象并使用helper进行mccmnc的变化监听
    • this._operatorVariantHelper.listen();

代码路径

  • gaia/apps/system/js/operator_variant_handler.js 具体APN数据处理者
  • gaia/apps/system/js/operator_variant_manager.js 运营商初始化管理
  • gaia/apps/system/js/operator_variant_handler.js 处理加载和应用不同的运营商信息

operator_variant_manager.js 
Manager的代码结构说明
(function() {var OperatorVariantManager = function(core) {/** Array of OperatorVariantHandler objects. */if (core) {this.mobileConnections = core.mobileConnections;}this.operatorVariantHandlers = [];};OperatorVariantManager.IMPORTS = ['js/operator_variant_handler.js'];//定义事件，在BaseModule监听到时执行对应逻辑OperatorVariantManager.EVENTS = ['simslot-updated','simslot-iccinfochange','logohidden'];BaseModule.create(OperatorVariantManager, {});//具体功能实现
})();

1、在 KaiOS 的 JavaScript 中，BaseModule 是一个基础模块，用于封装应用程序中的通用功能，例如管理应用程序状态、处理事件、创建通用UI等。BaseModule.create() 是一个用于创建模块实例的静态方法，第一个参数为模块构造函数，第二个参数为模块的配置对象，用于指定模块的名称、版本、依赖关系等信息。

2、logohidden 是一个自定义的事件名称（在OperatorVariantManager.EVENTS定义），用于在 KaiOS 中指示系统已经完成启动过程并准备好显示应用程序。当系统启动时，会显示 KaiOS 的 Logo，一旦logohidden！=null，就会触发 logohidden 事件，表明系统已经启动完毕并准备好显示应用程序。

（1）在下面init代码片段中，注册 logohidden 事件的监听器，在事件触发时调用 updateSavedIccIds() 方法，该方法用于更新保存的 ICCID 列表。这个事件监听器只会在 logohidden 后执行一次，因为 { once: true } 参数指定了事件只会触发一次，确保 updateSavedIccIds() 方法不会被重复调用。

（2）_handle_logohidden 方法是一个事件监听器，它会在 logohidden 事件触发时被调用。在这个方法中，会遍历所有的移动连接对象，并检查是否有对应的 operatorVariantHandlers 对象。如果没有，就将该对象的值设置为 null。

- 正常日志参考：

01-17 10:47:30.019 690 690 I GeckoDump: operator_variant_manager gid =544d
01-17 10:47:30.019 690 690 I GeckoDump: operator_variant_manager simslot.index = 0
01-17 10:47:34.093 690 690 I GeckoDump: _handle_logohidden operatorVariantHandlers[0] : [object Object]

- 异常情况：（在下方案例根据代码详细说明）

01-17 10:44:05.244 712 712 I GeckoDump: operator_variant_manager gid  = null

01-17 10:44:05.245 712 712 I GeckoDump: operator_variant_manager persist gid =[object Promise]

01-17 10:44:49.532 712 712 I GeckoDump: _handle_logohidden  operatorVariantHandlers[0] set to value null // logohidden 发现未初始化，设为'null'

PIN解锁后，不再更新operatorVariantHandlers

01-17 10:44:54.232 712 712 I GeckoDump: operator_variant_manager gid =544d
01-17 10:44:54.232 712 712 I GeckoDump: operatorVariantHandlers[0] : null

  BaseModule.create(OperatorVariantManager, {name: 'OperatorVariantManager',_start: function() {},_stop: function() {},//监听到simslot-updated事件，会更新OperatorVariantHandler'_handle_simslot-updated': function(evt) {var simslot = evt.detail;this._updateOperatorVariantHandler(simslot);},//监听到logohidden事件。会影响APN的加载，如operatorVariantHandlers[index]被初始化成null。'_handle_logohidden': function() {navigator.b2g.mobileConnections.forEach((conn, index) => {if (!this.operatorVariantHandlers[index]) {//如果指定SIM 卡槽还没有准备好，就需要将对应的 operatorVariantHandlers 对象的值设置为 nulldump('_handle_logohidden operatorVariantHandlers[' + index + '] set to value null ')this.operatorVariantHandlers[index] = 'null';}});},//监听到simslot-iccinfochange事件时执行。'_handle_simslot-iccinfochange': function(evt) {var simslot = evt.detail;this._updateOperatorVariantHandler(simslot);},//在SIM状态变化的时候会执行，如果存在客制化return了可能会导致operatorVariantHandlers=nnull因此出现APN加载中断问题。//【关键逻辑】this.operatorVariantHandlers[simslot.index]只会在这里赋值_updateOperatorVariantHandler: function(simslot) {if (!this._isVariantReady(simslot)) {return;}if (!this.operatorVariantHandlers[simslot.index]) {this.operatorVariantHandlers[simslot.index] =new OperatorVariantHandler(simslot.simCard.iccInfo.iccid,simslot.index, this);this.operatorVariantHandlers[simslot.index].start();}},//SIM卡槽状态_isVariantReady: function(simslot) {//sim不存在 || SIM没有iccInfo || SIM iccInfo没有iccid = SIM 没有readyif (!simslot.simCard ||!simslot.simCard.iccInfo ||!simslot.simCard.iccInfo.iccid) {if (this.operatorVariantHandlers[simslot.index]) {this.operatorVariantHandlers[simslot.index] = 'removed';} else {this.operatorVariantHandlers[simslot.index] = null;}return false;} else if (!this.deviceInfoOs) {return false;}return true;},updateSavedIccIds: function() {},//初始化，会调用_updateOperatorVariantHandler，并监听logohidden和拔卡//OperatorVariantManager 对象被创建时被调用，用于初始化该对象并注册必要的事件监听器init: function() {if (this.deviceInfoOs) {SettingsObserver.unobserve('deviceinfo.os', this.updateDeviceInfoOs);SIMSlotManager.getSlots().forEach(function(slot) {this._updateOperatorVariantHandler(slot);}, this);}window.addEventListener('logohidden', () => {this.updateSavedIccIds();}, { once: true });  //只执行一次window.addEventListener('simslot-removed', () => {this.updateSavedIccIds();});},updateDeviceInfoOs: function(value) {},nsureValueUnderKeyIsArray: function(key) {}});

正常逻辑：

  1. new OperatorVariantHandler =>
  2. OperatorVariantHandler start() =>
  3. 监听'cardstatechange' & 'iccinfochange' =>
  4. 收到以上事件且 cardstate 是 'ready' 时，匹配APN。
异常代码案例 

如果在 _updateOperatorVariantHandler 中添加GID等参数校验的时候考虑不全，实现代码时 return，则在插入有PIN码的卡时，可能会导致SIM卡相应index的operatorVariantHandlers一直为null，不会进行APN加载。

iccManager及其内gid判断代码return造成 logohidden 监听发现未初始化，设为'null。因为KaiOS逻辑，PIN lock情况下只能得到iccid， 得不到mcc/mnc/gid等信息。

  • PIN lock 时 gid1=null
  • SIM ready 时默认 'ff'

解决方案：

  1. 删除GID=null 时直接return 的逻辑，即gid1=null不return，可正常初始化。
  2. 新开发PIN unlock后的逻辑，重新触发初始化APN，执行加载。
    _updateOperatorVariantHandler: function(simslot) {if (!this._isVariantReady(simslot)) {return;}//非kaios原生存在缺陷的代码片段var iccManager = navigator.b2g.iccManager;if (iccManager) {var icc = iccManager.getIccById(simslot.simCard.iccInfo.iccid);if (icc) {var iccInfo = icc.iccInfo;if (iccInfo) {var gid = iccInfo.gid1;dump('operator_variant_manager: gid = ' + gid);if (gid === undefined || gid === null || gid === '') {//从persist.gsm.sim.gid获取，此值不用手动写入，根据卡。var gid1 = navigator.b2g.engmodeManager.getPropertyValue("persist.gsm.sim.gid");dump('operator_variant_manager: persist gid1 = ' + gid1);return;  //若PIN lock会直接return导致OperatorVariantHandler一直为null。}//gid}//iccInfo}//icc}//iccManager//最终卡状态ready后，唯一正常初始化operatorVariantHandlers的地方if (!this.operatorVariantHandlers[simslot.index]) {this.operatorVariantHandlers[simslot.index] =new OperatorVariantHandler(simslot.simCard.iccInfo.iccid,simslot.index, this);this.operatorVariantHandlers[simslot.index].start();}}//updateOperatorVariantHandler 私有方法

（二）APN 模块

operatorVariantHandlers正常加载后，根据卡匹配apn.json的APN 配置，

1、从配置加载到系统数据库：apn.json→ril.data.apnSettings.sim

  1. start()->
  2. getDMApnProtocol()->
  3. ObserveDMApnSettings()->
  4. combineApn(apnSettings, key)->
  5. this.cloneApn(apn)

2、从数据库到业务使用：ril.data.apnSettings.sim→DataCall

  1. observeSetting(aSettingInfo)
  2. ->this.handleSettingChanged(name, result);
  3. ->this.handleApnSettingChanged(clientId, resultApnObj)
  4. ->handler.updateApnSettings(aApnList);

（三）Engmode 模块(gecko)

  • gecko/koost/engmode/EngmodeService.jsm

在engmode实现同步APN到MD的接口，定义上层和底层APN Type的映射关系，用于同步dataProfile到Modem。

js/moduleInterfaceComment
EngmodeManager.jsmsetDataProfileByType(strApnSetting, type)管理通过消息调起服务。
EngmodeService.jsm_setDataProfileByType(networkType, profileId, apn, protocol, roamingProtocol, authType, user, password, type, maxConnsTime, maxConns, waitTime, enabled, inactivityTimer, callback) 定义服务

三、【开发】调试 Debug

源码编译到软件分区路径的说明，在设备中可以查看编译产物，使用adb pull/push 调试，webapps对应应用内的application.zip 和系统omini.ja  都是压缩包的形式。

Note：若编译调试，单编应用的产物路径在 gaia\profile\webapps\settings（应用名）

相关文件adb 设备路径代码模块路径

operator_variant_manager.js

operator_variant_handler.js

system/b2g/webapps/system/gaia\apps\system
DatacallManager.jsmsystem/b2g/omni.jagecko/dom/system/gonk/radio
EngmodeService.jsm
EngmodeManager.jsm		system/b2g/omni.jagecko/koost/engmode

四、业务知识

SIM

在KaiOS中，是operator_variant_handler.js文件管理着OperatorVariantHandler对象中运营商的信息，包括初始化和切换卡变更。

iccid

mcc

mnc

OMADM 

OMA-DM（Open Mobile Alliance Device Management）是一种用于远程管理移动设备的协议，通过OMA-DM协议，运营商可以向设备推送各种配置、更新、命令等。

在OMA-DM协议中，消息体是指通过协议传输的消息数据。

在OMA-DM协议中，更新APN配置时，需要通过指定一个APN配置模板来实现。

一般通过服务器推送消息到设备，用户终端收到后根据信息修改对应的APN。有的运营商通过class匹配不同类型的APN，而上层修改APN后也需要同步到MD，同样需要建立映射关系。

举例如下：

APN TypeAP classMD profile_IdComment/eg
ims15const NETWORK_TYPE_MOBILE_IMS = 5;
fota27const NETWORK_TYPE_MOBILE_FOTA = 7;
default30const NETWORK_TYPE_MOBILE = 1;
mms42const NETWORK_TYPE_MOBILE_MMS = 2;
  • MD ProfileId 可以自定义的，AP  Class应该运营商有要求。
  • apn.json中配置"profile_id"字段

这篇关于【笔记】KaiOS OTA APN 方案（OMADM）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/617367。

相关文章

无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

墙体画线地图切分方案 针对问题：墙体两侧特征混淆误匹配，导致建图和定位偏差，表现为过门跳变、外月台走歪等 ·解决思路：预期的根治方案IGICP需要较长时间完成上线，先使用切分地图的工程化方案，即墙体两侧切分为不同地图，在某一侧只使用该侧地图进行定位 方案思路 切分原理：切分地图基于关键帧位置，而非点云。 理论基础：光照是直线的，一帧点云必定只能照射到墙的一侧，无法同时照到两侧实践考虑：关
阅读更多...
高效+灵活，万博智云全球发布AWS无代理跨云容灾方案！

高效+灵活，万博智云全球发布AWS无代理跨云容灾方案！

摘要 近日，万博智云推出了基于AWS的无代理跨云容灾解决方案，并与拉丁美洲，中东，亚洲的合作伙伴面向全球开展了联合发布。这一方案以AWS应用环境为基础，将HyperBDR平台的高效、灵活和成本效益优势与无代理功能相结合，为全球企业带来实现了更便捷、经济的数据保护。 一、全球联合发布 9月2日，万博智云CEO Michael Wong在线上平台发布AWS无代理跨云容灾解决方案的阐述视频，介绍了
阅读更多...
Android平台播放RTSP流的几种方案探究（VLC VS ExoPlayer VS SmartPlayer）

Android平台播放RTSP流的几种方案探究（VLC VS ExoPlayer VS SmartPlayer）

技术背景 好多开发者需要遴选Android平台RTSP直播播放器的时候，不知道如何选的好，本文针对常用的方案，做个大概的说明： 1. 使用VLC for Android VLC Media Player（VLC多媒体播放器），最初命名为VideoLAN客户端，是VideoLAN品牌产品，是VideoLAN计划的多媒体播放器。它支持众多音频与视频解码器及文件格式，并支持DVD影音光盘，VCD影
阅读更多...
【学习笔记】 陈强-机器学习-Python-Ch15 人工神经网络（1）sklearn

【学习笔记】 陈强-机器学习-Python-Ch15 人工神经网络（1）sklearn

系列文章目录 监督学习：参数方法 【学习笔记】 陈强-机器学习-Python-Ch4 线性回归 【学习笔记】 陈强-机器学习-Python-Ch5 逻辑回归 【课后题练习】 陈强-机器学习-Python-Ch5 逻辑回归（SAheart.csv） 【学习笔记】 陈强-机器学习-Python-Ch6 多项逻辑回归 【学习笔记 及 课后题练习】 陈强-机器学习-Python-Ch7 判别分析 【学
阅读更多...
系统架构师考试学习笔记第三篇——架构设计高级知识（20）通信系统架构设计理论与实践

系统架构师考试学习笔记第三篇——架构设计高级知识（20）通信系统架构设计理论与实践

本章知识考点：         第20课时主要学习通信系统架构设计的理论和工作中的实践。根据新版考试大纲,本课时知识点会涉及案例分析题(25分),而在历年考试中,案例题对该部分内容的考查并不多,虽在综合知识选择题目中经常考查,但分值也不高。本课时内容侧重于对知识点的记忆和理解,按照以往的出题规律,通信系统架构设计基础知识点多来源于教材内的基础网络设备、网络架构和教材外最新时事热点技术。本课时知识
阅读更多...
JavaFX应用更新检测功能（在线自动更新方案）

JavaFX应用更新检测功能（在线自动更新方案）

JavaFX开发的桌面应用属于C端，一般来说需要版本检测和自动更新功能，这里记录一下一种版本检测和自动更新的方法。 1. 整体方案 JavaFX.应用版本检测、自动更新主要涉及一下步骤： 读取本地应用版本拉取远程版本并比较两个版本如果需要升级，那么拉取更新历史弹出升级控制窗口用户选择升级时，拉取升级包解压，重启应用用户选择忽略时，本地版本标志为忽略版本用户选择取消时，隐藏升级控制窗口 2.
阅读更多...
如何选择SDR无线图传方案

如何选择SDR无线图传方案

在开源软件定义无线电（SDR）领域，有几个项目提供了无线图传的解决方案。以下是一些开源SDR无线图传方案： 1. **OpenHD**：这是一个远程高清数字图像传输的开源解决方案，它使用SDR技术来实现高清视频的无线传输。OpenHD项目提供了一个完整的工具链，包括发射器和接收器的硬件设计以及相应的软件。 2. **USRP（Universal Software Radio Periphera
阅读更多...
论文阅读笔记: Segment Anything

论文阅读笔记: Segment Anything

文章目录 Segment Anything摘要引言任务模型数据引擎数据集负责任的人工智能 Segment Anything Model图像编码器提示编码器mask解码器解决歧义损失和训练 Segment Anything 论文地址: https://arxiv.org/abs/2304.02643 代码地址:https://github.com/facebookresear
阅读更多...
数学建模笔记—— 非线性规划

数学建模笔记—— 非线性规划

数学建模笔记—— 非线性规划 非线性规划1. 模型原理1.1 非线性规划的标准型1.2 非线性规划求解的Matlab函数 2. 典型例题3. matlab代码求解3.1 例1 一个简单示例3.2 例2 选址问题1. 第一问 线性规划2. 第二问 非线性规划 非线性规划 非线性规划是一种求解目标函数或约束条件中有一个或几个非线性函数的最优化问题的方法。运筹学的一个重要分支。2
阅读更多...
【C++学习笔记 20】C++中的智能指针

【C++学习笔记 20】C++中的智能指针

智能指针的功能 在上一篇笔记提到了在栈和堆上创建变量的区别，使用new关键字创建变量时，需要搭配delete关键字销毁变量。而智能指针的作用就是调用new分配内存时，不必自己去调用delete，甚至不用调用new。 智能指针实际上就是对原始指针的包装。 unique_ptr 最简单的智能指针，是一种作用域指针，意思是当指针超出该作用域时，会自动调用delete。它名为unique的原因是这个
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2