Mobile Device Maintenance

image1

The Mobile Device Maintenance program is used to setup and configure a variety of different mobile device network accounts and to enter, edit and assign mobile communication devices to power units. (Power units are configured in the Power Unit Profiles program).

The Mobile Device Maintenance program can also be used to create groups of users, so the same message can be sent simultaneously to several mobile units at once from TruckMate programs like Driver Call In and the Message Center. Similarly, it is also possible to create different groups for controlling who receives the messages coming from the mobile units.

The panel on the right side of the window displays the details for the item selected from the list of mobile device accounts and account properties on the left.

The Mobile Device Maintenance program and the Communications Manager are two parts of a larger team. The Communications Manager provides the setup for the interface managing the data being sent to and from the mobile devices and the Mobile Device Manager keeps track of the associated logistics like the list of devices, which power units are using which device and creating groups of devices for simultaneous and selectively filtered mass communication.

To access Mobile Device Maintenance:

From this location Go to

TruckMate Menu and TruckMate Task List

Mobile Communication > Mobile Device Maintenance

Windows Start Menu

TruckMate 20xx > Mobile Device Maintenance

Windows Explorer

C:\Program Files (x86) > TruckMate 20xx > Cfgcomm.exe

Setting up Mobile Device Maintenance

The basic steps for setting up mobile devices are:

  • Get the account and login information for your mobile device network account from Trimble (e.g. PeopleNet) or a third party vendor.

  • Go to Mobile Device Maintenance and setup your Mobile Device Network Account

  • Enter your mobile devices and assign them to specific equipment items

  • Create groups for sending messages to multiple devices

  • Create user distribution groups for receiving messages from devices

  • Configure additional device settings specific to this Mobile Device Network

  • Go to the Communications Manager program > Service menu > Windows Service Setup to setup / start the Windows service.

  • Go to the Communications Manager program > File menu > Configuration and complete the configuration for your mobile device network.

Application Configurator for Mobile Device Maintenance

The following Application Configurator options are listed under Configuration Options > CFGCOMM.EXE.

Option Definition Values

Multiple Devices Per Resource

Disables the check for multiple devices that would normally restrict how many devices can be assigned to a single resource (e.g. Power Unit). Allows you to add more than one mobile communications device.

  • True

  • False (default)

Security Configuration for Mobile Device Maintenance

The following options are available under Security > Business Events > Communications.

Enable Add Mobile Account

First available in TruckMate 2024.1

When selected, the Add Account button is enabled. By default, this option is deselected.

Enable Remove Mobile Account

First available in TruckMate 2024.1

When selected, the Remove Account button is enabled. By default, this option is deselected.

Adding a Mobile Device Network Account

A mobile device network account is required before you can set up TruckMate to communicate with the associated mobile devices using this network. Once you have been registered and setup with the mobile network, you need to configure TruckMate to communicate with the devices.

  1. Devices from more than one mobile communications network can exist in the system.

  2. As of TruckMate 2024.1, the ability to add an account is disabled by default for all users and groups. A system administrator can enable this feature.

To add a mobile device network account:

  1. In Mobile Device Maintenance, click Add Account.

    image3

    The Create Account window is displayed.

    image4

  2. Select a network account and click OK.

    Note: The list of available devices and network accounts will change over time as new devices enter the market and old devices become obsolete.

  3. The Mobile Device Maintenance window will display the new network account in the list on the left side of the window.

    Note: You may optionally give this account a different name if you need to differentiate it from other similar network names. (You can revise the network account name later.) This name is appended to the default name for this network account. For example: If you enter the name as CDN for the TruETA network it would appear as follows:

    image5

  4. Select the network account name you just added to the list.

    image6

    The remaining settings will be specific to your installation.

  5. If you are uncertain, accept the defaults for now and confirm the settings with your mobile network vendor, TruckMate implementer or TruckMate support.

    Field Definition

    Location Lookup

    (Normally set to Client.)

    Legacy: This is the default to ensure continuity for customers who were already setup before this Location Lookup feature was added in TruckMate 2015. It ensures the workflow is not changed unless someone explicitly adjusts this option.

    Client: Sets both the processing of returned information and the stoplist generation process to use client locations

    Zone: Sets both the processing of returned information and the stoplist generation process to use zone locations.

    Position Updates

    These checkboxes determine which resource items will also have their positions revised as part of the Driver Workflow updates. If the updates occur too frequently or take too long, deselect a resource type to increase performance.

    TruckMate API Identifier

    Enter the TruckMate API Identifier if your mobile network is setup to use the API to communicate with TruckMate.

    Click the Notifications button to enter the associated API notification setup information.

    image7

    The TruckMate API is a SOAP-based programming interface to TruckMate to enable easier integration with third party networks.

    Status Validations

    Enable Next Status Validation

    Restricts the status code updates (from a macro) to the defined 'next available' set of status codes.

    Prevent Trip Status Updates On Status Validation Error

    Prevents the trip from being updated by a mobile device if a macro tries to update a trip’s status incorrectly. This allows a dispatcher to apply the correct status updates and give control back to the mobile device.

  6. Click image8 Post to save your changes.

Removing a Mobile Device Network Account

  1. If you remove a mobile device network account, it will also remove all the devices, groups and any other device or network settings (e.g. reefer monitoring, sensor data, etc.) associated with this network. (It will not delete drivers, power units, trailers, etc.)

  2. As of TruckMate 2024.1, the ability to remove an account is disabled by default for all users and groups. A system administrator can enable this feature.

To remove a mobile device network account:

  1. In Mobile Device Maintenance, select the mobile device network account.

  2. Click the Remove Account button.

    image3

    A confirmation message is displayed.

    image9

  3. Click Yes to remove the mobile device network account.

Adding a Mobile Device

  1. In Mobile Device Maintenance, select the mobile device network account.

  2. Select Devices for that account.

  3. Click the Insert image10 button to enter a device.

    image11

  4. Make the appropriate entries to the fields associated with this specific mobile device. The fields and options will vary depending on the network account but the following describes some basic fields common to most devices.

    Required field: *

    Field Definition

    Device ID *

    Every mobile communications system assigns a unique identifier to each of their mobile hardware devices.

    Enabled

    This checkbox indicates the working status of the mobile unit. If the unit is no longer active or the Device ID is not valid, clear this checkbox. If a device was previously or is currently assigned to a power unit and actively used to communicate data, it cannot be deleted because messaging data is tied to this master record. A device must be associated with a specific unit before it can be enabled.

    Special Events Enabled

    The system will send a macro to your Mobile Communication Devices whenever a Special Event is added.

    Training Mode

    This option allows you to set a specific Mobile Device into Training Mode. Use this when training new drivers on device usage without running the risk of triggering an automatic action in dispatch based on an error made by the trainee driver. This allows the dispatcher to take required actions manually based on return driver messages for those devices flagged as Training Mode.

    There is an extension to this feature handled within the Macro Definition program. Instead of disallowing automatic updates of dispatch altogether for a device, you can specify those fields you do not want to auto-update. This way you can mark a device as being in Training Mode but still allow some of the low risk fields to be updated.

    Equipment Type

    Use the drop-down list to select the equipment type associated with this mobile device. The available options will vary depending on the specific account network.

    image12 image13 image14

    Unit ID

    Use the pick-list to enter the ID for the equipment where this mobile device is installed.

    image15

    Device Alias

    Enter a meaningful device alias name into this free form text field.

    Distribution Group

    Specifying a distribution group here indicates that all return messages from this device / power unit will only be returned to the members of the selected group meaning you can set up a device so it sends return communications only to a specific group of dispatchers. Leave this field empty to enable all users (who have the security permissions) to view the messages coming from this device.

    These groups are created and managed using the Maintain Distribution Groups function found in the Tools menu. These groups are not the same as the distribution groups associated with the devices.

    This is a complementary reverse function to the logic of the devices groups, which allows dispatchers to broadcast forward communications to a specific group of devices (e.g. power units).

    Firmware

    Use this free form text field to indicate the firmware used by this device.

    Comments

    Use this free form text field to enter any additional text such as notes regarding repairs and/or upgrading of the device hardware.

  5. Ensure the Enabled checkbox is selected for each active device.

    image16

    Note: A device must be associated with a specific unit before it can be enabled.

  6. Click the Post image17 button to save your entry.

The bottom grid lists all the devices currently entered and associated with this mobile device network account for easy reference.

Assigning a mobile device to a power unit, trailer, etc.

When assigning a mobile device to equipment such as a power unit, trailer, chassis, etc., all position updates returned from this device will be used to update the equipment’s position in Dispatch. Similarly, all messages forwarded to the power unit, trailer, etc. will be sent to this device, and all messages returned from this device will be displayed as returning from the power unit, trailer, etc.

TruckMate does attempt to match a driver to a power unit based on the current dispatch assignments, so some return messages may be displayed as having come from a particular driver. However, in cases of ambiguity (i.e. a team driving situation), the power unit is the most reliable indicator of what device originated a return message or position update.
  1. In Mobile Device Maintenance, select Devices for the network account.

  2. Locate the Device ID.

  3. Ensure the equipment type is correct. If not, use the drop-down list to select a different equipment type. The available options will vary depending on the specific account network.

    image18 image12 image14

  4. Use the pick-list to enter the ID for the equipment where this mobile device is installed.

    image15

  5. Ensure the Enabled checkbox is selected for each active device.

  6. Click the Post image17 button to save your entry.

After a device has been assigned the Miscellaneous Info tab on the Profiles > Power Unit Profiles and Profiles > Trailer Profiles windows will display the status and the mobile device ID currently assigned to this unit.

image19

Creating groups for sending to multiple devices

Groups are used by programs like the Message Center and Driver Call In to broadcast a message simultaneously to several devices (users), within a specific group. These groups will be unique to each mobile device network account. (These groups are not the same as the distribution groups created by using the Maintain Distribution Groups function found in the Tools menu that can control messages coming from the devices.)

To define groups (e.g. fleets) for the dispatchers to broadcast messages to:

  1. In Mobile Device Maintenance, select Groups for your mobile device network if it supports groups. (Not all mobile device network accounts support groups.)

    image20

  2. The Groups window is displayed.

    The Legend color green identifies which devices are active and enabled.

    Note: An invalid device may be a device that was created belonging to one network, assigned to a broadcast group, and then reset to belong to another network, whether purposefully or accidentally. Either the device configuration should be fixed or the device removed from the group to resolve the problem.

  3. Click image10 Insert.

  4. The Add/Edit Group window is displayed.

  5. Enter a Group Name and Description and click OK.

    Keep the group names short and descriptive to allow dispatchers to quickly identify which group to broadcast a message to.

    image21

  6. Select the group you just created.

  7. Select a mobile device from the Devices list and click the Add Selection button to add this device to the group.

    image22

  8. Use the Delete Selection button to remove any devices from the group

    Note: Devices can belong to more than one group at the same time. Invalid and disabled devices should be removed from the group to prevent unnecessary messages from being generated and sent to those units.

The groups created here will be immediately available in other programs like the Message Center and Driver Call In.

For example, here is the groups section as it is displayed on the Message Center.

image23

Creating user distribution groups

Distribution groups can also be setup to control which TruckMate users (e.g. a specific group of dispatchers) will simultaneously receive messages transmitted from the devices.

These distribution groups are not the same as the groups associated with the devices that allow dispatchers to broadcast forward communications to a specific group of devices (i.e. power units, drivers).

Users can belong to more than one distribution group at the same time.
  1. In Mobile Device Maintenance, go to Tools > Maintain Distribution Groups.

    image24

  2. The Distribution Group Setup window is displayed.

    image25

    Note: The Distribution Group Setup window can also be opened within the Communications Manager program by selecting Configuration from the File menu, going to the Distribution tab and clicking the Setup button for Addressed Messages.

  3. Create a new group by entering text (uppercase to a maximum of ten characters), and clicking the image26 Insert button.

    image27

  4. Use the image28 Copy button to add users to the selected distribution list for this group.
    (Use the image29 Delete button to remove users.)

    image30

Configuring additional device settings

Consult your third party vendor regarding any additional device settings specific to their Mobile Device Network.

Reefer monitoring

Because of the sensitivity involved when operating reefers and the amount of damage that might be caused if something goes wrong with the temperature or the planned rout of the trip, there are devices that can monitor both the temperature and the mileage of the reefer.TruckMate through this option allows the user to set up a Reefer Monitoring instance.A device that supports such monitoring must be available. (e.g. Shaw Tracking/Omnitracs TrailerTRACS)

Refer to the specific mobile device network documentation from the manufacturer or third party supplier for details about how to configure these devices.

For example, Shaw Tracking/Omnitracs TrailerTRACS offers a specific checkbox to indicate the device will be used with a Tethered Reefer type of trailer.

image31

image32

Handling missing devices

First available in TruckMate 2024.1

Occasionally, a mobile communications provider sends communication from a device that is not found within the TruckMate environment. When this happens, TruckMate adds an entry into the log file for the Mobile Communications Manager service, as shown in this example:

tm 157791 241a

If you do not have access to this log file, you can see information about missing devices in the mobile_missing_devices database table and in the Devices Not Installed grid.

tm 157791 241b

If you want, you can install the device or remove the device altogether.

Add the device

  1. Select Install Device from the right-click menu.

  2. Assign the device to a resource, such as a driver or trailer. This links the device to the resource.

  3. Save the assignment.

This removes the device from the mobile_missing_devices table and adds it to the mobile_device table. The device appears in the Installed Devices grid automatically.

Remove the device

Select Remove Device from the right-click menu. This removes the device from the mobile_missing_devices table.

Note that if the device appears in the Devices Not Installed grid again (via a new ping report, macro message, or other means), you have the option to install it if you want.