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

Developer

resources

Using Profile Creator

The Profile Creator is a utility to create device profiles for the Brew MP Simulator. This document describes how to create a device profile after setting up your environment.

To set up your environment

  1. Install flexSDK 3.0 or higher: http://opensource.adobe.com/wiki/display/flexsdk/download+flex+4.
  2. Unzip the ZIP file to a temporary folder.
  3. Install a recent JDK in your Program Files directory: http://www.oracle.com/technetwork/java/javase/downloads/java-se-jdk-7-download-432154.html.
  4. Add the pathnames, including the folder names containing the mxmlc.exe or java.exe, to the Path environment variable.

You can now create a profile using Profile Creator.

To create a device profile

  1. From the folder , launch the ProfileCreator.exe. The Profile Creator window opens:

  2. Select File > New Profile to create a new profile folder. The Create New Profile dialog box opens.
  3. Enter the profile name, and click Create. The profile is created under %appdata%\Qualcomm\Profiles\ directory and the default settings display along with the profile path and the available key events in the main window:

  4. Under the Phone Configuration tab, select or enter device profile information as follows:
    • Form Factor: Select Candy Bar (flip not supported), Flip or Slider (flip supported).
    • LCD Screen: Enter screen dimensions and touch points.
    • Supports 2nd Screen: Select for a second screen, and enter screen dimensions and touch points.
    • Supports Rotation: Select if the device supports rotation.
    • RAM Size (bytes): Enter size in bytes.
    • Key mapping/Extended Keyboard:
      • If Extended Keyboard is not selected, the 12-key keypad default mapping is displayed.
      • If Extended Keyboard is selected, the extended keypad default mapping is displayed.
    • Add, change, or delete key mapping:
      • Add: Select PC Keys, Modifier Keys (optional), and Brew Keys, and click Add.
      • Change: Select the key mapping entry, modify the mapping, and click Change.
      • Delete: Select the entry in the key mapping table, and click Delete.
  5. Select the following events that are supported for the device profile:
    • MMC Card
    • Headphone
    • Flip

    The PC key mappings to these events are read only.

  6. Under the Content tab, do the following:
    • Platform Version: Select from the available platforms installed on your computer under %BREWMP_PLATFORMS_ALL%. To create a profile for a platform not installed, enter the platform version in the field.
    • Group Box: Add or delete a file or directory for inclusion or exclusion in the profile.

      Note: If you remove a platform file or directory, the simulation target created from the profile may not work properly unless you add a new file or directory to replace the platform files or directories removed.

  7. After creating the profile, select File > Save and File > Build. A .bdpp file is generated in the associated device profile directory. The log window shows where the .bdpp file is created.

To import a device profile into Target Manager

  1. Locate and double-click the .bdpp file. The Target Manager is launched and imports the profile.
  2. Create the simulation target from Target Manager and launch the simulation target. The simulation target only has a screen.
  3. To use the PC keyboard as the device key, click in the simulator and the PC key events are sent to the Simulator.
  4. To view the PC key to Brew key mapping, press the PC esc key. A mapping table is displayed on the bottom right.
  5. Press the PC esc key to toggle the display and hide the mapping table.