Revert "doc: Updated and clarified overview"
authorAki Niemi <aki.niemi@nokia.com>
Thu, 3 Feb 2011 13:05:20 +0000 (15:05 +0200)
committerAki Niemi <aki.niemi@nokia.com>
Thu, 3 Feb 2011 13:05:20 +0000 (15:05 +0200)
This reverts commit 457b051928da7a831f7361b9bd156d494593ce04.

Meant only as request for comments.

doc/overview.txt

index 741f3a2..3f1f531 100644 (file)
@@ -2,23 +2,17 @@ oFono - Open Source Telephony
 *****************************
 
 Copyright (C) 2008-2010  Intel Corporation. All rights reserved.
-Copyright (C) 2009-2011 Nokia Corporation and/or its subsidiary(-ies).
 
 
 Mission statement
 =================
 
-The overall goal of the oFono project is to create an open telephony stack
+The overall goal of the oFono project is to create a telephony host stack
 for embedded/mobile and desktop systems based on Linux.
 
-It currently targets supporting User Equipment (UE) supporting GSM/UMTS and LTE
-based on 3GPP specifications as well as CDMA/EVDO based on 3GPP2 specifications.
-
-The oFono stack delegates implementation of the actual cellular protocol stack
-(L1-L3) to a modem firmware. Communication with the modem typically uses
-standard AT commands (3GPP TS 27.007) via a serial interface. Proprietary
-control protocols such as the Intelligent Serial Interface (ISI) can also be
-supported.
+It currently targets GSM/UMTS User Equipment (UE) based on 3GPP standards,
+but is of course not limited to that. Extensions for other telephony systems
+like CDMA/EVDO are more than welcome.
 
 Within oFono there is clear abstraction between the application interfaces
 based on D-Bus, the hardware level (via drivers) and the integration with
@@ -29,11 +23,14 @@ flexible.
 Telephony features
 ==================
 
-This paragraph lists features that have been implemented so far, features that
-are going to be supported in the future, and especially features that will not
-be part of oFono.
+The oFono stack will support the majority of the features from the 3GPP
+specification, but not all of them. The whole standard is pretty complex
+and some features are not used in any mobile network so far, some of them
+are outdated and have no relevance anymore. This paragraph tries to give
+some insights on what has been implemented so far, what is coming in the
+future and especially what will not be part of oFono.
 
-Implemented features:
+Current implemented features:
 
        Modem abstraction
 
@@ -42,8 +39,7 @@ Implemented features:
                The "atmodem" driver handles hardware based on the 3GPP
                TS 27.007 standard.
 
-               The "isimodem" driver handles hardware based on the ISI
-               protocol.
+               The "isimodem" driver handles Nokia based PhoNet modems.
 
        Network registration
 
@@ -77,7 +73,7 @@ Implemented features:
        Advanced voice call control
 
                Features like COLR/CLIR/CLIP/COLP are supported by the
-               voice call handling interface.
+               voice call handling interface. 
 
                The support for call forwarding and call waiting is also
                present.
@@ -94,11 +90,11 @@ Implemented features:
        Phonebook support
 
                The storage of the SIM card is not used. The only supported
-               features are to allow simple import and export of the contacts
-               stored on the SIM card to some third-part entity.
+               feature is to export the contacts stored on the SIM card to
+               some third-part entity.
 
                SIM card storage is limited, slow and not flexible enough
-               for modern telephony applications.
+               for modem telephony applications.
 
        Short message service
 
@@ -134,35 +130,42 @@ Implemented features:
                enabling and disabling fast dormancy on hardware that support
                this feature.
 
-       Smart Messaging
-
-               Support for sending and receiving business cards (vCard) and
-               appointments (vCalendar) is available using the SmartMessaging
-               interface.
-
-       Push Notification
-
-               Support for receiving push notifications (OMA Push over SMS) is
-               available using the PushNotification interface.
+Work in progress features:
 
        USSD
 
                User initiated USSD support is available, but not
                network-initiated USSD support.
 
-Work in progress:
+Not implemented features:
 
-       SIM application toolkit
+       SIM card storage
 
-               Basic support for SIM toolkit exists.
+               The SIM card storage will not be used by oFono. It is slow,
+               limited in size and flexibility. It is an outdated interface
+               that makes no sense in a modern telephony system.
 
-Out-of-scope features:
+               Export of stored contacts from the SIM card is supported for
+               legacy reasons and to allow a smooth transition.
 
        WAP support
 
                The WAP feature is outdated and using full Internet access
                with an embedded browser is the future.
 
+       MMS support
+
+               The MMS support should not be part of oFono itself. The best
+               idea is to implement a MMS service that runs in the user
+               session and uses oFono's SMS interface to listen for
+               notifications.
+
+               Similar to the split between BlueZ and OBEX daemon.
+
+               Especially when it comes to image conversion and other tasks
+               that MMS support requires it is important to NOT do this as
+               a system daemon.
+
        EMS support
 
                This is an Ericsson specific standard and not widely spread
@@ -170,12 +173,11 @@ Out-of-scope features:
 
        Video telephony
 
-               The support from mobile networks and available handsets is
-               still limited, and the feature is considered legacy.
+               Currently there are no plans to support this. The support
+               from the networks and available handsets are still limited.
+
+               This needs re-evaluation once such a service becomes more
+               prominent.
 
-       IP Multimedia Subsystem
+               A similar split like with MMS might be a good idea.
 
-               Implementing full IMS client support is not in scope for the
-               oFono project. However, oFono will provide some mandatory
-               supporting features for IMS, such as an interface for running
-               IMS AKA authentication on the ISIM/USIM.