harmony 鸿蒙Ril

2023-06-24
浏览 (3005)

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)