Devices
The default view is the device list, which shows all devices in the account.
Fields
The device list shows the following fields:
- Identifiers: Static identifiers for the device.
- ID
- Serial Number
- IMEI
- ICCID
- Names
- Name: User defined name for the device.
- Type: Device type, such as
ZeroN
etc. - Tags: User defined tags for the device.
- Seen
- Last: Time the device was last seen by the Lightbug platform, this may not be a 1:1 match with when data was last received.
- First: Time the device was fist seen by the Lightbug platform, likely around the time it was manufactured.
- Users
- Plan details
- Firmware
- Status
- Battery
- Enabled
- Actions
Filters
Filters can be used to narrow down the list of devices.
Such as all ZeroN
devices.
Actions
The devices table has a number of actions that can be performed on devices, either in row actions, or via buttons on the right hand side of the rows, or via bulk actions having multiple devices selected.
In row actions
Some actions are available on the device list itself, by interacting with various fields.
Reveal ICCID & IMEI
Click the (more)
link in the identifiers column to reveal the ICCID and IMEI of the device.
Set device name
Hovering over a device name will reveal a pencil icon, which can be clicked to edit the device name.
Hit Enter
to save the new name, or Escape
to cancel.
Schedule Firmware Update
Clicking on the firmware version will open a dialog allowing you to schedule a firmware update for the device.
Button Actions
Some per device actions are available via buttons on the right hand side of the rows, these are:
- Activate / Deactivate
- Manage Users
- Manage Settings
- See Device information
- Manage Forwarding
Manage Users
Clicking on the manage users icon will open a dialog allowing you to add or remove users from the device.
Users can have different global permissions, which can be controlled from the users page.
Clicking Add User
, open an additional dialog allowing you to select a user from the list of users on your account, or create a new user.
Add Existing user
In order to select an existing user, click on their name from the list.
On success, you'll see a confirmation message in the top right corner.
⚠️ Warning
If the user already exists, and they are not a sub user of your account, you will not be able to select them. If this is the case please contact support to get them added to your account.
Add New user
To create a new user, click on the Create New
button.
This will open a dialog allowing you to enter the new users details.
Once you have entered the details, click Create
to create the user.
On success, you'll see a confirmation message in the top right corner.
⚠️ Warning
If the user already exists, you will not be able to create an account for them.
Remove a user
To remove a user from the device, click on the X
icon next to their name.
Device information
Verbose information about the device, including:
- Overview: General device state information, and summarized device information over time.
- Timeline: A detailed timeline of data received from the device, and received by SIM providers.
- Config Pages: Current config pages applied to the device.
Plan
The top of the overview summarizes the current plan and billing state of the device.
Metric Summary
An expandable overview of some device metrics, errors, sends and power usage are then displayed.
You can mouse over the graphs to see more details about the data.
Use the +1 Day
and +1 Week
buttons to expands the time range of the graph into the past.
This data is then summarized further with some key metrics.
- Total Time
- Total Points
- Avenge Signal
- Average Points per transmit
- Average Time Between Points
- Average Time Between
- Average Power per Transmit
- Average Power per Point
- Battery percent and voltage at start of the time range.
- Battery percent and voltage at end of the time range.
- Max battery voltage during the time range.
And a breakdown of the source of locations received during the time range.
Timeline
The timeline shows a detailed view of events from and related to the device.
This will poll for new events as they happen, so you should be able to see your device connecting and sending data when active.
⚠️ Warning
If your device has not recently sent any data, you might find the timeline empty, or timing out.
Config Pages
The config pages tab shows the current config pages applied to the device.
You can remove config pages by clicking the X
icon next to the config page name.
Manage Forwarding
Forwarding is a new feature that allows you to forward data from your devices to other services, currently webhooks and MQTT.
This will replace similar messaging based on Notifications, which is only accessible via API or the Cloud app.
If you would like to use this feature, please contact support to get it enabled on your account, as it is not yet at General Availability.
Bulk actions
You can select multiple devices and perform actions on them by using the check boxes at the left of each row.
Export
Exporting selected devices will display a modal allowing you to copy a IDs, Serial numbers, IMEIs or ICCIDs in a bulk format.
Settings
Settings allows you to change the settings of multiple devices at once, making use of config pages that you have on your account.
Users
Allows, bulk adding or removing of users from the selected devices.
Tags
Allows, bulk adding or removing of tags from the selected devices.
Devices with no tags will allow you to add new tags.
Changes can be reviewed before they are applied.
If selected devices have a mixture of tags, they will be shown differently in the existing tags list.
Tags can be:
- Removed from all devices, using the bin icon.
- Applied to all devices by clicking tags only applied to "Some devices" (in yellow).
Activate / Deactivate
Bulk activations and deactivations of devices.