Features/3G Support/Database Support

From Sugar Labs
< Features‎ | 3G Support
Revision as of 15:48, 5 November 2013 by Godiard (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


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.


  • Name: Ajay Garg (on behalf of Andrés Ambrois)
  • Email: ajay@activitycentral.com, andresambrois@gmail.com


  • 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.


  • 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


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.


Please see the testing section.

Release Notes


Comments and Discussion