Kenji Arai / mbed-os_TYBLE16

Dependents:   TYBLE16_simple_data_logger TYBLE16_MP3_Air

Embed: (wiki syntax)

« Back to documentation index

AT_CellularInformation Class Reference

AT_CellularInformation Class Reference

Class AT_CellularInformation. More...

#include <AT_CellularInformation.h>

Inherits mbed::CellularInformation.

Inherited by GEMALTO_CINTERION_CellularInformation, QUECTEL_BC95_CellularInformation, QUECTEL_BG96_CellularInformation, and QUECTEL_M26_CellularInformation.

Public Types

enum  SerialNumberType
 

Request serial number identification of cellular device.

More...

Public Member Functions

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

Protected Member Functions

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

Detailed Description

Class AT_CellularInformation.

Class that provides information about cellular device.

Definition at line 32 of file AT_CellularInformation.h.


Member Enumeration Documentation

enum SerialNumberType [inherited]

Request serial number identification of cellular device.

Parameters:
bufserial number as zero terminated string
buf_sizemax length of serial number is 2048 characters
typeserial 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

Definition at line 89 of file CellularInformation.h.


Member Function Documentation

nsapi_error_t get_iccid ( char *  buf,
size_t  buf_size 
) [virtual]

Get serial number from the SIM card.

Parameters:
bufSIM ICCID as zero terminated string
buf_sizemax 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.

Definition at line 94 of file AT_CellularInformation.cpp.

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:
imsipreallocated char* which after successful request contains imsi
buf_sizesize 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.

Definition at line 81 of file AT_CellularInformation.cpp.

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

Request information text from cellular device.

Parameters:
cmd3gpp command string
bufbuffer for response
buf_sizebuffer size
Returns:
on success read character count, on failure negative error code

Definition at line 65 of file AT_CellularInformation.cpp.

nsapi_error_t get_manufacturer ( char *  buf,
size_t  buf_size 
) [virtual]

Request manufacturer identification of cellular device.

Parameters:
bufmanufacturer identification as zero terminated string
buf_sizemax 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.

Definition at line 33 of file AT_CellularInformation.cpp.

nsapi_error_t get_model ( char *  buf,
size_t  buf_size 
) [virtual]

Request model identification of cellular device.

Parameters:
bufmodel identification as zero terminated string
buf_sizemax 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.

Definition at line 38 of file AT_CellularInformation.cpp.

nsapi_error_t get_revision ( char *  buf,
size_t  buf_size 
) [virtual]

Request revision identification of cellular device.

Parameters:
bufrevision identification as zero terminated string
buf_sizemax 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.

Definition at line 43 of file AT_CellularInformation.cpp.