User`s manual

W406-LX Linux User’s Manual Programmer’s Guide
6-15
When the SIM card status is set to PIN (2), this function retrieves the available PIN code attempt
count.
If the SIM card status is set to PUK (3), this function gets the available PUK code attempt count.
int cellular_modem_sim_get_pin_attempt_count(unsigned int fd);
Inputs:
<fd> the cellular modem
Return Values:
The attempted count left of PIN/PUK code authentication. otherwise, a negative value indicates a
failure
Remark:
When the SIM card status is set to PIN (2), this function authenticates a PIN code. If the correct
code is entered the status will be set back to ready (0).
int cellular_modem_sim_authenticate_pin_code(unsigned int fd, char *pin_code);
Inputs:
<fd> the cellular modem
<pin_code> point to the PIN code
Return Values:
0 on success, otherwise, the function fails
Remark:
When the SIM card status is PUK (3), this function changes the status to PIN (2).
If this fails, the SIM card will be locked.
int cellular_modem_sim_unlock_pin_code(unsigned int fd, char *passwd, char
*new_pin_code);
Inputs:
<fd> the cellular modem
<passwd> point to the PUK passwd code
<new_pin_code> point to a new PIN code
Return Values:
0 on success, otherwise, the function fails
Remark:
Gets the PIN code enable status of the SIM card.
int cellular_modem_sim_get_pin_enable_status (unsigned int fd);
Inputs:
<fd> the cellular modem
Return Values:
0 : PIN code disabled
1 : PIN code enabled
otherwise, the function fails
Remark: