RE: UIM manager atom APIs review request

[Zhang, Caiwen <Caiwen.Zhang@windriver.com>]

[-- Attachment #1: Type: text/plain, Size: 4370 bytes --]

Hi andrzej,

> -----Original Message-----
> From: ofono-bounces(a)ofono.org [mailto:ofono-bounces(a)ofono.org] On
> Behalf Of andrzej zaborowski
> Sent: Friday, August 20, 2010 10:14 PM
> To: ofono(a)ofono.org
> Subject: Re: UIM manager atom APIs review request
> 
> Hi Caiwen,
> 
> On 19 August 2010 05:46, Zhang, Caiwen <Caiwen.Zhang@windriver.com>
> wrote:
> > Hi all,
> >
> > I am going to implement an UIM manager atom for CDMA extension. Its
> APIs will be almost the same as
> > current SIM manger atom's APIs.  But I suggest maybe will can do some
> changes:
> >
> >        1. Add PIN remain retry count support
> >        2. replace properties 'Present' 'PinRequired' and 'LockedPins'
> with a new add property 'Status'
> >
> > Properties      string Status [readonly]
> >
> >                        Contains the string type of the status of the
> SIM.
> >                        The possible values are:
> >                        "ready" - Not waiting for a password
> >                        "pin" - SIM PIN is required
> >                        "phone" - Phone-to-SIM PIN is required  [GSM
> only]
> >                        "firstphone" - Phone-to-very-first SIM
> >                                                PIN is required  [GSM
> only]
> >                        "pin2" - SIM PIN2 is required
> >                        "network" - Network Personalization password
> is
> >                                                required  [GSM only]
> >                        "netsub" - Network subset personalization
> >                                                password is
> required  [GSM only]
> >                        "service" - Service Provider personalization
> >                                                password is
> required  [GSM only]
> >                        "corp" - Corporate personalization password
> >                                                is required  [GSM only]
> >                        "puk" - SIM PUK is required
> >                        "firstphonepuk" - Phone-to-very-first SIM PUK
> is
> >                                                required  [GSM only]
> >                        "puk2" - SIM PUK2 is required
> >                        "networkpuk" - Network personalization
> unblocking
> >                                                password is
> required  [GSM only]
> >                        "netsubpuk" - Network subset personalization
> >                                                unblocking password is
> required  [GSM only]
> >                        "servicepuk" - Service provider
> personalization
> >                                                unblocking password is
> required  [GSM only]
> >                        "corppuk" - Corporate personalization
> unblocking
> >                                                password is
> required  [GSM only]
> >                        "absent" - No SIM inserted
> 
> This API does not convey the information that LockedPINs conveys.
> LockedPINs can be useful if you wanted a settings application that can
> enable and disable PIN authentication.
> 

Sorry, I misunderstand 'LockedPINs' property's meaning. 

If so, we should initialize its value at the first time SIM is ready. I see 
currently, its value is initialized with the result of +CPIN?
If it is used as the purpose that you said, it should be +CLCK=<pin type>,2

Besides, the possible values of this property are: "pin","phone","firstphone"
"pin2","network","netsub","service","corp". It can't be other puk relative values.
	

Maybe we can use a method to replace this property. Such as:
	Boolean GetPinLock(string type) 
If the return value is TURE, means PIN authentication is enabled, otherwise,
Means PIN authentication is disabled.


Thanks!

Best regards,
Caiwen