Ril

概述

Ril模块接口定义。

Ril模块为上层电话服务提供相关调用接口，涉及电话、短信、彩信、网络搜索、SIM卡等功能接口及各种回调等。

Since:

3.2

Version:

1.0

汇总

文件

名称 描述
IRil.idl Ril模块的请求接口。
IRilCallback.idl Ril模块的回调接口
Types.idl Ril模块HDI接口使用的数据类型。

类

名称 描述
IRil interface
Ril模块的请求接口。
IRilCallback interface
Ril模块的回调接口。
EmergencyCall struct
紧急呼叫号码。
EmergencyInfoList struct
紧急呼叫号码列表。
RilRadioResponseInfo struct
响应通用信息。
SetupDataCallResultInfo struct
数据业务激活结果信息。
DataCallResultList struct
数据业务激活结果列表。
DataProfileDataInfo struct
PDP上下文信息。
DataProfilesInfo struct
PDP上下文信息列表。
DataCallInfo struct
数据业务信息。
DataLinkBandwidthInfo struct
网络频率信息。
DataLinkBandwidthReportingRule struct
网络频率上报规则。
DataPerformanceInfo struct
数据业务性能模式。
DataSleepInfo struct
数据业务睡眠模式。
UniInfo struct
通用信息。
VoiceRadioTechnology struct
电路域接入技术。
DialInfo struct
拨号信息。
CallInfo struct
通话状态信息。
CallInfoList struct
通话状态信息列表。
GetClipResult struct
主叫号码显示结果信息。
GetClirResult struct
主叫号码显示限制结果信息。
CallWaitResult struct
呼叫等待结果信息。
CallRestrictionInfo struct
呼叫限制信息。
CallRestrictionResult struct
呼叫限制结果信息。
CallForwardSetInfo struct
呼叫转移信息。
CallForwardQueryResult struct
呼叫转移查询结果信息。
CallForwardQueryInfoList struct
呼叫转移信息列表。
UssdNoticeInfo struct
非结构化补充数据业务(USSD)业务信息。
SsNoticeInfo struct
补充业务信息。
SrvccStatus struct
SRVCC（Single Radio Voice Call Continuity）状态信息。
RingbackVoice struct
回铃音信息。
DtmfInfo struct
发送双音多频(DTMF)信息。
SetBarringInfo struct
设置呼叫限制密码的信息。
CardStatusInfo struct
SIM卡状态信息。
SimIoRequestInfo struct
SIM数据请求信息。
IccIoResultInfo struct
SIM数据的响应结果信息。
SimLockInfo struct
SIM卡锁信息。
SimPasswordInfo struct
SIM卡密码信息。
SimPinInputTimes struct
SIM密码输入次数信息。
ApduSimIORequestInfo struct
APDU数据传输请求信息。
SimAuthenticationRequestInfo struct
SIM卡鉴权请求信息。
OpenLogicalChannelResponse struct
APDU打开逻辑通道响应信息。
LockStatusResp struct
SIM卡解锁响应
RadioProtocol struct
主副卡协议栈信息。
GsmRssi struct
GSM信号强度。
CdmaRssi struct
CDMA信号强度。
WcdmaRssi struct
WCDMA信号强度。
LteRssi struct
LTE信号强度。
TdScdmaRssi struct
TDSCDMA信号强度。
NrRssi struct
NR信号强度。
Rssi struct
接收信号强度信息。
CsRegStatusInfo struct
CS注册状态信息。
PsRegStatusInfo struct
PS注册状态信息。
OperatorInfo struct
运营商信息。
AvailableNetworkInfo struct
可用网络信息。
AvailableNetworkList struct
可用网络列表。
SetNetworkModeInfo struct
设置网络模式信息。
CellListRatGsm struct
GSM小区信息。
CellListRatLte struct
LTE小区信息。
CellListRatWcdma struct
WCDMA小区信息。
CellListRatCdma struct
CDMA小区信息。
CellListRatTdscdma struct
TDSCDMA小区信息。
CellListRatNr struct
NR小区信息。
ServiceCellParas union
多种网络模式的小区信息。
CellNearbyInfo struct
相邻小区信息。
CellListNearbyInfo struct
附近小区信息列表。
CellRatGsm struct
GSM蜂窝信息。
CellRatLte struct
LTE蜂窝信息。
CellRatWcdma struct
WCDMA蜂窝信息。
CellRatCdma struct
CDMA蜂窝信息。
CellRatTdscdma struct
TDSCDMA蜂窝信息。
CellRatNr struct
NR蜂窝信息。
CurrentServiceCellParas union
当前蜂窝数据信息。
CurrentCellInfo struct
当前小区信息。
CellListCurrentInfo struct
当前小区信息列表。
PreferredNetworkTypeInfo struct
首选网络类型信息。
PhysicalChannelConfig struct
物理通道配置。
ChannelConfigInfoList struct
通道配置信息列表。
GsmSmsMessageInfo struct
发送GSM短信信息。
SendCdmaSmsMessageInfo struct
发送CDMA短信信息。
SmsMessageIOInfo struct
SIM卡短信信息
ServiceCenterAddress struct
短信中心地址信息。
CBConfigInfo struct
GSM小区广播配置信息。
CdmaCBConfigInfo struct
CDMA小区广播配置信息。
CdmaCBConfigInfoList struct
CDMA小区广播配置信息列表。
CBConfigReportInfo struct
小区广播上报信息。
SmsMessageInfo struct
上报短信信息。
ModeData struct
接收短信处理模式。
SendSmsResultInfo struct
发送短信响应信息。

枚举

名称 描述
EccType {
TYPE_CATEGORY = 0 , TYPE_POLICE = 1 , TYPE_AMBULANCE = 2 , TYPE_FIRE = 4 ,TYPE_SEA = 8 , TYPE_MOUNTAIN = 16
}		 紧急呼叫类型。
SimpresentType { TYPE_NO_CARD = 0 , TYPE_HAS_CARD = 1 } 表示号码是有卡时有效还是无卡时有效。
AbnormalServiceType { TYPE_ALL = 0 , TYPE_ONLY_CS = 1 } 表示号码有效性是否区分电路(CS)域非正常服务状态。
RilErrType {
NONE = 0 , RIL_ERR_GENERIC_FAILURE = 1 , RIL_ERR_INVALID_PARAMETER = 2 , RIL_ERR_MEMORY_FULL = 3 ,
RIL_ERR_CMD_SEND_FAILURE = 4 , RIL_ERR_CMD_NO_CARRIER = 5 , RIL_ERR_INVALID_RESPONSE = 6 , RIL_ERR_REPEAT_STATUS = 7 ,
RIL_ERR_NETWORK_SEARCHING = 8 , RIL_ERR_NETWORK_SEARCHING_INTERRUPTED = 9 , RIL_ERR_MODEM_DEVICE_CLOSE = 10 , RIL_ERR_NO_SIMCARD_INSERTED = 11 , RIL_ERR_NEED_PIN_CODE = 12 , RIL_ERR_NEED_PUK_CODE = 13 , RIL_ERR_NETWORK_SEARCH_TIMEOUT = 14 , RIL_ERR_PINPUK_PASSWORD_NOCORRECT = 15 ,
RIL_ERR_INVALID_MODEM_PARAMETER = 50 , RIL_ERR_HDF_IPC_FAILURE = 300 , RIL_ERR_NULL_POINT = 301 , RIL_ERR_VENDOR_NOT_IMPLEMENT = 302
}		 Ril错误码。
RilResponseTypes {
RIL_RESPONSE_REQUEST = 0 , RIL_RESPONSE_NOTICE = 1 , RIL_RESPONSE_REQUEST_ACK = 2 , RIL_RESPONSE_REQUEST_MUST_ACK = 3 , RIL_RESPONSE_NOTICE_MUST_ACK = 4
}		 响应类型。
RilSrvStatus {
RIL_NO_SRV_SERVICE = 0 , RIL_RESTRICTED_SERVICE = 1 , RIL_SERVICE_VALID = 2 , RIL_REGIONAL_SERVICE = 3 , RIL_ENERGY_SAVING_SERVICE = 4
}		 Ril系统服务状态。
RilSrvDomain {
RIL_NO_DOMAIN_SERVICE = 0 , RIL_CS_SERVICE = 1 , RIL_PS_SERVICE = 2 , RIL_CS_PS_SERVICE = 3 , RIL_CS_PS_SEARCHING = 4 , RIL_CDMA_NOT_SUPPORT = 255
}		 系统服务域。
RilRoamStatus { RIL_NO_ROAM = 0 , RIL_ROAMING = 1 , RIL_ROAM_UNKNOWN = 2 } 漫游状态。
RilSimLockStatus { RIL_SIM_CARD_UNLOCK = 0 , RIL_SIM_CARD_LOCK = 1 } SIM卡锁定状态。
RilSysMode {
RIL_NO_SYSMODE_SERVICE = 0 , RIL_GSM_MODE = 1 , RIL_CDMA_MODE = 2 , RIL_WCDMA_MODE = 3 , RIL_TDSCDMA_MODE = 4 , RIL_WIMAX_MODE = 5 , RIL_LTE_MODE = 6 , RIL_LTE_CA_MODE = 7 , RIL_NR_MODE = 8
}		 系统制式。
RilRadioTech {
RADIO_TECHNOLOGY_INVALID = 65535 , RADIO_TECHNOLOGY_UNKNOWN = 0 , RADIO_TECHNOLOGY_GSM = 1 , RADIO_TECHNOLOGY_1XRTT = 2 , RADIO_TECHNOLOGY_WCDMA = 3 , RADIO_TECHNOLOGY_HSPA = 4 , RADIO_TECHNOLOGY_HSPAP = 5 , RADIO_TECHNOLOGY_TD_SCDMA = 6 , RADIO_TECHNOLOGY_EVDO = 7 , RADIO_TECHNOLOGY_EHRPD = 8 , RADIO_TECHNOLOGY_LTE = 9 , RADIO_TECHNOLOGY_LTE_CA = 10 , RADIO_TECHNOLOGY_IWLAN = 11 , RADIO_TECHNOLOGY_NR = 12
}		 语音接入技术类型。
RilSimStatus {
RIL_USIM_INVALID = 0 , RIL_USIM_VALID = 1 , RIL_USIM_CS_INVALID = 2 , RIL_USIM_PS_INVALID = 3 , RIL_USIM_CS_PS_INVALID = 4 , RIL_ROM_SIM = 240 , RIL_NO_USIM = 255
}		 SIM卡状态。
RilRegStatus {
NO_REG_MT_NO_SEARCH = 0 , REG_MT_HOME = 1 , NO_REG_MT_SEARCHING = 2 , REG_MT_REJECTED = 3 , REG_MT_UNKNOWN = 4 , REG_MT_ROAMING = 5 , REG_MT_EMERGENCY = 6
}		 描述网络注册状态。
RilCellConnectionStatus { RIL_SERVING_CELL_UNKNOWN = 0 , RIL_SERVING_CELL_PRIMARY = 1 , RIL_SERVING_CELL_SECONDARY = 2 } 小区连接状态。
RilRegNotifyMode { REG_NOT_NOTIFY = 0 , REG_NOTIFY_STAT_ONLY = 1 , REG_NOTIFY_STAT_LAC_CELLID = 2 } 上报模式。
RadioProtocolPhase {
RADIO_PROTOCOL_PHASE_INITIAL , RADIO_PROTOCOL_PHASE_CHECK , RADIO_PROTOCOL_PHASE_UPDATE , RADIO_PROTOCOL_PHASE_NOTIFY , RADIO_PROTOCOL_PHASE_COMPLETE
}		 设置Radio协议动作参数。
RadioProtocolStatus { RADIO_PROTOCOL_STATUS_NONE , RADIO_PROTOCOL_STATUS_SUCCESS , RADIO_PROTOCOL_STATUS_FAIL } Radio协议状态。

关键字

名称 描述
package ohos.hdi.ril.v1_0 Ril模块接口的包路径。

枚举类型说明

AbnormalServiceType

enum AbnormalServiceType

描述:

表示号码有效性是否区分电路(CS)域非正常服务状态。

枚举值 描述
TYPE_ALL 所有状态均有效
TYPE_ONLY_CS 仅在CS域非正常服务时有效

EccType

enum EccType

描述:

紧急呼叫类型。

枚举值 描述
TYPE_CATEGORY 默认
TYPE_POLICE 匪警
TYPE_AMBULANCE 救护
TYPE_FIRE 火警
TYPE_SEA 海警
TYPE_MOUNTAIN 高山营救

RadioProtocolPhase

enum RadioProtocolPhase

描述:

设置Radio协议动作参数。

枚举值 描述
RADIO_PROTOCOL_PHASE_INITIAL 初始化
RADIO_PROTOCOL_PHASE_CHECK 检查
RADIO_PROTOCOL_PHASE_UPDATE 更新
RADIO_PROTOCOL_PHASE_NOTIFY 上报
RADIO_PROTOCOL_PHASE_COMPLETE 结束

RadioProtocolStatus

enum RadioProtocolStatus

描述:

Radio协议状态。

枚举值 描述
RADIO_PROTOCOL_STATUS_NONE 无状态
RADIO_PROTOCOL_STATUS_SUCCESS 成功
RADIO_PROTOCOL_STATUS_FAIL 失败

RilCellConnectionStatus

enum RilCellConnectionStatus

描述:

小区连接状态。

枚举值 描述
RIL_SERVING_CELL_UNKNOWN 未知连接状态
RIL_SERVING_CELL_PRIMARY 主要连接状态
RIL_SERVING_CELL_SECONDARY 次要连接状态

RilErrType

enum RilErrType

描述:

Ril错误码。

枚举值 描述
NONE 调用成功
RIL_ERR_GENERIC_FAILURE 通用错误
RIL_ERR_INVALID_PARAMETER 参数错误
RIL_ERR_MEMORY_FULL 内存满载
RIL_ERR_CMD_SEND_FAILURE 命令发送失败
RIL_ERR_CMD_NO_CARRIER 命令连接终止
RIL_ERR_INVALID_RESPONSE 非法响应
RIL_ERR_REPEAT_STATUS 状态已存在
RIL_ERR_NETWORK_SEARCHING 网络搜索中
RIL_ERR_NETWORK_SEARCHING_INTERRUPTED 网络搜索中断
RIL_ERR_MODEM_DEVICE_CLOSE Modem设备关闭
RIL_ERR_NO_SIMCARD_INSERTED SIM卡未插入
RIL_ERR_NEED_PIN_CODE 需要输入PIN码
RIL_ERR_NEED_PUK_CODE 需要输入PUK码
RIL_ERR_NETWORK_SEARCH_TIMEOUT 搜网超时
RIL_ERR_PINPUK_PASSWORD_NOCORRECT PIN码或PUK码错误
RIL_ERR_INVALID_MODEM_PARAMETER Modem参数错误
RIL_ERR_HDF_IPC_FAILURE IPC错误
RIL_ERR_NULL_POINT 空指针
RIL_ERR_VENDOR_NOT_IMPLEMENT 厂商库未实现

RilRadioTech

enum RilRadioTech

描述:

语音接入技术类型。

枚举值 描述
RADIO_TECHNOLOGY_INVALID 非法
RADIO_TECHNOLOGY_UNKNOWN 未知
RADIO_TECHNOLOGY_GSM GSM
RADIO_TECHNOLOGY_1XRTT 无线电传输技术(1XRTT)
RADIO_TECHNOLOGY_WCDMA WCDMA
RADIO_TECHNOLOGY_HSPA 高速分组接入(HSPA)
RADIO_TECHNOLOGY_HSPAP 高速下行分组接入(HSPAP)
RADIO_TECHNOLOGY_TD_SCDMA 同步码分多址的无线接入技术(SCDMA)
RADIO_TECHNOLOGY_EVDO 仅演进数据(EVDO)
RADIO_TECHNOLOGY_EHRPD 演进的高速分组网络(EHRPD)
RADIO_TECHNOLOGY_LTE LTE
RADIO_TECHNOLOGY_LTE_CA CA
RADIO_TECHNOLOGY_IWLAN 工业无线局域网(IWLAN)
RADIO_TECHNOLOGY_NR NR

RilRegNotifyMode

enum RilRegNotifyMode

描述:

上报模式。

枚举值 描述
REG_NOT_NOTIFY 禁止主动上报
REG_NOTIFY_STAT_ONLY 网络注册状态发生改变时上报
REG_NOTIFY_STAT_LAC_CELLID 小区信息发生改变时上报

RilRegStatus

enum RilRegStatus

描述:

描述网络注册状态。

枚举值 描述
NO_REG_MT_NO_SEARCH 没有注册，MT（Mobile Terminal）现在没有搜索和注册新的运营商
REG_MT_HOME 注册了归属网络
NO_REG_MT_SEARCHING 没有注册，MT正在搜索并注册新的运营商
REG_MT_REJECTED 注册被拒绝
REG_MT_UNKNOWN 未知状态
REG_MT_ROAMING 注册了漫游网络
REG_MT_EMERGENCY 处于紧急模式

RilResponseTypes

enum RilResponseTypes

描述:

响应类型。

枚举值 描述
RIL_RESPONSE_REQUEST 请求响应
RIL_RESPONSE_NOTICE 通知响应
RIL_RESPONSE_REQUEST_ACK 应答请求响应
RIL_RESPONSE_REQUEST_MUST_ACK 必须应答请求响应
RIL_RESPONSE_NOTICE_MUST_ACK 必须应答通知响应

RilRoamStatus

enum RilRoamStatus

描述:

漫游状态。

枚举值 描述
RIL_NO_ROAM 非漫游状态
RIL_ROAMING 漫游状态
RIL_ROAM_UNKNOWN 未知

RilSimLockStatus

enum RilSimLockStatus

描述:

SIM卡锁定状态。

枚举值 描述
RIL_SIM_CARD_UNLOCK 未被CardLock功能锁定
RIL_SIM_CARD_LOCK 被CardLock功能锁定

RilSimStatus

enum RilSimStatus

描述:

SIM卡状态。

枚举值 描述
RIL_USIM_INVALID USIM卡状态无效
RIL_USIM_VALID USIM卡状态有效
RIL_USIM_CS_INVALID USIM卡在CS下无效
RIL_USIM_PS_INVALID USIM卡在PS下无效
RIL_USIM_CS_PS_INVALID USIM卡在CS+PS下均无效
RIL_ROM_SIM 仿真SIM卡
RIL_NO_USIM USIM卡不存在

RilSrvDomain

enum RilSrvDomain

描述:

系统服务域。

枚举值 描述
RIL_NO_DOMAIN_SERVICE 无服务
RIL_CS_SERVICE 仅CS服务
RIL_PS_SERVICE 仅分组(PS)服务
RIL_CS_PS_SERVICE CS+PS服务
RIL_CS_PS_SEARCHING CS、PS均未注册
RIL_CDMA_NOT_SUPPORT CDMA不支持

RilSrvStatus

enum RilSrvStatus

描述:

Ril系统服务状态。

枚举值 描述
RIL_NO_SRV_SERVICE 无服务
RIL_RESTRICTED_SERVICE 有限制服务
RIL_SERVICE_VALID 服务有效
RIL_REGIONAL_SERVICE 有限制的区域服务
RIL_ENERGY_SAVING_SERVICE 省电和睡眠状态

RilSysMode

enum RilSysMode

描述:

系统制式。

枚举值 描述
RIL_NO_SYSMODE_SERVICE 服务不存在
RIL_GSM_MODE 全球移动通信系统 (GSM)
RIL_CDMA_MODE 码分多址(CDMA)
RIL_WCDMA_MODE 宽带码分多址(WCDMA)
RIL_TDSCDMA_MODE 时分同步码分多址(TDSCDMA)
RIL_WIMAX_MODE 全球微波接入互操作性(WIMAX)
RIL_LTE_MODE 长期演进(LTE)
RIL_LTE_CA_MODE 载波聚合(CA)
RIL_NR_MODE 5G新空口(NR)

SimpresentType

enum SimpresentType

描述:

表示号码是有卡时有效还是无卡时有效。

枚举值 描述
TYPE_NO_CARD 无卡时有效
TYPE_HAS_CARD 有卡时有效