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:

http://tizen.org/feature/network.telephony

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 List.

Functions
int	telephony_network_get_lac (telephony_h handle, int *lac)
	Gets the LAC (Location Area Code) of the current network.
int	telephony_network_get_cell_id (telephony_h handle, int *cell_id)
	Gets the cell ID.
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.
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_service_state (telephony_h handle, telephony_network_service_state_e *network_service_state)
	Gets the current network state of the telephony service.

Enumeration Type Documentation

enum telephony_network_rssi_e

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

enum telephony_network_service_state_e

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

enum telephony_network_type_e

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

Function Documentation

int telephony_network_get_cell_id	(	telephony_h	handle,
		int *	cell_id
	)

Gets the cell ID.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	cell_id	The cell identification number

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_lac	(	telephony_h	handle,
		int *	lac
	)

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

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	lac	The Location Area Code

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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:: You must release mcc using free().

Parameters:

[in]	handle	The handle from telephony_init()
[out]	mcc	The 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_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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:: You must release mnc using free().

Parameters:

[in]	handle	The handle from telephony_init()
[out]	mnc	The 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_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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:: You must release network_name using free().

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_name	The name of the current registered network

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_roaming_status	(	telephony_h	handle,
		bool *	status
	)

Gets the roaming state.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	status	`true` if roaming, otherwise `false` if not roaming

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_rssi	(	telephony_h	handle,
		telephony_network_rssi_e *	rssi
	)

Gets the RSSI (Received Signal Strength Indicator).

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	rssi	The 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_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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.

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]	handle	The handle from telephony_init()
[out]	network_service_state	The current network state

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

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

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_type	The network service type

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

Required Header

Overview

Related Features

Functions

Enumeration Type Documentation

Function Documentation