Security commands – Westermo GD-01 User Manual

Page 34

Advertising
background image

34

6196-2220

Security commands

+CPIN – Enter PIN

Description:

This command is used to enter 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.

Syntax:

AT+CPIN=<pin>

Command example

Possible responses

Note

AT+CPIN=1234 OK

Enter

PIN, result: PIN

code is correct

AT+CPIN=5678

+CME ERROR: 3

Enter PIN, 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 valida-
tion succeeds. CHV1 is then enabled if PUK1 is correct.

The application therefore uses this command:
AT+CPIN=<Puk>,<NewPin>

Command example

Possible responses

Note

AT+CPIN=00000000,1234

+CME ERROR: 16

Enter PUK and new PIN,
result: Incorrect PUK

AT+CPIN=12345678,1234

OK

Enter PUK and new PIN,
2nd attempt, PUK
correct, new PIN stored

To ascertain 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.

B A C K

Advertising