Difference between revisions of "Features/3G Support/Database Support"

From Sugar Labs
Jump to navigation Jump to search
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<noinclude>{{TOCright}}
 
<noinclude>{{TOCright}}
[[Category:Feature|3G database support]]
+
[[Category:FeatureLanded|3G database support]]
 
</noinclude>
 
</noinclude>
  
 
== Summary ==
 
== 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.
 
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 ==
 
== Owner ==
* Name: Andrés Ambrois, Anish Mangal
+
* Name: Ajay Garg (on behalf of Andrés Ambrois)
* Email: andresambrois@gmail.com, anish@activitycentral.com
+
* Email: ajay@activitycentral.com, andresambrois@gmail.com
  
 +
 +
 +
== Credits ==
 +
* Name: Anish Mangal (Reviving the feature, Feature Page)
 +
* Email: anish@activitycentral.com
 +
 +
 +
 +
== Current Status ==
 
* Targeted release: 0.98
 
* Targeted release: 0.98
 
* Development status: This feature is tested to be working quite well in sugar-0.94 based dextrose-3 images. The mainline-ported rpms/patches can be found at  
 
* Development status: This feature is tested to be working quite well in sugar-0.94 based dextrose-3 images. The mainline-ported rpms/patches can be found at  
 
** Patchwork
 
** Patchwork
http://patchwork.sugarlabs.org/patch/1646/
+
***http://patchwork.sugarlabs.org/patch/1646/
 
** Devel-List
 
** Devel-List
http://lists.sugarlabs.org/archive/sugar-devel/2012-August/038916.html
+
***http://lists.sugarlabs.org/archive/sugar-devel/2012-August/038916.html
 +
** Github
 +
***https://github.com/sugarlabs/sugar/pull/46
  
 
== Detailed Description ==
 
== Detailed Description ==
Line 21: Line 34:
  
 
Thus this is an add-on to existing functionality, where all settings must be manually typed in into the text-entry fields.
 
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 ==
 
== Benefit to Sugar ==
 
Ease of use and configurability.
 
Ease of use and configurability.
 +
 +
  
 
== Scope ==
 
== Scope ==
Line 31: Line 48:
 
* extensions/cpsection/modemconfiguration/view.py
 
* extensions/cpsection/modemconfiguration/view.py
 
* The XML database for Country, Plan, Provider already included in builds.
 
* The XML database for Country, Plan, Provider already included in builds.
 +
 +
  
 
==UI Design==
 
==UI Design==
Line 41: Line 60:
 
Old user interface without database support.
 
Old user interface without database support.
 
[[File:3g_configuration_old_ui.png|700px]]
 
[[File:3g_configuration_old_ui.png|700px]]
 +
 +
  
 
== How To Test ==
 
== How To Test ==
Line 56: Line 77:
 
* Open the My Settings -> Modem again
 
* Open the My Settings -> Modem again
 
* Check that the selected Country, Plan, and Provider values in the Drop down boxes are correct.
 
* Check that the selected Country, Plan, and Provider values in the Drop down boxes are correct.
 +
  
 
== User Experience ==
 
== User Experience ==
Line 70: Line 92:
  
 
6. After restart, the modem should automatically get connected
 
6. After restart, the modem should automatically get connected
 +
 +
  
 
== Dependencies ==
 
== Dependencies ==

Latest revision as of 14:48, 5 November 2013


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: Ajay Garg (on behalf of Andrés Ambrois)
  • Email: ajay@activitycentral.com, andresambrois@gmail.com


Credits

  • Name: Anish Mangal (Reviving the feature, Feature Page)
  • Email: anish@activitycentral.com


Current Status

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
  • The XML database for Country, Plan, Provider already included in builds.


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. 3g database support ui.png

Old user interface without database support. 3g configuration old ui.png


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.