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
198
199
|
SimToolkit Hierarchy [experimental]
===============
Service org.ofono
Interface org.ofono.SimToolkit
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Returns properties for the SimToolkit object. See the
properties section for available properties.
Possible Errors: [service].Error.InvalidArguments
array{byte} GetIcon(byte id)
Returns the icon data for icon identified by id.
Possible Errors: [service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.NotFound
void SelectItem(byte item, object agent)
Selects an item from the main menu, thus triggering
a new user session. The agent parameter specifies
a new agent to be used for the duration of the
user session.
void RegisterAgent(object path)
Registers a default agent to be used for SIM initiated
actions such as Display Text, Get Inkey or Get Input.
These can typically occur when a special SMS is
received and might not involve interaction from the
user.
Possible Errors: [service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.InUse
void UnregisterAgent(object path)
Unregisters the default agent. If no agent is
registered then unsolicited commands from the SIM
are rejected.
Possible Errors: [service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.NotFound
[service].Error.NotAuthorized
Properties string IdleText
Contains the text to be used when the home screen is
idle. This text is set by the SIM and can be changed
at any time.
array{struct{string, byte}} MainMenu
Contains the items that make up the main menu. This
is populated by the SIM when it sends the Setup Menu
Proactive Command. The main menu is always available,
but its contents can be changed at any time.
string MainMenuTitle
Contains the title of the main menu.
array{byte} Icons
Contains the identifiers of all available icons for
this SIM.
SimToolkitAgent Hierarchy [experimental]
===============
Service unique name
Interface org.ofono.SimToolkitAgent
Object path freely definable
Methods byte RequestSelection(string title, byte icon_id,
array{struct(string, byte)} items,
byte default)
Tells the agent to ask the user to select an item
from the menu. This function should return the index
of the item or an error given below:
Possible Errors: [service].Error.SimToolkit.GoBack
Implementation notes:
- Data / Navigation type not indicated
- Soft key preferred not indicated
- Help available ignored
void DisplayText(string text, byte icon_id, boolean urgent)
Tells the agent to display text from the SIM. The
boolean urgent parameter tells the agent whether this
is an urgent message and all other messages should be
cleared prior to the display of this text.
Possible Errors: [service].Error.SimToolkit.GoBack
Implementation notes:
- High / normal priority indicated by urgent
- The clear message after delay / wait for user to
clear flags are handled as follows. If the wait for
user flag is set, then oFono sets a higher timeout
for the Agent DisplayText method call. It will then
call Cancel() on the agent after this timeout
expires and the "No response from user" terminal
response is sent. If the agent returns earlier from
this method call, a terminal response "Command
"performed successfully" is sent.
It might be required to pass a flag to the UI to
hint it that allocation of an 'acknowledgement'
button is required in the case of a longer timeout.
However, the UI can figure this out itself as well
based on a timer threshold. More input needed.
- Immediate Response indication is handled internally,
terminal response is sent immediately and no other
indication is given to the user / agent. Response
from this method call is ignored and a short
timeout is used for the method call. Once another
proactive command arrives, and the DisplayText is
still pending, Cancel() is called.
string RequestInput(string alpha, byte icon_id,
string default, byte min, byte max,
boolean hide_typing)
Tells the agent to request an input string from the
user. The alpha parameter and icon_id gives context
to the user. The default string contains the suggested
default by the SIM. The min and max parameters contain
how many characters the user should enter. The
parameter hide_typing indicates whether user's typing
should be opaque.
Possible Errors: [service].Error.SimToolkit.GoBack
Implementation notes:
- It is still unclear how to handle gsm vs ucs2
accepted alphabet selection. Can the reduced
character set functionality from SMS be applied
here? If not, then an extra gsm vs ucs2 acceptance
argument needs to be added.
string RequestDigits(string alpha, byte icon_id,
string default, byte min, byte max,
boolean hide_typing)
Same as GetInput but only digit characters (0-9, *#+)
are expected.
Possible Errors: [service].Error.SimToolkit.GoBack
string RequestKey(string alpha, byte icon_id)
Tells the agent to request a single input key from
the user. The alpha parameter contains the context
for the request.
Possible Errors: [service].Error.SimToolkit.GoBack
string RequestDigit(string alpha, byte icon_id)
Same as above, but only digits (0-9, *#+) are
expected.
Possible Errors: [service].Error.SimToolkit.GoBack
boolean RequestConfirmation(string alpha, byte icon_id)
Asks the agent to get confirmation from the user.
Possible Errors: [service].Error.SimToolkit.GoBack
void Cancel()
Asks the agent to cancel any ongoing operation in
progress. This is usually either because the agent
is taking too long to respond or the Sim Application
has terminated the session.
void Release()
Agent is being released, possibly because of oFono
terminating, SimToolkit interface torn down or modem
off. If the agent is registered as a global agent,
no UnregisterAgent call is expected.
|
