Telephony Core Service

• Introduction

• Directory Structure

• Constraints

• Available APIs

  • SimManager APIs
  • NetworkSearchManager APIs

• Usage Guidelines

  • Network Search
  • SIM Card Management

• Repositories Involved

Introduction

The telephony core service initializes the SimManager, NetworkSearchManager, and TelRilManager modules, 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

As shown in the preceding figure, the telephony core service consists of the following:

• SimManager: 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.
• NetworkSearchManager: provides services including network registration and network status acquisition. These services offer functions such as network registration, network mode query, IMS network status reporting, radio service status query, radio service management, signal strength query, cell management, registration status management, and time and time zone setting.
• TelRilManager: provides the proactive callback service and query result callback service.

Directory Structure

/base/telphony/core_service
├── figures                       # Figures of readme files
├── frameworks                    # Framework layer
│   ├── js
│   └── native
├── interfaces                    # APIs
│   ├── innerkits                 # Internal APIs
|   |    ├── ims                  # IMS network status reporting APIs
│   └── kits                      # External APIs \(such as JS APIs\)
├── sa_profile                    # SA profile
├── services                      # Implementation of the telephony core service
│   ├── etc                       # Telephony core service driver scripts
|   ├── ims_service_interaction   # IMS service interaction (for status reporting)
│   ├── include
│   ├── network_search            # Network search service
│   ├── sim                       # SIM card service
│   ├── src
│   └── tel_ril                   # Telephony core service and RIL Adapter communication
├─ test                            # Test code
│   └── unittest
└── utils
    ├── common                    # Telephony core service log
    ├── log
    └── preferences

Constraints

• Programming language: C++ and JavaScript.
• Software constraints: This module must work with the HDF (drivers_interface and drivers_peripheral), RIL Adapter service (ril_adapter), and state registry service (state_registry).
• Hardware constraints: 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 and radio modules.

SimManager APIs

For details about the complete description of JavaScript APIs and sample code, see SIM Card Management.

NetworkSearchManager APIs

For details about the complete description of JavaScript APIs and sample code, see Radio.

NOTE

The RIL Manager does not provide external APIs. It 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 getNetworkState method in callback or promise mode to obtain the network status.

3. Obtain the SIM card status information. The getNetworkState 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 = 0;
   
   // Call the API in callback mode.
   radio.getNetworkState(slotId, (err, value) => {
     if (err) {
       // If the API call fails, err is not empty.
       console.error(`failed to getNetworkState because ${err.message}`);
       return;
     }
     // If the API call is successful, err is empty.
     console.log(`success to getNetworkState: ${value}`);
   });
   
   // Call the API in promise mode.
   let promise = radio.getNetworkState(slotId);
   promise.then((value) => {
     // The API call is successful.
     console.log(`success to getNetworkState: ${value}`);
   }).catch((err) => {
     // The API call fails.
     console.error(`failed to getNetworkState because ${err.message}`);
   });

SIM Card Management

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.

3. Obtain the SIM card status information. The getSimState 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 = 0;
   
   // Call the API in callback mode.
   sim.getSimState(slotId, (err, value) => {
     if (err) {
       // If the API call fails, err is not empty.
       console.error(`failed to getSimState because ${err.message}`);
       return;
     }
     // If the API call is successful, 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 is successful.
     console.log(`success to getSimState: ${value}`);
   }).catch((err) => {
     // The API call fails.
     console.error(`failed to getSimState because ${err.message}`);
   });

Repositories Involved

Telephony Subsystem

telephony_core_service

telephony_sms_mms

drivers_interface

drivers_peripheral

telephony_ril_adapter