xref: /drivers/peripheral/ril/README_zh.md

# Ril

## 简介

基于HDF（Hardware Driver Foundation）驱动框架开发的Ril驱动，能够屏蔽硬件器件差异，为上层服务提供稳定的拨打电话、发短信、激活SIM卡等稳定的接口。

Ril驱动模块主要包含HDI（Hardware Driver Interface）接口定义及其实现，对上层提供Telephony的驱动能力接口，HDI接口主要提供如下功能：

-   通话相关的业务处理能力
-   SIM卡相关的业务处理能力
-   短彩信相关的业务处理能力
-   搜网相关的业务处理能力
-   蜂窝数据相关的业务处理能力

**图 1**  Ril驱动模型图

![Ril驱动模型图](figures/ril-driver-module-architecture_zh.png)

## 目录

该仓下源代码目录结构如下所示

```
/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](https://gitee.com/openharmony/drivers_interface/blob/master/ril/v1_1/IRil.idl)。

### 使用说明

本节以拨打电话为例进行介绍。

代码示例

```c++
#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);
}
```

## 相关仓

[驱动子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E9%A9%B1%E5%8A%A8%E5%AD%90%E7%B3%BB%E7%BB%9F.md)

[drivers\_framework](https://gitee.com/openharmony/drivers_framework/blob/master/README_zh.md)

[drivers\_adapter](https://gitee.com/openharmony/drivers_adapter/blob/master/README_zh.md)

[drivers\_adapter\_khdf\_linux](https://gitee.com/openharmony/drivers_adapter_khdf_linux/blob/master/README_zh.md)

[drivers\_peripheral](https://gitee.com/openharmony/drivers_peripheral)

[telephony_core_service](https://gitee.com/openharmony/telephony_core_service/blob/master/README_zh.md)

[telephony\_ril\_adapter](https://gitee.com/openharmony/telephony_ril_adapter/blob/master/README_zh.md)