Connected devices
Connected Devices is where you manage your devices.
View your devices
The Connected Devices page displays a list of all your devices. You can tailor the table to your specific workflow using Table settings.
This new approach replaces the previous Plain and Extensive views, giving you a single, flexible interface to manage your devices more effectively. For more information, see Customize tables in the emnify Portal.
Available columns
| Property | Description | Predefined options if applicable |
|---|---|---|
| Device Name | Name of the device and the tags you've assigned to the device. | |
| Tags | Name of the tags you've assigned to the device. | |
| Status | Current state of the device. For descriptions and configuration instructions, see Device status. |
|
| Connection | Current connectivity status of the device. |
|
| Cellular usage | Total amount of terrestrial cellular network data usage in MB or no usage. | |
| Satellite usage | Total amount of satellite non-terrestrial network usage in Messages, no usage, or can't connect. Note: This column only shows if you have satellite capable SIMs. | |
| ICCID | Integrated circuit card identifier including the final Luhn checksum digit. | |
| Service Policy | Name of the service policy assigned to the device. | |
| Coverage Policy | Name of the coverage policy assigned to the device. | |
| IMEI | 15-digit IMEI including the final check digit. | |
| Device ID | Unique identifier for the device. | |
| IP address | Unique address that identifies the device on the internet or a local network (for example, 10.1.1.9). | |
| SIM ID | Unique identifier for the attached SIM card. | |
| MSISDN | Mobile Station International Subscriber Directory Number, used to identify a mobile phone number internationally. |
For each device, click anywhere on the table row to open the device details.
Quick actions
When you hover over a device, buttons appear to trigger quick actions.
The following actions are available:
| Action | Icon | Description |
|---|---|---|
| Reset connectivity | Reset the device's connectivity. This action is commonly used for troubleshooting. | |
| Enable device | Change the device status to Enabled if the device is currently Disabled or in Factory Test. | |
| Disable device | Change the device status to Disabled if the device is currently Enabled. | |
| Open SMS console | Open an interface to send SMS from the Portal to the device. | |
| Enable IMEI lock | > | Strictly associate the assigned SIM with its International Mobile Equipment Identity (IMEI) if IMEI lock is currently disabled. |
| Disable IMEI lock | > | Clears the IMEI lock if it's currently enabled. |
| Extend limit | > | Increase the device's data limit for the rest of the month. |
| Release SIM | > | Release the assigned SIM. For more information on the potential affects, see How SIM status and device status interact Note: If there's no assigned SIM, this action isn't visible. |
| Delete | > | Permanently removes the device from Connected Devices. |
Create a new device
As part of the SIM registration process, you can create a new device for the newly registered SIM while still in the SIM registration dialog.
To create a new device to be used with an unattached SIM, navigate to Connected Devices and select Add device. After providing a name for the new device and selecting device policies, you can select a SIM from the list of registered, unassigned SIMs or filter for a specific SIM under Assign SIM (optional).
Get your device online
For information about configuring a device for network connectivity, see Get a device online.
Filter devices
Filters allow you to query devices based on one or more properties (for example, assigned tags or the device ID). For more information and available filters, see Filter tables in the emnify Portal.
Search devices
The Connected Devices search bar is under the page title next to the filters. For more information and searchable fields, see Search tables in the emnify Portal.
Get device information
To view all information about a device, navigate to Connected Devices, find it in the list, and click anywhere on the table row to open the device details.
It opens to the General tab by default. General shows the following properties:
| Property | Description |
|---|---|
| Status | Current state of the device (in this document, see Device status). |
| Services | Indicates whether the following services are active or disabled:
|
| Connection | Connectivity status and available PDP context, with an option to reset the connectivity. If the device is Online, click the i icon to show all connectivity information—breakout IP, MSC, VLR, etc. |
| Blocked networks | Names of any operators on the device's networks blocklist (often used for troubleshooting). |
| Device | Identifiers for the device, including:
|
| Policies | Names of the assigned service policy and coverage policy. |
| SIM | Properties of the assigned SIM, including:
|
| Usage | Data and SMS traffic based on a selected time period:
|
For definitions of any unfamiliar terms or acronyms, see the Glossary.
Device status
| State | Icon | Description |
|---|---|---|
| Enabled | A SIM is assigned to the device and activated. The device must be enabled to connect to a network. | |
| Disabled | No SIM assigned, or the assigned SIM is suspended. | |
| Factory Test | The assigned SIM is in factory test mode (FTM). | |
| Deleted | N/A | Permanently removed from your Connected Devices. |
Configure the device status
A device has only two configurable states, Enabled or Disabled. You can toggle one or more devices between these states to control their data usage. To change the status of a single device, use quick actions. For multiple devices, use the enable or disable devices bulk action.
To create a device in FTM, see Activate FTM while creating devices.
If you're using the emnify REST API to configure devices, it's possible to have a Disabled endpoint with an Activated assigned SIM. In this case, you continue to accrue costs as emnify charges for activated SIMs. Be sure to suspend the assigned SIM to avoid unexpected charges.
Reference: Endpoint Object and Endpoint API
Reset connectivity
You can reset a device's connectivity by selecting its Reset connectivity icon while viewing it in the list of Connected Devices or in device details: General tab > Status column > Connection > Reset Connectivity.
Show where this happens in the Portal
Bulk actions
You can also perform bulk actions on a group of devices.
Enable or disable devices
Use a filter to display a list of the targeted devices. Once their checkboxes indicate that they have been selected, the bulk actions menu bar appears at the top of the screen. Select Device and then one of the actions:
- Enable Devices
- Disable Devices
Show where this happens in the Portal
Rename devices
To rename multiple devices, see Rename devices in bulk.
Release SIMs
To release SIMs from multiple devices, see Release SIMs from devices in bulk.