Changes

Created page with "<noinclude>{{TOCright}} 3G database support </noinclude> == Summary == The 3G connectivity availability was only the first step. Next step is to provide ..."
<noinclude>{{TOCright}}
[[Category:Feature|3G database support]]
</noinclude>

== Summary ==
The 3G connectivity availability was only the first step. Next step is to provide a UX for easy configuration of 3G modems. Gnome allows users to enter details such as 'Country', 'Plan' and 'Provider' in a drop-down box fashion. This feature brings that functionality into Sugar.

== Owner ==
* Name: Andrés Ambrois, Anish Mangal
* Email: andresambrois@gmail.com, anish@activitycentral.com

== Current status ==
* Targeted release: (0.98)
* Percentage of completion: 70% (0.94 compatible code is working and included in Dextrose builds. The code needs to be ported to 0.98.)

== Detailed Description ==
Provides and easy to use mechanism of entering the configuration settings for 3G modems. The user can select 'Country', 'Plan' and 'Provider' from drop down boxes, and the required settings for the modem will automatically be configured. For some modems which require specific user names or passwords, the user can still manually input those settings.

Thus this is an add-on to existing functionality, where all settings must be manually typed in into the text-entry fields.

== Benefit to Sugar ==
Ease of use and configurability.

== Scope ==

extensions/cpsection/modemconfiguration/config.py.in
extensions/cpsection/modemconfiguration/model.py
extensions/cpsection/modemconfiguration/view.py

==UI Design==
The UI has been kept consistent with what is provided in Gnome. Drop down boxes for Country, Plan and Provider are provided, which when entered, configure settings in the text fields below. Attaching screenshots:


New user interface with database support.
[[File:3g_database_support_ui.png|700px]]

Old user interface without database support.
[[File:3g_configuration_old_ui.png|700px]]

== How To Test ==

* Insert the 3G modem.
* Open "My Settings -> Modem"
* Enter the modem configuration settings manually in the text entry fields
* Click the 'tick' button. It will prompt for a restart. Restart Sugar. The modem will be detected and connected
* Now open "My Settings -> Modem" again
* Clear the text entry fields which have values/text in them
* Select the Country, Plan and Provider from the drop down boxes.
* Verify that some values in the text entry fields were automatically set
* Enter information in missing fields (if any)
* Click the 'tick' button. It will prompt for a restart. Restart Sugar. The modem will be detected and connected
* Open the My Settings -> Modem again
* Check that the selected Country, Plan, and Provider values in the Drop down boxes are correct.

== User Experience ==

1. Plug GSM modem.

2. Open My Settings -> Modem

3. Select Country, Plan and Provider from the provided drop down menus

4. Click the 'tick' button on the top right corner of screen.

5. It will prompt for a sugar restart, Select Restart now.

6. After restart, the modem should automatically get connected

== Dependencies ==
Network Manager 0.8x (Most probably wont work with NM 0.9x. It needs to be ported)

== Contingency Plan ==
The manual text entry fields are provided to configure the modem, if the drop down boxes dont work.

== Documentation ==
Please see the testing section.

== Release Notes ==
N.A.

== Comments and Discussion ==
N.A.
166

edits