Configuration
To get started, you'll need to have enabled on your account. To request access, contact our Sales Team .
Provisioning
Provisioning to your IoT SIM will disable automatic switching between subscriptions, including cellular subscriptions. You will need to use AT commands to switch subscriptions manually. !!!! For example, if you provision to a IoT SIM that also has the subscription container, the IoT SIM will no longer automatically switch between and based on coverage.
-
Add to your or IoT SIM card by following the Adding a Subscription instructions in the Subscription Containers documentation.
-
Confirm that the delivery status of the subscription is
ready.
Switching the Active Subscription
Provisioning an IoT SIM with disables automatic switching between subscriptions, including cellular subscriptions. To switch the active subscription after delivery, use AT commands.
To run
AT+CSIMcommands, your modem must be enabled. You can use theAT+CFUN=1command to enable the modem manually.
Switching to
Unlike other subscriptions, is provisioned as disabled by default using the "enable":false parameter. This precaution is intentional to prevent accidental usage, as satellite communication incurs significantly higher costs compared to cellular.
To use , the subscription must be manually selected by connecting to your device's serial interface and running the following AT command:
AT+CSIM=52,"80C2000015D613190103820282811B0100130799F08900010001"
After selecting the subscription, verify that the active IMSI has switched correctly:
AT+CIMI
The IMSI displayed should be the same IMSI beginning with 29510 that is displayed on your SIM Management page.
Switching to Other Subscriptions
To return to using other Soracom subscriptions, activate the subscription by using the appropriate AT command for that subscription:
| Subscription | Subscription Activation AT Command |
|---|---|
AT+CSIM=52,"80C2000015D613190103820282811B0100130799F05000010001" | |
AT+CSIM=52,"80C2000015D613190103820282811B0100130799808500010001" | |
AT+CSIM=52,"80C2000015D613190103820282811B0100130799F00100010001" | |
AT+CSIM=52,"80C2000015D613190103820282811B0100130799000200010001" | |
AT+CSIM=52,"80C2000015D613190103820282811B0100130799F01300010001" | |
| or | AT+CSIM=52,"80C2000015D613190103820282811B0100130799F02100010001" |
AT+CSIM=52,"80C2000015D613190103820282811B0100130799302100010001" | |
| {# |
- planP2 - AT+CSIM=52,"80C2000015D613190103820282811B0100130799F08100010001"
- planV1 - AT+CSIM=52,"80C2000015D613190103820282811B0100130799F04000010001"
- planM1 AT+CSIM=52,"80C2000015D613190103820282811B0100130799F08500010001"
#}
Module Configuration
For detailed configuration instructions, see specific setup guides depending on your module:
- Murata 1SC / Quectel BG770A-SN setup
- While this page only directly mentions the 1SC, both modules are based on the Altair1250 chipset and therefore support the same AT commands, making their setup and configuration identical.
All modules follow similar configuration patterns:
- Set APN to
soracom.io - Enable NB-IoT (NTN)
- Set the correct frequency band for your region: band 256 for Europe, band 255 for the UK, Oceania, and Brazil, or band 23 for the US and Canada.
- Set the GPS or GNSS location
- Enable the modem using
AT+CFUN=1
supports both eDRX and PSM modes.
Sending and Receiving Data
Once connected, you can test your connection by:
- Sending a ping to Soracom's ping endpoint.
- Adding your -provisioned IoT SIM to a group configured to use Unified Endpoint and Soracom Harvest Data, and sending data to the Unified Endpoint. Unified Endpoint will return response codes validating reception.