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

Developer

resources

Brew MP Level 1 Definition

Databases: Contacts

ClassID Primary Interface(s) Test Modules
AEECLSID_ADDRBOOK deprecated IAddrBook

AddrBookTest

AddrBook_AddAITest

AddrBook_SaveAITest

Note: ClassID pim_AEECLSID_EFSDBDevice and all IContacts interfaces have been removed from the BL1 specification.

The BL1 definition requires that IADDRBOOK support one of the following:

  • AEE_ADDRFIELD_FIRSTNAME and AEE_ADDRFIELD_LASTNAME

  • AEE_ADDRFIELD_NAME

BL1 also requires that IADDRBOOK support at least one of the following phone number fields:

  • AEE_ADDRFIELD_PHONE_WORK

  • AEE_ADDRFIELD_PHONE_HOME

  • AEE_ADDRFIELD_PHONE_FAX

  • AEE_ADDRFIELD_PHONE_VOICE

  • AEE_ADDRFIELD_PHONE_PREF

  • AEE_ADDRFIELD_PHONE_CELL

  • AEE_ADDRFIELD_PHONE_PAGER

  • AEE_ADDRFIELD_PHONE_GENERIC

  • AEE_ADDRFIELD_PHONE_OTHER

Databases: Database Connect - SQL

ClassID Primary Interface(s) Test Modules

dbc_AEECLSID_Factory

dbc_IFactory

dbc_IConnection

dbc_IObserver

dbc_IStatement

dbc_IPreparedStatement

dbc_IResultSet

DBCFactoryTest

AEECLSID_DBMGR deprecated

IDBMgr

IDatabase

DBMgrTest

DatabaseTest

Device Management: Module Manager

ClassID Primary Interface(s) Test Modules

AEECLSID_ModCollector

IModCollector ModCollectorAPITest
AEECLSID_ModInstaller2 IModInstaller2 ModInstallerAPITest

Hardware: Backlight

ClassID Primary Interface(s) Test Modules
AEECLSID_BACKLIGHT IBacklight

BacklightTest

Backlight_EnableAITest

Media: Image Control

ClassID Primary Interface(s) Test Modules

AEECLSID_JPEG

IImage

ImageControlTest_JPEG

AEECLSID_JPEGDecoder

IImageDecoder

ImageDecoderTest_JPEG

AEECLSID_PNG

IImage

ImageControlTest_PNG

AEECLSID_PNGDecoder

IImageDecoder

IForceFeed

ImageDecoderTest_PNG

AEECLSID_WINBMP

IImage

ImageControlTest_WINBMP

Media: Players

ClassID Primary Interface(s) Test Modules

AEECLSID_MEDIAMIDIOUTQCP

IMedia

mediaqcpoutmidi_playbacktest

AEECLSID_MediaAAC

IMedia

mediaaac_playbacktest

media_play_aacaitest

Note: Minimum encoding: 384 Kbps @ 48Khz

AEECLSID_MediaMIDI

IMedia

mediamidi_playbacktest

media_play_midiaitest

Note: Minimum encoding: 128 voices, 512Kb wavetable

The following additional IMedia parameters must be supported on all MIDI IMedia implementations:

  • PARM_TEMPO

AEECLSID_MediaMP3

IMedia

mediamp3_playbacktest

media_play_mp3aitest

AEECLSID_MediaQCP IMedia

mediaqcp_playbacktest

media_play_qcpaitest

Note: Because this API level does not require media recording, IMedia_Record and IMedia_SetTickTime can be omitted from test results.

Note: The following parameters must be supported on all IMedia implementations:

  • PARM_MEDIADATA
  • PARM_VOLUME
  • PARM_MUTE
  • PARM_POS
  • PARM_CAPS
  • PARM_SEEK_CAPS
  • PARM_PLAY_TYPE

AEECLSID_SOUND

ISound

sound_propsStereoHS

sound_basictests

sound_setcurrenttests

sound_sethandsettests

sound_setspeakertests

sound_setbtheadsetAITest

sound_setbtstereoheadsetAITest

sound_sethandsetAITest

sound_setheadsetAITest

sound_setspeakerAITest

sound_setstereoheadsetAITest

sound_setvolumeAITest

sound_setcurrentAITest

Note: The minimum supported sound devices are:

  • AEE_SOUND_DEVICE_HANDSET
  • AEE_SOUND_DEVICE_CURRENT
  • AEE_SOUND_DEVICE_SPEAKER
  • AEE_SOUND_DEVICE_STEREO_HEADSET

AEECLSID_SOUNDPLAYER deprecated

ISoundPlayer

soundplayer_midi

soundplayer_mp3

soundplayer_propsMidi

soundplayer_propsMp3

soundplayer_propsQcp

soundplayer_propsStereoHS

soundplayer_qcp

Note: Remove ISoundPlayer_SetTune and SoundPlayer_SetStream from the result set.

Networking: Web - HTTP

ClassID Primary Interface(s) Test Modules
AEECLSID_WEB IWeb WebTest
AEECLSID_WEBUTIL IWebUtil WebUtilTest
AEECLSID_xOpts IxOpts Web_WebOptsTest

System: Application

ClassID Primary Interface(s) Test Modules

AEECLSID_SHELL

IShell

ShellTest

ShellUITest

ShellBrowseUrlAITest_Http

ShellBrowseUrlAITest_Https

ShellBrowseUrlAITest_Tel

Note: Part of the basic shell service is to offer the ability to applications to post URLs to applications that register for a particular URI schema.

The following URI schema must be supported on devices:
http:// host [":" port] [url_path ["?" query] ]
https:// host [":" port] [url_path ["?" query] ]
  • Host: Domain name
  • Port: Assume port 80 unless specified
  • url_path: Path to requested resource
  • query: optional parameters

The URLs must be handled by the browser application through any of the Shell URL methods (BrowseURL, PostURL and SendURL).

The result should be that the browser application is launched and the given URL loaded.

tel:

The result should be that the dialer application is launched and the given number called after allowing the user to confirm that the number should be called.

System: File System

Note: Only very basic on device filesystem support is declared in this initial level. Support for removable media is slated for a next release of the Brew API Level definition, but may be supported on any device.

ClassID Primary Interface(s) Test Modules

AEECLSID_FileSystem2

IFileSystem2

IFilePort1

FileSystem2Test

FilePort1Test

AEECLSID_FILEMGR deprecated IFileMgr

FileMgrTest

FileTest

System: Memory

ClassID Primary Interface(s) Test Modules

AEECLSID_HEAP

IHeap HeapTest
AEECLSID_MEMASTREAM IMemAStream MemAStreamtest

System: Services

ClassID Primary Interface(s) Test Modules
AEECLSID_UNZIPSTREAM IUnZipAStream UnzipAStreamTest
AEECLSID_THREAD IThread ThreadTest

System: Settings

ClassID Primary Interface(s) Test Modules
AEECLSID_RINGERMGR IRingerMgr

ringermgrtest

RingerMgr_CreateAITest

RingerMgr_SetRingerAITest

AEECLSID_Wallpaper IWallpaper

wallpapertest

Wallpaper_InstalledAITest

WallpaperAITest_BMP

WallpaperAITest_JPEG

WallpaperAITest_PNG

System: Utilities

ClassID Primary Interface(s) Test Modules
AEECLSID_SOURCEUTIL ISourceUtil SourceUtilTest

Telephony: SMS

ClassID Primary Interface(s) Test Modules

AEECLSID_SMS

ISMS

smstest_sr_default

AEECLSID_SMSMSG ISMSMSG

smstest_sr_default

AEECLSID_SMSNOTIFIER ISMSNotifier

Note: While ISMS supports a number of MSGOPTs, only the following are included in this level:

  • MSGOPT_TO_DEVICE_SZ
  • MSGOPT_PAYLOAD_ENCODING
  • MSGOPT_PAYLOAD_SZ
  • MSGOPT_PAYLOAD_WSZ
  • MSGOPT_BREW_HANDLER_SZ
  • MSGOPT_BREW_CLASS
  • MSGOPT_LOOPBACK_MSG
  • MSGOPT_CLASS

For MSGOPT_PAYLOAD_ENCODING, the payload encoding required by this level is the encoding that is retrieved from the device by querying ISHELL_GetDeviceInfoEx() for AEE_DEVICEITEM_TAPI_SMS_ENCODING.

Telephony: TAPI

ClassID Primary Interface(s) Test Modules

AEECLSID_CALLMGR

ICallMgr callmgrtest
AEECLSID_PHONENOTIFIER INotifier PhoneNotifierTest
AEECLSID_TELEPHONE ITelephone TelephoneTest

Note: The ITelephone_GetNetworks() method is not required for BL1.

AEECLSID_TAPI deprecated ITAPI tapi1test

UI: Controls

ClassID Primary Interface(s) Test Modules
AEECLSID_TEXTCTL_10 ITextCtl

TextCtl_Test

TextCtl_10_Test

TextCtl_IM_10Key_LET_AITest

TextCtl_IM_10Key_NUM_AITest

TextCtl_IM_10Key_SYM_AITest

TextCtl_IM_Touch_EXT_AITest

TextCtl_IM_Touch_NUM_AITest

TextCtl_IM_Qwerty_EXT_AITest

TextCtl_IM_Qwerty_NUM_AITest

TextCtl_EnterPasswordAITest

AEECLSID_TEXTCTL ITextCtl

Depending on the user input features of the device, various text input modes are to be supported through the text widget. The following table shows the text input modes that are required by the BL1 definition, based on the user input features present in the device:
Input mode 10 key QWERTY Touch only
AEE_TM_SYMBOLS Required Not supported Not supported
AEE_TM_LETTERS Required Not supported Not supported
AEE_TM_NUMBERS Required Required Required
AEE_TM_EXTENDED_KEYS Not supported Required Required

UI: Display

ClassID Primary Interface(s) Test Modules

AEECLSID_DISPLAY

IDisplay

IBitmap

IDIB

ITransform

DisplayTest

UI: Fonts and Text

Note: Requirements for the defined fonts at this level are only that the font class exists on device.

ClassID Primary Interface(s) Test Modules

AEECLSID_FONTSYSBOLD

IFont FontSysBoldTest
AEECLSID_FONTSYSLARGE IFont FontSysLargeTest
AEECLSID_FONTSYSNORMAL IFont FontSysNormalTest
AEECLSID_FONT_STANDARD11 IFont FontStandard11Test
AEECLSID_FONT_STANDARD11B IFont FontStandard11BTest
AEECLSID_FONT_STANDARD15 IFont FontStandard15Test
AEECLSID_FONT_STANDARD15B IFont FontStandard15BTest
AEECLSID_FONT_STANDARD18 IFont FontStandard18Test
AEECLSID_FONT_STANDARD18B IFont FontStandard18BTest
AEECLSID_FONT_STANDARD23 IFont FontStandard23Test
AEECLSID_FONT_STANDARD23B IFont FontStandard23BTest
AEECLSID_FONT_STANDARD26 IFont FontStandard26Test
AEECLSID_FONT_STANDARD26B IFont FontStandard26BTest
AEECLSID_FONT_STANDARD36 IFont FontStandard36Test

UI: Graphics

ClassID Primary Interface(s) Test Modules

AEECLSID_BilinearScale

IBitmapScale BilinearScaleTest
AEECLSID_GRAPHICS IGraphics GraphicsTest