Manage Your Gateways

For large fleets, managing multiple gateways in the dashboard can be cumbersome. To lessen that burden, you can change settings for multiple gateways in a single instance using the bulk gateway upload feature instead of editing gateway settings individually.

To configure or manage your gateways in bulk, you export a template in comma-separated values (CSV) format. This file identifies all existing gateways, their unique Samsara IDs, and additional fields that you can modify.

Move or Replace a Gateway

If you plan to move or replace a gateway, first deactivate the old gateway from your dashboard and activate the new gateway. For full instructions, reference the following topics:

• Move a Vehicle Gateway from One Vehicle to Another

• Replace a Vehicle Gateway (VG) with the Same Model

• Replace a VG34 with a VG54

• Retrieve Video When a Vehicle Gateway Is Lost, Stolen, or Damaged

Create or Edit Gateways in Bulk

To quickly modify information about your Asset Gateways (AGs) and Vehicle Gateways (VGs), you can upload data directly to the Samsara dashboard in bulk.

The easiest way to modify information about your devices is to first download the gateway list from the Samsara dashboard. Samsara provides the gateway list in comma-separated values (CSV) format and includes all editable fields. Consider the following notes before downloading and making changes to the gateways list.

• The file must be a properly formatted CSV file.

• The first row of the CSV file is the header row, and you must include it in the file.

• The header row must contain all fields from the CSV table.

• The CSV file must contain no more than 500 rows of data (including one row for the header).

• Fields that contain commas (such as device names and tags) will disrupt the import format. To avoid errors, revise any fields containing commas.

• Leading 0s in numerical fields will be truncated in exported files. Device names with numbers, license numbers, and user notes are at risk of this issue. Make sure to check your imported file for missing digits.

To download your gateways list and edit gateways in bulk:

1. Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.

2. From within Devices, select Devices > Gateways.

3. Select More Actions > Upload CSV.

4. Select Devices List to download your existing devices data.

   Note

   Ensure that you only use the provided template. Any other format will display an error.

   

5. Update the information in the CSV file and save the changes (see CSV Format for Devices for detailed formatting requirements).

6. After you edit your file, select Upload a file.

7. Choose the CSV file from your computer, or drag and drop the CSV file to the window.

8. Click Preview to review the devices that will be added and edited.

9. Click Confirm to save the changes.

CSV Format for Devices

The following table describes the CSV fields you can use to define your vehicle and asset gateways. When there is no data specified for a given field, the value will be n/a. This can mean that this data has never been defined or that the data is not collected by Samsara. Where indicated in the description, internal identifying information such as the ID and gateway serial cannot be edited.

Field	Description	Example
ID	Internal ID number of device. This field is not editable on import since it represents an internal storage identifier.	G212014918601586
Gateway Serial	Serial number associated with the gateway. This field is not editable.	G12W-ABC-DEF
Name	The name of the associated vehicle.	Truck 265
Tags	Tags associated with the vehicle.	Tag 1, Tag 2, Tag 3
License Number	(Required) License plate of the paired vehicle.	ABC1234
VIN	The VIN as reported by the diagnostic connection from the VG. If your vehicle does not report it automatically, you can manually provide the value.	55SJF3JA6IU270951
Carrier US DOT Number Override	Alternate carrier US DOT number if different from your default settings. If this field is blank, the default carrier settings apply.	USDOT1234567
Carrier Name Override	Alternate carrier name if different from your default settings. If this field is blank, the default carrier settings apply.	Carrier Name
Carrier Address Override	Alternate carrier address if different from your default settings. If this field is blank, the default carrier settings apply.	123 Delivery St., Hauling
Harsh Event Detection Setting	Vehicle type to use for Harsh Event Detection.	Off, Automatic, Passenger Car, Light Truck, Heavy Duty
Driver Id	ID of the driver assigned to the vehicle.	1234567
User Note	Vehicle notes for your organization. Vehicle notes have a limit of 255 characters.	Out of service
Aux Input #(1-13)	Type of auxiliary input for the vehicle to assign to each auxiliary input # from 1 to 13.	Emergency Lights, Emergency Alarm, Stop Paddle, Power Take-Off, Plow, Sweeper, Salter, Door, Boom, Auxiliary Engine, Generator, Eight-Way Lights, Panic Button, None
Vehicle Regulation Mode	Select the vehicle regulation status for CMV. For more information, see Unregulated Vehicles (non-CMV).	Regulated, Unregulated
Asset Attribute: (Attribute Name)	A unique column for each asset attribute name that describe the features of a vehicle using one or more attribute values. The attribute name and value must match existing attributes. To separate attribute values, use a semicolon. To remove all attribute values, type NULL. For more information about attributes, see Attributes.	Asset Attribute: Vehicle Type Pickup; Dualcab

Edit an Individual Vehicle Gateway (VG)

You can modify the settings of an individual VG, for example if certain settings only apply to a specific vehicle, directly from the device settings.

Note

If you are transferring your gateway from one vehicle to another and need to maintain historical vehicle records for HOS or IFTA purposes, please review how to Move a Vehicle Gateway from One Vehicle to Another.

To view or edit the settings for an individual gateway:

1. Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.

2. From within Devices, select Devices > Gateways.

3. Locate the gateway from the list. To narrow the scope of the results, Search for the gateway or filter the options by Tags or Attributes.

4. On the device row, click the more actions menu ( ... ) > Settings.

5. Edit the device settings. For a summary of setting options, see Individual Vehicle Gateway Settings

6. To delete the vehicle, see Delete a Vehicle.

Individual Vehicle Gateway Settings

The available VG settings are dependent on accessory options installed and the features you have enabled for your fleet. The following table summarizes the settings you can view or edit for your gateway:

Setting	Description
Name	The name of the associated vehicle. When you first add a gateway, the Samsara dashboard identifies it by serial number. For ease of management and identification, use descriptive names for your gateways.
Gateway	Serial number associated with the gateway. This field is not editable.
License Plate	License plate of the paired vehicle.
Tags	Tags associated with the vehicle.
Static Driver Assignment	Driver assigned to the vehicle.
Aux Input Type	Auxiliary input usage of the connected device and the associated port number, 1 or 2. Examples include Privacy Buttons, Emergency Lights, and Weight Sensors. For more information, see Auxiliary Inputs.
VIN	Vehicle identification number (VIN) associated with the paired vehicle.
Odometer	Estimated miles or kilometers as calculated by GPS from the vehicle. You can only edit the value if the value is not provided by the vehicle engine control unit (ECU). For more information, see Manually Edit an Odometer Reading.
Engine hours	Engine hours reading from the vehicle. This value is typically supplied by the Engine Control Module (ECM) but can also display configurable Synthetic Engine Hours (SEH). SEHs provide a backup input to estimate engine hours for when engine hours can’t be read based on when the engine is running.
Carrier Name Override	Alternate carrier settings if different from your default settings. If these fields are blank, the default carrier settings apply.
Main Office Address Override
Carrier US DOT Number Override
Harsh Event Detection Settings	Vehicle type to use for Harsh Event Detection.
Audio Recording	Audio recording setting for the vehicle (Enabled, Disabled, Default to organization setting (On or Off)). For more information, see Enable Audio Recording.
Vehicle Regulation Mode	Select the vehicle regulation status for CMV vehicles (Regulated, Unregulated (non-CMV)). For more information, see Unregulated Vehicles (non-CMV).
Voice Coaching	The vehicle in-cab voice coaching setting. For more information, see Enable and Configure In-Cab Voice Coaching.
Forward Collision Warning Safety Inbox	Setting to surface Forward Collision Warning events to the Safety Inbox. For more information, see Forward Collision Detection [Beta].
Forward Collision Warning Audio Alerts	Setting to play Forward Collision Warning in-cab audio alerts. For more information, see Forward Collision Detection [Beta].
Distracted Driving Detection Safety Inbox	Setting to surface distracted driving detection events to the Safety Inbox. For more information, seeDistracted Driving Detection
Distracted Driving Warning Audio Alerts	Setting to play distracted driving in-cab audio alerts. For more information, seeDistracted Driving Detection
In-Cab Speed Limit Alerts	Setting to play in-cab audio alerts for speeding events. For more information, see Driver Speeding and Speed Limits
Note	Notes you want to capture about the vehicle or gateway.
Check Dash Cam Installation	Click Take Picture to Test Dash Cam Positioning.

Pair Gateways

Use the following workflow to pair AGs and VGs to assets without using CSV bulk gateway upload:

1. Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.

2. From within Devices, select Devices > Gateways.

3. Select each gateway you intend to pair with a vehicle.

4. Select Pair Gateway.

   

5. Select the vehicle to pair with each gateway.

   

6. Save your changes when finished.

Deactivate Gateways

Use the following workflow to deactivate AGs and VGs without using CSV bulk upload:

1. Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.

2. From within Devices, select Devices > Gateways.

3. Select each gateway you intend to deactivate.

4. Select More Actions > Deactivate Gateway.

   

5. Click Deactivate to confirm the removal of the gateways from your dashboard.

   Any data collected by that gateway is preserved under the original vehicle name.

   

6. To view unpaired vehicles, navigate to Overview ( ) > Assets and use the Gateway filter to display devices with No Gateway Paired.