Devices

Topics in this document:

• Devices
• Scheduled Job Operations for Device Management

Devices

Devices provide the use of customer services. Each device has a lifecycle where it transitions between states. A device type is custom and specifies its physical type (sim card, modem, phone number, RFID, NFC, etc.).

Each device has several descriptors, which hold information about its model, vendor, brand. MAC address and other identifiers can be stored in an external system and related to a device with the external service identifier.

A device is typically created with a batch of other devices sharing the same type, optionally vendor, model and brand. The device identifier has to be unique to each device. Device codes are also unique. Unique values can be generated through a template for the whole device group. Devices can be assigned to services.

When a Device is no longer active, it moves to a proper state – e.g., mobile numbers can go into quarantine and be reused, while other devices can become permanently unusable.

Device Type

Navigate to Devices on the left side menu. Select the Device Type tab to define and manage different types of devices.

Batches

Navigate to Devices on the left side menu. Select the Batches tab and follow the wizard by which you can generate the batch of devices for the selected device type by the following rules definition:

• Quantity of new devices.
• Code format template (alphanumeric/numeric) with randomized values or incremental values.
• Device identifier format template (alphanumeric/numeric) with randomized values or incremental values.

Devices

To manually add the Device, navigate to Devices on the left side menu. Select the Devices tab on the top and follow the wizard by providing the Device name, unique alphanumeric code identifier, parent Device Type and unique device identifier.

Assigning Device to the Customer’s Service

The service identifier is populated to reflect one of the device identifiers tied to that service. Can be setup at subscription creation or by modifying the existing subscription’s service and applying the device reference. Refer to Subscription’s Service.

Device’s Status Transitions

Table: Allowed device status transitions

Device History

Device history represents the historical event which happened to the device: Customer change, status change, service change.

Scheduled Job Operations for Device Management

Manageable in the Operations section.

Job to Release Quarantined Devices

Quarantined devices will change their status to Unassigned or Inactive, depending on state transition definitions. A scheduled task will periodically check for devices to be put out of quarantine.

Configurable filters for the job execution:

• Time period: Quarantine period length in seconds after which the device is allowed to be transitioned for new assigning.
• Device id: To limit the job to apply only to the specific set of devices.
• Device type: To limit the job to apply only to the specific type of devices.

Job to Delete Closed Devices

Devices may end up in the CLOSED state, meaning they are lost, destroyed or out of order indefinitely. To save up space and avoid unnecessary data, a scheduled task should delete such devices after a specified period of time.

Configurable filters for the job execution:

• Time period: Period length in seconds since the device was closed and is allowed to be deleted.
• Device id: To limit the job to apply only to the specific set of devices.
• Device type: To limit the job to apply only to the specific type of devices.