gsmSIMLocked (Function)

Top  Previous  Next

Architecture:

X32 / NX32 / NX32L

Device support:

All

Firmware version:

1.00 / 1.00.00


Depending on the device this function returns whether the SIM card is locked in place or the tray is inserted.

 

Notice: On devices where the SIM card slot is a lid-type, this function will return TRUE when the SIM card is present (see gsmSIMPresent).
 

Input:

None.

 

Returns: BOOL

TRUE:

The SIM card is locked in place  / The SIM card tray is inserted.

FALSE:

The SIM card is not locked in place / The SIM card tray is removed.

 

Declaration:

FUNCTION gsmSIMLocked : BOOL;

 

 

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
BEGIN
  ...
  // Check for successful insertion of SIM card
  IF gsmSIMPresent() AND gsmSIMLocked() THEN
     // OK
     ...
  ELSE
     // Not inserted and locked
     ...
  END_IF;
END;
 
END_PROGRAM;