Cellular.off() turns off the Cellular module. Useful for saving power, since most of the power draw of the device is the Cellular module. Note: turning off the Cellular module will force it to go through a full re-connect to the Cellular network the next time it is turned on.
// SYNTAX Cellular.off(); // EXAMPLE Particle.disconnect(); Cellular.off();
You must not turn off and on cellular more than every 10 minutes (6 times per hour). Your SIM can be blocked by your mobile carrier for aggressive reconnection if you reconnect to cellular very frequently.
If you are manually managing the cellular connection in case of connection failures, you should wait at least 5 minutes before stopping the connection attempt. When retrying on failure, you should implement a back-off scheme waiting 5 minutes, 10 minutes, 15 minutes, 20 minutes, 30 minutes, then 60 minutes between retries. Repeated failures to connect can also result in your SIM being blocked.
You must call
Particle.disconnect() before turning off the cellular modem manually, otherwise the cloud connection may turn the cellular modem back on.
This should only be used with
MANUAL) as the cloud connection and cellular modem are managed by Device OS in
Cellular.off() API is non-blocking on all platforms except for Electron with threading disabled.