Modem

---

The Modem Information API provides functions to obtain information from the modem.

Required Header

#include <telephony.h>

Overview

The Telephony Modem Information API allows you to access, but not change the information about IMEI.

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

Functions
int	telephony_modem_get_imei (telephony_h handle, char **imei)
	Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone.
int	telephony_modem_get_power_status (telephony_h handle, telephony_modem_power_status_e *status)
	Gets the power status of the modem.
int	telephony_modem_get_meid (telephony_h handle, char **meid)
	Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA).

---

Enumeration Type Documentation

enum telephony_modem_power_status_e

Enumeration for Modem Power Status.

Since :

2.4

Enumerator:

TELEPHONY_MODEM_POWER_STATUS_UNKNOWN	Unknown
TELEPHONY_MODEM_POWER_STATUS_ON	Modem power ON
TELEPHONY_MODEM_POWER_STATUS_OFF	Modem power OFF
TELEPHONY_MODEM_POWER_STATUS_RESET	Modem power RESET
TELEPHONY_MODEM_POWER_STATUS_LOW	Modem power LOW

---

Function Documentation

int telephony_modem_get_imei	(	telephony_h	handle,
		char **	imei
	)

Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone.

The IMEI number is used by a GSM network to identify valid devices and therefore can be used for stopping a stolen phone from accessing that network.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/telephony

Remarks:

You must release imei using free() on success case.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	imei	The International Mobile Station Equipment Identity

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_modem_get_meid	(	telephony_h	handle,
		char **	meid
	)

Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA).

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/telephony

Remarks:

You must release meid using free() on success case.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	meid	The Mobile Equipment Identifier

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_modem_get_power_status	(	telephony_h	handle,
		telephony_modem_power_status_e *	status
	)

Gets the power status of the modem.

Since :

2.4

Privilege Level:

public

Privilege:

http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	status	The Modem power status (0=on,1=off,2=reset,3=low)

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