harmony 鸿蒙电话服务开发指导

  • 2022-08-09
  • 浏览 (729)

电话服务开发指导

Modem厂商库初始化开发指导

场景介绍

Modem厂商库初始化是指在厂商库里实现const HRilOps *RilInitOps(const struct HRilReport *reportOps)函数,在该函数里处理三个重要的功能:

  • 接收RIL Adapter事件回调的函数指针,当Modem有业务事件上报时,调用对应的函数指针,把事件上报给RIL Adapter。

  • 创建读取Modem设备节点的线程,在该线程里会循环地读取Modem上报的事件,并把接收的Modem信息解析为具体业务相关的事件进行上报。

  • 返回业务请求接口的函数指针给RIL Adapter。

接口说明

Modem厂商库初始化接口。

表1 Modem厂商库初始化接口功能介绍

接口名 描述
const HRilOps *RilInitOps(const struct HRilReport * reportOps) 接口功能:Modem厂商库运行的入口。
参数reportOps:RIL Adapter传入的事件回调函数指针。
返回值:业务请求接口的函数指针。

开发步骤

  1. RilInitOps接口中设置RIL Adapter传入的事件回调函数指针。
   // 定义Modem厂商库回调函数指针
   static struct HRilReport g_reportOps = {
       OnCallReport,    // 通话相关业务回调函数
       OnDataReport,    // 蜂窝数据相关业务回调函数
       OnModemReport,   // Modem相关业务回调函数
       OnNetworkReport, // 搜网相关业务回调函数
       OnSimReport,     // SIM卡相关业务回调函数
       OnSmsReport      // 短信相关业务回调函数
   };
  1. 创建主线程g_reader,开启消息循环。
   pthread_attr_t t;
   pthread_attr_init(&t);
   pthread_attr_setdetachstate(&t, PTHREAD_CREATE_DETACHED);
   ret = pthread_create(&g_reader, &t, ReaderLoop, &t); // 创建线程
  1. 在g_eventListeners线程用open()打开Modem设备节点,并创建g_reader线程循环读取处理Modem上报的消息。
   g_fd = open(g_devicePath, O_RDWR); // 打开设备节点,入参g_devicePath是Modem设备节点
   pthread_attr_init(&attr);   
   pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);   
   ret = pthread_create(&g_eventListeners, &attr, EventListeners, NULL);
  1. 返回业务请求接口的函数指针。
   // call模块业务请求接口结构体
   typedef struct {
       // 获取呼叫列表
       void (*GetCallList)(ReqDataInfo *requestInfo, const void *data, size_t dataLen);
       // 拨打电话
       void (*Dial)(ReqDataInfo *requestInfo, const void *data, size_t dataLen);
       // 挂断电话
       void (*Hangup)(ReqDataInfo *requestInfo, const void *data, size_t dataLen);
       // 拒接来电
       void (*Reject)(ReqDataInfo *requestInfo, const void *data, size_t dataLen);
       // 接听来电
       void (*Answer)(ReqDataInfo *requestInfo, const void *data, size_t dataLen);
   } HRilCallReq;
   
   // call模块回调函数指针
   static const HRilCallReq g_callReqOps = { 
       .GetCallList = ReqGetCallList, // 获取呼叫列表接口
       .Dial = ReqDial,               // 拨打电话接口
       .Hangup = ReqHangup,           // 挂断电话接口
       .Reject = ReqReject,           // 拒接来电接口
       .Answer = ReqAnswer,           // 接听来电接口
   };
   
   // 业务请求结构体
   typedef struct { 
       const HRilCallReq *callOps;       // 通话相关业务请求结构体指针
       const HRilSimReq *simOps;         // SIM卡相关业务请求结构体指针
       const HRilSmsReq *smsOps;         // 短彩信相关业务请求结构体指针
       const HRilDataReq *dataOps;       // 蜂窝数据相关业务请求结构体指针
       const HRilNetworkReq *networkOps; // 搜网相关业务请求结构体指针
       const HRilModemReq *modemOps;     // Modem相关业务请求结构体指针
   } HRilOps;  
     
   // 业务请求接口定义
   HRilOps g_hrilOps = {
       .callOps = &g_callReqOps,       // 定义通话业务请求接口
       .simOps = &g_simReqOps,         // 定义SIM卡业务请求接口
       .smsOps = &g_smsReqOps,         // 定义短彩信业务请求接口
       .networkOps = &g_networkReqOps, // 定义蜂窝数据业务请求接口
       .dataOps = &g_dataReqOps,       // 定义搜网业务请求接口
       .modemOps = &g_modemReqOps,     // 定义Modem业务请求接口
   };

调测验证

  1. hdc_std工具连接调试设备,把编译生成的libril_vendor.z.so库文件(参见Modem厂商库集成指导)通过以下命令推到/system/lib/目录下。
   hdc_std file send libril_vendor.z.so /system/lib/
  1. 执行hdc_std shell sync,hdc_std shell reboot重启设备。
   hdc_std shell sync
   hdc_std shell reboot
  1. 执行hdc_std shell hilog,根据日志查看函数RilInitOps()是否正确执行完成。如下调测验证日志供参考:
   09-02 07:40:47.807   455   455 I 01f08/HrilHdf: [LoadVendor-(hril_hdf.c:148)] RilInit LoadVendor start with rilLibPath:libril_vendor.z.so
   09-02 07:40:47.830   455   455 I 01f08/HrilHdf: [LoadVendor-(hril_hdf.c:163)] HRilRegOps completed

Modem业务请求及响应开发指导

场景介绍

Modem业务请求及响应是指RIL Adapter收到电话服务具体业务请求后,调用Modem厂商库初始化获得的函数指针,把具体业务请求发送给厂商库,厂商库根据业务请求ID做相应的业务处理。

接口说明

Modem业务请求及响应接口。

表2 Modem业务请求及响应接口功能介绍(以拨号功能模块为例)

接口名 描述
void ReqDial(ReqDataInfo *requestInfo, const void *data, size_t dataLen); 接口功能:对拨号请求进行处理。
参数requestInfo:请求类型信息。
参数data:被叫号码信息。
参数dataLen:数据长度。
返回值:无。
void (*OnCallReport)(struct ReportInfo reportInfo, const void *data, size_t dataLen); 接口功能:对通话业务执行结果进行响应,即当请求业务执行完成后,Modem将该请求执行的结果上报给RIL Adapter。
参数reportInfo:返回类型信息。
参数data:返回数据。
参数dataLen:数据长度。
返回值:无。

开发步骤

  1. 在ReqDial()接口中对拨号请求进行处理。
   // 拨号请求接口实现
   void ReqDial(ReqDataInfo *requestInfo, const void *data, size_t dataLen)
   {
       HRilDial *pDial = NULL;
       char cmd[MAX_BUFF_SIZE] = {0};
       const char *clir = NULL;
       int ret;
       int err = HRIL_ERR_SUCCESS;
       struct ReportInfo reportInfo = {};
       ResponseInfo *pResponse = NULL;
       if (data == NULL) {
           TELEPHONY_LOGE("data is null!!!");
           err = HRIL_ERR_INVALID_PARAMETER;
           reportInfo = CreateReportInfo(requestInfo, err, HRIL_RESPONSE, 0);
           OnCallReport(reportInfo, NULL, 0);
           return;
       }
       pDial = (HRilDial *)data;
       switch (pDial->clir) {
           case CALL_CLIR_INVOCATION:
               clir = "I";
               break; /* invocation */
           case CALL_CLIR_SUPPRESSION:
               clir = "i";
               break; /* suppression */
           case CALL_CLIR_SUBSCRIPTION_DEFUALT:
           default:
               clir = "";
               break; /* subscription default */
       }
       (void)sprintf_s(cmd, MAX_BUFF_SIZE, "ATD%s%s;", pDial->address, clir);
       ret = SendCommandLock(cmd, NULL, 0, &pResponse); // 发送AT指令
       ......
   }
  1. 在Modem执行完拨号命令后,调用OnCallReport()回调函数,把该请求执行的结果上报给RIL Adapter。
   ret = SendCommandLock(cmd, NULL, 0, &pResponse);
   if (ret != 0||(pResponse != NULL && pResponse->success == 0)) {
       TELEPHONY_LOGE("ATD send failed");
       err = HRIL_ERR_GENERIC_FAILURE;
   }
   reportInfo = CreateReportInfo(requestInfo, err, HRIL_RESPONSE, 0);
   OnCallReport(reportInfo, NULL, 0); // 调用通话相关回调函数

调测验证

  1. hdc_std工具工具连接调试设备,把编译生成的libril_vendor.z.so库文件通过以下命令推到/system/lib/目录下。
   hdc_std file send libril_vendor.z.so /system/lib/
  1. 执行hdc_std shell sync,hdc_std shell reboot重启设备。
   hdc_std shell sync
   hdc_std shell reboot
  1. hdc_std shell后执行./system/bin/ril_adapter_test,输入编号1,根据提示输入电话号码,测试拨打电话功能。
   hdc_std shell
   # ./system/bin/ril_adapter_test
   ----> Test Enter  --------->Call---------------------
    
   1----> RilUnitTest::OnRequestCallDialTest
   2----> RilUnitTest:: OnRequestCallHangupTest
   3----> RilUnitTest:: OnRequestCallAnswerTest
   4----> RilUnitTest::OnRequestCallGetCurrentCallsStatusTest
   5----> RilUnitTest::OnRequestRefusedCallTest
      
   1
  1. 另开一个终端窗口,执行hdc_std shell hilog,通过日志查看函数ReqDial()是否正确执行完成。如下调测验证日志供参考:
   09-02 07:55:09.073   455  2059 I 01f08/RilVendor: [SendCommandLock-(at_support.c:226)] command ATD18675231804;, NeedATPause:0, atCmd:AT
   09-02 07:55:09.099   455  2053 I 01f08/Rilvendor: [ProcessResponse-(at_support.c:159)] processLine line = OK
   09-02 07:55:09.100   455  2053 E 01f08/RilVendor: [ReportStrWith-(vendor_util.c:63)] str or prefix parameter is null.
   09-02 07:55:09.100   455  2053 E 01f08/RilVendor: [ProcessLastResponse-(vendor_channel.c:77)] g_bufferCur endLine is null
   09-02 07:55:09.100   455  2059 I 01f08/RilVendor: [SendCommandLock-(at_support.c:243)] err = 0
   09-02 07:55:09.100   455  2053 I 01f08/RilVendor: [ProcessResponse-(at_support.c:159)] processLine line = ^ORIG:1,0

Modem事件上报开发指导

场景介绍

Modem事件上报是指在厂商库的Modem设备节点读取线程,循环读取到Modem主动上报的消息后,对Modem上报事件进行解析,然后上报给RIL Adapter。

接口说明

Modem事件上报接口。

表3 Modem事件上报接口功能介绍

接口名 描述
void OnNotifyOps(const char *s, const char *smsPdu) 接口功能:对Modem上报的事件进行分发处理。
参数s:AT指令前缀。
参数smsPdu:短信PDU信息。
返回值:无。

开发步骤

  1. 在Modem设备节点读取线程g_reader里调用OnNotifyOps()解析具体的Modem上报事件,判断命令类型,并调用OnXxxReport()把解析得到的各模块事件上报给hril业务层。
   // 将Modem上报数据解析为对应模块的主动上报事件
   void OnNotifyOps(const char *s, const char *smsPdu)
   {
       int ret = 0;
       struct ReportInfo reportInfo = {0};
       reportInfo.error = HRIL_ERR_SUCCESS;
       reportInfo.type = HRIL_NOTIFICATION;
       if (GetRadioState() == HRIL_RADIO_POWER_STATE_UNAVAILABLE) {
           return;
       }
       TELEPHONY_LOGD("enter to [%{public}s]:%{public}s", s, smsPdu);
       // 通过AT指令判断主动上报命令类型
       if (ReportStrWith(s, "+CRING:")||ReportStrWith(s, "RING")||ReportStrWith(s, "IRING")||
           ReportStrWith(s, "NO CARRIER")||ReportStrWith(s, "+CCWA")||ReportStrWith(s, "^CCALLSTATE")||
           ReportStrWith(s, "^CEND")||ReportStrWith(s, "^CCWA")) {
           reportInfo.notifyId = HNOTI_CALL_STATE_UPDATED;
           OnCallReport(reportInfo, NULL, 0);
       } else if (ReportStrWith(s, "+CMT:")) {
           reportInfo.notifyId = HNOTI_SMS_NEW_SMS;
           OnSmsReport(reportInfo, (void *)smsPdu, strlen(smsPdu));
       }
       // 将各模块事件上报给hril业务层
       ......
   }
  1. hril业务层将上报事件分发给Telephony Service。
   // 呼叫状态主动上报
   int32_t HRilCall::CallStateUpdated(
       int32_t slotId, int32_t notifyType, const HRilErrno e, const void *response, size_t responseLen)
   {
       struct HdfSBuf *dataSbuf = HdfSBufTypedObtain(SBUF_IPC);
       if (serviceCallbackNotify_ == nullptr) {
           TELEPHONY_LOGE("RilAdapter serviceCallbackNotify_ is null");
           HdfSBufRecycle(dataSbuf);
           return HDF_FAILURE;
       }
       // 分发处理
       int32_t ret = serviceCallbackNotify_->dispatcher->Dispatch(
           serviceCallbackNotify_, HNOTI_CALL_STATE_UPDATED, dataSbuf, nullptr);
       if (ret != HDF_SUCCESS) {
           HdfSBufRecycle(dataSbuf);
           return HDF_FAILURE;
       }
       HdfSBufRecycle(dataSbuf);
       return HDF_SUCCESS;
   }

调测验证

  1. hdc_std工具工具连接调试设备,把编译生成的libril_vendor.z.so库文件通过以下命令推到/system/lib/目录下。
   hdc_std file send libril_vendor.z.so /system/lib/
  1. 执行hdc_std shell sync,hdc_std shell reboot重启设备。
   hdc_std shell sync
   hdc_std shell reboot
  1. hdc_std shell后执行./system/bin/ril_adapter_test,输入编号1,根据提示输入电话号码,测试拨打电话功能。
   hdc_std shell
   # ./system/bin/ril_adapter_test
   ----> Test Enter  --------->Call---------------------
    
   1----> RilUnitTest::OnRequestCallDialTest
   2----> RilUnitTest:: OnRequestCallHangupTest
   3----> RilUnitTest:: OnRequestCallAnswerTest
   4----> RilUnitTest::OnRequestCallGetCurrentCallsStatusTest
   5----> RilUnitTest::OnRequestRefusedCallTest
      
   1
  1. 另开一个终端窗口,执行hdc_std shell hilog,通过日志查看函数OnNotifyOps()是否正确执行完成。如下调测验证日志供参考:
   01-01 00:08:01.334   546   551 D 02b01/TelRilTest: [DialResponse-(tel_ril_call.cpp:280)] DialResponse --> radioResponseInfo->serial:2, radioResponseInfo->error:0
   01-01 00:08:01.334   546   557 D 02b01/TelRilTest: [ProcessEvent-(tel_ril_test.cpp:1262)] TelRilTest::DemoHandler::ProcessEvent --> eventId:101
   01-01 00:08:01.334   143   512 D 02b01/Rilvendor: [ReadResponse-(channel.c:93)] g_bufferCur : 
   01-01 00:08:01.334   143   512 D 02b01/Rilvendor: ^ORIG:1,0
   01-01 00:08:01.334   143   512 D 02b01/Rilvendor: [ReadResponse-(channel.c:108)] AT< ^ORIG:1,0
   01-01 00:08:01.334   143   512 D 02b01/Rilvendor: [ProcessResponse-(at_support.c:137)] processLine line = ^ORIG:1,0
   01-01 00:08:01.334   143   512 D 02b01/Rilvendor: [OnNotifyOps-(vendor_report.c:126)] enter to [^ORIG:1,0]:(null)
   01-01 00:08:01.335   143   512 W 02b01/Rilvendor: [OnNotifyOps-(vendor_report.c:167)] enter to  is unrecognized command: ^ORIG:1,0
   01-01 00:08:01.335   143   512 D 02b01/Rilvendor: [ProcessLastResponse-(channel.c:37)] last data more than one line , FindEndOfLine  g_bufferCur: 
   01-01 00:08:01.335   143   512 E 02b01/Rilvendor: [ProcessLastResponse-(channel.c:39)] g_bufferCur endLine is null
   01-01 00:08:01.336   143   512 D 02b01/Rilvendor: [ReadResponse-(channel.c:93)] g_bufferCur : 
   01-01 00:08:01.336   143   512 D 02b01/Rilvendor: ^CCALLSTATE: 1,0,1
   01-01 00:08:01.336   143   512 D 02b01/Rilvendor: [ReadResponse-(channel.c:108)] AT< ^CCALLSTATE: 1,0,1
   01-01 00:08:01.336   143   512 D 02b01/Rilvendor: [ProcessResponse-(at_support.c:137)] processLine line = ^CCALLSTATE: 1,0,1
   01-01 00:08:01.336   143   512 D 02b01/Rilvendor: [OnNotifyOps-(vendor_report.c:126)] enter to [^CCALLSTATE: 1,0,1]:(null)
   01-01 00:08:01.336   546   551 D 02b01/CoreService: [OnRemoteRequest-(tel_ril_manager.cpp:80)] RilManager OnRemoteRequest code:1001
   01-01 00:08:01.336   546   551 D 02b01/CoreService: [NotifyObserver-(observer_handler.cpp:76)] handler->SendEvent:8

开发实例

  • 去电开发实例 去电的调用流程示例如下图所示: 图1 去电调用时序图

zh-cn_image_0000001171507146

当应用触发去电动作时,RIL Adapter会接收到拨打电话的请求,hril调用对应的拨打电话的接口ReqDial()。在该接口里会把电话服务传过来的数据封装为对应的AT指令发送到Modem,Modem执行完拨号命令后通过OnCallReport()接口把响应结果上报给RIL Adapter。
  // call模块回调函数指针
  static const HRilCallReq g_callReqOps = { 
      .GetCallList = ReqGetCallList, // 获取呼叫列表接口
      .Dial = ReqDial,               // 拨打电话接口
      .Hangup = ReqHangup,           // 挂断电话接口
      .Reject = ReqReject,           // 拒接来电接口
      .Answer = ReqAnswer,           // 接听来电接口
  }; 
  
  // 系统业务请求接口定义
  HRilOps g_hrilOps = {
      .callOps = &g_callReqOps,       // 定义通话业务请求接口
      .simOps = &g_simReqOps,         // 定义SIM卡业务请求接口
      .smsOps = &g_smsReqOps,         // 定义短彩信业务请求接口
      .networkOps = &g_networkReqOps, // 定义蜂窝数据业务请求接口
      .dataOps = &g_dataReqOps,       // 定义搜网业务请求接口
      .modemOps = &g_modemReqOps,     // 定义Modem业务请求接口
  };
  
  // 拨号请求接口实现
  void ReqDial(ReqDataInfo *requestInfo, const void *data, size_t dataLen)
  {
      HRilDial *pDial = NULL;
      char cmd[MAX_BUFF_SIZE] = {0};
      const char *clir = NULL;
      int ret;
      int err = HRIL_ERR_SUCCESS;
      struct ReportInfo reportInfo = {};
      ResponseInfo *pResponse = NULL;
      if (data == NULL) {
          TELEPHONY_LOGE("data is null!!!");
          err = HRIL_ERR_INVALID_PARAMETER;
          reportInfo = CreateReportInfo(requestInfo, err, HRIL_RESPONSE, 0);
          OnCallReport(reportInfo, NULL, 0);
          return;
      }
      pDial = (HRilDial *)data;
      switch (pDial->clir) {
          case CALL_CLIR_INVOCATION:
              clir = "I";
              break; /* invocation */
          case CALL_CLIR_SUPPRESSION:
              clir = "i";
              break; /* suppression */
          case CALL_CLIR_SUBSCRIPTION_DEFUALT:
          default:
              clir = "";
              break; /* subscription default */
      }
      (void)sprintf_s(cmd, MAX_BUFF_SIZE, "ATD%s%s;", pDial->address, clir);
      ret = SendCommandLock(cmd, NULL, 0, &pResponse); // 发送AT命令
      if (ret != 0) {
          err = HRIL_ERR_CMD_SEND_FAILURE;
          TELEPHONY_LOGE("ATD send failed");
      } else {
          if (pResponse != NULL && pResponse->success == 0) {
              TELEPHONY_LOGE("ReqDial return ERROR");
              err = HRIL_ERR_CMD_NO_CARRIER;
          }
      }
      reportInfo = CreateReportInfo(requestInfo, err, HRIL_RESPONSE, 0);
      OnCallReport(reportInfo, NULL, 0); // 调用通话相关业务回调函数
      FreeResponseInfo(pResponse);
  }
  • 来电开发实例 来电的调用流程示例如下图所示: 图2 来电调用时序图

zh-cn_image_0000001214727595

Modem设备节点读取线程g_reader会循环读取Modem上报的消息,当Modem接收到来电时会主动上报来电相关的信息;

当该线程通过调用OnNotifyOps()解析到Modem上报的数据是以"+CRING"、"RING"等字符开头时,表示有来电事件,然后通过OnCallReport(reportInfo, NULL, 0)上报给RIL Adapter完成来电事件上报。
  // 将Modem上报数据解析为对应模块的主动上报事件
  void OnNotifyOps(const char *s, const char *smsPdu)
  {
      int ret = 0;
      struct ReportInfo reportInfo = {0};
      reportInfo.error = HRIL_ERR_SUCCESS;
      reportInfo.type = HRIL_NOTIFICATION;
      if (GetRadioState() == HRIL_RADIO_POWER_STATE_UNAVAILABLE) {
          return;
      }
      TELEPHONY_LOGD("enter to [%{public}s]:%{public}s", s, smsPdu);
      // 通过AT指令判断主动上报命令类型
      if (ReportStrWith(s, "+CRING:")||ReportStrWith(s, "RING")||ReportStrWith(s, "IRING")||
          ReportStrWith(s, "NO CARRIER")||ReportStrWith(s, "+CCWA")||ReportStrWith(s, "^CCALLSTATE")||
          ReportStrWith(s, "^CEND")||ReportStrWith(s, "^CCWA")) {
          reportInfo.notifyId = HNOTI_CALL_STATE_UPDATED;
          OnCallReport(reportInfo, NULL, 0);  // 调用通话相关业务回调函数
      } else if (ReportStrWith(s, "+CMT:")) {
          reportInfo.notifyId = HNOTI_SMS_NEW_SMS;
          OnSmsReport(reportInfo, (void *)smsPdu, strlen(smsPdu));
      } 
      // add your codes
      ......
  }

Modem厂商库集成指导

编译设置

Modem厂商库可通过BUILD.gn编译为一个动态库,在RIL Adapter启动时用dlopen方式加载到系统中,然后执行厂商库的初始化操作(参见Modem厂商库初始化开发指导),BUILD.gn编写示例如下:

import("//build/ohos.gni")
RIL_ADAPTER = "//base/telephony"
ohos_shared_library("ril_vendor") { // Modem厂商库名称
    sources = [ // 编译源文件
        "at_call.c",
        "at_data.c",
        "xxx.c",
    ]
    include_dirs = [ // 包含的头文件目录
        "$RIL_ADAPTER/ril_adapter/vendor/include",
        "$RIL_ADAPTER/ril_adapter/interfaces/innerkits",
        "include",
    ]
    deps = [ // 内部依赖
        "//drivers/adapter/uhdf2/osal:libhdf_utils",
        "//base/telephony/core_service/utils:libtelephony_common",
    ]
    external_deps = [ "hilog:libhilog" ] // 外部依赖

    part_name = "ril_adapter"  // 部件名称
    subsystem_name = "telephony" // 子系统名称	
}

调测验证

  1. 编译代码。

  2. 查看/out/{device_name}/telephony/ril_adapter目录是否存在libril_vendor.z.so,存在证明集成成功。否则检查代码,重新编译验证。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙子系统开发

harmony 鸿蒙AI框架开发指导

harmony 鸿蒙NNRt接入适配指导

harmony 鸿蒙应用特权配置指南

harmony 鸿蒙开发实例

harmony 鸿蒙搭建环境

harmony 鸿蒙开发指导

harmony 鸿蒙概述

harmony 鸿蒙ArkCompiler开发指导

harmony 鸿蒙窗口标题栏定制开发指导

0  赞