Connectivity

Factory test mode

The factory test mode (FTM) feature allows you to test SIM cards prior to their deployment in a production environment. SIM cards in FTM provide 100 KB of data usage and 10 SMS MT/MO free of charge.

In this state, you won’t be charged the monthly SIM hosting fees and the data consumed won’t affect the pooled allowance.

Patch your SIM to Factory Test

You need to register your SIM before activating FTM. For more information, see Register SIMs.

A SIM card can only be patched to “Factory Test” from the “Issued” state. To patch your SIM card, follow these steps:

1

Open the API Reference.

2

Authorize your account, if you haven’t already.

3

Go to the SIMs section and select /api/v1/sim/{sim_id} (Update a SIM).

4

Select Try it out and enter the sim_id.

5

Edit the Body Parameters to change the SIM status ID to 4 (Factory Test):

1{
2    "status": {
3        "id": 4
4    }
5}
6

When you’re satisfied with your request, click Send Request.

The server responds with code 204 if successful.

Once the SIM is assigned to a device, the device status shows as Factory test in the Connected Devices page of the emnify Portal.

When the 100 KB of data or 10 SMS MT/MO are reached, the SIM card automatically moves to “Activated” status and the device status changes to “Enabled.”

Activate FTM in bulk

To activate FTM in bulk, use the following API calls.

First, update the SIM status to Factory Test.

PATCH https://cdn.emnify.net/api/v1/sim/{sim_id}

1{
2    "status": {
3        "id": 4
4    }
5}

Second, create the endpoints.

Important: Make sure to assign the Factory Test SIM cards to an enabled endpoint (status_id=0). Otherwise, assigning SIM cards to a disabled endpoint activates the SIM once the endpoint gets enabled.

POST https://cdn.emnify.net/api/v1/endpoint

1{
2    "name": "DEVICE_NAME",
3    "status": {
4        "id": 0
5    },
6    "service_profile": {
7        "id": 1234
8    },
9    "tariff_profile": {
10        "id": 1234
11    },
12    "sim": {
13        "id": 1234,
14        "activate": false
15    }
16}

Replace 1234 with the relevant ID values.