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

Developer

resources

Port settings

To work with a Brew MP device you must first enable USB access by enabling the device Gateway, which enables communication between the PC and the device so Brew MP Tools can connect to the device.

The Brew MP USB compositor supports Gateway only and Gateway + COM ports. The following device port settings options are supported:

  • USB Device only - This port setting allows activation of High Speed USB without need of manufacturer drivers. This driver is provided with the Brew MP SDK. USB only is sufficient for the general Brew MP developer community.
  • USB + MODEM + COM - This USB compositor supports combinatory port settings. Tools can use these combinatory settings to select the "best fit" or "as needed" port and protocol. For instance, when tool features do not exist over USB or USB features have limitations, COM can be selected. The USB + MODEM + COM setting is required to support OEM and Pro Developer communities. This allows a device to simultaneously support high speed USB operations, as well as OEM COM tools (i.e. QPST, QXDM). Typically, MODEM corresponds to Data and COM corresponds to Diag.

The Developer Mode port settings menu may be accessible as a hidden menu on your device by typing *#DEVMODE# on the device keypad.

Turn on Gateway using Target Manager

To turn on Gateway using Target Manager, do the following:

  1. Connect your device to your computer.
  2. Open Brew MP Target Manager.

    This can be done from Brew MP SDK Manager.

  3. Click the Add New Device button under the Physical Targets list.

    The Add New Device dialog opens.

  4. In the Add New Device dialog, click Next until you reach the dialog to select the diag port.

    Select the diag port from the drop-down list and click Enable Gateway.

  5. Once Gateway is enabled, follow the prompts to exit the dialog.

    The device is displayed in the Physical Targets list.

Turn on Gateway using GatewayTurnOn and DiagTurnOn command-line tools

The GatewayTurnOn and DiagTurnOn tools are located in the <%Brew MP SDK%\Toolset\bin\deprecated\BTIL\Host\bin> folder.

  • The GatewayTurnOn application is used to turn on Gateway mode on the device. If the factory default mode is set, the device will be changed to DIAG, DATA, NMEA and Gateway mode when GatewayTurnOn is used. If Gateway Only or DDNG mode is set on the device, there will be no change to the device. When connecting with the GatewayTurnOn tool, you need to connect to the device over DIAG first with the manufacturer's device driver installed on your machine.
  • The DiagTurnOn application turns on DIAG and DATA modes on the device. If the factory default, DITA, DATA, or NMEA mode is set on the device there will be no change using DiagTurnOn. If Gateway Only mode is set on the device, DiagTurnOn will switch the device to DDNG mode. If DDNG mode is set on the device, DiagTurnOn will not change the device mode.

The format of the commands for both tools is as follows:

GatewayTurnOn/DiagTurnOn [option]

Any port can be used as a parameter. Turning on Gateway or Diag mode lasts until the device is reset. Once the device has been reset, the mode returns to default.

command
-gui Runs the compositor GUI applet on device
-quiet Prints only error messages
-persist Save the current compositor settings as device default
-help Displays help contents and enable ports (device) list

Turn on Gateway using SystemTask application

The SystemTask application is released with the Brew MP SDK, in <%BREWMP_TOOLSET%/utilities/>. The SystemTask application modules need to be loaded to the device using Brew MP Loader, as described in the following steps. The device connection needs to be over DIAG, and you need a device signature. You can then use the GUI to turn on developer mode on the device.

  1. Install Brew MP SDK 7.4 (or newer).
  2. Connect your device to your system (assuming you have loaded the drivers for your device).
  3. Launch Brew MP Loader (SDK Manager > Tools > Loader).
  4. Connect to your device using Loader, selecting Brew Devices (COM/Diag) as the connection method and select the port where your device is connected (preferably serial if available).
  5. Using Loader, create a folder in fs:\usermods on the device for c_systemtaskapp.

    If your device does not have the usermods folder, create a folder in fs:\mod called fs:\mod\c_systemtaskapp.

  6. Copy the *.mod, *.png and *.ttf files from %BREWMP_TOOLSET%\utilities\SystemTask\c_systemtaskapp to fs:\usermods\c_systemtaskapp (or fs:\mod\c_systemtaskapp).
  7. Copy the *.mif file from %BREWMP_TOOLSET%\utilities\SystemTask\c_systemtaskapp to fs:\usermods\c_systemtaskapp or fs:\mif.
  8. Copy a valid sig file named c_systemtaskapp.sig to fs:\sys\mod\c_systemtaskapp.
  9. Reset your device.
  10. Launch c_systemtaskapp.
  11. For touch devices select the USB tab on the device screen, for non-touch device click * on the device keypad to access the USB tab.
  12. Select USB + MODEM + COM to put the device in Developer Mode.
  13. If Windows prompts for device drivers, specify the folder referenced by %BREWMP_TOOLSET%\drivers\usbdevice\Win32\WinXP\free for the driver location.
  14. Within Windows Device Manager, a device called Brew Mobile Platform is listed under Connected Gateway Devices.
  15. Install the device signature to the device using Loader by either obtaining a temporary signature from the Brew MP website using the DES, or by specifying your Developer Enablement Signature file.
  16. To verify the steps, install the Brew MP Visual Studio Plugin, and launch Visual Studio. In the Visual Studio toolbar select Physical in the Target Type list. The device ID should be visible in the Brew MP Target list.