1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
SimManager hierarchy
===============
Service org.ofono
Interface org.ofono.SimManager
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Returns SIM properties for the modem object. See
the properties section for available properties.
void ChangePin(string type, string oldpin, string newpin)
Changes the pin given by string type.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
void EnterPin(string type, string pin)
Enters the currently pending pin. The type value must
match the pin type being asked in the PinRequired
property.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
void ResetPin(string type, string puk, string newpin)
Provides the unblock key to the modem and if correct
resets the pin to the new value of newpin.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
void LockPin(string type, string pin)
Activates the lock for the particular pin type. The
device will ask for a PIN automatically next time the
device is turned on or the SIM is removed and
re-inserted. The current PIN is required for the
operation to succeed.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
void UnlockPin(string type, string pin)
Deactivates the lock for the particular pin type. The
current PIN is required for the operation to succeed.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
array{byte} GetIcon(byte id)
Obtain the icon given by id. Only ids greater than 1
are valid. XPM format is currently used to return the
icon data.
Possible Errors: [service].Error.NotImplemented
[service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.Failed
Signals PropertyChanged(string name, variant value)
This signal indicates a changed value of the given
property.
Properties boolean Present [readonly]
True if a SIM card is detected. There are
no other properties if false.
string SubscriberIdentity [readonly, optional]
Contains the IMSI of the SIM, if available.
string MobileCountryCode [readonly, optional]
Contains the Mobile Country Code (MCC) of the home
network (not to be confused with the currently
registered network reported on NetworkRegistration
interface) and is read directly from the SIM if
available.
string MobileNetworkCode [readonly, optional]
Contains the Mobile Network Code (MNC) of the home
network (not to be confused with the currently
registered network reported on NetworkRegistration
interface) and is read directly from the SIM if
available.
array{string} SubscriberNumbers [readwrite]
Contains the list of subscriber numbers. This is
usually stored in the EFmsisdn sim file.
array{string} PreferredLanguages [readonly, optional]
Contains the list of preferred languages from the SIM,
if available.
dict{string,string} ServiceNumbers [readonly, optional]
Contains a dictionary of service dialing numbers from
the SIM, if available.
string PinRequired [readonly]
Contains the string type of the pin required by the
modem. The possible values are:
"none" - Nothing is required
"pin" - SIM PIN is required
"phone" - Phone-to-SIM PIN is required
"firstphone" - Phone-to-very-first SIM
PIN is required
"pin2" - SIM PIN2 is required
"network" - Network Personalization password is
required
"netsub" - Network subset personalization
password is required
"service" - Service Provider personalization
password is required
"corp" - Corporate personalization password
is required
"puk" - SIM PUK is required
"firstphonepuk" - Phone-to-very-first SIM PUK is
required
"puk2" - SIM PUK2 is required
"networkpuk" - Network personalization unblocking
password is required
"netsubpuk" - Network subset personalization
unblocking password is required
"servicepuk" - Service provider personalization
unblocking password is required
"corppuk" - Corporate personalization unblocking
password is required
array{string} LockedPins [readonly]
Contains the pins that are currently locked and will
require the user to enter the password at startup.
Using LockPin and UnlockPin will result in changes to
this property.
The list contains elements of the same format as the
PinRequired property.
string CardIdentifier [readonly]
Contains the Integrated Circuit Card Identifer (ICCID)
which is read directly from the SIM.
boolean FixedDialing [readonly]
True if Fixed Dialing service is enabled in SIM card.
If FDN is enabled, oFono halts the SIM initialization
procedure and only emergency calls are allowed.
boolean BarredDialing [readonly]
True if Barred Dialing service is enabled in SIM card.
If BDN is enabled, oFono halts the SIM initialization
procedure and only emergency calls are allowed.
dict{string,byte} Retries [readonly]
Contains all the retry counters available. The possible
values for the first field are the same as in
PinRequired property. The second field contains is the
counter for that pin type.
This property is updated after each operation that
might have changed the retry counters, i.e. calls to
ChangePin(), EnterPin(), ResetPin() LockPin(),
UnlockPin().
|
