AT_CellularInformation Class Reference

Class AT_CellularInformation. More...

#include <AT_CellularInformation.h>

Inheritance diagram for AT_CellularInformation:

Public Member Functions
virtual nsapi_error_t	get_manufacturer (char *buf, size_t buf_size)
	Request manufacturer identification of cellular device. More...
virtual nsapi_error_t	get_model (char *buf, size_t buf_size)
	Request model identification of cellular device. More...
virtual nsapi_error_t	get_revision (char *buf, size_t buf_size)
	Request revision identification of cellular device. More...
virtual nsapi_error_t	get_serial_number (char *buf, size_t buf_size, SerialNumberType type)
	Request serial number identification of cellular device. More...
virtual nsapi_error_t	get_imsi (char *imsi, size_t buf_size)
	Get IMSI from the sim card. More...
virtual nsapi_error_t	get_iccid (char *buf, size_t buf_size)
	Get serial number from the SIM card. More...

Protected Member Functions
nsapi_error_t	get_info (const char *cmd, char *buf, size_t buf_size)
	Request information text from cellular device. More...

Detailed Description

Class AT_CellularInformation.

Class that provides information about cellular device.

Definition at line 39 of file AT_CellularInformation.h.

Member Function Documentation

get_manufacturer()

virtual nsapi_error_t get_manufacturer ( char *  buf, size_t  buf_size  )

virtual

Request manufacturer identification of cellular device.

Parameters

buf	manufacturer identification as zero terminated string
buf_size	max length of manufacturer identification is 2048 characters

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if buf is null or buf_size is zero NSAPI_ERROR_DEVICE_ERROR on failure

Implements CellularInformation.

get_model()

virtual nsapi_error_t get_model ( char *  buf, size_t  buf_size  )

virtual

Request model identification of cellular device.

Parameters

buf	model identification as zero terminated string
buf_size	max length of model identification is 2048 characters

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if buf is null or buf_size is zero NSAPI_ERROR_DEVICE_ERROR on failure

Implements CellularInformation.

get_revision()

virtual nsapi_error_t get_revision ( char *  buf, size_t  buf_size  )

virtual

Request revision identification of cellular device.

Parameters

buf	revision identification as zero terminated string
buf_size	max length of revision identification is 2048 characters

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if buf is null or buf_size is zero NSAPI_ERROR_DEVICE_ERROR on failure

Implements CellularInformation.

get_serial_number()

virtual nsapi_error_t get_serial_number ( char *  buf, size_t  buf_size, SerialNumberType  type  )

virtual

Request serial number identification of cellular device.

Parameters

buf	serial number as zero terminated string
buf_size	max length of serial number is 2048 characters
type	serial number type to read

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if buf is null or buf_size is zero NSAPI_ERROR_UNSUPPORTED if the modem does not support SerialNumberType NSAPI_ERROR_DEVICE_ERROR on other failures

Implements CellularInformation.

get_imsi()

virtual nsapi_error_t get_imsi ( char *  imsi, size_t  buf_size  )

virtual

Get IMSI from the sim card.

Remarks

Given imsi buffer length must be 16 or more as imsi max length is 15!

Parameters

imsi	preallocated char* which after successful request contains imsi
buf_size	size of imsi buffer

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if imsi is null or buf_size is zero or buf_size is smaller than MAX_IMSI_LENGTH + 1 NSAPI_ERROR_DEVICE_ERROR on other failures

Implements CellularInformation.

get_iccid()

virtual nsapi_error_t get_iccid ( char *  buf, size_t  buf_size  )

virtual

Get serial number from the SIM card.

Parameters

buf	SIM ICCID as zero terminated string
buf_size	max length of SIM ICCID is MAX_ICCID_LENGTH

Returns

NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if buf is null or buf_size is zero NSAPI_ERROR_DEVICE_ERROR on failure

Implements CellularInformation.

Reimplemented in GEMALTO_CINTERION_CellularInformation.

get_info()

nsapi_error_t get_info ( const char *  cmd, char *  buf, size_t  buf_size  )

protected

Request information text from cellular device.

Parameters

cmd	3gpp command string
buf	buffer for response
buf_size	buffer size

Returns

on success read character count, on failure negative error code