Scaling an IoT deployment? Join our webinar on May 28th where we dive into real-world scaling pain points and how to overcome them.

Blues Developers
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
Button IconHelp
Notehub StatusVisit our Forum
Button IconSign In
Sign In
Sign In
Docs Home
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
Guides & Tutorials
Collecting Sensor Data
Routing Data to Cloud
Building Edge ML Applications
Best Practices for Production-Ready Projects
Twilio SMS Guide
Fleet Admin Guide
Using the Notehub API
Notecard Guides
Guide Listing
Asset Tracking
Attention Pin Guide
Connecting to a Wi-Fi Access Point
Debugging with the FTDI Debug Cable
Diagnosing Cellular Connectivity Issues
Diagnosing GPS Issues
Encrypting and Decrypting Data with the Notecard
Feather MCU Low Power Management
Minimizing Latency
Notecard Communication Without a Library
Recovering a Bricked Notecard
Remote Command and Control
Sending and Receiving Large Binary Objects
Serial-Over-I2C Protocol
Understanding Environment Variables
Understanding Notecard Penalty Boxes
Updating ESP32 Host Firmware
Using External SIM Cards
Configuring the NotecardFailing Over to a Different SIMFrequently Asked Questions
Using JSONata to Transform JSON
homechevron_rightDocschevron_rightGuides & Tutorialschevron_rightNotecard Guideschevron_rightUsing External SIM Cards

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, 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 or you have added one to your own board, the Notecard provides support for switching to an external SIM.

Configuring the Notecard

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 other can be discovered using APN discovery websites like 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

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 API.

Following on with the Airtel example:

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

Update the Frequency Band

The default mode for the Notecard is auto, which is the appropriate setting for the majority of scenarios. However, if a Notecard is known to be limited to a specific region 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 API. You can select from modes Cat-M1 (5G eMTC) (m), Cat-NB1 (5G NB-IoT) (nb), and GSM/GPRS/EDGE (2G) (gprs).

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

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.

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

Refer to the card.wireless API, for detailed instructions.

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.

note

This feature is available in the LTS v4.1.1 and later Notecard firmware releases (including Developer Firmware releases starting with v5.1.1).

Configuring SIM Failover

The card.wireless API 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.

{
  "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.

As of Notecard firmware v5.3.1, you also can use the hours argument to specify the number of hours after which the Notecard should attempt to switch back to the preferred SIM.

Programmatically Switching Between SIMs

As of the latest Notecard firmware release, the active SIM will be used as long as the Notecard is able to register on a cellular network. There is currently no way to programmatically switch between using internal and external SIMs without the Notecard experiencing a registration failure.

For example, if the 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 it experiences a registration failure on the external SIM.

Frequently Asked Questions

  • Q: What type of external SIM does the Notecarrier support?
  • A: The type of external SIM used is a Nano SIM.

  • Q: Can I use an external SIM to access 2G, 3G, 4G/LTE networks?
  • A: The answer is two fold. 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 to access 3G or 4G networks.

  • Q: Can I specify the frequency band I want to connect to, when multiple frequencies are available (Cat-M1, Cat-NB1, EGPRS)?
  • A: Yes. You will need to select a narrowband Notecard , and you can specify the network using the mode parameter of the card.wireless API.

  • Q: Does the card.wireless setting take effect immediately – or after a restart of the card?
  • A: 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 has been configured separately.

  • Q: Is it possible to programmatically switch between an internal and external SIM card?
  • A: The Notecard does automatically recognize and use an external SIM card when present, but programmatic switching between SIMs is not currently supported.

Additional Resources

  • API Reference: card.wireless
  • Advanced Notecard Configuration
  • Forum: Couldn't connect network using external SIM
  • Forum: External SIM Card on NoteCarrier
Can we improve this page? Send us feedback
© 2025 Blues Inc.
© 2025 Blues Inc.
TermsPrivacy
Notecard Disconnected
Having trouble connecting?

Try changing your USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Advanced Usage

The help command gives more info.

Connect a Notecard
Use USB to connect and start issuing requests from the browser.
Try Notecard Simulator
Experiment with Notecard's latest firmware on a Simulator assigned to your free Notehub account.

Don't have an account? Sign up