Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Form Factor Technology Guide

Form Factor Technology Guide for Developers for Manufacturers

Base version: 1.0
Document number:

HT80-VT500-53 Rev. B

HT80-VT500-54 Rev. B

Date published: June 10, 2011

This document describes how to use Brew ® MP events, notifications, and interfaces that support the hardware features built into the form factor of a mobile device. These events, notifications, and interfaces primarily allow applications to set, enable, and disable these features; get information about them; and control user input to them.

Most mobile devices incorporate hardware features that allow the user to interact with the device and the applications that are resident on the device. Some of these user input methods are obvious (keypad and joystick. for example) and some are more subtle, such as the user's interacting with the form factor of the device (opening and closing the flip on a clamshell phone, for example). Brew MP provides a set of events and notifications to convey these sorts of user inputs to the Brew MP application as they occur. Brew MP also provides a set of standard APIs that offer applications the ability to query for information related to user input. These features of Brew MP are the focus of this technical guide.

This technical guide discusses the following hardware features that are built into the form factor:

  • Keypad
  • Touchscreen
  • Jogdial
  • Joystick
  • Flip
  • Keyguard, screen rotation, and headset

Documentation resources

  • For information about interfaces, classes, datatypes, and methods that are available to Brew MP developers, refer to the Brew Mobile Platform API Reference.
  • For information about external keyboards, game-related devices (such as a joystick), and other Human Interface Devices (HID) that are connected to a mobile device through its USB interface, see the HID Technology Guide.
  • For information about USB devices, refer to the USB Technology Guide.
  • For information about resource files, including the CIF file, refer to the Resource File Reference.
All these documents are available on the Brew MP Developer website, at http://developer.brewmp.com/ (login required).

High-level architecture

Form-factor features are implemented in the hardware layer of a mobile device. When the user interacts with a form-factor feature such as the keypad or flip, the OEM layer sends events to the top-visible Brew MP application, and to background applications that have registered to receive events or notifications.

Form-factor features are implemented in the hardware layer of a mobile device. When the user interacts with a form-factor feature such as the keypad or flip, Brew MP sends events to the top-visible Brew MP application, and to background applications that have registered to receive events or notifications.