Ril
简介
基于HDF（Hardware Driver Foundation）驱动框架开发的Ril驱动，能够屏蔽硬件器件差异，为上层服务提供稳定的拨打电话、发短信、激活SIM卡等稳定的接口。
Ril驱动模块主要包含HDI（Hardware Driver Interface）接口定义及其实现，对上层提供Telephony的驱动能力接口，HDI接口主要提供如下功能：
- 通话相关的业务处理能力
- SIM卡相关的业务处理能力
- 短彩信相关的业务处理能力
- 搜网相关的业务处理能力
- 蜂窝数据相关的业务处理能力
图 1 Ril驱动模型图
目录
该仓下源代码目录结构如下所示
/drivers/peripheral/ril
├── figures # readme资源文件
├── interfaces # Ril模块对上层服务提供的驱动能力接口
│ └── include # Ril模块对外提供的接口定义
约束
- 开发语言：C++ 。
- 软件约束：需要与RIL Adapter模块（ril_adapter）配合使用。
- 硬件约束：需要搭载的设备具备可以进行独立蜂窝通信的Modem以及SIM卡。
说明
接口说明
Ril驱动提供给framework层可直接调用的能力接口，主要功能有：通话、SIM卡、短彩信、蜂窝数据、事件上报等业务。Ril驱动模型对HDI开放的API接口功能如表1：
表 1 Ril HDI 接口列表
| 接口名 | 功能描述 |
|---|---|
| int32_t SetCallback(const sptr<IRilCallback> &rilCallback) | 设置IRil回调接口。 |
| int32_t Dial(int32_t slotId, int32_t serialId, const DialInfo &dialInfo) | 拨打电话，slotId 表示卡槽ID，serialId 表示请求的序列化ID，dialInfo 表示拨号信息。 |
| int32_t Answer(int32_t slotId, int32_t serialId) | 接听电话，slotId 表示卡槽ID，serialId 表示请求的序列化ID。 |
| int32_t SendGsmSms(int32_t slotId, int32_t serialId, const GsmSmsMessageInfo &gsmSmsMessageInfo) | 发送GSM短信，slotId 表示卡槽ID，serialId 表示请求的序列化ID，gsmSmsMessageInfo 表示GSM短信信息。 |
| int32_t SetActiveSim(int32_t slotId, int32_t serialId, int32_t index, int32_t enable) | 激活或去激活SIM卡，slotId 表示卡槽ID，serialId 表示请求的序列化ID，index 表示SIM卡信息的索引值，enable 表示激活状态 |
| int32_t GetOperatorInfo(int32_t slotId, int32_t serialId) | 查询运营商名称信息，slotId 表示卡槽ID，serialId 表示请求的序列化ID。 |
| int32_t ActivatePdpContext(int32_t slotId, int32_t serialId, const DataCallInfo &dataCallInfo) | 查询运营商名称信息，slotId 表示卡槽ID，dataCallInfo 表示数据业务信息。 |
| int32_t SetRadioState(int32_t slotId, int32_t serialId, int32_t fun, int32_t rst) | 给Modem上下电，slotId 表示卡槽ID，serialId 表示请求的序列化ID，fun 表示功能模式，rst 表示是否复位。 |
完整的接口说明请参考： drivers_interface_ril。
使用说明
本节以拨打电话为例进行介绍。
代码示例
#include "V1_1/iril.h"
/* Ril回调类 */
class RilCallback : public HDI::Ril::V1_1::IRilCallback {
int32_t DialResponse(const HDI::Ril::V1_1::RilRadioResponseInfo &responseInfo) override;
int32_t HangupResponse(const HDI::Ril::V1_1::RilRadioResponseInfo &responseInfo) override;
int32_t RejectResponse(const HDI::Ril::V1_1::RilRadioResponseInfo &responseInfo) override;
int32_t AnswerResponse(const HDI::Ril::V1_1::RilRadioResponseInfo &responseInfo) override;
...
}
/* 回调函数 */
int32_t RilCallback::DialResponse(const HDI::Ril::V1_1::RilRadioResponseInfo &responseInfo)
{
printf("DialResponse");
return 0;
}
void RilSample(void)
{
/* 创建Ril接口实例 */
sptr<OHOS::HDI::Ril::V1_1::IRil> g_rilInterface = OHOS::HDI::Ril::V1_1::IRil::Get();
if (g_rilInterface == nullptr) {
return;
}
/* 设置回调*/
sptr<HDI::Ril::V1_1::IRilCallback> g_cbObj = new RilCallback();
g_rilInterface->SetCallback(RilCallback());
/**拨打电话**/
int32_t slotId = 0;
int32_t serialId = 1;
HDI::Ril::V1_1::DialInfo dialInfo = {};
dialInfo.address = "10086";
dialInfo.clir = 0;
int32_t ret = g_rilInterface->Dial(slotId, serialId, dialInfo);
}