le_info_interface.h File Reference

#include "legato.h"

Go to the source code of this file.

Macros
#define	LE_INFO_IMEI_MAX_LEN   15
#define	LE_INFO_IMEI_MAX_BYTES   16
#define	LE_INFO_MAX_VERS_LEN   256
#define	LE_INFO_MAX_VERS_BYTES   257
#define	LE_INFO_MAX_MODEL_LEN   256
#define	LE_INFO_MAX_MODEL_BYTES   257
#define	LE_INFO_MAX_ESN_LEN   32
#define	LE_INFO_MAX_ESN_BYTES   33
#define	LE_INFO_MAX_MEID_LEN   32
#define	LE_INFO_MAX_MEID_BYTES   33
#define	LE_INFO_MAX_MDN_LEN   32
#define	LE_INFO_MAX_MDN_BYTES   33
#define	LE_INFO_MAX_MIN_LEN   32
#define	LE_INFO_MAX_MIN_BYTES   33
#define	LE_INFO_MAX_NAI_LEN   72
#define	LE_INFO_MAX_NAI_BYTES   73

Functions
void	le_info_ConnectService (void)
void	le_info_DisconnectService (void)
le_result_t	le_info_GetImei (char *imei, size_t imeiNumElements)
le_result_t	le_info_GetFirmwareVersion (char *version, size_t versionNumElements)
le_result_t	le_info_GetBootloaderVersion (char *version, size_t versionNumElements)
le_result_t	le_info_GetDeviceModel (char *modelPtr, size_t modelPtrNumElements)
le_result_t	le_info_GetMeid (char *meidStr, size_t meidStrNumElements)
le_result_t	le_info_GetEsn (char *esnStr, size_t esnStrNumElements)
le_result_t	le_info_GetMdn (char *mdnStr, size_t mdnStrNumElements)
le_result_t	le_info_GetPrlVersion (uint16_t *prlVersionPtr)
le_result_t	le_info_GetPrlOnlyPreference (bool *prlOnlyPreferencePtr)
le_result_t	le_info_GetMin (char *msisdnStr, size_t msisdnStrNumElements)
le_result_t	le_info_GetNai (char *naiStr, size_t naiStrNumElements)

Detailed Description

Legato Modem Information include file.

Copyright (C) Sierra Wireless Inc. Use of this work is subject to license.

Macro Definition Documentation

#define LE_INFO_IMEI_MAX_LEN   15

Maximum IMEI length (15 digits) One extra byte is added for the null character.

#define LE_INFO_MAX_ESN_LEN   32

Maximum length of an Electronic Serial Number (ESN) string.

#define LE_INFO_MAX_MDN_LEN   32

Maximum length of an Mobile Directory Number (MDN) string.

#define LE_INFO_MAX_MEID_LEN   32

Maximum length of an Mobile Equipment Identifier (MEID) string.

#define LE_INFO_MAX_MIN_LEN   32

Maximum length of an Mobile Station ISDN Number (MSISDN) string.

#define LE_INFO_MAX_MODEL_LEN   256

Maximum length of a model string

#define LE_INFO_MAX_NAI_LEN   72

Maximum length of an Mobile Station ISDN Number (NAI) string.

#define LE_INFO_MAX_VERS_LEN   256

Maximum length of a version string

Function Documentation

void le_info_ConnectService

(

void

)

Connect the client to the service

void le_info_DisconnectService

(

void

)

Disconnect the client from the service

le_result_t le_info_GetBootloaderVersion	(	char *	version,
		size_t	versionNumElements
	)

Get the bootloader version string

Returns

• LE_OK on success
• LE_NOT_FOUND if the version string is not available
• LE_OVERFLOW if version string to big to fit in provided buffer
• LE_FAULT for any other errors

Parameters

[out]	version	Bootloader version string
[in]	versionNumElements

le_result_t le_info_GetDeviceModel	(	char *	modelPtr,
		size_t	modelPtrNumElements
	)

Get the device model identity (Target Hardware Platform).

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The device model identity length exceed the maximum length.

Parameters

[out]	modelPtr	The model identity string (null-terminated).
[in]	modelPtrNumElements

le_result_t le_info_GetEsn	(	char *	esnStr,
		size_t	esnStrNumElements
	)

Get the CDMA Electronic Serial Number (ESN) of the device.

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The Electronic Serial Number length exceed the maximum length.

Parameters

[out]	esnStr	The Electronic Serial Number (ESN) of the device. string (null-terminated).
[in]	esnStrNumElements

le_result_t le_info_GetFirmwareVersion	(	char *	version,
		size_t	versionNumElements
	)

Get the firmware version string

Returns

• LE_OK on success
• LE_NOT_FOUND if the version string is not available
• LE_OVERFLOW if version string to big to fit in provided buffer
• LE_FAULT for any other errors

Parameters

[out]	version	Firmware version string
[in]	versionNumElements

le_result_t le_info_GetImei	(	char *	imei,
		size_t	imeiNumElements
	)

Retrieve the International Mobile Equipment Identity (IMEI).

Returns

LE_FAULT Function failed to retrieve the IMEI.

LE_OVERFLOW IMEI length exceed the maximum length.

LE_OK Function succeeded.

Note

If the caller passes a bad pointer into this function, it's a fatal error; the function will not return.

Parameters

[out]	imei	IMEI string.
[in]	imeiNumElements

le_result_t le_info_GetMdn	(	char *	mdnStr,
		size_t	mdnStrNumElements
	)

Get the CDMA Mobile Directory Number (MDN) of the device.

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The Mobile Directory Number length exceed the maximum length.

Parameters

[out]	mdnStr	The Mobile Directory Number (MDN) string (null-terminated).
[in]	mdnStrNumElements

le_result_t le_info_GetMeid	(	char *	meidStr,
		size_t	meidStrNumElements
	)

Get the CDMA device Mobile Equipment Identifier (MEID).

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The device Mobile Equipment identifier length exceed the maximum length.

Parameters

[out]	meidStr	The Mobile Equipment identifier (MEID) string (null-terminated).
[in]	meidStrNumElements

le_result_t le_info_GetMin	(	char *	msisdnStr,
		size_t	msisdnStrNumElements
	)

Get the CDMA Mobile Identification Number (MIN).

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The CDMA Mobile Identification Number length exceed the maximum length.

Parameters

[out]	msisdnStr	The Mobile Identification Number (MIN) string (null-terminated).
[in]	msisdnStrNumElements

le_result_t le_info_GetNai	(	char *	naiStr,
		size_t	naiStrNumElements
	)

Get the CDMA Network Access Identifier (NAI) string in ASCII text.

Returns

• LE_OK The function succeeded.
• LE_FAULT The function failed to get the value.
• LE_OVERFLOW The Network Access Identifier (NAI) length exceed the maximum length.

Parameters

[out]	naiStr	The Network Access Identifier (NAI) string (null-terminated).
[in]	naiStrNumElements

le_result_t le_info_GetPrlOnlyPreference

(

bool *

prlOnlyPreferencePtr

)

Get the CDMA Preferred Roaming List (PRL) only preferences status.

Returns

• LE_OK The function succeeded.
• LE_NOT_FOUND The information is not availble.
• LE_FAULT The function failed to get the value.

Parameters

[out]

prlOnlyPreferencePtr

The CDMA Preferred Roaming List only preferences status.

le_result_t le_info_GetPrlVersion

(

uint16_t *

prlVersionPtr

)

Get the CDMA version of Preferred Roaming List (PRL).

Returns

• LE_OK The function succeeded.
• LE_NOT_FOUND The information is not availble.
• LE_FAULT The function failed to get the value.

Parameters

[out]

prlVersionPtr

The Preferred Roaming List (PRL) version.