😌 Learn How to Simplify Host Firmware Updates with the Notecard on February 2nd !

Search
Documentation Results
End of results
Community Results
End of results
Support
Blues.io
Notehub.io
Shop
Sign In
Search
Documentation Results
End of results
Community Results
End of results
Support
Blues.io
Notehub.io
Shop
Γ—
HomeGuides & Tutorials
Welcome
Collecting Sensor Data
Routing Data to Cloud
Building Edge ML Applications
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
Encrypting Data With the Notecard
Minimizing Latency
Notecard Outboard Firmware Update
Remote Command and Control
Serial-Over-I2C Protocol
Understanding Environment Variables
Understanding Notecard Penalty Boxes
Updating ESP32 Host Firmware
Using External SIM CardsConfiguring the NotecardFrequently Asked Questions
Using JSONata to Transform JSON
Rate this page Β 
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
Can we improve this page? Send us feedbackRate this page
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
  • β˜…
    β˜…
Β© 2023 Blues Inc.Terms & ConditionsPrivacy
blues.ioTwitterLinkedInGitHubHackster.io
Disconnected
Notecard Disconnected
Having trouble connecting?

Try changing your Micro 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

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

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.

  • 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
  • APN Global
  • Forum: Couldn’t connect network using external SIM
  • Forum: External Sim Card on NoteCarrier