Raven and TELUS have cooperatively developed the TELUS | Raven Geotab Add-in to allow TELUS Geotab users to benefit from a consolidated user experience, adding Raven related video telematics functionality into the myGeotab user interface.

This solution is being deployed in phases, with continuous improvements being made. The initial solution assumes that a Geotab Go9 device is installed in parallel with the TELUS | Raven hardware.

Key features of the TELUS | Raven Geotab Add-in include:

Ability to pair/unpair a Raven to a Geotab Go9 device
Ability to configure settings of individual Ravens
Ability to view the connection status of a Raven device
Ability to access Live Preview Images for a Raven equipped vehicle
Ability to access Live Streaming Video for a Raven equipped vehicle
Ability to access Event Preview Images associated with Geotab exceptions
Ability to stream Historical video associated with a Geotab exceptions
Ability to stream Historical video from a specific time/location for a trip
Ability to request higher quality Video associated with Geotab exceptions
Ability to request higher quality Video for a specific time/location for a trip

If you have any questions, please contact support. You can reach us toll-free, 24x7 at 1-866-273-3423 OR open a request at www.telus.com/serviceportal.

Initial Set-up

Apply Raven Connected Add-in

Open a New Unsigned Add-in:

a. From your Geotab Web App Select System > Settings > Add-ins. Ensure that you have ‘Allow Unsigned Add-ins’ set to ‘Yes’.

b. Then select the ‘+ Add-in’ button.

Copy the complete contents of the RavenConnected Add-in JSON file: https://support.telus.ravenconnected.com/hc/en-us/articles/16943424713751
Paste the contents into the new Unsigned Add-in and click ‘OK’
Click the Save button at the top left of the Geotab Add-ins window

*Note: The RavenConnected Add-in will automatically create a new User that will allow Raven Connected to connect as a Geotab API Viewer to your Geotab database. Do not delete this User while you are using the RavenConnected Add-in.

User Details:

User (Email): geotab+<<geotab_database_name>>@ravenconnected.com
First name: RavenConnected
Last name: API Poller
Authentic type: Basic Authentication
Security Clearance: ViewOnlyAPI
Groups: Everything
Data access: Everything

Once the RavenConnected Add-in has been installed, the dedicated Raven Connected menu items (Exceptions with Media and Manage Ravens) will present in the left menu panel of the myGeotab interface below the ‘Add-Ins’ menu item.

Manage Ravens: Pair Ravens to Go9s

The first time you launch the Manage Ravens page there will not be any Ravens listed.

Manage Ravens allows you to add and view the pairing associations between Ravens that have been assigned to your Geotab database and the Geotab Assets equipped with a Go9.

To add a Raven and pair it to a Geotab Go9:

From the Add-Ins drop down in the left-hand menu select ‘Manage Ravens’.
Click the ‘+ Add Raven’ button at the top right of the page.
On the ‘Add a Raven’ page, enter the Raven Serial Number, select the unpaired Asset from the selection list and click on the ‘Save’ button. (The Raven Serial number can be found at the base of the Raven or on the individual Raven packaging (i.e. 2RVPxxxxxxxxx).)

*Note only Raven serial numbers that have been associated with your Geotab database by TELUS IoT CoE can be added.

Using the RavenConnected Add-in

The RavenConnected Add-in introduces functionality for a subset of the Geotab menus and screens, including:

Map
Trip History (within the Productivity menu item)
Add-Ins
1. Manage Ravens (previously reviewed in the set up section)
2. Exceptions with Media
Assets

This guide overviews how to use these features in the sections below.

Map

From the Map screen, the Raven integration enables a number of new features including:

Hover over previews
A new right panel that provides:
1. Raven Status
2. Preview Images
3. Live Streaming

Hover Over Preview

To access hover over previews:

Position your cursor over the vehicle icon to view the last road image that was captured by that Raven.

*Note that this image will only present if the age of the most recent image does not exceed 60 minutes.

Raven Status

Raven Status provides four pieces of information:

Whether the device is online or not
The SD card status of the unit
Whether Raven is plugged in
Serial number for the selected device

To access Raven Status:

From the left vehicle panel select a Raven equipped asset (note that only vehicles within the map view will be listed) or from the map select one of your vehicles.
A right panel will appear, with the name of the vehicle and Raven Status information listed below.

Driver Messaging

Driver messaging enables fleet managers to send short messages directly to the screen of the selected vehicle.

To send a message to a particular driver:

Select a Raven-equipped asset from the map.
From the right-hand pop-out a dialogue box will appear beneath Raven status.
Type out a message of up to 15 characters for the driver, select the duration for which you would like the message to appear, and then select the arrow to send the message.

Live Previews

Live Previews display images from the road- and cabin-facing cameras for the selected vehicle updated every 2 seconds while driving and every 15 seconds while parked.

To access live previews:

Select a vehicle, the right side panel will automatically present preview images for the active cameras.
Click the expand icon to view in full screen.

*Note that Live Preview images will only present if the Raven is Online and Plugged In.

Live Streaming

Live Streaming enables a real time view into the road and cabin of the vehicle providing additional context where preview images are not sufficient.

To initiate a Live Streaming session:

Select a vehicle
From the expanded right panel scroll down to the Live Streaming accordion menu item.
Click to expand and a streaming session will begin.
Toggle the camera switch icon to change views between the cabin and road cameras or click the expand icon to view in full screen.
The streaming session will automatically terminate after 2 minutes and 45 seconds unless you click within the video frame to reset the timer.

Live Streaming.png

*Note that Live Streaming video will only present if the Raven is Online and Plugged In.

Trips History

The Raven integration expands a number of features with imagery and video around previously taken trips. From the Trips History menu item within the Productivity dropdown, you can access:

Trip Exceptions
Exception Previews
Exception Videos
Ad-hoc Exception Videos
Historical Streaming
Ad-hoc Historical Stream

Trip Exceptions

Select one or more trip segments to show the Trip Exceptions in the right side panel with thumbnail sized preview images for the active cameras near the time of the exception.

Exception Previews

Clicking on a specific exception in the right side panel will cause larger images for the exception to be presented under the ‘Exception Preview’ accordion element.

Exception Videos

In addition to “Exception Preview’ images automatically captured by Raven, video for an individual exception can be requested by the user.

To request exception videos:

Select the exception of interest
Expand the ‘Exception Videos’ accordion element
Select the desired duration for the video (15s, 30s, 45s or 60s)

Finally, clicking on the download icon. Video will be uploaded for the enabled cameras to the TELUS | Raven Cloud.
Once a video has successfully uploaded, it will automatically play within the ‘Exception Video’ accordion element and subsequently appear as a ‘User Requested Video’ exception in the ‘Trip Exceptions’ list.

If a different video duration for the exception is then desired, it can be requested by clicking on the ‘+’ icon at the top right of the Exception Video pane. Multiple videos that have been requested for a specific exception can be viewed as a carousel, using the left and right arrows to move between video files.

Exception Videos can be downloaded to the user’s workstation by clicking on the ‘More Options’ icon (three vertical dots) at the bottom right of a video frame.

*Note that new Exception Videos can only be requested if the Raven is Online and Plugged In.

Exception Videos will only be available for upload while they remain available on the SD memory card inserted into the Raven device. Once they have been uploaded to the TELUS | Raven Cloud they will remain available for up to 13 months.

Ad-hoc Exception Videos

Users can request higher quality video in increments of 15s, 30s, 45s or 60s. To do so:

Click on the location on the breadcrumb trail on the map
Select ‘Request Video’ from the Trip History panel.

Screenshot 2024-05-27 160500.png

Historical Streaming

For the selected exception the user can initiate a historical video stream for the selected camera (road or cabin). To do so:

Select the ‘Historical Streaming’ element of the accordion of the right panel.

This will play from the time at the selected exception was detected, and the user has the option to rewind or advance in 15 second increments as well as to pause the frame and toggle the camera view.

The streaming session will automatically terminate after 2 minutes and 45 seconds unless you click within the video frame to reset the timer.
Once a streaming session has successfully completed, it will be available for future viewing as a ‘Streaming’ exception in the ‘Trip Exceptions’ list and will play within the ‘Exception Video’ accordion element.

*Note that new Historical Streaming can only be requested if the Raven is Online and Plugged In.

Historical video will only be available for streaming while it remains available on the SD memory card inserted into the Raven device. Once they have been uploaded to the TELUS | Raven Cloud they will remain available for up to 13 months.

Ad-hoc Historical Stream

Ad-hoc Historical Streams enable users to begin streaming from any point along a route. To begin streaming:

Clicking anywhere along the marked route for the selected trip.
The user can initiate a Historical Stream from that location/timestamp which will play in the Historical Stream section of the right side panel.

Exceptions with Media

‘Exceptions with Media’ is a sub-menu item under the ‘Add-Ins’ menu that allows users to view all exceptions with Raven camera media for a specified date range.

To access Exceptions with Media:

Select a date range, assets, and rules filters

The Exceptions with Media page will present all events matching those criteria.

Select a specific exception to see all exceptions captured by vehicle.

Clicking a specific vehicle will cause all of the associated exceptions for that vehicle to present with their associated thumbnail images for the enabled cameras.

Clicking on a specific exception in the right side panel will cause larger images for the exception preview images to be presented.

Historical Stream From Exceptions with Media

For the selected exception the user can then initiate a historical video stream for the selected camera (road or cabin) to do so:

Select the ‘Historical Streaming’ element of the accordion of the right panel. This will play from the time at the selected exception was detected
Rewind or advance in 15 second increments or pause the frame and toggle the camera view.
1. The streaming session will automatically terminate after 2 minutes and 45 seconds unless you click within the video frame to reset the timer.
2. Once a streaming session has successfully completed, it will be available for future viewing as a ‘Streaming’ exception in the ‘Trip Exceptions’ list and will play within the ‘Exception Video’ accordion element.

*Note that new Historical Streaming can only be requested if the Raven is Online and Plugged In.

Assets (Raven Settings)

Configure the settings of individual Raven devices via the Raven Settings section within the ‘Assets’ menu item.

Configurable Raven Settings Include:

Cameras
Driver Alerts
Events
Unit of Measure

To access Raven Settings for a particular device:

Select the Assets menu item

Screen Shot 2024-05-09 at 9.12.53 AM.png

A list of you assets will be displayed, select a Raven asset.

Along the top menu for the selected asset, click on Raven Settings

Cameras

The ‘Cameras’ settings allow you to configure which cameras are active. For example if you elect to disable the Cabin facing camera for your operations, no cabin facing images or video will be captured. Both the Road and Cabin facing cameras are enabled by default.

The ‘Video Quality’ setting allows you to extend the number of hours of video that will be retained on the memory card provided with the Raven device. The default setting is HD (1080p/30fps for the Road facing camera and 720P/15fps for the Cabin facing camera), which will retain approximately 60-hours of drive time video before overwriting the oldest 5 minutes files on the memory card. Lower quality settings will capture video at a lower bit rate, which will impact both image resolution and frame rate.

Driver Alerts

‘Driver Alerts’ are audible alerts that will be played to the driver for Raven driven events such as speeding. Enabled by default, these audible alerts can be disabled should you wish.

Events

‘Events’ allow you to control Raven driven events including speeding notifications to your drivers. The Speeding event can be configured as a percentage or fixed number of kilometers over the posted speed limit.

Unit of Measure

Units of Measure will dictate whether Imperial or Metric units will be presented on the LCD display of the Raven.

WiFi

Enable WiFi Hotspot for the selected Raven and set user credentials.

*Note that WiFi Hotspot allows up to five devices to be connected at any time.

Raven In-Vehicle Hardware

The Raven in-vehicle hardware is designed to be plug and play, and is provided with a pre-configured SIM card and SD memory card. Once power is applied, the Raven device will connect with the cellular data network and provision itself against the associated Raven fleet account.

Included Raven Accessories

Each Raven is provided with a standard set of accessories that facilitate installation in a vehicle equipped with an available OBD2 port to which the Raven will be connected for both power and telematics data capture.

Raven+
Universal Mount
8ft OBD2 Cable
Allen Wrench
Security Panel
Security Screws (x3)
Adhesive Cable Clips (x4)
Spare Mount Adhesives x2)

Optional Raven Accessories

For installation in vehicles that do not have an available OBD2 port, optional cables and cable adapters can be used in series with the standard 8ft Raven to OBD2 cable, including:

Cable - OBD Extender (6ft)
Cable - OBD to J1939 (9-Pin Type 2) Adapter (6ft)
Cable - OBD to 12VDC 2-Wire Adapter (18in)
Cable - OBD Y-Splitter (15in)

The requirement for any of these optional cables/adapters will be dictated by the type of vehicle into which the Raven+ device is being installed, the preferred mounting location, and any other peripheral devices (i.e. Geotab Go9) that may also require access to the diagnostic port.

Installation with a Geotab Go9

When installing the Raven+ device with a Geotab Go9, additional cabling may be required. This will depend upon the cables that were provided with your Go9, as well as the preferred installation configuration.

For light/medium duty vehicles equipped with OBD2 port, you will typically use Geotab harness HRN-GS16K22. For this configuration, either an additional Geotab T-harness (i.e. HRN-BM16T2 or HRN-BM16T22) or Raven’s Cable - OBD Y-Splitter (15in) will be required.

For Heavy duty vehicles equipped with J1939 (9-pin) port, you will typically use Geotab harness HRN-GS09K2. For this configuration, either an additional Geotab T-harness (i.e. HRN-BM16T2 or HRN-BM16T22) or Raven’s Cable - OBD Y-Splitter (15in) will be required.

Raven Media Types

Different types of visual media are exposed via the TELUS | Raven Add-in. These are described below including the resolution and frame rates as appropriate.

Captured to the Raven SD card (for enabled cameras):

Road: 1080P @ 30fps
Cabin: 720P @ 15fps

From the Geotab Map Screen:

Live Preview Images
- 960 x 540 pixels
  - Update every 2 seconds while driving
  - Update every 15 seconds while parked
Live Streaming
- Road: 720P @ 30fps
- Cabin: 720P @ 15fps

From the Geotab ‘Trip History’ and Raven ‘Exceptions with Media’ screens:

Exception Preview Images
- 960 x 540 pixels
Exception Videos (15s, 30s, 45s or 60s):
- Road: 720P @ 30fps
- Cabin: 720P @ 15fps
Historical Streaming:
- Road: 720P @ 30fps
- Cabin: 720P @ 15fps

*Note that streaming video quality may be impacted by cellular data connection (i.e. for ‘Live Streaming’ and ‘Historical Streaming’ sessions) as the Raven device is negotiating the best encoding rate for the available bandwidth to present in real-time, and video may appear pixelated at times.

Clicking on the full screen icon at the bottom right corner of any image or video frame will expand to full screen viewing. Full screen mode can be exited using the ‘Esc’ or ‘F11’ button on your keyboard or by clicking on the ‘X’ icon that will appear when you mouse over the top portion of the screen.

Support

We’re here to help!

If you have any questions, please contact support. You can reach us toll-free, 24x7 at 1-866-273-3423 OR open a request at www.telus.com/serviceportal.

Menu

Articles in this section

Geotab Integration User Guide

Table of Contents

Overview Video

Introduction

Initial Set-up

Apply Raven Connected Add-in

Manage Ravens: Pair Ravens to Go9s

Using the RavenConnected Add-in