Chapter 7 – Security Commands
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I)
40
Chapter 7 – Security
Commands
Enter PIN +CPIN
Description:
This command enters the ME passwords (CHV1 / CHV2 / PUK1 / PUK2, etc.), that are required before
any ME functionality can be used.
CHV1/CHV2
is between
4
and
8
digits long,
PUK1/PUK2
is
only
8
digits
long.
If the user application tries to make an outgoing call before the SIM PIN code (CHV1) has been
confirmed, then the product will refuse the “ATD” command with a “+CME ERROR: 11” (SIM PIN
required).
The application is responsible for checking the PIN after each reset or power on - if the PIN was
enabled.
Values:
<pin>
is the Personal Identification Number. A four-digit number.
<puk>
is the Personal Unblocking Key needed to change the PIN. An eight-digit number.
Syntax:
AT+CPIN=<pin>
Command
Possible responses
AT+CPIN=1234
Note: Enter PIN
OK
Note: PIN code is correct
AT+CPIN=5678
Note: Enter PIN
+CME ERROR: 3
Note: Operation not allowed, PIN previously entered
After 3 unsuccessful attempts to enter the PIN (Personal Identification Number), the PUK (Personal
Unblocking Key) will be required.
PUK validation forces the user to enter a new PIN code as a second parameter and this will be the new
PIN code if PUK validation succeeds. CHV1 is then enabled if PUK1 is correct. The application
therefore uses this command:
AT+CPIN=<Puk>,<NewPin>
Command
Possible responses
AT+CPIN=00000000,1234
Note: Enter PUK and new PIN
+CME ERROR: 16
Note: Incorrect PUK
AT+CPIN=12345678,1234
Note: Enter PUK and new PIN, 2nd attempt
OK
Note: PUK correct, new PIN stored
To determine which code must be entered (or not), the following query command can be used:
AT+CPIN?
The possible responses are:
+CPIN: READY
ME is not pending for any password
+CPIN: SIM PIN
CHV1 is required
+CPIN: SIM PUK
PUK1 is required
+CPIN: SIM PIN2
CHV2 is required
+CPIN: SIM PUK2
PUK2 is required
+CPIN: PH-SIM PIN
SIM lock (phone-to-SIM) is required
+CPIN: PH-NET PIN
Network personnalisation is required
+CME ERROR: <err>
SIM failure (13) absent (10) etc.
Please note that in this case the mobile equipment does not end its response with the OK string.
The reCME ERROR: 13 (SIM failure) is returned after 10 unsuccessful PUK attempts. The SIM
card is then out of order and must be replaced by a new one.