Skip to main content
Omnitracs Knowledge Base

Omnitracs Drive 6.5 Mobile Release

Overview

We are pleased to announce that Omnitracs Drive and CoPilot v6.5 Mobile Release is available. This release includes feature enhancements and software corrections.

 

Features

 

Updated APK Versions

CoPilotDriveAndroid (APK) 6.5.0.0030
DocsAndroid / Scanning (APK) 6.5.0.0002
DriveAndroid (APK) 6.5.2.0083

 

CoPilot

We continue working to enrich your experience with the application.
This version includes two important functionalities, AMS authentication and Map Upgrades. 
Look at these important considerations:

  • Both Drive and CoPilot apps should be upgraded to the 6.5 release.
  • The Customer should have a Fleet portal account for mobile app licensing to work.
  • Before launching Copilot app, Mobile Device ID needs to be configured as Asset under Account Manager in Trimble Fleet Portal (To do this please see the “Steps to add a Mobile Device ID asset in Trimble Fleet Portal”  section).
  • Until 6.4, CoPilot app will work even when it is not registered in Fleet portal, because the device will be auto-added to the Trimble Fleet portal bucket account. This will not be the case in 6.5 and going forward.
  • Vehicle ID needs to be configured in Trimble Fleet Portal for functionalities like route reporter, routing profile, and route modifiers to work (To do this please see the “Steps to add a Vehicle ID in Trimble Fleet Portal”  section).
  • Vehicle Group must exist to be able to associate additional functionalities like route reporter, routing profile, and route modifiers (To do this please see the “Steps to add a Vehicle Group in Trimble Fleet Portal”  section).
  • Vehicle Group and Vehicle IDs must be associated in Trimble Fleet Portal for route reporter, routing profile, and route modifiers to work (To do this please see the “Steps to associate Vehicle ID to Vehicle Group in Trimble Fleet portal”  section).
  • CoPilot will display the following message when the same license is used on another device: Shutting down CoPilot due to expired or invalid licenses. Please contact your fleet admin. 
  • In Fleet Portal the naming convention of Vehicle ID and Mobile Device ID had some changes, now the Vehicle ID format is <rnavehicleid>-<rnacustomerid>-<environment> and the Mobile Device ID format is <mobileid>/<environment>.
  • Vehicle IDs and Mobile Device Assets IDs must be unique to work.
  • It is highly recommended to follow the same vehicle group/equipment type between OT1 and Trimble FP.
  • Android mobile devices need to have connectivity at least once a week, for CoPilot mobile app licensing to work.
  • Need regular Wi-Fi connection to download or upgrade the maps. Map download or upgrade is not supported through the AMG-C or Relay connection.
  • When launching the applications please wait until the initialization is completed.
  • CoPilot navigation settings are based on the truck type configured. 
  • In the Local.ini file, CoPilot saves the current AMS configuration information under the License section: deviceid, environment, status, tenantid, and type of auth.
  • The CPIK library was updated to support special characters.
  • The following Setting Options can now be remotely configured in the Command Portal under the CoPilot navigation Routing Options:
    • Allow International Borders (For all truck types)
    • Routing Type: Fastest (For all truck types)
  • The Display Truck Restriction value set in Command is now honored and retrieved by the CoPilot app. 
  • To improve Customer Support, the logs now save the destination address and coordinates of received Drive Stops.
  • CoPilot maps will now be updated quarterly. 
  • The map version will be auto updated to the latest version in the background.
  • CoPilot will display the following message when Wi-Fi is needed to upgrade maps: Need Wi-Fi connection to upgrade maps.  
  • The Android notification menu displays the progress status bar for the map upgrade process.

 

Drive/Command

  • Modified the grid view, list view, and map popup context to display the Workflow Stop Type.
  • The RNA Dispatch record for Unplanned Stop Types will default to Generic, but can also be recorded as Generic, Break, or Layover. 
  • Models and mapping updated to include attachments.
  • When files are attached to dispatch to a driver message in RNA, the files are now sent to MilesAhead with the message to be downloaded by devices. 
  • Added the ability to attach a picture in Messages from either the camera or image library.
  • Redeliver functionality modified to be simpler for the user with dropdown choices for desired actions
  • Unplanned Stops captured in Drive are now reflected in Fleetview..
  • Modified the Connect to Vehicle process to keep the user in Drive avoiding transition to XRS compliance application.
  • New Connected Equipment view provides single-click access to drop, hook, and DVIR tasks.
  • Modified colors and fonts and provided other small visual improvements to support the latest brand and enable better consistency across all applications.
  • Single Sign On integration support for Supervision CSA Performer.
  • Add "Hide Cancelled Stops" option to My Day Planner.
  • Allow cancellation of Unplanned Stops.

 

Driver Vehicle Inspection Report (DVIR)

The driver is not required to complete a Driver Vehicle Inspection Report to activate equipment on Hours of Service (HOS) logs for customers who do not have DVIR as a mandatory requirement of a load.

 

Hook Trailer Data

The Hook Trailer Task auto populates the trailer data for the driver, so that the driver does not need to enter it manually.

 

Steps to add a Mobile Device ID asset in Trimble Fleet Portal:

To grant the license access of your application, a Mobile Device Asset must be added to Trimble Fleet Portal, please follow next steps to do it:

Add a Single Device ID

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com)

3.  In the top right select “Web Tools” option

clipboard_e3dc483e2b5510bc4b4c349becd47f0c2.png

4.  From the dropdown select “Account Manager” option.

clipboard_e55ad63aefc7019d0089fc54a99bf167e.png

5.  In the opened portal select “Add Asset” option

clipboard_ea0c53feaf64bc3c87280abbb905e231a.png

6.  Fill in the form, make sure to use the Device ID with matching data that exists in OT1 with next format: mobileid/environment e.g. 9987654321/prod

7.  Check the box of the license available.

clipboard_e8497a0853e3b8a11df2fb52aec357981.png

8.  Click on “Add Asset” button.

clipboard_ef4863507d28f3a45640a3cd8ca8efc8c.png

 

Import multiple Device IDs

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com).

3.  In the top right select “Web Tools” option
clipboard_e63f30781e23d82ba9d553753a03ee0cc.png

4.       From the dropdown select “Account Manager” option.
clipboard_ee7e42ad4636d4d51e6ca7f5f113c4bda.png

5.  In the opened portal select “Import” 

clipboard_eed83fc56d7fe25196cd94eb966bf96fc.png

6.  Select “Download CSV template”

clipboard_eb89189d97735ec6d1feddad44f974622.png

7.  Fill the Excel File

clipboard_e343f15b369bf73bbfe8fbf49d2ee5e29.png

8.  Upload and import the file

clipboard_ee7471d81e0fcb7dfdc3befa26f75ac57.png

 

Steps to add a Vehicle ID in Trimble Fleet Portal:

To grant the full integration of the Vehicle and get the best of CoPilot routing experience, a Vehicle ID must be added to Trimble Fleet Portal, please follow next steps to do it:

Add a Single Vehicle ID

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com).

3.  Select “Company Administration” option located on upper right corner.

clipboard_e5126d4d686b491f5f58aa768ca17a42d.png

4.  Click on “+ New” button.

clipboard_e0ddb9f4ac8a45806009a7db214040358.png

5.  Insert Vehicle ID with next format: truckid-customerid-env (e.g. 5525262728-milesahead-prod).

clipboard_ed6431bc4f04845dd4af08e8e5992b15f.png

6.  Insert any Vehicle Name (there is not a specific rule for this field).

clipboard_e36f3b6b6e09183771fe4162f75171e01.png

7.  Click on the green “Save” button.

clipboard_e87497d30f950e6abb4d71440197b33c7.png

 

Add multiple Vehicle IDs

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com).

3.  Select “Company Administration” option located on upper right corner.
clipboard_e34e07a9fc9f35fe90c7fb6b6dd3157a9.png

4.  In the page select “Import”

clipboard_e293a630c5302eebd20c64340d1d974bd.png

5.  Select “Download sample import file”

clipboard_ea8cb0d438ac172f2e0b0194198122d15.png

6.  Fill the Excel File

clipboard_e5fef41e7b91977cd8b780a9e19013f39.png

7.  Upload and import the file

clipboard_efa441d4015c35f134c4e55722bb2bc3a.png

 

Steps to add a Vehicle Group in Fleet Portal:

To grant the full integration of the Vehicle and get the best of CoPilot routing experience, a Vehicle Group must be added to Trimble Fleet Portal, please follow next steps to do it:

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com).

3.  Select “Vehicle Groups” option located on the top center of the page.
clipboard_efdc8c091420a0f2eb4b42d28764c58f8.png

4.  Click on “+ New Vehicle Group”.

clipboard_e6e11ab87e7e70dd719a80546034dbe9f.png

5.  Enter any Vehicle group name in the box “Group Name”.

clipboard_e4b360cfdde1bd5bf9813ed85599c0d4e.png

6.  You can either add prior created Vehicles or save the Group empty and come back to add vehicles later.

7.  Click on the green “Save” button at the bottom of the page, you will see a green notification on top the page.
clipboard_eb569150f32530bc2a2777e6dcfb0c0fb.png

 

Steps to associate a Vehicle ID to a Vehicle Group in Trimble Fleet Portal

To grant the full integration of the Vehicle and be able to use Fleet Portal tools, the vehicle ID must be associated to a vehicle group.

1.  From a browser (Chrome is recommended), visit https://copilotfleetportal.alk.com/login

2.  Enter your valid credentials (To get credentials, please contact Trimble Support: support@trimblemaps.com).

3.  Select “Vehicle Groups” option located on the top center of the page.

clipboard_eeed33a264154e99bd70071c8e1e4ada5.png

4.  Click on the Vehicle Group already created, details of the group will be displayed.
clipboard_e07638587e5a095431ef4747085bfcfe1.png

5.  Click on “+ Add” button.

clipboard_ef7cb73d6d898a748c77a06c367e0eecc.png

6.  Type the vehicle ID already created in the “Filter” box.

clipboard_e8b4bcfc6d5da83fac8f8a5edffdfb6b2.png

7.  Check the left box of all vehicles that want to be added.

clipboard_e8fdda17ad81c73ddcc983750b2318984.png

8.  Click on “OK” button.

clipboard_eb916e8782247621df7c68701680ed329.png

9.  Click on the green “Save” button.

clipboard_e19ea491f616b49eed3b4d7f9883c07b1.png

10.  A green line will be displayed indicating changes have been applied.
clipboard_e9908b21094447c071b7d6f05c1479162.png
 

Frequently Asked Questions

How to check the app and map version of the mobile app?
The app version is displayed in the Omnitracs Installer App.
Also, for CoPilot app, the version is displayed in the About CoPilot page.
To review the map version, go to Menu > Settings > About CoPilot page and under the Map Version category you will see the Year and Quarter values.
clipboard_ea5eb28bf52931234a9690671223fe947.png   clipboard_e1c8593e1b75275e760cbcf8a5ebb91e0.png
 

How to know which map region is installed?
To review the map region, go to Menu > Settings > About CoPilot page and under the Map Version category in the Cities row e.g. CTY_ALK.NA-USVirginIslands-378.2022.01.17.9.1.1 - The key is before the numbers.
clipboard_ed4acc236b861ff6c764bfc737d75b48e.png
 

Why do I not see the road segment in the map?
Please make sure that the correct set of maps of the region where your driver will be navigating is installed, this can be checked on the About CoPilot page.
When not having the correct set of maps, the way to go is clear data of the application and relaunch it, since the app does not have any set of maps installed the user will be prompted to download a set of maps.
You can go to Android Settings > Apps > CoPilot Navigation > Storage > Clear data
clipboard_ea136510b85dcf547ab5fead2869047bd.png   clipboard_e8901c8ed42f6c28e7da904d74ba2fb25.png
 

What if I see the screen where CoPilot says No App Licensing?
This means the Mobile device or partner id is not identified, please make sure that the Mobile ID asset was correctly configured by reviewing the “Steps to add a Mobile Device ID asset in Trimble Fleet Portal section and theSteps to add a Vehicle ID in Trimble Fleet Portal" section. 
clipboard_e84095ee31cbacfbd12e77c03a7192284.png

 

These are some of the terminologies between OT1 and Trimble that you will need to know

Term

RNA Portal/OT1 Portal

Trimble Fleet Portal

Driver Experience

Mobile

Mobile Device ID

Asset – Device ID

Mobile ID

Vehicle

Equipment

Vehicle ID

Truck ID

Category Vehicle Group

Equipment Type

Vehicle Group

NA

 

Why is the vehicle and mobile Device ID format different that what's in OT1?
Within Trimble Fleet Portal the Mobile and Vehicle IDs need to be unique for the entire Omnitracs partner. This is different than OT1 portal where Vehicle and Mobile IDs need to be different only per Customer account.
Also, Trimble has only one environment to be integrated with, while OT1 has 5 different environments.
 

Will there be any entity integration between OT1 and Trimble?
Yes, we are planning to improve the experience to reduce the effort to add Vehicles and Mobiles easily across the different portals. In the 6.6 release, equipment and equipment type data will be integrated between OT1 and Fleet Portal.
In the following release we are trying to prioritize the work of integrating mobile device data.
 

Can I stop the map upgrade?
Yes, just pull down the android notifications menu and select Pause or Cancel.
clipboard_e5db574a7d88b4f53063e9ac71ca37442.png
 

Will the map upgrade need any user confirmation?
No, when having Wi-Fi this process is automatically run in the background.
 

How long does the map upgrade take to complete?
This depends on the size of the map region that you wish to download and the speed of the Network, our average time was around 5 minutes for a state like Texas and 15 minutes for a country like USA.
 

Will the driver be interrupted with the map upgrade?
No, when having Wi-Fi this process is automatically run in the background and won’t need any response from the driver.
 

Does the Vehicles include trucks (power unit) and trailers?
When using OT1, a Telematic Device is needed to pass the vehicle dimensions.
The Telematic Device is only configured for the Power Unit; therefore, we only include the dimensions set for the Truck.
 

Do we have to register both Vehicle and Trailer data in Fleet Portal?
Yes, the application technically only needs the Truck ID, but it is better to register both Vehicle and Trailer data.
 

Where do I need to configure routing profile to be used in CoPilot?
Two areas must be covered when using a Telematic Device.
The first one is OT1 portal; the vehicle dimensions are configured under the Equipment Type.
In the Equipment, make sure to have the Equipment Type and a Telematic Device assigned.
clipboard_eb61b1b7c4905ca82d60d599191940473.png   clipboard_e333d875102200193147b671fa481bbd6.png
 

How to edit the workflow

The second area is Command portal; you will need to configure the workflow of your driver.

Please, follow these steps to edit the workflow:

clipboard_e6b37a3978d111a4de0083835b5fd18f6.png

  • Under “Universal Config” tab, select “Maps/Navigation”

clipboard_e89d27da9e1c1e588392498cb7490a694.png

  • In the Navigation section select CoPilot Navigation option

clipboard_e441fcd1f184388d9ca3936a4bb878084.png

  • Scroll down and edit the Settings as you wish

clipboard_efbbabe529b4b49cc532bf1c958c98b8f.png

 

What steps do I need follow to onboard 100 new Mobile Devices?

  • Import the Mobile Devices in OT1 by going to Maintenance > Mobile Devices > Select Import (Makes sure to have only one Region selected in the Filter)

clipboard_e3bf5f36a294370fe7eb752a996eda95c.png

  • Add or update an equipment type in OT1 under Maintenance > Equipment Types

clipboard_ef0c03ae8b18b9cbfd9aa240b2b01004a.png

  • Import Vehicles in OT1 by going to Maintenance > Equipment > Select Import

clipboard_e514ec8cdaf39c81b30a9ffeb1fa2a208.png

 

Can I downgrade the app to 6.4 version?
No, it is not recommended to downgrade.
 

Will my drivers be impacted on April 23'th after the 6.5 release?
No, the drivers should not be impacted, all current users of CoPilot are taken care by setting up their mobile device and vehicle ids in Fleet Portal.
This task has been completed by Omnitracs and Trimble support teams.
 

How to access Fleet Portal, or what should I do if I do not have access to https://copilotfleetportal.alk.com/?
Contact Trimble Support to get access: support@trimblemaps.com
 

What are the entity changes in Trimble Fleet Portal with 6.5 release?
clipboard_ef0f8e0ec9602488406147b30dc58ad5d.png

  • For all the existing accounts, the data migration for both Vehicle and Mobile Device IDs had been taken care of.
  • All Mobile Devices in OT1 had been imported into Trimble Fleet Portal as Assets and activated for CoPilot Truck License.
  • All Equipment Data in OT1 had been imported into Trimble Fleet Portal as Vehicles.

 

Software Corrections

Work Item Number

Issue

Component

RPE-85027 Fixed an issue with the integration between CoPilot App and Fleet Portal, with this the FP Route Reporter data is displayed. CoPilot
DCMD-6324 UNLOAD_DOCUMENTS_ByPass scan will now be grayed out once BOL has been scanned. Drive/Command
RPE-17378 While performing a Driver Vehicle Inspection Report (DVIR), Drive will no longer display inactive equipment when searching for equipment. Drive/Command
DCMD-6726 Error message improved when Identity server requests fail. Previously, these failed with a 5xx error (unhandled exception) and now fail with 4xx if an invalid client is used. Drive/Command
DCMD-6770 Single Sign On: To support the additional security in Android 11, Drive now has the capability to acquire support files such as customer databases from the public Documents folder. Drive/Command
DCMD-6768 Password: While the device is in-motion, a Co-Driver will no longer be restricted from authenticating if their password was incorrectly entered the first time. Drive/Command
DCMD-6761 Depart/Done tasks can now be completed in the same minute as the last completed task. Drive/Command
DCMD-6744 You can now cancel an unplanned stop on a trip originating from Roadnet. Drive/Command
DCMD-6735 The Core App Settings in Command have been reorganized. Drive/Command
DCMD-6528 An issue where drivers were sometimes unable to add an unplanned stop to an Adhoc Trip has been corrected. Drive/Command
DCMD-6750 In OT drive, an Exception being generated from Bump Dock task has been fixed. Drive/Command
DCMD-6850 We resolved an issue in Drive 6.5 when you press the small red truck icon it no longer takes you to XRS to associate the vehicle. A new button has been added to the "No Vehicles Found" dialog called "Take me there". The user will be navigated to XRS where the connection to the vehicle can be attempted in XRS using "Connect to Vehicle" from XRS dashboard. Drive/Command
RPE-83075 An issue was resolved when FileUpload integration event for attachment to messaged failed to process with null reference exception. Drive/Command

DVIR-1407

Fixed an issue in Drive where a trailer did not populate the DVIR task when it is included in the Trip Document.

Drive/Command

DVIR-1369

Fixed an issue where the trailer remained in the asset list and was visible during the next DVIR task even after the driver performed a post-trip inspection and selected the drop option from the trailer function drop down list.

DVIR

 

Tags recommended by the template: article:topic

  • Was this article helpful?