# telephony_core_service **Repository Path**: libo729/telephony_core_service ## Basic Information - **Project Name**: telephony_core_service - **Description**: Establishing communication with RIL Adapter | 电话基础服务模块主要功能实现与RIL Adapter进行通信 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1138 - **Created**: 2021-09-08 - **Last Updated**: 2022-09-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Telephony Core Service - [Introduction](#section117mcpsimp) - [Directory Structure](#section129mcpsimp) - [Constraints](#section133mcpsimp) - [Available APIs](#section139mcpsimp) - [APIs for the SIM Card Service](#section142mcpsimp) - [APIs for the Network Search Service](#section198mcpsimp) - [Usage Guidelines](#section370mcpsimp) - [Network Search](#section393mcpsimp) - [SIM Card](#section402mcpsimp) - [Repositories Involved](#section409mcpsimp) ## Introduction The telephony core service initializes the RIL Manager, SIM card module, and network search module, and provides access to the RIL Adapter service. You can implement communication with the RIL Adapter by registering the callback service and implement communication between modules by subscribing to callbacks. **Figure 1** Architecture of the telephony core service ![](figures/en-us_architecture-of-the-core_service-module.png) As shown in the preceding figure, the telephony core service consists of the SIM card service, network search service, and RIL Manager service. - SIM card service: Provides services including SIM card initialization, file read/write, loading status notification, and single-SIM/dual-SIM control. These services implement functions such as SIM card status query, SIM card management, SIM card control, STK, contact storage, and SMS storage. - Network search service: Provides services including network registration and network status acquisition. These services offer functions such as network registration, network mode query, radio status query, network search management, signal strength query, cell management, registration status management, and time and time zone setting. - RIL Manager service: Provides the proactive callback service and query result callback service. ## Directory Structure ``` /base/telphony/core_service ├── interfaces # APIs │ ├── innerkits # Internal APIs │ └── kits # External APIs (such as JS APIs) ├── services # Implementation of the telephony core service │ ├── include │ └── src ├── etc # Telephony core service driver scripts │ └── init ├── sa_profile # SA profile ├── tel_ril # RIL Manager service code │ ├── include │ ├── src │ └── test ├── network_search # Network search service code │ ├── include │ ├── src │ └── test ├── sim # SIM card service code │ ├── include │ ├── src │ └── test ├── common │ ├── log # Core service log print directory │ ├── preferences │ ├── utils │ └── test ``` ## Constraints - Programming language: C++、JavaScript - In terms of software, this module needs to work with the RIL adapter service \(ril\_adapter\) and status registration service \(state\_registry\). - In terms of hardware, the accommodating device must be equipped with a modem and a SIM card capable of independent cellular communication. ## Available APIs The telephony core service module needs to provide APIs for related modules, including the SIM card, network search modules. ### APIs for the SIM Card Service

API

Description

Required Permission

function GetSimStatus(int32_t slotId): void;

Obtains the SIM card status.

None

function GetIsoCountryCode(int32_t slotId): void;

Obtains the country code.

None

function GetSimOperator(int32_t slotId): void;

Obtains the carrier code.

None

function GetSpn(int32_t slotId): void;

Obtains the SPN information.

None

function SimStateUpdated(int32_t slotId): void;

SIM Card state update

None

function UnlockSimPin(int32_t slotId): void;

Unlock SIM Card

None
### APIs for the Network Search Service

API

Description

Required Permission

function GetPsRadioTech(int32_t slotId): void;

function GetCsRadioTech(int32_t slotId): void;

Obtains the current radio access technology.

ohos.permission.GET_NETWORK_INFO

function GetSignalInfoList(int32_t slotId): void;

Obtains the signal information.

None

function GetNetworkStatus(slotId: number, callback: AsyncCallback<GetNetworkStatus>): void;

Obtains the network status.

ohos.permission.GET_NETWORK_INFO

function getNetworkSelectionMode(slotId: number, callback: AsyncCallback): void;

Obtains the current network mode.

None

function setNetworkSelectionMode(options: NetworkSelectionModeOptions, callback: AsyncCallback): void;

Set the current network mode.

None

function getNetworkSearchInformation(slotId: number, callback: AsyncCallback): void;

Obtains the results of manual networksearch.

None

function isRadioOn(slotId: number, callback: AsyncCallback): void;

Determine that the radio is on.

None

function turnOnRadio(callback: AsyncCallback): void;

Open the radio.

None

function turnOffRadio(callback: AsyncCallback): void;

Close the radio.

None

function getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback): void;

Obtains the ISOCountryCode.

None

function setPreferredNetworkPara(slotId: number, networkMode: NetworkMode, callback: AsyncCallback): void;

Set the Preferred Network Mode.

None

function getPreferredNetworkPara(slotId: number, callback: AsyncCallback): void;

Obtains the Preferred Network Mode.

None

function GetSignalStrength(slotId: number, callback: AsyncCallback): void;

Get signal strength

None

function GetOperatorInfo(slotId: number, callback: AsyncCallback): void;

Get operator information

None
>**NOTE:** >The RIL Manager does not provide external APIs and can only be called by modules of the Telephony subsystem. ## Usage Guidelines ### Network Search The function of obtaining the network status is used as an example. The process is as follows: 1. Query the SIM card in the slot specified by **slotId**. If **slotId** is not set, information about the primary card is queried by default. 2. Call the **GetNetworkStatus** method in callback or Promise mode. 3. Obtain the network status information. The **GetNetworkStatus** method works in asynchronous mode. The execution result is returned through the callback. ``` import radio from "@ohos.telephony.radio"; // Set the value of slotId. let slotId = 1; // Call the API in callback mode. radio.GetNetworkStatus(slotId, (err, value) => { if (err) { // If the API call failed, err is not empty. console.error(`failed to GetNetworkStatus because ${err.message}`); return; } // If the API call succeeded, err is empty. console.log(`success to GetNetworkStatus: ${value}`); }); // Call the API in Promise mode. let promise = radio.GetNetworkStatus(slotId); promise.then((value) => { // The API call succeeded. console.log(`success to GetNetworkStatus: ${value}`); }).catch((err) => { // The API call failed. console.error(`failed to GetNetworkStatus because ${err.message}`); }); ``` ### SIM Card The function of querying the status of a specified SIM card is used as an example. The process is as follows: 1. Set the value of **slotId**. 2. Call the **getSimState** method in callback or Promise mode to obtain the SIM card status information. 3. This method works in asynchronous mode. The execution result is returned through the callback. ``` import sim from "@ohos.telephony.sim"; // Set the value of slotId. let slotId = 1; // Call the API in callback mode. sim.getSimState(slotId, (err, value) => { if (err) { // If the API call failed, err is not empty. console.error(`failed to getSimState because ${err.message}`); return; } // If the API call succeeded, err is empty. console.log(`success to getSimState: ${value}`); }); // Call the API in Promise mode. let promise = sim.getSimState(slotId); promise.then((value) => { // The API call succeeded. console.log(`success to getSimState: ${value}`); }).catch((err) => { // The API call failed. console.error(`failed to getSimState because ${err.message}`); }); ``` ## Repositories Involved [Telephony](https://gitee.com/openharmony/docs/blob/master/en/readme/telephony.md) **telephony_core_service** [telephony_sms_mms](https://gitee.com/openharmony/telephony_sms_mms/blob/master/README.md)