Managing modules and assets

When you purchase BlackBerry Radar devices, the devices are added as "modules" to the BlackBerry Radar Dashboard application under your organization. You need to add the assets that will host these modules to the application.

Before adding any assets to the application, you must define the asset types, as you need to specify the asset type when adding an asset. A typical sequence of asset configuration is as follows:

  1. Define asset types
  2. Add assets
  3. Pair assets with modules

The rest of the tasks can be performed as required.


Define an asset type

An asset type is a common alerting configuration for assets that share that configuration. In each asset type, you can specify the types of alerts you want the BlackBerry Radar Dashboard to notify users about. For example, you can define an asset type for assets that carry cargo of high value. In this asset type, you can include alerts about changes in door state and unusual changes in temperature and humidity. When the BlackBerry Radar service discovers any alert condition in any asset of this asset type, it will report that condition as an event on the map, and also send an alert notification message to registered users.

Note: These alerts may not apply to all assets.

If needed, you can override the alert settings for an individual geofence or a particular asset. For more information, see Configure or modify alert settings.

To define an asset type:

  1. Open the Assets Types view from the main menu.
  2. Click Add Asset Type.
  3. Enter a name and a description for the asset type.
  4. In the Alert On area, check each box that you want to include in asset alert notification (see example).
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  5. In the Update Frequency area, default update frequencies are provided for the Radar module and the Radar-L module. If you don't want to use the default frequencies, select an update frequency from the dropdown list for each module type. The default update frequencies indicate:
    • Radar: 15min/24hr For a Radar module, asset data is updated every 15 minutes when asset is in motion, every 24 hours when asset is not in motion.
    • Radar-L: 30min/24hr For a Radar-L module, asset data is updated every 30 minutes when asset is in motion, every 24 hours when asset is not in motion.
  6. Click the Add Asset Type button.

Add an asset

When a new asset is added to your fleet, enter the asset in the application.

  1. Open the Assets view.
  2. Click Add to open the Add Asset view. A red textbox denotes a mandatory field.
  3. In the Identifier field, enter the asset identifier. This is usually the number or code painted on the exterior of the asset.
  4. Under Asset Type, click to display the dropdown list. You must have the required asset type defined (see Define an asset type).
  5. Select the asset type from the list.
  6. Under Asset Class, click and select the asset class from the dropdown list. Note: For some of the Asset Class options (such as Chassis), Door Type, Mounting Location and Dimensions are not applicable.
  7. Under Door Type, click and select the door type from the dropdown list.
  8. Under Mounting Location, click and select the mounting location from the dropdown list.
  9. In the Notes field, enter any notes if needed. You can leave this field blank.
  10. In the Mileage at Install field, enter the mileage at the time of installation, or use the arrow buttons at the right end of the field.
  11. In the Dimensions fields, enter the asset dimensions.
  12. Click Save New Asset.

Add assets in bulk

If you have a large number of assets to add, you can add them by uploading a CSV file that contains the information about the assets.

CSV stands for comma-separated values. A CSV file is a text file that contains information structured in tabular form. If you have an Excel spreadsheet that contains all the assets as well as the required information about the assets (see list below), you can create a CSV file simply by saving your Excel file as Comma Separated Values (CSV).

It’s important to note that your CSV file must contain all the information required for each asset. This means that you must include the following columns in your CSV, and that each column must contain the required information, as detailed below.

You can give the columns any names in your CSV file, but the column names must be in the first row and separated by commas (or another delimiter that you decide to use).

The content of the asset type column must match the asset type names used in the application; for example, if your asset type is Perishable Cargo, enter it exactly in your CSV file.

The content of the Door Type, Roof Type, and Asset Class columns must use only lowercase letters. For any multiple-word type names, you must use underscores between the words. The table below lists all the type names used on the Dashboard UI and their expected values in the CSV file.

On Dashboard UI In CSV
Asset Class
  • Reefer Trailer
  • Dry Trailer
  • Heated Trailer
  • Reefer Container
  • Dry Container
  • Heated Container
  • Chassis
  • Flatbed
  • Light Vehicle
  • Heavy Equipment
  • Other
  • reefer_trailer
  • dry_trailer
  • heated_trailer
  • reefer_container
  • dry_container
  • heated_container
  • chassis
  • flatbed
  • light_vehicle
  • heavy_equipment
  • other
Door Type
  • Barn
  • Rollup
  • None
  • barn
  • rollup
  • none
Mounting Location
  • Door
  • Chassis
  • door
  • chassis

Note: Door Type and Dimensions are not required for the following asset classes:

The CSV file excerpt below provides some sample entries.

Note: The Notes field is required in the CSV file. You can enter any notes in the field or leave it blank.

Note: A CSV file may contain no more than 1000 rows. A larger CSV file will cause the import to fail.

Note: Importing a CSV file will block the application UI until the import is completed. Do not close the browser while a CSV file is being processed.

To upload a CSV file:

  1. Open the Assets view.
  2. Click CSV.
  3. In the Upload CSV File of Assets view, change the delimiter to match the delimiter used in your CSV file, if needed.
  4. Click Choose File under CSV File.
  5. Navigate to the location of the CSV file to upload, select the file, and click Open.
  6. In the next screen, in the Configure Columns area, Data Field lists the data fields required for adding your assets. In each dropdown list under CSV Field Header, select the header name that matches the data field on the left.
  7. Click Process CSV File. When processing is complete, a summary of the operation is displayed (see example).
  8. Click Done to go back to the Assets view.

Pair a module with an asset

When a BlackBerry Radar module is installed on an asset, you need to pair the module with the asset in order for asset tracking to start on this asset. This can be done in either the Modules or the Assets view.

At the Modules view:

  1. Open the Modules view.
  2. Check the module type or association button(s) to filter the list.
  3. Select the module from the list. If the module is already associated with an asset, you need to disassociate it first before associating it with a different asset.
  4. To pair with an existing asset, under Associate with Existing Asset:
    • Type in the asset identifier or select from the dropdown list.
    • Click Associate.

Alternatively, at the Assets view:

  1. Search for or select the asset from the Assets view.
  2. Open the Association tab. This asset’s association is shown under Current Association.
  3. If this asset is already associated with another module, click Disassociate.
  4. In the confirmation dialog box, click Yes.
  5. Under Associate with Module,
    • Click the module type button to filter the list.
    • Click Select Module to display the dropdown list.
    • Select the module to associate with.
    • Click Associate.

Unpair a module

When a Radar module needs to be replaced or removed from the container, remove the association between the module and the asset in the BlackBerry Radar Dashboard. You can do this from either the Modules view or the Assets view.

From the Modules view:

  1. Open the Modules view.
  2. Select the module from the list.
  3. Click Disassociate.
  4. Click Yes in the confirmation dialog box.

Alternatively, from the Assets view:

  1. Open the Assets view.
  2. Select the asset from the list.
  3. Open the Association tab.
  4. Click Disassociate.
  5. Click Yes in the confirmation dialog box.

Modify asset information

You can modify an individual asset's properties, such as its asset type and asset class, in the asset view:

  1. Open the Assets view.
  2. Click the asset to modify.
  3. Click Options to open the Options tab.
  4. To change the asset identifier, enter the new identifier in the Identifier field.
  5. To change the Asset Type, Asset Class, Door Type, or Mounting Location selection, select the new type from the corresponding dropdown list.
  6. To modify or add to notes, enter it in the Notes area.
  7. To change asset dimensions, enter new dimension values in the Dimensions fields.
  8. Click Save Changes.

Modify asset alert settings

You can modify asset alert settings in the asset view.

Note 1: For an asset that is associated with a Radar-L module, only the following alerts are available for configuration:

Note 2: For any asset of the following Asset Class, the “Door” alert is not applicable:

For more information about events and alerts, see Events and alerts.

  1. Open the Assets view.
  2. Click the asset to modify.
  3. Click Options to open the Options tab.
  4. Check the Override alerting box. This opens a new list of alert boxes. Note that alerts set here will override the alerts set in the asset type or in any geofence. Check all the boxes that you want to override alerting for; modify the values under the alerts as needed.
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  5. Scroll down and click Save Changes.

See example for a Radar module; example for a Radar-L module.


Remove an asset

If an asset needs to be removed from the fleet, remove it from the BlackBerry Radar Dashboard. Note that if an asset is associated with a module, you cannot remove the asset.

  1. Open the Assets view.
  2. Click the asset you want to delete.
  3. Click the grey garbage can button garbage can button at the upper right corner of the asset view. If the button is not clickable, this asset is in use and cannot be removed.
  4. Click Yes in the confirmation dialog box.

Remove an asset type

If an asset type is no longer used, you may remove it from the Dashboard application. Note that if any asset is assigned to this asset type, you won’t be able to remove the asset type.

  1. Open the Asset Types view.
  2. Click the asset type you want to remove.
  3. Click the grey garbage can button garbage can button at the upper right corner of the asset type view. If the button is not clickable, this asset type is in use and cannot be removed.
  4. Click Yes in the confirmation dialog box.