Sorry, you need to enable JavaScript to visit this website.

Additional features

Remote access

As of the 16.2 release BRIDGE allows devices to be accessed remotely (and controlled) via the TeamViewer QuickSupport app. To setup your fleet you will need to:

  1. Download and add the TeamViewer QuickSupport app from the TeamViewer website to your package-list.
  2. Add the TomTom TeamViewerQSAddon from the download page to a package-list. As of 16.6 release this step is no longer required.
{ "name": "com.teamviewer.quicksupport.addon.tomtom", "path": "TeamViewerQSAddon_tomtom.signed.apk", "version": "4765" }
    

Once installed your user must open the app, send you their id and then allow your request on the device screen.

Connecting to an external camera

TomTom Bridge devices support an external video camera connection - either via the 16pin cable bundle on Bridge Hub or with a dock with external camera support for Bridge Terminal devices.

Applications that want to use an external camera, should use the standard Android Camera API.

Here are some hints for using the external camera in app development:

  1. The external camera is identified as the front facing camera.
  2. The external camera has a constant resolution of 640x480. It does not depend on the actual camera hardware that is used.
  3. The intent sent when the external video becomes available is:
     "tomtom.intent.action.VIDEO_AVAILABLE"

    and when it becomes unavailable:

    "tomtom.intent.action.VIDEO_UNAVAILABLE"
  4. Note that when tomtom.intent.action.VIDEO_AVAILABLE is sent, it means that the video dock was just connected and the initialization of the video camera has started. It might take up to 3 seconds to set up the camera. In this case, Camera.open(camId) will throw a RuntimeException. To deal with this situation consider the following piece of code:
      int count = 0;
      Camera camera = null;
      do {
          try {
              for (int camId = 0; camId < Camera.getNumberOfCameras(); camId++) {
                  CameraInfo camInfo = new CameraInfo();
                  Camera.getCameraInfo(camId, camInfo);
                  if (camInfo.facing == CameraInfo.CAMERA_FACING_FRONT) {
                      camera = Camera.open(camId);
                      break;
                  }
              }
          } catch (RuntimeException ex) {
          }
          if (camera == null) {
              try {
                  Thread.sleep(100);
              } catch (InterruptedException e) {
                  Log.w(TAG, "Sleep was interrupted.", ie);
                  break;
              }
          }
      } while ((camera == null) && (count++ < 30));
    

Android application installer

App installer was developed to allow a quick installation of android applications without using the Software Update mechanism. It is not intended for final configuration of the device.

Note that all the apps installed by the Android application installer will be removed if a user does Personal Data Reset or a factory reset.

To install an android app on the device follow the next steps:

  1. Put an Android app .apk file to the root folder of a micro SD card.
  2. Insert the micro SD card in the TomTom Bridge device.
  3. A dialog will appear on the screen, prompting to install one or more Android Applications from the SD card.
  4. Click 'Install' and the standard android installation dialog will appear.
  5. Follow the steps in the dialog to install the application(s).

Important:

If "Unknown sources" is disabled in Security Settings, the user will not be prompted for installation.

Screen Lock feature

This feature is only available on Android 4.3 (17.4 Baggio) or earlier. It will not be supported in Android 6. The Screen Lock feature locks user interaction with the screen.

With the exception of the  back, home and volume buttons, when the user touches  the screen,  they will be informed  the reason for screen lock with a full screen notification.

When activated there will  be an icon on the system bar informing the user that the screen is locked. The full screen notification will stay on the screen for 3 seconds, unless the user docks/undocks, rotates the device, or touches the screen.
Note that the screen lock will be deactivated once the device is rebooted.

There are a few things to take care of when using this feature. Firstly, you need to be careful you don’t lock the screen and never unlock it, as this will render the device unusable. If you choose to use a custom message then you should take care to keep it short as the full screen notification will only display for 3 seconds and your user needs sufficient time to read it.

Enabling the Screen Lock Feature

To have the screen lock feature enabled on the device, the “screenlock-allowed” package needs to be installed on the device.
This package can be found in the extra-packages.zip on the Releases page.

Activating the Screen Lock feature

The screen lock can be activated or deactivated by sending the following broadcast:

  • am broadcast -a "tomtom.intent.action.SCREEN_LOCK" --ez enabled true
    This will enable the screen lock and a default string ("Screen locked for safety.") will be displayed in the notification when user touches the locked areas.
  • am broadcast -a "tomtom.intent.action.SCREEN_LOCK" --ez enabled true --es lock_description "Your custom message"
    This will enable the screen lock and  "Your custom message" will be displayed in the notification when user touches the locked areas.
  • am broadcast -a "tomtom.intent.action.SCREEN_LOCK" --ez enabled false
    This will disable the screen lock, and make the whole screen interactive.

Immersive mode

This section is only relavant for Android 4.3 (17.4 Baggio) and earlier. For Marshmallow please see the Android documentation.

There are two ways to implement immersive mode, the first, and preferred, method is to add an immersive mode flag to the system UI visibility flags in an activity's view, and the second method is to use the policy control feature of android.

System user interface visibility

Immersive mode can also be enabled in any android activity by setting the SYSTEM_UI_FLAG_IMMERSIVE or SYSTEM_UI_FLAG_IMMERSIVE_STICKY flag on the activity view as follows:

int vis = View.SYSTEM_UI_FLAG_FULLSCREEN
        | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
        | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
View decorView = getWindow().getDecorView();
decorView.setSystemUiVisibility(vis);

The immsersive mode flags should be set in both onCreate() and onResume(), this will cause the activity to use the standard android immersive mode features described in the android developer documentation.

The following flags were also added to the TomTom addon:

tomtom.platform.View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
tomtom.platform.View.SYSTEM_UI_FLAG_IMMERSIVE
tomtom.platform.View.SYSTEM_UI_FLAG_IMMERSIVE_TOTAL

Applications can use either the tomtom.platform flags, or the standard android flags when calling setSystemUiVisibility()

The tomtom.platform.View.SYSTEM_UI_FLAG_IMMERSIVE_TOTAL flag is only available with the TomTom addon, if an application uses this flag then the system bar will never be shown while the application is active.

Policy control

The window policy control can be used to apply runtime adjustments to the global window policy. This includes forcing immersive mode behavior for the system bar (based on a package list) and permanently disabling immersive mode confirmations for specific packages.

Control by setting Settings.Global.POLICY_CONTROL (policy_control) to one or more name-value pairs. e.g.

To force immersive mode everywhere:

settings put global policy_control "immersive.full=*"

To force immersive mode for all apps except a specific package:

settings put global policy_control "immersive.full=apps,-com.package"

To force total immersive mode for all all apps:

settings put global policy_control "immersive.total=*"

To disable the immersive mode confirmations for specific packages:

settings put global policy_control "immersive.preconfirms=com.package.one,com.package.two"

Separate multiple name-value pairs with a colon:

settings put global policy_control "immersive.full=apps:immersive.preconfirms=*"

Disabling access to the notification tray

As of 15.3 Rossi access to the notification tray and its notifications can be disabled so that users cannot open the notification tray or open a notification. To do so a package must be installed and the device must be rebooted. Simply install ro-tomtom-sysbar-expand-disable_1.0_arm.ttpkg from the extra-packages.zip on the Releases page.

Privacy disclaimers

If your application records or collects privacy sensitive information, you should inform the user of this. To keep this clear to the user, we've provided a mechanism to show all these disclaimers in one location: Settings → About your TomTom device → Legal information → Your information. You'll see all apps listed there and tapping them will show you their privacy information.

To list the privacy disclaimer of your application there, you need to add a meta-data element called privacy_disclaimer to the application element of the application's AndroidManifest.xml, defining a reference to a string resource via the android:resource field. For example:

AndroidManifest.xml

    <application android:name="CustomApp"
               android:label="@string/application_name"
               android:icon="@mipmap/ic_launcher_custom_app" >
 
        <meta-data android:name="privacy_disclaimer"
                  android:resource="@string/privacy_disclaimer"/>
        ...
    </application>

strings.xml

    ...
    <string name="privacy_disclaimer"><b>General</b>\nThis is a stylized <i>privacy disclaimer</i>.</string>
    ...

Wake on SMS

TomTom Bridge can be woken up from sleep by sending an SMS to it. The screen is not turned on by default, but an intent tomtom.intent.action.MODEM_WAKEUP is broadcasted by the system. Upon receiving the intent, applications can decide whether to turn on the display or to do some work and sleep again. The intent tomtom.intent.action.MODEM_WAKEUP is only sent to the current user to prevent multiple instances of the same application from retrieving the intent.

Writing to external SD card

This feature is only available on Android 4.3 (17.4 Baggio) or earlier. For Android 6 please see the Android documentation (getExternalFilesDirs).

By default, applications are allowed only to read from the external SD card. To enable writing to the SD card, the “write_external_media” package needs to be installed on the device.
This package can be found in the extra-packages.zip on the Releases page. The application requires the android.permission.WRITE_EXTERNAL_STORAGE declared in its AndroidManifest.xml to use this feature.

Risks of allowing write access to the external SD card

Use this feature only for testing purposes. Unknown third party applications can write unlimited amount of data and access other applications data on the SD card. They can also leave the data undeleted in the SD card when uninstalled.
If an application relies on the inserted sd card and the user ejects it, there would be unexpected failures. If the user ejects the cards while an application is writing to it, the data could get corrupted.

Ethernet Dongles

This feature is only available in Android 4.3 (17.4 Baggio) or earlier.

When TomTom Bridge is connected to internet via a supported ethernet dongle, the ethernet connection takes priority over all other available connections.

Changing passwords

This feature is only available in Android 4.3 (17.4 Baggio) or earlier.

The DevicePolicyManager.resetPassword() in the standard android API allows programmers to change the current users password. The TomTom addon has a new API that extends this functionality to allow setting and clearing the password for a specified user.

public boolean resetPassword(String password, int flags, int userHandle);
    try {
        tomtom.platform.DevicePolicyManager ttdpm = new tomtom.platform.DevicePolicyManager();
        boolean ret = ttdpm.resetPassword(password, 0, userId);
    } catch (SecurityException ex) {
        Log.e(TAG, "Security exception: ", ex);
    }

See the documentation in the TomTom addon for more details.

Miracast

Screencasting with a Miracast dongle is supported on Bridge Terminal but not Hub at the moment.