GroundCloud

VEDR - Device Maintenance and Troubleshooting

About Device Maintenance and Troubleshooting

VEDR devices require ongoing maintenance to remain fully functional and meet FedEx VEDR requirements. Components such as storage media, wiring, power connections and mounting hardware may wear out, become damaged or require service over time.

Promptly identifying and correcting issues helps restore device functionality, protect critical video footage and reduce compliance risks.

Tip: Looking for compliance requirements? See the VEDR - Device Compliance Requirements article for information about what makes a device compliant and how compliance is determined.


How to Identify Devices That Need Attention

To identify devices that may require maintenance:

  1. Log in to the GroundCloud Portal.

  2. Navigate to the VEDR Devices page.

  3. Review devices displaying:

    • Device health alerts

    • Maintenance recommendations

    • Troubleshooting requests

    • Compliance warnings

  4. Investigate and address affected devices promptly.

Many issues can be resolved through basic troubleshooting and maintenance.


Non-Reporting Devices

A non-reporting device is a VEDR device that has not checked in for at least seven days despite evidence that the associated vehicle has been in operation recently. Before troubleshooting the device, verify that the device and vehicle should still be included in active fleet reporting.

Step 1: Confirm the Device Is Still in Use

Ask yourself:

  • Is this device still installed?

  • Has the device been removed, transferred, discarded or replaced?

  • Is the device still expected to report activity?

If the device is no longer in use, deactivate it so it can be removed from active reporting.

Step 2: Confirm the Vehicle Assignment Is Correct

Ask yourself:

  • Is the device assigned to the correct vehicle?

  • Has the vehicle been sold, retired, transferred or replaced?

  • Has the device been moved to another vehicle?

If the device is assigned to the wrong vehicle, update the vehicle assignment.

Step 3: Determine Whether the Vehicle Is Active

Ask yourself:

  • Is the vehicle actively operating?

  • Is it a spare vehicle?

  • Is it seasonal?

  • Is it temporarily out of service?

If the vehicle is not currently being used, create an Out of Service window to prevent unnecessary device alerts.

Step 4: Determine Whether the Device Should Be Reporting

If all the following are true:

  • The device is still installed.

  • The device is assigned to the correct vehicle.

  • The vehicle is actively operating.

Then ask yourself:

  • Is the device receiving power?

  • Does the device have a working connection?

  • Is the device able to acquire GPS?

  • Has the device experienced a hardware failure?

If the device is not reporting due to one of these issues, continue with the troubleshooting steps in this article. Common causes include:

  • Power loss

  • Wiring issues

  • Loose connections

  • Connectivity problems

  • GPS issues

  • Hardware failures


Compliance Troubleshooting Guide

Use the table below to identify common issues and recommended checks.

Compliance Area

Common Symptoms

Recommended Checks

Power & Device Operation

Device offline, no recent activity, device will not power on

General Checks

  • Verify the USB-C connector is fully inserted.

  • Confirm the security panel is properly installed.

  • Inspect the power cable for cuts, pinches, abrasion or exposed wiring.

  • Verify all connections are secure.

  • Verify vehicle battery health and available power.

Installation-Specific Checks

  • OBD-II installations: Ensure the connector is fully seated.

  • J1939 installations: Ensure the connector is fully seated.

  • Direct-wire installations: Inspect power and ground connections, fuse taps, splices and wiring.

Network Connectivity

Connectivity alerts, stale device information, device not reporting data

  • Verify the device is powered and operating normally.

  • Confirm the vehicle has been driven recently.

  • Operate the vehicle in an area with known cellular coverage.

  • Check for recent installation changes or physical damage.

GPS Reporting

Missing GPS data, stale location information, inaccurate locations

  • Ensure the device has a clear view of the sky.

  • Check for windshield obstructions, metallic tint or nearby equipment.

  • Confirm proper mounting location.

  • Verify consistent power.

AI Event Detection

Reduced event volume, expected events not detected

  • Verify the camera lens is clean and unobstructed.

  • Confirm the device has not shifted position.

  • Check for windshield replacement, impact damage or installation changes that may affect camera alignment.

Storage Media Health

Storage warnings, device health alerts, missing footage

  • Verify a supported high-endurance microSD card is installed.

  • Confirm the card is fully seated and free from visible damage.

  • Replace worn or suspect cards.

Video Retention

Insufficient retained video footage

  • Verify the SD card meets minimum capacity requirements and is functioning properly.

  • Replace older cards that may have reached end-of-life.

Hardware Condition

Intermittent operation, unexplained issues, recurring alerts

  • Inspect for:

    • Physical damage

    • Corrosion

    • Water intrusion

    • Overheating

    • Tampering

    • Impact damage

  • Verify all mounting and connection points remain secure.

Active Fleet Compliance

Device appears healthy but should not be included in reporting

  • Confirm the vehicle is actively operating.

  • Deactivate devices assigned to vehicles that have been:

    • Retired

    • Sold

    • Reassigned

    • Removed from service


Troubleshooting Power Issues

Power-related issues are among the most common causes of device health alerts and reporting loss.

Verify Physical Connections

Inspect the device and all accessible cabling.

Check that:

  • The USB-C power connector is fully inserted into the device.

  • The security panel is properly installed and secured.

  • The power cable is not pinched, crushed, cut or damaged.

  • All visible wiring connections are secure.

OBD-II Powered Devices

If the device uses an OBD-II power cable:

  • Verify the connector is fully seated in the vehicle's OBD-II port.

  • Check for loose, damaged or partially disconnected connectors.

  • Confirm the connector hasn't come loose due to vehicle vibration.

J1939 Powered Devices

If the device uses a J1939 connection:

  • Verify the connector is firmly seated.

  • Inspect the cable and connector for damage.

Direct-Wire Installations

If the device uses a direct-wire harness:

  • Verify power and ground connections remain secure.

  • Inspect fuse taps, butt connectors, splices and wire taps.

  • Check for wiring damage caused by vibration, abrasion or vehicle repairs.

Verify Vehicle Power

If the device remains offline:

  • Confirm the vehicle battery is functioning properly.

  • Verify the vehicle electrical system is supplying power.

  • Check for blown fuses or damaged wiring associated with the installation.

Camera Does Not Appear to Power On

If the camera does not respond after power is connected:

  1. Make sure the camera is securely connected to power.

  2. Leave the camera connected to power for at least 10 minutes.

  3. Check whether the camera starts after the internal battery has had time to recharge.

A camera with a depleted internal battery may need several minutes of charging before it can start normally.

If the camera remains unresponsive, contact GroundCloud Support for assistance.

Note: Device component locations, power connector details and installation-specific guidance are in the AIR-II VEDR Unit Installation Guide.


Troubleshooting Connectivity Issues

If the device is not reporting data or appears disconnected:

  • Verify the device is powered on and operating normally.

  • Confirm the vehicle has been driven recently.

  • Operate the vehicle in an area with known cellular coverage.

  • Inspect the device for physical damage.

  • Verify the device has not been removed, disconnected or recently reinstalled.

Some connectivity issues may resolve after the vehicle is driven and the device has an opportunity to re-establish communications.


Troubleshooting GPS Reporting Issues

If GPS data is missing, stale or inaccurate:

  • Verify the device is securely mounted in the approved location.

  • Ensure the device has a clear view of the sky.

  • Check for metallic tint, coverings, stickers or equipment that may interfere with GPS reception.

  • Verify the device maintains consistent power.

  • Operate the vehicle outdoors to allow GPS reception.

GPS reception issues often resolve once the device has an unobstructed view of the sky and the vehicle has been driven for a period of time.


Troubleshooting AI Event Detection Issues

If expected AI events are not being detected:

  • Verify the road-facing camera lens is clean.

  • Confirm the camera remains securely mounted.

  • Check for changes in camera position caused by vibration or impact.

  • Verify that no obstructions are blocking either camera.

  • Inspect for windshield replacements or installation changes that may have altered camera positioning.

Improper camera positioning can reduce detection performance and affect event capture quality.

Note: Camera positioning and adjustment instructions are available in the AIR-II VEDR Unit Installation Guide.


SD Card Maintenance

Why SD Cards Require Maintenance

MicroSD cards are wearable components and will eventually wear out during normal operation.

As microSD cards age, they may:

  • Retain less video footage

  • Generate storage-related errors

  • Affect video availability

  • Reduce overall device reliability

Routine replacement helps maintain device health and compliance.

Recommended SD Cards

Use only high-endurance microSD cards designed for continuous recording.

Recommended capacities:

  • Minimum: 128 GB

  • Recommended: 256 GB

Using unsupported or low-endurance cards may increase the likelihood of storage-related issues and premature failures.

Signs an SD Card May Need Replacement

Consider SD card replacement if:

  • Storage errors are reported.

  • Video footage is missing.

  • You cannot meet video retention requirements.

  • The card has visible physical damage.

  • The card has reached its expected service life and other corrective actions have not resolved the issue.

In many cases, SD card replacement is the recommended first corrective action for storage-related issues.

Note: Detailed SD card replacement instructions are available in the AIR-II SD Card Replacement Guide.


Common Corrective Actions

Depending on the issue identified, corrective actions may include:

  • Deactivating devices that are no longer in use

  • Correcting improper vehicle assignments

  • Creating Out of Service windows for inactive vehicles

  • Restoring power connections

  • Repairing damaged wiring

  • Re-establishing network connectivity

  • Resolving GPS reception issues

  • Replacing damaged hardware

  • Replacing the microSD card

  • Correcting camera positioning

If basic troubleshooting can't resolve the issue, contact GroundCloud Support.


Understanding Device Alerts

Device health alerts and Device Tickets help identify conditions that may require attention.

Examples include:

  • Device Media Error

  • Camera Not Connected

  • Device SD Card Door Open

  • No SD Media Present

  • Device Camera Obstructed

  • Internal Failure

  • VIN Mismatch

For definitions and explanations of individual alerts, refer to the VEDR - Device Operational Status and Device Tickets article.


Before Contacting Support

To help expedite troubleshooting and resolution, gather the following information before contacting GroundCloud Support:

  • Vehicle number

  • Device serial number

  • Description of the issue

  • Date the issue was first observed

  • Troubleshooting steps already completed

  • Photos of the installation, wiring, connectors or damage, if applicable

Providing this information can significantly reduce troubleshooting time.


Need Help?

GroundCloud Support can assist with:

  • Device troubleshooting

  • Connectivity issues

  • GPS reporting issues

  • Device health concerns

  • SD card replacement guidance

  • Hardware failures

  • Device deactivation requests

GroundCloud Support

Phone: (218) 864-7900 (Option 2)
Email: servicedesk@descartes.com


Frequently Asked Questions

Why Is My Device Listed As a Non-Reporting Device?

A non-reporting device is a device that has not checked in for at least seven days despite evidence that the associated vehicle has been in operation recently.

Before troubleshooting the device, verify that:

  • The device is still installed.

  • The device is assigned to the correct vehicle.

  • The vehicle is actively operating.

If all three conditions are true, continue with the troubleshooting steps in this article.

What Should I Do if My Device Needs Attention?

Review any device health information displayed within GroundCloud and perform the recommended troubleshooting steps in this article. If the issue persists, contact GroundCloud Support.

How Do I Know if an SD Card Should Be Replaced?

Replace SD cards that are damaged, produce storage-related errors or no longer reliably support the required video retention.

What Should I Do if a Device Is No Longer in Use?

If a device has been permanently removed, transferred, discarded or replaced, deactivate it so it can be removed from active reporting. If you need assistance, contact GroundCloud Support.

Why Would a Device Stop Reporting Data?

Common causes include power issues, loose or damaged connections, connectivity problems, hardware failures or storage-related issues.

Why Is My Device Not Detecting Events?

Events may not be detected due to a dirty or obstructed camera lens, a camera that has shifted position or installation changes such as a windshield replacement that has altered camera alignment. Verify the device is powered, reporting data, properly mounted and free from camera obstructions. Also inspect the camera position to ensure it has not shifted from its intended orientation.

Where Can I Learn More About Compliance Requirements?

See the VEDR - Device Compliance Requirements article for the official definition of a compliant VEDR device and information about compliance expectations.


Back to Top