Tizen Native API  3.0

The Network Information API provides functions to obtain information about the current telephony service network.

Required Header

#include <telephony.h>

Overview

The Telephony Network Information API allows you to access, but not change the information about the current cellular network and telephony service.

Related Features

This API is related with the following feature:

It is recommended to design feature related codes in your application for reliability.

You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions

int telephony_network_get_lac (telephony_h handle, int *lac)
 Gets the LAC (Location Area Code) of the current location.
int telephony_network_get_cell_id (telephony_h handle, int *cell_id)
 Gets the cell ID of the current location.
int telephony_network_get_rssi (telephony_h handle, telephony_network_rssi_e *rssi)
 Gets the RSSI (Received Signal Strength Indicator).
int telephony_network_get_roaming_status (telephony_h handle, bool *status)
 Gets the roaming state of the current registered network.
int telephony_network_get_mcc (telephony_h handle, char **mcc)
 Gets the MCC (Mobile Country Code) of the current registered network.
int telephony_network_get_mnc (telephony_h handle, char **mnc)
 Gets the MNC (Mobile Network Code) of the current registered network.
int telephony_network_get_network_name (telephony_h handle, char **network_name)
 Gets the name of the current registered network.
int telephony_network_get_type (telephony_h handle, telephony_network_type_e *network_type)
 Gets the network service type of the current registered network.
int telephony_network_get_ps_type (telephony_h handle, telephony_network_ps_type_e *ps_type)
 Gets the packet service type of the current registered network.
int telephony_network_get_network_name_option (telephony_h handle, telephony_network_name_option_e *network_name_option)
 Gets the network name option of the current registered network.
int telephony_network_get_service_state (telephony_h handle, telephony_network_service_state_e *network_service_state)
 Gets the current network state of the telephony service.
int telephony_network_get_default_data_subscription (telephony_h handle, telephony_network_default_data_subs_e *default_sub)
 Gets the current default subscription for data service (Packet Switched).
int telephony_network_get_default_subscription (telephony_h handle, telephony_network_default_subs_e *default_sub)
 Gets the current default subscription for voice service (Circuit Switched).
int telephony_network_get_selection_mode (telephony_h handle, telephony_network_selection_mode_e *mode)
 Gets the network selection mode.
int telephony_network_get_tac (telephony_h handle, int *tac)
 Gets the TAC (Tracking Area Code) of the current location.
int telephony_network_get_system_id (telephony_h handle, int *sid)
 Gets the system ID of the current location.
int telephony_network_get_network_id (telephony_h handle, int *nid)
 Gets the network ID of the current location.
int telephony_network_get_base_station_id (telephony_h handle, int *bs_id)
 Gets the base station ID of the current location.
int telephony_network_get_base_station_latitude (telephony_h handle, int *bs_latitude)
 Gets the base station latitude of the current location.
int telephony_network_get_base_station_longitude (telephony_h handle, int *bs_longitude)
 Gets the base station longitude of the current location.

Enumeration Type Documentation

Enumeration for the possible 'default' Data Subscriptions for Packet Switched(PS).

Since :
3.0
Enumerator:
TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_UNKNOWN 

Unknown status

TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM1 

SIM 1

TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM2 

SIM 2

Enumeration for defining possible 'default' Subscriptions for Circuit Switched(CS).

Since :
3.0
Enumerator:
TELEPHONY_NETWORK_DEFAULT_SUBS_UNKNOWN 

Unknown status

TELEPHONY_NETWORK_DEFAULT_SUBS_SIM1 

SIM 1 network

TELEPHONY_NETWORK_DEFAULT_SUBS_SIM2 

SIM 2 network

Enumeration for Network Name Priority.

Since :
3.0
Enumerator:
TELEPHONY_NETWORK_NAME_OPTION_UNKNOWN 

Unknown

TELEPHONY_NETWORK_NAME_OPTION_SPN 

Network name displayed by SPN

TELEPHONY_NETWORK_NAME_OPTION_NETWORK 

Network name displayed by Network

TELEPHONY_NETWORK_NAME_OPTION_ANY 

Network name displayed by SPN or Network

Enumeration for PS Type.

Since :
3.0
Enumerator:
TELEPHONY_NETWORK_PS_TYPE_UNKNOWN 

Unknown

TELEPHONY_NETWORK_PS_TYPE_HSDPA 

HSDPA ps type

TELEPHONY_NETWORK_PS_TYPE_HSUPA 

HSUPA ps type

TELEPHONY_NETWORK_PS_TYPE_HSPA 

HSPA ps type

TELEPHONY_NETWORK_PS_TYPE_HSPAP 

HSPAP ps type

Enumeration for RSSI (Receive Signal Strength Indicator).

TELEPHONY_NETWORK_RSSI_6 indicates the highest strength.

Since :
2.3.1
Enumerator:
TELEPHONY_NETWORK_RSSI_0 

Strength 0

TELEPHONY_NETWORK_RSSI_1 

Strength 1

TELEPHONY_NETWORK_RSSI_2 

Strength 2

TELEPHONY_NETWORK_RSSI_3 

Strength 3

TELEPHONY_NETWORK_RSSI_4 

Strength 4

TELEPHONY_NETWORK_RSSI_5 

Strength 5

TELEPHONY_NETWORK_RSSI_6 

Strength 6

Enumeration for network selection mode.

Since :
3.0
Enumerator:
TELEPHONY_NETWORK_SELECTION_MODE_AUTOMATIC 

Automatic mode

TELEPHONY_NETWORK_SELECTION_MODE_MANUAL 

Manual mode

Enumeration for Network Service State.

Since :
2.3.1
Enumerator:
TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE 

In service

TELEPHONY_NETWORK_SERVICE_STATE_OUT_OF_SERVICE 

Out of service

TELEPHONY_NETWORK_SERVICE_STATE_EMERGENCY_ONLY 

Only emergency call is allowed

Enumeration for Network Type.

Since :
2.3.1
Enumerator:
TELEPHONY_NETWORK_TYPE_UNKNOWN 

Unknown

TELEPHONY_NETWORK_TYPE_GSM 

2G GSM network type

TELEPHONY_NETWORK_TYPE_GPRS 

2.5G GPRS network type

TELEPHONY_NETWORK_TYPE_EDGE 

2.5G EDGE network type

TELEPHONY_NETWORK_TYPE_UMTS 

3G UMTS network type

TELEPHONY_NETWORK_TYPE_HSDPA 

HSDPA network type

TELEPHONY_NETWORK_TYPE_LTE 

LTE network type

TELEPHONY_NETWORK_TYPE_IS95A 

IS95A network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_IS95B 

IS95B network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_CDMA_1X 

CDMA 1x network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_EVDO_REV_0 

EVDO revision 0 network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_EVDO_REV_A 

EVDO revision A network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_EVDO_REV_B 

EVDO revision B network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_EVDV 

EVDV network type (Since: 3.0)

TELEPHONY_NETWORK_TYPE_EHRPD 

EHRPD network type (Since: 3.0)


Function Documentation

int telephony_network_get_base_station_id ( telephony_h  handle,
int *  bs_id 
)

Gets the base station ID of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in CDMA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]bs_idThe base station ID, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_base_station_latitude ( telephony_h  handle,
int *  bs_latitude 
)

Gets the base station latitude of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in CDMA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]bs_latitudeThe base station latitude, 0x7FFFFFFF if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_base_station_longitude ( telephony_h  handle,
int *  bs_longitude 
)

Gets the base station longitude of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in CDMA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]bs_longitudeThe base station longitude, 0x7FFFFFFF if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_cell_id ( telephony_h  handle,
int *  cell_id 
)

Gets the cell ID of the current location.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in GSM / WCDMA / LTE network.
http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0.
http://tizen.org/privilege/telephony privilege is no longer required since 3.0.
Parameters:
[in]handleThe handle from telephony_init()
[out]cell_idThe cell identification number, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()

Gets the current default subscription for data service (Packet Switched).

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]default_subThe current default data subscription
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the current default subscription for voice service (Circuit Switched).

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]default_subThe current default voice subscription
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
int telephony_network_get_lac ( telephony_h  handle,
int *  lac 
)

Gets the LAC (Location Area Code) of the current location.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in GSM / WCDMA network.
http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0.
http://tizen.org/privilege/telephony privilege is no longer required since 3.0.
Parameters:
[in]handleThe handle from telephony_init()
[out]lacThe Location Area Code, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_mcc ( telephony_h  handle,
char **  mcc 
)

Gets the MCC (Mobile Country Code) of the current registered network.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
This API can be used in GSM / WCDMA / LTE network. You must release mcc using free() on success case, empty string if unknown.
Parameters:
[in]handleThe handle from telephony_init()
[out]mccThe Mobile Country Code (three digits) Mobile Country Code (MCC) identifies the country where the cell is being used
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
int telephony_network_get_mnc ( telephony_h  handle,
char **  mnc 
)

Gets the MNC (Mobile Network Code) of the current registered network.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
This API can be used in GSM / WCDMA / LTE network. You must release mnc using free() on success case, empty string if unknown.
Parameters:
[in]handleThe handle from telephony_init()
[out]mncThe Mobile Network Code (three digits) The Mobile Network Code (MNC) identifies the mobile phone operator and network provider
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
int telephony_network_get_network_id ( telephony_h  handle,
int *  nid 
)

Gets the network ID of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in CDMA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]nidThe network ID, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_network_name ( telephony_h  handle,
char **  network_name 
)

Gets the name of the current registered network.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
This API can be used in GSM / WCDMA / LTE network. You must release network_name using free() on success case.
Parameters:
[in]handleThe handle from telephony_init()
[out]network_nameThe name of the current registered network, empty string if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the network name option of the current registered network.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]network_name_optionThe network name display option
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the packet service type of the current registered network.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
This API can be used in HSDPA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]ps_typeThe type of packet service
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_roaming_status ( telephony_h  handle,
bool *  status 
)

Gets the roaming state of the current registered network.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]statustrue if roaming, otherwise false if not roaming
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the RSSI (Received Signal Strength Indicator).

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]rssiThe Received Signal Strength Indicator
Higher the received number, the stronger the signal strength
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the network selection mode.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]modeThe network selection mode
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the current network state of the telephony service.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
To know the state of data network, refer connection API.
Parameters:
[in]handleThe handle from telephony_init()
[out]network_service_stateThe current network state
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
int telephony_network_get_system_id ( telephony_h  handle,
int *  sid 
)

Gets the system ID of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in CDMA network.
Parameters:
[in]handleThe handle from telephony_init()
[out]sidThe system ID, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_tac ( telephony_h  handle,
int *  tac 
)

Gets the TAC (Tracking Area Code) of the current location.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/location.coarse
Remarks:
This API can be used in LTE network.
Parameters:
[in]handleThe handle from telephony_init()
[out]tacThe Tracking Area Code, -1 if unknown
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()
telephony_network_get_type()
int telephony_network_get_type ( telephony_h  handle,
telephony_network_type_e network_type 
)

Gets the network service type of the current registered network.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
This API can be used in case network is in service.
Parameters:
[in]handleThe handle from telephony_init()
[out]network_typeThe network service type
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
See also:
telephony_network_get_service_state()