72f40be1b4b14ff8d5057eeac130848b2d12fc93
[platform/upstream/ofono.git] / doc / features.txt
1 oFono - Open Source Telephony
2 *****************************
3
4 Purpose
5 =======
6
7 The purpose of this document is to enumerate all major functionality areas
8 of oFono.  In effect, this document will serve as the primary, up to date
9 source of oFono feature information.  It is intended for developers, managers
10 and users alike to quickly gauge the progress of the project and feature
11 availability.
12
13 Sim Toolkit
14 ===========
15
16 Supported Proactive Commands:
17
18 - Display Text proactive command support.  Upon receiving the proactive
19   command notification oFono decodes it, including performing character
20   conversion from packed/unpacked GSM 7bit and UCS2 to UTF-8 encoded text.
21   The registered agent is then called using the DisplayText method on the
22   SimToolkitAgent interface to handle the user interaction aspects.
23
24   SIM-specified duration are handled.  If immediate response to the SIM
25   is required, oFono sends a terminal response immediately.  DisplayText
26   method is still executed normally, until a timeout occurs or a new
27   proactive command arrives from the SIM.
28
29 - Get Inkey proactive command support.  When this command is received,
30   oFono decodes it and checks what "flavor" it is.  Depending on this, the
31   SimToolkitAgent is called with a different method call:
32         * If the Get Inkey flavor indicates that this is a simple Yes/No
33           confirmation, then the RequestConfirmation method is called.
34         * If the Get Inkey flavor indicates that the SIM only expects digits,
35           then the RequestDigit method is called.
36         * Otherwise the RequestKey method is called
37
38   SIM specified durations are handled, if the user agent does not respond
39   in the time allowed, then the 'No Response' Terminal Response is generated
40   automatically.
41
42 - Get Input proactive command support.  When this command is received,
43   oFono decodes it and checks what "flavor" it is.  Depending on this, the
44   SimToolkitAgent is called with a different method call:
45         * If the Get Input flavor indicates that the SIM only expects digits,
46           then the RequestDigits method is called.
47         * Otherwise the RequestInput method is called
48
49 - More Time proactive command support.  This command is intended to notify
50   that the SIM is still busy processing a command.  For oFono, this proactive
51   command is a no-op.  It is always replied to successfully.
52
53 - Setup Menu proactive command support. When this command is received, oFono
54   parses the new main menu structure and updates its MainMenu and MainMenuTitle
55   properties which reflect the items, icons and the alpha text of the
56   proactive command.  Soft key support and menu help system are ignored by
57   oFono.
58
59 - Select Item proactive command support.  When this command is received, oFono
60   decodes it and dispatches it to the SimToolkitAgent by calling the
61   RequestSelection method.  This method is passed the menu selection title,
62   the selectable items and the default, if any.
63
64 - Timer Management proactive command support.  oFono supports starting,
65   stopping and querying timer state flavors of this command.  Up to eight
66   timers are supported.  This proactive command is handled completely
67   inside oFono and no external user interaction is required.
68
69 - Set Up Idle Mode Text proactive command support.  Whenever oFono receives
70   this proactive command, it updates the IdleText property on the main
71   SimToolkit interface.  Indications that this property has changed are
72   handled by the usual means.
73
74 - Send DTMF proactive command.  Whenever oFono receives the Send DTMF command,
75   it checks that there are calls in progress and DTMF is possible.  If so,
76   DTMF characters are passed to the voicecall atom to be transmitted to the
77   modem.  The appropriate terminal response is sent to the SIM once the DTMF
78   tones have been played or the call has been disconnected.
79
80   NOTE: This command can also be handled by the modem.
81
82 - Play Tone proactive command.  Whenever oFono receives a Play Tone proactive
83   command it checks whether the tone is to be continuous/looped or played once.
84   It then calls the SimToolkitAgent PlayTone or LoopTone method as appropriate.
85   The sound that will be played will be determined based on the sound type
86   that is passed to the agent.  It is up to the system integrator to provide
87   the appropriate sounds.
88
89 - Send USSD proactive command.  Whenever oFono receives a Send USSD proactive
90   command it checks whether there are any USSD / SS operations in progress.
91   If an operation is in progress, the appropriate terminal response is sent
92   without performing the Send USSD operation.  Otherwise the USSD string
93   is sent to the network, and the response is sent back to the SIM in the
94   terminal response.
95
96   NOTE: This command can also be handled by the modem.
97
98 - Language Notification proactive command. Whenever oFono receives a Language
99   Notification proactive command, it prints the language code and sends
100   terminal response to the SIM immediately.
101
102 - Provide Local Information proactive command.  Whenever oFono receives a
103   Provide Local Information proactive command, it checks the type of the
104   information requested.  If the information is about the time/date or the
105   language of the terminal, it responds to the command with the appropriate
106   terminal response. The time/date information is obtained using localtime().
107   The language information is obtained by checking the LANG environment
108   variable.  All other information requests are expected to be handled by
109   the modem.
110
111 - Send Short Message proactive command.  Whenever oFono receives a Send SMS
112   proactive command, it parses the PDU and submits it to the outgoing SMS
113   queue.  A terminal response is sent to the SIM When the raw PDU has been
114   sent, or failed to be sent.
115
116   NOTE: This command can also be handled by the modem.
117
118 - Set Up Call proactive command.  When oFono receives a Set Up Call proactive
119   command, it checks whether the UICC has indicated that the user should be
120   informed.  In this case the SimToolkitAgent is called with the
121   ConfirmCallSetup method.  If the user has authorized the operation, or if
122   the user's confirmation was not indicated oFono will setup the call and
123   optionally inform the user.  The information sent by the SIM will be
124   available on the resulting voice call object.  The relevant properties are
125   Information and Icon.
126
127   NOTE: This command can also be handled by the modem.
128
129 - Refresh proactive command.  The specification defines 7 types
130   of Refresh requests:
131         - NAA Initialization
132         - NAA File Change Notification
133         - NAA Initialization and File Change Notification
134         - NAA Initialization and Full File Change Notification
135         - UICC Reset
136         - NAA Application Reset (2G only)
137         - NAA Session Reset (3G only)
138
139   oFono can fully perform the the first four types of Refresh.  The
140   remaining three must be handled by the modem or its driver with a
141   notification sent to ofono.  Regardless of whether the command is
142   handled by the modem or not, oFono will check whether there are any
143   calls or ussd operations active.  If there are, the appropriate
144   response will be sent (e.g. busy on call or screen busy terminal
145   response.)  Otherwise a positive response will be sent to the driver.
146   In the case of a 'UICC Reset' the driver / modem can interpret this
147   that it is safe to reset the UICC.
148
149   Alternatively, the driver / modem can notify the core of the SIM removal
150   / SIM insertion events without using the Refresh proactive command.  It
151   is up to the driver / modem to perform a warm reset.  In particular, 3GPP
152   31.111 mandates that any change to EFimsi is done by using 'UICC Reset',
153   'NAA Application Reset' or 'NAA Session Reset'.  Please see 3GPP 31.111
154   Section 6.4.7.1.
155
156   Other types are handled by oFono flushing the EF cache of the files
157   affected (or the entire SIM cache in case of Full File Change Notifications)
158   and re-reading the affected files.  Any properties derived from these
159   Elementary Files will be updated and signaled using PropertyChanged.
160
161   NOTE: This command can also be handled by the modem.
162
163 - Sim icon support.  oFono supports icons that are stored on the SIM.  If the
164   SIM notifies oFono that an icon is available for a particular proactive
165   command, oFono passes this information to the UI.  The UI is able to obtain
166   the icons by using GetIcon method on the SimManager interface.  The icons
167   are read from the SIM and converted into XPM format.
168
169 - Text attribute support.  Whenever oFono detects that text attributes have
170   been given to any text or alpha string, it applies them and converts the
171   resulting text to HTML.  The UI is expected to be able to display such
172   HTML formatted text.
173
174 Envelopes:
175
176 - Timer Expiration envelope support.  Whenever a timer expires (as started by
177   the Timer Management proactive command) oFono forwards, this envelope type
178   to the SIM.  No external user interaction is required.
179
180 - Menu Selection envelope support.  The user can initiate a proactive command
181   session by selecting something from the Sim Toolkit main menu.  This is done
182   by using the SimToolkit's SelectItem method.  As a result, oFono will send
183   the Menu Selection envelope to the SIM.
184
185 - CBS-PP Download envelope support.  When oFono receives a cell broadcast
186   and on a channel listed in EFcbmid, it is dispatched to the SIM using the
187   CBS-PP Download envelope.  No user interaction is required or signaled
188   whenever this occurs.
189
190 - SMS-PP Download envelope support.  When oFono receives an sms message
191   addressed to the SIM, it is dispatched to the SIM using the SMS-PP Download
192   envelope.  No user interaction is required or signaled whenever this occurs.
193
194   Please note that many current modems do not support returning RP-ACK and
195   RP-ERROR acknowledgement PDUs back to the network.  This is required by the
196   CAT specification for SMS-PP Download.  E.g. the sim response to the SMS-PP
197   Download Envelope is to be stored in an RP-ACK / RP-ERROR PDU and returned to
198   the network.  It is thus anticipated that modems will transparently handle
199   this feature in the firmware.
200
201 The following commands are expected to be handled by the modem:
202
203 - Send SS proactive command.  oFono does not explicitly support this proactive
204   command since AT modems do not provide the low level information necessary
205   for oFono to generate a valid response.  The modem (or driver) shall handle
206   this command.  Optionally the modem (or driver) can inform oFono that the
207   proactive command has been received and is being handled by the modem, as
208   well as when the terminal response has been sent by the modem.  oFono will
209   display the necessary user information for this time period if this
210   information is included in the proactive command.
211
212  -----------------------------------------------------------------------
213 |       Feature                 |       Support |       Implemented by  |
214 |                               |               |                       |
215  -----------------------------------------------------------------------
216 |Profile Download               |       YES     |       BASEBAND        |
217 |                               |               |                       |
218  -----------------------------------------------------------------------
219 |SMS-PP Data Download           |       YES     |       BASEBAND        |
220 |                               |               |                       |
221  -----------------------------------------------------------------------
222 |Cell Broadcast data Download   |       YES     |       BASEBAND or ME  |
223 |                               |               |                       |
224  -----------------------------------------------------------------------
225 |CALL CONTROL BY SIM            |       YES     |       BASEBAND        |
226 |                               |               |                       |
227  -----------------------------------------------------------------------
228 |DISPLAY TEXT                   |       YES     |       ME              |
229 |                               |               |                       |
230  -----------------------------------------------------------------------
231 |GET INPUT                      |       YES     |       ME              |
232 |                               |               |                       |
233  -----------------------------------------------------------------------
234 |GET INKEY                      |       YES     |       ME              |
235 |                               |               |                       |
236  -----------------------------------------------------------------------
237 |MORE TIME                      |       YES     |       ME              |
238 |                               |               |                       |
239  -----------------------------------------------------------------------
240 |PLAY TONE                      |       YES     |       ME              |
241 |                               |               |                       |
242  -----------------------------------------------------------------------
243 |POLL INTERVAL                  |       YES     |       BASEBAND        |
244 |                               |               |                       |
245  -----------------------------------------------------------------------
246 |POLLING OFF                    |       YES     |       BASEBAND        |
247 |                               |               |                       |
248  -----------------------------------------------------------------------
249 |REFRESH                        |       YES     |       BASEBAND-ME     |
250 |                               |               |                       |
251  -----------------------------------------------------------------------
252 |SELECT ITEM                    |       YES     |       ME              |
253 |                               |               |                       |
254  -----------------------------------------------------------------------
255 |SEND SHORT MESSAGE             |       YES     |       BASEBAND-ME     |
256 |                               |               |                       |
257  -----------------------------------------------------------------------
258 |SEND SS                        |       YES     |       BASEBAND-ME     |
259 |                               |               |                       |
260  -----------------------------------------------------------------------
261 |SEND USSD                      |       YES     |       BASEBAND-ME     |
262 |                               |               |                       |
263  -----------------------------------------------------------------------
264 |SET UP CALL                    |       YES     |       BASEBAND-ME     |
265 |                               |               |                       |
266  -----------------------------------------------------------------------
267 |SET UP MENU                    |       YES     |       ME              |
268 |                               |               |                       |
269  -----------------------------------------------------------------------
270 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
271 |(MCC, MNC, LAC, cellId &       |               |                       |
272 |IMEI)                          |               |                       |
273 |                               |               |                       |
274  -----------------------------------------------------------------------
275 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
276 |(NMR)                          |               |                       |
277 |                               |               |                       |
278  -----------------------------------------------------------------------
279 |SET UP EVENT LIST              |       YES     |       BASEBAND        |
280 |                               |               |                       |
281  -----------------------------------------------------------------------
282 |EVENT: MT CALL                 |       YES     |       BASEBAND        |
283 |                               |               |                       |
284  -----------------------------------------------------------------------
285 |EVENT: CALL CONNECTED          |       YES     |       BASEBAND        |
286 |                               |               |                       |
287  -----------------------------------------------------------------------
288 |EVENT: CALL DISCONNECTED       |       YES     |       BASEBAND        |
289 |                               |               |                       |
290  -----------------------------------------------------------------------
291 |EVENT: LOCATION STATUS         |       YES     |       BASEBAND        |
292 |                               |               |                       |
293  -----------------------------------------------------------------------
294 |EVENT: USER ACTIVITY           |       NO      |                       |
295 |                               |               |                       |
296  -----------------------------------------------------------------------
297 |EVENT: IDLE SCREEN AVAILABLE   |       NO      |                       |
298 |                               |               |                       |
299  -----------------------------------------------------------------------
300 |EVENT: CARD READER STATUS      |       NO      |                       |
301 |                               |               |                       |
302  -----------------------------------------------------------------------
303 |EVENT: LANGUAGE SELECTION      |       NO      |                       |
304 |                               |               |                       |
305  -----------------------------------------------------------------------
306 |EVENT: BROWSER TERMINATION     |       NO      |                       |
307 |                               |               |                       |
308  -----------------------------------------------------------------------
309 |EVENT: DATA AVAILABLE          |       NO      |                       |
310 |                               |               |                       |
311  -----------------------------------------------------------------------
312 |EVENT: CHANNEL STATUS          |       NO      |                       |
313 |                               |               |                       |
314  -----------------------------------------------------------------------
315 |EVENT: ACCESS TECHNOLOGY       |       YES     |       BASEBAND        |
316 |       CHANGE                  |               |                       |
317  -----------------------------------------------------------------------
318 |EVENT: DISPLAY PARAMETERS      |       NO      |                       |
319 |       CHANGED                 |               |                       |
320 |                               |               |                       |
321  -----------------------------------------------------------------------
322 |EVENT: LOCAL CONNECTION        |       NO      |                       |
323 |                               |               |                       |
324  -----------------------------------------------------------------------
325 |EVENT: NETWORK SEARCH MODE     |       YES     |       BASEBAND        |
326 |       CHANGE                  |               |                       |
327 |                               |               |                       |
328  -----------------------------------------------------------------------
329 |POWER ON CARD                  |       NO      |                       |
330 |                               |               |                       |
331  -----------------------------------------------------------------------
332 |POWER OFF CARD                 |       NO      |                       |
333 |                               |               |                       |
334  -----------------------------------------------------------------------
335 |PERFORM CARD APDU              |       NO      |                       |
336 |                               |               |                       |
337  -----------------------------------------------------------------------
338 |GET READER STATUS              |       NO      |                       |
339 |(Card reader status)           |               |                       |
340 |                               |               |                       |
341  -----------------------------------------------------------------------
342 |GET READER STATUS              |       NO      |                       |
343 |(Card reader identifier)       |               |                       |
344 |                               |               |                       |
345  -----------------------------------------------------------------------
346 |TIMER MANAGEMENT               |       YES     |       BASEBAND-ME     |
347 |                               |               |                       |
348  -----------------------------------------------------------------------
349 |PROVIDE LOCAL INFORMATION      |       YES     |       ME              |
350 |(Date, Time, & Time Zone)      |               |                       |
351 |                               |               |                       |
352  -----------------------------------------------------------------------
353 |SET UP IDLE MODE TEXT          |       YES     |       ME              |
354 |                               |               |                       |
355  -----------------------------------------------------------------------
356 |RUN AT COMMAND                 |       YES     |       BASEBAND        |
357 |                               |               |                       |
358  -----------------------------------------------------------------------
359 |SEND DTMF                      |       YES     |       BASEBAND-ME     |
360 |                               |               |                       |
361  -----------------------------------------------------------------------
362 |PROVIDE LOCAL INFORMATION      |       YES     |       ME              |
363 |(Language)                     |               |                       |
364 |                               |               |                       |
365  -----------------------------------------------------------------------
366 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
367 |(Timing Advance)               |               |                       |
368 |                               |               |                       |
369  -----------------------------------------------------------------------
370 |Language Notification          |       YES     |       ME              |
371 |                               |               |                       |
372  -----------------------------------------------------------------------
373 |LAUNCH BROWSER                 |       YES     |       ME              |
374 |                               |       (MIN)   |                       |
375  -----------------------------------------------------------------------
376 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
377 |(ACCESS TECHNOLOGY)            |               |                       |
378 |                               |               |                       |
379  -----------------------------------------------------------------------
380 |OPEN CHANNEL                   |       NO      |                       |
381 |                               |               |                       |
382  -----------------------------------------------------------------------
383 |CLOSE CHANNEL                  |       NO      |                       |
384 |                               |               |                       |
385  -----------------------------------------------------------------------
386 |RECEIVE DATA                   |       NO      |                       |
387 |                               |               |                       |
388  -----------------------------------------------------------------------
389 |SEND DATA                      |       NO      |                       |
390 |                               |               |                       |
391  -----------------------------------------------------------------------
392 |GET CHANNEL STATUS             |       NO      |                       |
393 |                               |               |                       |
394  -----------------------------------------------------------------------
395 |SERVICE SEARCH                 |       NO      |                       |
396 |                               |               |                       |
397  -----------------------------------------------------------------------
398 |GET SERVICE INFORMATION        |       NO      |                       |
399 |                               |               |                       |
400  -----------------------------------------------------------------------
401 |DECLARE SERVICE                |       NO      |                       |
402 |                               |               |                       |
403  -----------------------------------------------------------------------
404 |Text Attributes                |       YES     |       ME              |
405 |                               |               |                       |
406  -----------------------------------------------------------------------
407 |ICONS                          |       YES     |       ME              |
408 |                               |               |                       |
409  -----------------------------------------------------------------------
410 |Bearer Independent Protocol    |       NO      |                       |
411 |                               |               |                       |
412  -----------------------------------------------------------------------
413 |VARIABLE TIMEOUT               |       YES     |       ME              |
414 |                               |               |                       |
415  -----------------------------------------------------------------------
416 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
417 |(IMEISV)                       |               |                       |
418 |                               |               |                       |
419  -----------------------------------------------------------------------
420 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
421 |(SEARCH MODE CHANGE)           |               |                       |
422 |                               |               |                       |
423  -----------------------------------------------------------------------
424 |Extended Launch Browser        |       NO      |                       |
425 |Capability                     |               |                       |
426 |                               |               |                       |
427  -----------------------------------------------------------------------
428 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
429 |(battery state)                |               |                       |
430 |                               |               |                       |
431  -----------------------------------------------------------------------
432 |RETRIEVE MULTIMEDIA MESSAGE    |       NO      |                       |
433 |                               |               |                       |
434  -----------------------------------------------------------------------
435 |SUBMIT MULTIMEDIA MESSAGE      |       NO      |                       |
436 |                               |               |                       |
437  -----------------------------------------------------------------------
438 |DISPLAY MULTIMEDIA MESSAGE     |       NO      |                       |
439 |                               |               |                       |
440  -----------------------------------------------------------------------
441 |SET FRAMES                     |       NO      |                       |
442 |                               |               |                       |
443  -----------------------------------------------------------------------
444 |GET FRAMES STATUS              |       NO      |                       |
445 |                               |               |                       |
446  -----------------------------------------------------------------------
447 |PROVIDE LOCAL INFORMATION      |       YES     |       BASEBAND        |
448 |(NMR(UTRAN))                   |               |                       |
449 |                               |               |                       |
450  -----------------------------------------------------------------------
451 |USSD Data Download and         |       NO      |                       |
452 |application mode               |               |                       |
453 |                               |               |                       |
454  -----------------------------------------------------------------------
455 |EVENT: BROWSING STATUS         |       NO      |                       |
456 |                               |               |                       |
457  -----------------------------------------------------------------------
458 |EVENT: MMS TRANSFER STATUS     |       NO      |                       |
459 |                               |               |                       |
460  -----------------------------------------------------------------------
461
462 Modem
463 =====
464
465 - 'silent' modem reset. Sometimes modems get in a bad state and have to reset
466   itself. Now oFono can be notified when a reset happens and do proper work to
467   put the modem back to work restoring the state before the reset.
468
469 - Lockdown support. Through the Lockdown property on the Modem D-Bus API, one
470   can power down the modem and lock it disallowing any other application to
471   use that modem. Useful for firmware update and similar stuff.
472
473 Short Messaging Service
474 =======================
475
476 - Unique identifier for incoming and outgoing SMS messages.  Whenever a
477   message is received or sent by oFono, a unique ID is generated for that
478   message.  The id is relevant to all segments of an SMS and in the case of
479   incoming messages is only generated when the SMS is fully assembled.  The
480   hash used is SHA1.  This unique identifier is used to identify the SMS
481   message to history plugins as well.
482
483 - SMS Status Report support.  oFono allows requesting of SMS Status Reports
484   via the MessageManager UseDeliveryReports property.  If enabled, oFono
485   will set the SRR bit and process incoming status reports.  oFono takes
486   care of collating the status reports for multi-fragment messages.  Once all
487   status reports are received, the UI is notified either via DBus or history
488   plugin API.
489
490 - Source / Destination port addressing scheme from 3GPP 23.040.  A special
491   header is used to indicate the source / destination port of the application
492   this SMS message belongs to.  oFono provides a handler registration
493   framework where plugins can handle the reception of such messages.  The
494   handler can be registered to receive messages which contain a specific
495   source and destination port, or a wildcard.  When such messages are received,
496   they are matched against the registered handlers and dispatched appropriately.
497
498   oFono takes care of de-fragmentation of such SMS messages, so the handler
499   is informed only once the entire message has been received, and the data
500   payload has been extracted.
501
502 - Smart Messaging Service - vCard support.  oFono provides the ability to send
503   and receive vCard objects through the SmartMessaging interface.  vCards can
504   be sent using the SendBusinessCard method and received using the
505   SmartMessagingAgent framework.
506
507 - Smart Messaging Service - vCalendar support.  oFono provides the ability to
508   send and receive vCalendar objects through the SmartMessaging interface.
509   vCalendars can be sent using the SendAppointment method and received using
510   the SmartMessagingAgent framework.
511
512 - WAP PUSH notification support.  oFono allows the reception of WAP PUSH
513   messages via SMS through the use of the PushNotification interface and the
514   PushNotificationAgent framework.
515
516 - Persisting of outgoing SMS messages.  Whenever oFono is asked to send an SMS
517   message, it adds it to an internal queue and persists it on disk.  The queue
518   is persistent across reboots of oFono and allows to queue SMS messages even
519   while the modem is offline.
520
521 GPRS
522 ====
523
524 - GPRS suspension event support.  The packet data service may be temporarily
525   suspended while a circuit switched service such as voice call or SMS is
526   active.
527
528 - GPRS context protocol support.  oFono supports the followig types of GPRS
529   contexts:
530         - IPv4
531         - IPv6
532         - Dual Stack (IPv4 + IPv6)
533
534 Location Reporting
535 ==================
536
537 - GPS support. Many modem manufacturers provide a GPS unit with their modem
538   hardware.  Upon client request oFono can turn this unit on or off and pass a
539   file descriptor in which client may receive the desired location reporting
540   data.
541
542 SIM
543 ===
544
545 - Fixed Dialing support.  oFono reads the necessary bits from the SIM to
546   check if FDN support is allocated and enabled in the SIM.  If enabled,
547   oFono halts the SIM initialization procedure and the modem remains in the
548   PRESIM state.  In this state oFono will only allow emergency calls.
549
550 - Barred Dialing support.  oFono reads the necessary bits from the SIM to
551   check if BDN support is allocated and enabled in the SIM.  If enabled,
552   oFono halts the SIM initialization procedure and the modem remains in the
553   PRESIM state.  In this state oFono will only allow emergency calls.
554
555 - Read / Write EFcfis / EFcphs-cff.  oFono reads EFcfis/EFcphs-cff SIM files
556   to check if VoiceUnconditional call forwarding rule is enabled.  If enabled,
557   ForwardingFlagOnSim will be set and VoiceUnconditional may contain the
558   "forwarded to" number if the number is available.
559
560 - Support SIM retry counters. oFono exports all the retry counters available on
561   SIM, e.g., PIN, PIN2, PUK and PUK2. Whenever an action changes them, a signal
562   is sent with the updated values, so user can keep track of how many times
563   he/she can still give a wrong pin before the SIM locking down.
564
565 Radio settings
566 ==============
567
568 - Fast dormancy support. A fast dormancy feature can be enabled in the
569   cellular modem to conserve power when the end user is not actively
570   using the device but some networking applications are online using
571   packet data.
572
573 - Frequency Band Selection support. This feature allows the user to limit the
574   frequency bands in which the cellular modem can operate.
575
576 Text Telephony
577 ==============
578
579 - TTY (hearing impaired) support, also known as Cellular Text Modem (CTM).
580   In case it's supported by the modem, oFono allows the user to enabled
581   or disable it through the TextTelephony interface.
582
583 Emergency Calls
584 ===============
585
586 - Emergency number reporting.  During SIM initialization phase oFono reads
587   EFecc in order to bootstrap the emergency calling codes provided by the SIM.
588   Emergency number list is exposed via the EmergencyNumbers property on the
589   VoicecallManager interface.  If SIM is present, list is the union of default
590   emergency numbers(112, 911), numbers in EFecc and Network / Modem reported
591   emergency numbers.  If SIM is not present or EFecc has not been read yet,
592   list is the union of default emergency numbers(112, 911) and emergency
593   numbers without SIM(119, 118, 999, 110, 08 and 000).
594
595 - Emergency call reporting.  When a voicecall is made to a number present
596   on the EmergencyNumbers list it is automatically flagged as an emergency
597   call.  This is done by setting the Emergency property on the Voicecall
598   interface to TRUE.
599
600 - Emergency Mode.  oFono supports a concept of an 'Emergency Mode'.  This mode
601   is activated when any emergency procedure is ongoing and restricts certain
602   actions (e.g. setting the modem offline).  Emergency procedures are e.g.
603   ongoing emergency calls, or network initiated location requests related to
604   the emergency call.  The state of the emergency mode is exposed via the
605   Emergency property on the org.ofono.Modem interface.  This property is
606   intended to be used by power management daemons and other entities which
607   need to be aware of the ongoing emergency operation.
608
609 Supplementary Services
610 ======================
611
612 - CNAP support.  The Calling Name Presentation supplementary service is
613   supported by oFono.  One can query whether the service is provisioned in the
614   network by using the CallSettings interface.  If the network reports the
615   calling name, it is presented on the Voicecall interface using the Name
616   property.  If no calling name is given, the Name is empty.
617
618 - CDIP support.  The Called Line Presentation is supported by oFono. One can
619   query whether the service is provisioned in the network by using the
620   CallSettings interface.  If the network supports this service, the number
621   dialed by the remote party is presented through the Voicecall interface using
622   the IncomingLine property.
623
624 Voice Calls
625 ===========
626
627 - Long phone number support. oFono supports dialing of phone numbers up to
628   80 digits long.
629
630 - Supplementary service notifications related to mobile originated (MO) and
631   mobile terminated (MT) calls.  oFono supports certain supplementary service
632   notifications, typically reported by CSSU and CSSI, that are related to
633   MT/MO calls:
634         - outgoing call has been forwarded (+CSSI: 2)
635         - outgoing calls are barred (+CSSI: 5)
636         - outgoing call barred due to call barring on remote party (+CSSI: 6)
637         - incoming call is a forwarded call (+CSSU: 0)
638         - call has been put on hold by the remote party (+CSSU: 2)
639         - call has been retrieved by the remote party (+CSSU: 3)
640         - call has been added to a mpty call by the remote party (+CSSU: 4)
641
642 Flight Mode
643 ===========
644
645 - Flight Mode support.  oFono uses the 'Online' property on the Modem interface
646   that controls the state of the radio.  When Online state is False, all
647   interfaces that depend on the radio being on are removed.  Other interfaces
648   enter reduced functionality mode where only certain actions are available
649   that do not depend on the radio.  E.g. setting various settings on the local
650   store or the SIM.
651
652 Network Registration
653 ====================
654
655 - Support for PLMN_MODE bit from CPHS Customer Service Profile (CSP) within
656   the 'Value Added Services' service group.  oFono reads this file when the
657   network registration atom has been initialized.  If EFcsp indicates that
658   manual network registration is not allowed, oFono enters into 'auto-only'
659   registration mode.  Updates to this file via STK Refresh is also supported.
660
661 - Support for 3GPP Service Provider Name (EFspn), CPHS Operator Name
662   String (ONS) and CPHS Short Operator Name String fields.  oFono always
663   tries to read the EFspn field first.  If this is not available, then oFono
664   tries to read the CPHS variant.  If neither are available and the
665   appropriate bits are set in the CPHS Information field, oFono tries to read
666   the CPHS Short ONS field.  oFono then reports the network name via the
667   'Name' property.
668
669 PPP Stack
670 =========
671
672 - Support for Protocol Field Compression (PFC) packets.  The oFono PPP stack
673   supports both receiving and sending of packets with PFC enabled.  The user
674   can also control whether PFC capability is advertised to the peer, and used
675   during transmission.
676
677 - Support for Address & Control Field Compression (ACFC) packets.  The oFono
678   PPP stack supports both receiving and sending of packets with ACFC enabled.
679   The user can also control whether ACFC capability is advertised to the peer,
680   and used during transmission.
681
682 Modem Emulator
683 ==============
684
685 - Support for Bluetooth HandsFree Profile Audio Gateway (HFP AG).  oFono
686   supports the underlying AT command protocol specified by BT HFP version 1.6.
687   Supported features include 3-way calling, ability to reject a call,
688   enhanced call status, enhanced call control, report of extended error results
689   code and indicator activation. Audio management is assumed to be performed in
690   another system component, e.g. PulseAudio.
691
692 - Support for Bluetooth DUN profile.  oFono supports the Dial Up Networking
693   profile and all mandatory commands specified by BT DUN 1.1.  For a list
694   of supported commands please see doc/dialup-command-set.txt.
695
696 CDMA Connection Manager
697 =======================
698
699 - Support Network Initiated disconnection of Packet Data Service over CDMA
700   (1xRTT and 1xEV-DO) systems.
701
702 CDMA Network Acquisition
703 ========================
704
705 - Support reporting of the received signal strength indicator (RSSI)
706   measurement for the currently acquired CDMA network.
707
708 - Support reporting of the received signal strength indicator (RSSI)
709   measurement for the currently acquired 1xEV-DO data network.