Devices

Created: Modified: Documentation

The Devices tab allows you to view your inventory of devices and information about them, including their serial number, platform, model & OS, name, last seen date, status, and any associated Attributes.

Hide filters / Show filters

Health metrics filters are displayed by default, as a part of the Dashboard feature.

Click Hide filters to hide the health metrics filters. Click Show filters to view them again.

Device Statuses

There are 3 device statutes: Active, Pending and Retired.

  • Active devices count towards your GroundControl license. A device that has had a successful deployment in the last 12 months counts as Active.
  • Pending devices include new devices uploaded via spreadsheet (see below) or added manually. Devices are Pending until their first deployment. Pending devices do not use a license. Pending devices can be deleted from the system.
  • Retired devices do not use a license. GroundControl automatically marks devices as Retired when their 1-year license expires. You may also manually retire a device that has been lost or stolen. This frees up the license so you can use it on another device.

Devices that are Pending or Retired automatically become Active again after a Workflow is once again deployed to them.

Editing Device Details

To edit a device, click on a device row. The Device Details dialog opens.

Retiring a Device

To retire a device:

  1. In the Device details dialog, in the License status section, click Retire.
  2. To indicate a lost or stolen device, click the Lost or Stolen options.
    To specify additional device status, click the Other option, and enter additional details.
  3. Select Submit to retire the device.
Unretiring a Device

In the same fashion that you can retire a device, you can also unretire them.

To unretire a device, under Device Status, click Unretire. This changes the device status from Retired to Active.

Adding One Device

To add to the list one at a time, click Add Device. You must add a serial number, and you may enter custom attributes.

Importing Multiple Devices

To upload a list of device Serial numbers and your Custom Fields:

  1. On the Devices tab, click Import. The Import CSV dialog opens.
  2. A CSV template is available for download.

Requirements for Import
  • The first row of the import file is for column headers. The header names are matched to attribute values and are case sensitive.
  • You must include a column named Device Serial. This column is used to match existing devices — updating any columns you include — or to add new pending devices. When scanning devices, the ‘S’ prefix for the serial number will be removed automatically by GroundControl.
  • Column names are case sensitive.
  • You may also import as many Custom Attributes as you wish. Other column headers should match names in your Custom Attributes.
  • You may not import built-in attributes, such as Device Model, Device OS, or Device Name. Built-in attributes are read-only. Any columns matching built-in attributes will be ignored.
  • Unrecognized columns are ignored.
Importing Custom Device Names

Built-in attributes, such as Device Name, are read-only. If you wish to import unique names for devices, do the following:

  1. Create a new device attribute called, for example, “Custom Name”.
  2. Create a spreadsheet with a column named “Device Serial” and a column named “Custom Name”.
  3. Enter your data into the sheet, save, and import into GroundControl.
  4. In your workflow, use the Set Name action and set the value to the attribute “[Custom Name]” — be sure to include the square brackets.
Exporting Devices

To export a list of the devices in your GroundControl account, in the Devices tab, click Export.

This spreadsheet contains all your devices, and a long list of built-in and custom attributes. Many GroundControl customers use this spreadsheet to create custom reports. If you filtered the Devices list, the CSV contains the results from your filter.

Deploy Workflows in Bulk to Devices that have no Heartbeat

Admins can deploy Workflows in bulk to devices that have a status of “device has no heartbeat“, in an attempt to remediate them.

To deploy a Workflow in bulk to devices that have no heartbeat:

  1. On the Devices tab, click Device has no heartbeat filter.
  2. Click Bulk Deploy.
  3. Select the appropriate devices and click Deploy to Selected.
  4. Select the appropriate Workflow for your devices:
    1. DEP Workflows are only eligible connected iOS devices.
    2. Non-DEP Workflows are only eligible for connected iOS devices.
    3. Android Workflows are only eligible for connected Android devices.
    4. Over the air (OTA) Workflows are eligible for all device types and connection statuses.
  5. Click Deploy.

NOTE: Deploying to a large number of devices may take an extended amount of time.