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

Developer

resources

Managing physical targets

The Physical Targets list displays all configured devices, even if they are not currently connected.

Physical targets are listed by device ID in the Physical Targets pane of the Target Manager GUI as shown in the image below.

The following icons are associated with the physical target in Target Manager:

  • The green phone icon represents a Gateway connection.
  • The blue lock icon indicates that Developer Mode is not enabled on the device.
  • The orange timer icon indicates that the device is Developer Mode enabled, but the enablement will expire in 2 days or less.
  • The B icon indicates legacy BTIL. The icon is grey when legacy BTIL is disconnected, green when legacy BTIL is connected.

Any devices not currently connected have their connection icons greyed out, but can still be right-clicked on to view and modify their properties.

Adding a physical target

  1. To add a physical target, connect the target to your computer, and launch Target Manager.
  2. If the target is a either a Gateway-enabled Brew MP device or previously configured device, it will appear in the Physical Targets list in Target Manager, it does not need to be added. Otherwise, click the Add icon.

    The Add New Device Wizard dialog opens.

  3. Follow the prompts for OEM driver installation, and depending on your device, do the following steps:
    • For a Brew 3.x/4.x device, follow the prompts for selection of a BTIL or Diag port, along with BTIL client installation if required.
    • For a non-Gateway enabled Brew MP device, follow the prompts for selection of a Diag port and GatewayTurnOn.

    The device is now configured and appears in the Physical Targets list.

Device Settings

Double-clicking on the physical target ID launches the Device Settings dialog. The Device Settings dialog contains the following tabs.

  • General - The General tab of the Properties dialog displays the device IMEI, connected status, and Developer Mode status. If Developer Mode is not enabled on the device, click the Developer Mode tab. The display name for the device can be changed in the General settings dialog by changing the Device Name field, and clicking OK. The new name displays under Physical Targets.

    (Tip: You can change the physical target name to a more user-friendly name.)

  • Developer Mode - The Developer Mode tab of the Properties dialog allows you to enable your device via Developer Mode Enablement Service (DES) or using a Developer Mode Enablement Signature. The dialog shown below is for a device that is enabled. Developer Mode status for the device is displayed.

    To Developer Mode Enable a device using a Developer Mode Enablement Signature, select Developer Mode Enablement Signature, and click Browse to locate the signature on your computer. Select Enable.

    Select Disable Developer Mode to disable Developer Mode on the device.

    Note: The Developer Mode Enablement Service is no longer available. Use a Developer Mode Enablement Signature instead.

    For more information on Developer Mode, see the Connect Technology Guide on the Brew MP website.

  • Connection - The Connection tab provides the option to enable BTIL support for Brew 3.x/4.x devices or legacy Diag devices. To enable Legacy BTIL connection, disable Gateway, select a BTIL port from the COM port drop-down menu, and select Enable Legacy BTIL connection. To toggle Gateway, select a COM port to use for turning gateway on and off from the COM port drop-down menu, and select Toggle Gateway. If you do not see COM ports listed from the drop-down menus, select Refresh COM Port Lists. Note that if the device is reset, Gateway is disabled.
  • Features - The Features tab installs listed clients on Gateway enabled devices, and provides the option to install or uninstall features on the device.

Additional tools

For active connected devices, additional tools are available from the Actions menu of the Target Manager.

  • Remote Control - Remote Control is used to remotely inject key presses to a target (device or simulation target). For usage, see the Remote Control section of the Target Manager Help in the Tools Reference.
  • Interrogate - The Interrogator scans USB Gateway enabled devices for the loaded modules, Brew MP classes, registry, and hardware information. For usage, see the Interrogator Help in the Tools Reference.
  • Heap Analyzer - The Heap Analyzer is a PC-side UI tool that acts as a one-click solution for heap analysis and diagnostics. For usage, see the Heap Analyzer Help in the Tools Reference.