---
title: Using External SIM Cards
description: 'Set up an external SIM with Blues Notecard to reach other cellular networks: configure the APN with card.wireless, add SIM failover, and switch between SIMs.'
source_url: https://dev.blues.io/guides-and-tutorials/notecard-guides/using-external-sim-cards/
canonical_url: https://dev.blues.io/guides-and-tutorials/notecard-guides/using-external-sim-cards/
markdown_url: https://dev.blues.io/guides-and-tutorials/notecard-guides/using-external-sim-cards.md
---

# Using External SIM Cards

You might find a need to use your Notecard with an external SIM for certain deployments, for instance, if a device needs to operate in a region that is [not currently covered](https://dev.blues.io/datasheets/notecard-datasheet/note-nbgl.md#cellular-service), or if you need to ensure network redundancy for your application. In these cases, provided you are using a [Notecarrier which includes an external SIM slot](#which-notecarriers-include-an-external-sim-card-slot) or you have added one to your own board, the Notecard provides support for switching to an external SIM.

note

The external SIM slot is a physical Nano-SIM socket on the Notecarrier itself. (The Notecard's built-in SIM is embedded and is not user-removable.) Most current Notecarriers include an external SIM slot; see the FAQs below for [the full list](#which-notecarriers-include-an-external-sim-card-slot) and for [help identifying the slot](#how-do-i-identify-the-sim-slot-on-my-notecarrier) on your board.

## Configuring the Notecard {#configuring-the-notecard}

### Identify the APN {#identify-the-apn}

You must know the 3rd-party carrier's Access Point Name (APN) in order to connect to their service. Several carriers will have a website dedicated to manually configuring devices, while others can be discovered using APN discovery websites like [apn.how](https://apn.how/). For example, to operate a Notecard in India, you may wish to use an Airtel SIM with their "Internet" APN.

**Name:** Airtel\
**APN:** `airtelgprs.com`

### Update the APN Settings {#update-the-apn-settings}

Once you have determined the correct APN, the Notecard requires very minimal setup to be configured to utilize an external SIM card. The APN can be configured using the `apn` parameter of the [`card.wireless`](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless) API.

Following on with the Airtel example:

```json
{
  "req": "card.wireless",
  "apn": "airtelgprs.com"
}
```

### Verify the External SIM Is Being Used {#verify-the-external-sim-is-being-used}

After setting the APN, confirm that the Notecard registered on the new carrier using the external SIM. First set your Notehub ProductUID:

```json
{
  "req": "hub.set",
  "product": "com.your-company.your-name:your_project",
  "mode": "continuous"
}
```

Then request a sync:

```json
{
  "req": "hub.sync"
}
```

Now check the radio and SIM state:

```json
{
  "req": "card.wireless"
}
```

Look for a `status` of `{cell-registered}` or `{connected}`, and confirm that the `iccid` in the response matches the ICCID printed on your external SIM. If it matches the embedded SIM instead, the Notecard did not detect the external one — recheck that the SIM is fully seated in the Notecarrier's Nano-SIM socket. To interpret the reported signal values, see [Check Cellular Signal Quality](https://dev.blues.io/support/diagnosing-cellular-connectivity-issues.md#check-cellular-signal-quality).

Finally, confirm the Notehub session itself:

```json
{
  "req": "hub.status"
}
```

`hub.status` reports `"connected":true` while a session is open. In `periodic` or `minimum` mode, `"connected":false` between syncs is normal, so also check `hub.sync.status`, which reports `completed {sync-end}` after a successful sync:

```json
{
  "req": "hub.sync.status"
}
```

### Update the Frequency Band {#update-the-frequency-band}

The default `mode` for the Notecard is `auto`, which is the appropriate setting for the majority of scenarios. However, if using a Narrowband (NB) Notecard and you want to speed up network registration, you can specify the frequency band associated with the carrier's service.

This can be accomplished using the `mode` parameter of the [`card.wireless`](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless) API. You can select from modes Cat-M1 (5G eMTC) (`m`), Cat-NB1 (5G NB-IoT) (`nb`), and GSM/GPRS/EDGE (2G) (`gprs`).

```json
{
  "req": "card.wireless",
  "mode": "m"
}
```

### Reverting to the Embedded SIM on the Notecard {#reverting-to-the-embedded-sim-on-the-notecard}

If you need to revert from using an external SIM to using the embedded SIM on the Notecard, simply remove the external SIM and the Notecard will automatically switch to the default carrier. You can also reset the APN setting and frequency band to their defaults by using the following `card.wireless` API request.

```json
{
  "req": "card.wireless",
  "apn": "-",
  "mode": "-"
}
```

note

Refer to the [`card.wireless` API](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless), for detailed instructions.

## Failing Over to a Different SIM {#failing-over-to-a-different-sim}

In scenarios where the SIM in use on the Notecard is unable to connect (whether it's due to coverage limitations or roaming restrictions), you may configure a SIM as a failover/backup connectivity option.

### Configuring SIM Failover {#configuring-sim-failover}

The [card.wireless API](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless) is used to configure SIM failover via the `method` argument, including setting an `apn` that the Notecard will use only when using the external SIM.

```json
{
  "req": "card.wireless",
  "method": "dual-primary-secondary",
  "apn": "airtelgprs.com"
}
```

There are five possible values for the `method` argument:

- `"-"` resets the Notecard to the default value. In this state, the Notecard uses the external SIM exclusively if it detects the presence of an external SIM, otherwise it uses the internal SIM.
- `"dual-primary-secondary"` will attempt to register with the **internal SIM first** and switch to the external SIM upon a network registration failure.
- `"dual-secondary-primary"` will attempt to register with the **external SIM first** and switch to the internal SIM upon a network registration failure.
- `"primary"` - will **exclusively use the internal SIM**, even if an external SIM is present.
- `"secondary"` - will **exclusively use the external SIM**, but only if an external SIM is present.

In the two `dual-*` modes, the primary/secondary SIMs are ordered by preference. The first SIM listed is the one Notecard treats as "home" and tries to register with first. For `dual-primary-secondary`, the preferred SIM is the primary (internal). For `dual-secondary-primary`, the preferred SIM is the secondary (external).

When using either `dual-*` method, Notecard makes **two registration attempts on the current SIM** before toggling to the other SIM. Once a switch occurs, Notecard continues using the new SIM as long as it remains registered. **By default, it does not automatically return to the preferred SIM on its own.**

#### Returning to the Preferred SIM with the hours Argument {#returning-to-the-preferred-sim-with-the-hours-argument}

You can optionally use the `hours` argument to have Notecard periodically retry the preferred SIM, even when the current SIM is working fine.

```json
{
  "req": "card.wireless",
  "method": "dual-primary-secondary",
  "apn": "airtelgprs.com",
  "hours": 4
}
```

This introduces a second, independent switching trigger:

1. **Registration-failure switching**: after two failed registration attempts on the current SIM, Notecard toggles to the other SIM. The `hours` timer restarts each time a failure-triggered switch occurs.
2. **Periodic reset**: every `hours` hours, Notecard attempts to switch back to the preferred SIM regardless of which SIM is currently active.

### Programmatically Switching Between SIMs {#programmatically-switching-between-sims}

There is currently no API to force an immediate switch between the internal and external SIMs from your application code. The active SIM continues to be used as long as Notecard remains registered on a cellular network, and switches are driven only by the two triggers described above (registration failure or the `hours` periodic reset).

For example, if Notecard experiences a registration failure on the internal SIM and then successfully registers on the external SIM, it will not re-attempt to use the internal SIM until either it experiences a registration failure on the external SIM, or the `hours` periodic reset fires for whichever SIM is preferred.

## Frequently Asked Questions {#frequently-asked-questions}

### Which Notecarriers include an external SIM card slot? {#which-notecarriers-include-an-external-sim-card-slot}

Most current Notecarriers include one. The following Notecarriers have an external Nano-SIM slot:

- Notecarrier A, AA, AF, and AL
- Notecarrier F v1.3 and v1.5
- Notecarrier Pi v2.0
- Notecarrier X, CX, XS, and XI

The following Notecarriers do **not** have an external SIM slot: Notecarrier AE, Notecarrier B (all versions), Notecarrier R, Notecarrier XM, Notecarrier F v1.0, and Notecarrier Pi v1.0.

See the [Notecarrier Datasheet](https://dev.blues.io/datasheets/notecarrier-datasheet.md) for the full feature list of a specific Notecarrier and revision.

### What type of external SIM does the Notecarrier support? {#what-type-of-external-sim-does-the-notecarrier-support}

The type of external SIM used is a Nano SIM.

### How do I identify the SIM slot on my Notecarrier? {#how-do-i-identify-the-sim-slot-on-my-notecarrier}

It is a push-push Nano-SIM socket — push the card in until it clicks to seat it, and push it in again to eject it. It is a hinged metal socket roughly the size of the Notecard's own edge connector, and it is the only slot on the board sized to accept a card. The exact placement per board is shown in the front/back photos and the [design files](https://github.com/blues/note-hardware) for each Notecarrier.

### Does the external SIM have to be an M2M or IoT SIM? {#does-the-external-sim-have-to-be-an-m2m-or-iot-sim}

No, there is no requirement that an external SIM be an M2M or IoT SIM. You can use a standard consumer SIM, provided it meets two requirements:

1. **The SIM must not have a PIN lock enabled.** The Notecard cannot supply a SIM PIN, so a PIN-locked SIM will never register. Disable the PIN using a phone or a SIM reader before inserting the SIM.
2. **The APN must not require a username and password.** The Notecard configures the APN name only, so an APN that requires PAP or CHAP authentication is not supported.

Beyond that, the usual constraints apply: the carrier must offer service your Notecard SKU can reach (see the 2G/3G/4G question below), and you must set the carrier's APN with [`card.wireless`](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless).

### Can I use an external SIM to access 2G, 3G, 4G/LTE networks? {#can-i-use-an-external-sim-to-access-2g-3g-4g-lte-networks}

The answer is twofold. First, it's up to the 3rd party carrier/SIM provider as to whether or not 2G/3G/4G is available. Second, you must [select a wideband Notecard](https://shop.blues.com/collections/notecard?utm_source=dev-blues\&utm_medium=web\&utm_campaign=store-link) to access 3G or 4G networks.

### Can I specify the frequency band I want to connect to? {#can-i-specify-the-frequency-band-i-want-to-connect-to}

Yes, when multiple frequencies are available (Cat-M1, Cat-NB1, EGPRS) you can choose between them. You will need to [select a narrowband Notecard](https://shop.blues.com/collections/notecard?utm_source=dev-blues\&utm_medium=web\&utm_campaign=store-link), and you can specify the network using the `mode` parameter of the [`card.wireless`](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless) API.

### Does the card.wireless setting take effect immediately, or after a restart of the Notecard? {#does-the-card-wireless-setting-take-effect-immediately-or-after-a-restart-of-the-notecard}

It takes effect immediately, but is used only when an external SIM is plugged in. The apn setting on `card.wireless` is applicable only to an external SIM. When there is no SIM, the default carrier will be used, and when there is a SIM, the provided APN (or the default for an internally-supported SIM) will be used unless [failing over to a different SIM](#failing-over-to-a-different-sim) has been configured separately.

### If I use my own SIM, do I still pay Blues, and does traffic still go through Notehub? {#if-i-use-my-own-sim-do-i-still-pay-blues-and-does-traffic-still-go-through-notehub}

**Cellular data:** with an external SIM you buy connectivity directly from your SIM provider and pay them for it. Bundled data and coverage apply only to the Notecard's internal SIM, so Blues does not bill you for the data that the external SIM carries. Notehub event usage, however, is metered identically no matter which SIM is in use.

**Traffic path:** yes, the Notecard still talks only to Notehub. The SIM determines which carrier bearer the Notecard registers on, not where it connects.

### Is it possible to programmatically switch between an internal and external SIM card? {#is-it-possible-to-programmatically-switch-between-an-internal-and-external-sim-card}

The Notecard does automatically recognize and use an external SIM card when present, but programmatic switching between SIMs is not currently supported.

## Additional Resources {#additional-resources}

- [API Reference: `card.wireless`](https://dev.blues.io/api-reference/notecard-api/card-requests/latest.md#card-wireless)
- [Advanced Notecard Configuration](https://dev.blues.io/notecard/notecard-walkthrough/advanced-notecard-configuration.md#view-and-customize-modem-behavior)
- [Forum: Couldn't connect network using external SIM](https://discuss.blues.com/t/couldnt-connect-network-using-external-sim/214)
- [Forum: External SIM Card on NoteCarrier](https://discuss.blues.com/t/external-sim-card-on-notecarrier/169)

Can we improve this page? [Send us feedback](mailto:devrel@blues.com)
