Preferences

From Openmoko

Contents 1 Overview 2 Use Cases 3 Layout Components 3.1 Application Area 3.1.1 Application Menu 3.1.2 Filter Menu 3.2 Navigation Area 3.3 Toolbar 3.3.1 Search 3.3.2 Action Buttons 3.4 Details Area 3.4.1 Device Settings Mode 3.4.1.1 Appearance 3.4.1.2 Display Calibration 3.4.1.3 Language 3.4.1.4 SIM Codes 3.4.1.5 Reset Options 3.4.2 Profiles Mode 3.4.2.1 Rules 3.4.2.2 Connections 3.4.2.3 Call Firewall 3.4.2.4 Theme 3.4.2.5 Backlight 3.4.2.6 Auto screen lock 3.4.2.7 Screen lock PIN 3.4.2.8 Vibrate & Ring Tones 3.4.2.9 Volumes 3.4.2.10 Phone 3.5 Footer Area 3.5.1 Status Bar 4 Constraints 5 Sessions 6 Architectural Details 7 Implementation Recommendations 8 Icons 9 UI positions 10 Interactions 11 Unresolved Issues 12 Questions and Answers

Overview

This article defines the Preferences Application, an application designed for the OpenMoko platform. This is a Native Stylus-Based application.

Use Cases

Here are some possible use cases:

• I want to be able to create new profiles that are based on location information.
• I want to be able to configuration the various hardware preferences.

Layout Components

• 1) Application Menu -- Additional options related to preference objects.
• 2) Filter_Menu -- Filtering options for the list of preferences.
• 3) Navigation Area -- List of preferences based on current filter.
• 4) Toolbar -- Primary commands available to preferences.
• 5) Details Area -- Detailed view of current selected preference.
• 6) Footer Area -- Status information.

Application Area

Application Menu

Item	Action	Constraints
Help	Opens Help Viewer Application with help for this application

Filter Menu

Item	Action	Constraints
Profiles	Displays all profiles
Settings	Displays all device settings
Search Results	Displays all profiles and settings matching current search string

Navigation Area

Displays list of items from current filter menu using the Navigation Widget. Has the following structure:

Item	Action	Constraints
Column 1	Displays Preference name (can be a profile or setting)
Column 1	Displays Preference detail (can be a profile or setting)

Tap selecting a row, will display correspoding preference information in the Details Area.

Toolbar

Search

Search reindexes, after every keypress, the item membership of the Search Results.

Action Buttons

Details Area

A Details List that behaves different in each of the following modes:

Device Settings Mode

Appearance

• Fontsize (Small, Normal, Large)
• Smoothing (On, Off)
• Display (Black on White, White on Black, Use Grayscale)

Display Calibration

• Calibrate -- Show screen for calibration

Language

• Current Language -- Show list of languages (English, German, Simplified Chinese, Traditional Chinese, ...)

SIM Codes

• PIN Code -- Show field to change PIN
• PUK Code -- Show field to change PUK

NOTE: If the PIN code is enabled the dialer will prompt the user to enter the PIN before GSM related events can be processed. Emergency calls will always be allowed.

Reset Options

• Reset Preferences -- Show Yes / No (Must prompt for confirmation saying this cannot be undone)

Profiles Mode

NOTE: Automatic profile changing is based on system or call parameters (time, GPS, availability of GSM or BT services, dedicated user calling).

Rules

• date & time based -- Show fields to configure date and time and profile to switch to.
• location based -- Show fields with location and radius and profile to switch to.
• network based -- Show fields with network names and profile to switch to.
• mac address based -- Show fields with devices within vicinity and profile to switch to.

Connections

• GPRS -- Show fields with all GPRS settings.
• Bluetooth -- Show fields with all BT settings.
• USB -- Show fields with all USB settings.
• AGPS -- Show fields with all AGPS settings.

Call Firewall

• (TBD)

Theme

• Current Theme -- Show list of themes

Backlight

• Time -- Show list of backlight times (Always On, 60, 30, 15, Off)

Auto screen lock

• Status -- Show screen lock options (On, Off)

Screen lock PIN

• Set -- Show field to set PIN

Vibrate & Ring Tones

• Vibrate -- show options (On, Off)
• Ringer -- Show list of ringers
• Incoming Message Ringer -- Show list of ringers

Volumes

Volume preferences will need to check the current active profile before rendering/changing any volumes. This is because the volume controls for each profiles will possibly map to different alsa controls.

• Ringer -- show volume level
• Microphone -- Show volume level
• Alarm -- show volume level
• Speaker -- show volume level

Phone

• Call Diverting -- Show field with number to divert call to
• Caller ID -- show options (On, Off)
• Call Waiting -- show options (On, Off)

Footer Area

Status Bar

(TBD)

Constraints

• First time entering application defaults to Profiles Mode.

Sessions

• The current item selection and Details Area mode is persistant.

Architectural Details

(TBD)

Implementation Recommendations

(TBD)

Icons

Preferences icon size is 94x94 pixels

UI positions

Interactions

(TBD)

Unresolved Issues

(TBD)

Questions and Answers

(TBD)