summaryrefslogtreecommitdiffstats
path: root/doc/sim-api.txt
blob: f87dbebbca92af098f952b428d366af214f175ae (plain)
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
SimManager hierarchy
===============

Service		org.ofono
Interface	org.ofono.SimManager
Object path	[variable prefix]/{modem0,modem1,...}

Methods		dict GetProperties()

			Returns properties for the modem object. See
			the properties section for available properties.

			Possible Errors: [service].Error.InvalidArguments

		ChangePin(string type, string oldpin, string newpin)

			Changes the pin given by string type.

		EnterPin(string type, string pin)

			Enters the currently pending pin.  The type value must
			match the pin type being asked in the PinRequired
			property.

		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.

		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-inserter.  The current PIN is required for the
			operation to succeed.

		UnlockPin(string type, string pin)

			Deactivates the lock for the particular pin type.  The
			current PIN is required for the operation to succeed.

Signals		PropertyChanged(string name, variant value)

			This signal indicates a changed value of the given
			property.

Properties	string SubscriberIdentity [readonly, optional]

			Contains the ISMI of the SIM, if available

		uint8 MobileNetworkCodeLength [readonly, optional]

			Contains the length of the MNC (2 or 3 digits)

		array{string} SubscriberNumbers [readwrite]

			Contains the list of subscriber numbers.  This is
			usually stored in the EFmsisdn sim file.

		dict 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