Kenji Arai / TYBLE16_mbedlized_os5_several_examples_1st

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   nRF51_Vdd TextLCD BME280

Embed: (wiki syntax)

« Back to documentation index

CellularSIM Class Reference
Public Member Functions | Protected Member Functions

CellularSIM Class Reference

Class CellularSIM. More...

#include <CellularSIM.h>

Inherited by AT_CellularSIM.

Public Member Functions

virtual nsapi_error_t set_pin (const char *sim_pin)=0
 Open the SIM card by setting the pin code for SIM.
virtual nsapi_error_t change_pin (const char *sim_pin, const char *new_pin)=0
 Change SIM pin code.
virtual nsapi_error_t set_pin_query (const char *sim_pin, bool query_pin)=0
 Change is pin query needed after boot.
virtual nsapi_error_t get_sim_state (SimState &state)=0
 Get SIM card's state.
virtual nsapi_error_t get_imsi (char *imsi)=0
 Get IMSI from the sim card.
virtual nsapi_error_t get_iccid (char *buf, size_t buf_size)=0
 Get serial number from the SIM card.

Protected Member Functions

virtual ~CellularSIM ()
 virtual Destructor

Detailed Description

Class CellularSIM.

An abstract interface for SIM card handling.

Definition at line 35 of file CellularSIM.h.

Constructor & Destructor Documentation

virtual ~CellularSIM (  ) [protected, virtual]

virtual Destructor

Definition at line 43 of file CellularSIM.h.

Member Function Documentation

virtual nsapi_error_t change_pin ( const char *  sim_pin,
const char *  new_pin 
) [pure virtual]

Change SIM pin code.

Parameters:
sim_pinCurrent PIN for SIM
new_pinNew PIN for SIM
Returns:
NSAPI_ERROR_OK on success NSAPI_ERROR_DEVICE_ERROR on failure

Implemented in AT_CellularSIM.

virtual nsapi_error_t get_iccid ( char *  buf,
size_t  buf_size 
) [pure 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_DEVICE_ERROR on failure

Implemented in AT_CellularSIM.

virtual nsapi_error_t get_imsi ( char *  imsi ) [pure 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
Returns:
NSAPI_ERROR_OK on success NSAPI_ERROR_PARAMETER if imsi if null NSAPI_ERROR_DEVICE_ERROR on other failures

Implemented in AT_CellularSIM.

virtual nsapi_error_t get_sim_state ( SimState &  state ) [pure virtual]

Get SIM card's state.

Parameters:
statecurrent state of SIM
Returns:
NSAPI_ERROR_OK on success NSAPI_ERROR_DEVICE_ERROR on failure

Implemented in AT_CellularSIM.

virtual nsapi_error_t set_pin ( const char *  sim_pin ) [pure virtual]

Open the SIM card by setting the pin code for SIM.

Parameters:
sim_pinPIN for the SIM card
Returns:
NSAPI_ERROR_OK on success NSAPI_ERROR_DEVICE_ERROR on failure

Implemented in AT_CellularSIM.

virtual nsapi_error_t set_pin_query ( const char *  sim_pin,
bool  query_pin 
) [pure virtual]

Change is pin query needed after boot.

Parameters:
sim_pinValid PIN for SIM card
query_pinFalse if PIN query not needed, True if PIN query needed after boot.
Returns:
NSAPI_ERROR_OK on success NSAPI_ERROR_DEVICE_ERROR on failure

Implemented in AT_CellularSIM.

Generated on Tue Jul 12 2022 15:16:19 by  doxygen 1.7.2