Chapter 5 - Security Commands; At+Cpin Pin Authentication - Multi-Tech MultiModem EDGE Reference Manual

Chapter 5 – Security Commands
The AT Commands described in this chapter allow the external application to determine various security related
settings.

5.1 AT+CPIN PIN Authentication

AT+CPIN controls network authentication of the Multi-Tech wireless modem.
Description:
The read command returns an alphanumeric string indicating whether or not network
authentication is required.
The write command allows the Multi-Tech wireless modem to store the entered password. This
may be for example the SIM PIN1 to register to the GSM network, or the SIM PUK1 to replace
a disabled SIM PIN1 with a new one, or the PH-SIM PIN if the client has taken precautions for
preventing damage in the event of loss or theft etc.
If no PIN1 request is pending (for example if PIN1 authentication has been done and the same
PIN1 is entered again), the Multi-Tech wireless modem responds "+CME ERROR: operation
not allowed"; no further action is required.
Each time a password is entered with AT+CPIN the module starts reading data from the SIM.
The duration of reading varies with the SIM card. This may cause a delay of several seconds
before all commands which need access to SIM data are effective. See Section 20.1,
Restricted access to SIM data after SIM PIN authentication for further detail.
Test Command Syntax:
Response:
Read Command Syntax:
Response:
Write Command Syntax:
Response:
Parameter Descriptions:
<pin>
Password (string type), usually SIM PIN1.
If the requested password was a PUK, such as SIM PUK1 or PH-FSIM PUK or another password, then <pin>
must be followed by <new pin>.
<new pin>
If the requested code was a PUK: specify a new password or restore the former disabled password. See Section
5.1.1, What to do if PIN or password authentication fails? for more information about when you may need to
enter the PUK.
<code>
SIM PIN authentication
READY PIN has already been entered. No further entry needed.
SIM PIN ME is waiting for SIM PIN1.
SIM PUK ME is waiting for SIM PUK1 if PIN1 was disabled after three failed attempts to enter PIN1.
SIM PIN2 ME is waiting for PIN2. This is only applicable when an attempt to access a PIN2 related
feature was acknowledged with +CME ERROR: 17 ("SIM PIN2 required"), for example when
the client attempts to edit the FD phonebook). In this case the read command AT+CPIN? also
prompts for SIM PIN2. Normally, the AT+CPIN2 command is intended for SIM PIN2.
SIM PUK2 ME is waiting for PUK2 to unblock a disabled PIN2. As above, this is only necessary when the
preceding command was acknowledged with +CME ERROR:
18 ("SIM PUK2 required") and only if the read command AT+CPIN? also prompts for SIM
PUK2. Normally, the AT+CPIN2 command is intended for SIM PUK2.
Phone security locks set by client or factory
PH-SIM PIN ME is waiting for phone-to-SIM card password if "PS" lock is active and the client inserts other
SIM card than the one used for the lock. ("PS" lock is also referred to as phone or antitheft
lock).
PH-SIM PUK ME is waiting for Master Phone Code, if the above "PS" lock password was incorrectly entered
three times.
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371G)
AT+CPIN=?
OK
AT+CPIN?
+CPIN: <code>
OK
ERROR
+CME ERROR: <err>
AT+CPIN=<pin>[, <new pin>]
OK
ERROR
+CME ERROR: <err>
Chapter 5 – Security Commands
64