For large fleets, managing multiple gateways in the dashboard can be cumbersome. Instead of editing gateway settings individually, you can make changes to multiple gateways in a single instance using the bulk gateway upload feature in the dashboard. To configure or manage your gateways, 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.
Before you modify your gateways:
-
You must be an organizational administrator to bulk upload gateways.
-
If you plan to move or replace a gateway, first deactivate the old gateway from your dashboard and activate the new gateway. See Replace a Gateway or Move a Gateway for full instructions.
To manage gateways, see the following topics:
You can use the bulk upload tool to modify information about your Asset Gateways (AGs) and Vehicle Gateways (VGs). For AGs, you can modify the gateway name, license plate, tags, and user notes. For VGs, you can modify the name, license plate, tags, VIN, auxiliary inputs, harsh event settings, and user notes.
The easiest way to modify information about your gateways 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, rename 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:
-
Select the Settings icon (
) at the bottom of your Fleet menu to view dashboard settings.
-
Select Devices.
-
Select More Actions > Upload CSV.
-
Select Gateways List to download your existing gateway data.
Note
You can only use this template containing the list of your gateways and the fields that are configurable. Any other format will display an error.
-
Update the information in the CSV file (see CSV Format for Vehicle Gateways for details instructions).
-
After you have updated your file, select Upload a file.
-
Choose the CSV file from your computer, or drag and drop the CSV file to the window.
-
Click Preview to review the admins that will be added and/or edited.
-
Click Confirm to confirm the changes.
The following table describes the CSV fields you can use to define your vehicle gateways. When there is no data specified for a given field, the value will be n/a
. This can mean either this data has never been entered by the user or is not being collected by Samsara.
Field |
Description |
Example |
---|---|---|
ID |
Internal ID Number of driver. This field is not editable on import since it represents an internal storage identifier. Leave blank when creating new vehicle gateways. |
G212014918601586 |
Vehicle Name |
The name of the gateway |
Vehicle 265 |
License Plate |
(Required) The license plate of the vehicle |
AZM8290 |
Tags |
Tags associated with the device |
Tag 1, Tag 2, Tag 3 |
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 here. |
55SJF3JA6IU270951 |
Aux Input #1 Type |
Type of auxiliary input for the vehicle |
Emergency Lights, Emergency Alarm, Stop Paddle, Power Take-Off, Plow, Sweeper, Salter, Door, Boom, Auxiliary Engine, Generator, Eight-Way Lights, Panic Button, None |
Aux Input #2 Type |
Type of auxiliary input for the vehicle |
Emergency Lights, Emergency Alarm, Stop Paddle, Power Take-Off, Plow, Sweeper, Salter, Door, Boom, Auxiliary Engine, Generator, Eight-Way Lights, Panic Button, None |
Harsh Event Detection Setting |
Any harsh event settings to apply to the vehicle |
Off, Automatic, Passenger Car, Light Truck, Heavy Duty |
User Note |
Vehicle notes for your organization |
Out of service |
Attributes |
(Beta) The vehicle's attributes. Must match existing attributes. Format is Name1:Value1&Value2; Name2:Value3&Value4 |
License Type:ClassA&ClassB |
-
Select the Settings icon (
) at the bottom of your Fleet menu to view dashboard settings.
-
Select Devices.
-
Select each gateway you intend to pair individually by checking the box to the left of the serial number, or select all by checking the box at the top of the list.
-
Select Pair Gateway.
-
A window will appear displaying your selected gateways. The device serial numbers is on the left, and the name of the vehicle they are currently paired with is on the right.
-
Use the dropdown selector on the right column to choose a vehicle for each gateway.
-
Select Save at the bottom of the window.
-
Select the Settings icon (
) at the bottom of your Fleet menu to view dashboard settings.
-
Select Devices.
-
Select each gateway you intend to deactivate individually by checking the box to the left of the serial number, or select all by checking the box at the top of the list.
-
Select Deactivate Gateway.
-
Click Deactivate to confirm removing all gateways from your dashboard. Any data collected by that gateway will be preserved under their original vehicles' names.
-
View your unpaired vehicles under Fleet > Assets.
Comments
0 comments
Article is closed for comments.