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 view the list in two ways: Extensive (default) and Plain. To change the view, select the corresponding tab to the right of the page title.
Extensive view
The Extensive view provides an overview of a device's statuses and usage. The following columns are available:
| Property | Predefined options if applicable | Description |
|---|---|---|
| Name | Name of the device and 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. |
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. |
| 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. |
Plain view
The Plain view focuses on the device details. Instead of columns, it shows the following data for each device:
| Property | Description |
|---|---|
| Name | Name of the device. |
| Tags | Name of the tags you've assigned to the device. |
| Status | Current state of the device, specifically: Enabled, Disabled, or Factory Test. |
| IMEI | 15-digit IMEI including the final check digit. |
| IP address | Unique address that identifies the device on the internet or a local network (for example, 10.1.1.9). |
| ICCID | Integrated circuit card identifier including the final Luhn checksum digit. |
| MSISDN | Mobile Station International Subscriber Directory Number, used to identify a mobile phone number internationally. |
| Device ID | Unique identifier for the device. |
Next to each device, you can select Details to view more device information.
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 are available for both the Extensive and Plain view of the Connected Devices table. These filters allow you to query devices based on one or more properties (for example, assigned tags or the device ID).
Select the filter you want to edit and enter a value.
To add multiple filter values, press the Tab key.
Once you've entered all the values you want to filter by, press the Enter key or click Apply.
To remove a filter or value, click the corresponding .
Filters can be combined or used together with the search bar.
Filtered values are saved in the URL as a query parameter (for example, after filtering for devices named Alexa, the URL includes &name=Alexa at the end).
Your selected filters remain active when you visit a device's details page. However, the filters reset if you go to another page in the Portal.
Available filters
| Property | Value | Wildcard support | Description |
|---|---|---|---|
| Name | String | yes | Name of a device. |
| ICCID | String | yes | Integrated circuit card identifier including the final Luhn checksum digit. |
| Tag | String | yes | Name of a tag you've assigned to a device. |
| Device ID | String | no | Unique identifier for a device. |
| Status | Predefined | no | List of possible device statuses, specifically: Enabled, Disabled, Factory Test, and No SIM. |
| MSISDN | String | yes | MSISDN of the device's assigned SIM. Accepts phone numbers with or without a + before the country code. |
| EID | String | yes | Unique global serial number for an eUICC. |
| IMEI | String | yes | IMEI or IMEI Software Version (IMEISV). Note: The filter queries the first 14 digits to support both IMEI types. Therefore, the results may show devices with different final digits. |
| IP address | String | yes | Unique address that identifies a device on the internet or a local network (for example, 10.1.1.9). |
| Coverage policy | Predefined | yes | List of your configured coverage policies. |
| Service policy | Predefined | yes | List of your configured service policies. |
Status filter
Filtering by status returns devices based on a combination of the device status and the status of the attached SIM.
| Filter option | Description |
|---|---|
| Enabled | Device status Enabled and SIM status Activated |
| Disabled | Two possible options:
|
| Factory Test | Device status Factory Test because the device is in factory test mode (FTM). |
| No SIM | No SIM assigned to the device. Device status is Disabled by default. |
Wildcard support
A wildcard filter lets you find various value forms based on a partial match.
You can also use character matching with an asterisk *.
This is especially useful if a term has multiple spellings or you're unsure of the exact value.
For example, if you have two devices named Phase modem and My iPhone, filtering for ph or ph*e shows both devices in the results.
Another example is filtering names using organi*ation shows all results regardless of whether the device name uses American (organization) or British (organisation) spelling.
Upload a CSV file
You can use a comma-separated values (CSV) file to apply multiple values to any filter that accepts string values.
This feature is especially useful if you have dozens of values (for example, 100 ICCIDs). Importing values through a CSV file lets you skip the tedious task of entering each value individually.
To upload a CSV file, follow these steps:
- On Connected Devices, choose the corresponding filter for the property in your CSV file (for example, ICCID).
- Click Import a CSV file.
- Drag and drop the file or select Browse file to find the file you want to import.
- Verify the file name and line count are correct, then click Confirm.
Each value is parsed, and the table shows any devices with the corresponding values.
Uploading a CSV file won't overwrite any existing filters. To add or remove any values, select the filter again.
Please note the following limits:
- You can only upload one
.csvor.txtfile at a time - Maximum rows: 10,000
- Maximum row length: 100 characters
- The CSV file size can't exceed 400 KB in total
You can download and view a sample CSV file to use as a template. Choose the filter, select Import a CSV file, then click Download example of right format CSV.
Enter a list of values
You can also enter a list of values to filter for multiple ones simultaneously. This works for any property that accepts string values.
Lists must be plain text with every value on its own line. Write the values exactly as they appear in the Portal.
To demonstrate, if you enter the following in the Tag filter and press the Enter key:
test
v1
beta
Each value is parsed, and the table shows any devices with the test, v1, and beta tags.
Search devices
The Connected Devices search bar is next to the Add device button. It's visible on both the Extensive and Plain table view.
To search your devices, type a value in the text field, then press the Enter key.
To reset, click the corresponding .
All the Available filter properties are searchable except Status, Coverage policy, and Service policy.
Unlike filters, where the results are focused on one property, the search simultaneously looks for matches across multiple properties.
For example, if you enter the number 2, the search results would show any device with 2 in its name (like WalkieTalkie 2.0), any assigned tags, or one or more of its numeric values (ICCID, EID, etc.).
The search is case insensitive, meaning GPS Tracker and gps tracker would produce the same results.
You can also combine the search with filters, but searched values aren't saved in the URL.
Wildcards using an asterisk * aren't supported in the search bar.
For example, if your device's Name is My iPhone, searching phone would show results, but searching *phone wouldn't.
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.