Use the Cellular Modem tool to control modem functions.

Warning: This tool has been designed to be used for development and testing purposes by a user in real time. This tool should not be called from user apps, and may cause instabilities if called continuously. Data Connection should be used to open and configure connections within user apps.

Usage

cm [SERVICES] [COMMANDS]

ADC

cm adc read channel

Read and print the value from an adc channel (where channel is one of the names returned).

Data

cm data
cm data info

Get info on profile in use.

cm data profile <index>

Set profile in use.

cm data apn <apn>

Set apn for profile in use.

cm data pdp <pdp>

Set pdp type for profile in use.

cm data auth <none/pap/chap> <username> <password>

Set authentication for profile in use.

cm data connect <optional timeout (secs)>

Start a data connection.

cm data watch

Monitor the data connection.

To start a data connection, ensure that your profile is configured correctly. Also ensure your modem is registered to the network. To verify, use cm radio and check Status.

If you specify a time-out timer when starting a data connection, it will try to start a data connection until the timer expires.

When starting a data connection, currently it only uses profile 1. Any configuration set for other profiles can't be used to start a data connection through the cm tool.

Info

cm info
cm info all

Print all known info.

cm info device

Print the device model.

cm info imei

Print the IMEI.

cm info firmware

Print the firmware version.

cm info bootloader

Print the bootloader version.

IPS

cm ips
cm ips read

Print information about the power supply (voltage, power source, battery level).

cm ips thresholds

Print the input voltage thresholds.

Radio

cm radio
cm radio status

Get modem status.

cm radio <on/off>

Enable/disable radio.

cm radio rat <[CDMA] [GSM] [UMTS] [LTE] [TDSCDMA]>

Set the prefered radio access technologies.

cm radio getRAT

Get the prefered radio access technologies.

cm radio rat AUTO

Resume automatic RAT selection.

After setting the radio access technology, you'll need to do a legato restart before it's effective.

RTC

cm rtc read

Reads the RTC time

cm rtc set "21 Oct 2015 16:29:00"

Sets the RTC time

Time Format:

day of the month (leading zeros are permitted)
month (either the abbreviated or the full name)
year with century
hour (leading zeros are permitted)
minute (leading zeros are permitted)
seconds (leading zeros are permitted)

SIM

Regardless if security is enabled or not, the SIM card PIN code must be entered for every operation. The only ways to change the PIN code are through changepin and unblock.

cm sim
cm sim status

Get SIM status

cm sim info

Get SIM information.

cm sim imsi

Get the SIM imsi.

cm sim iccid

Get the SIM iccid.

cm sim number

Get the sim phone number. Often M2M SIM cards don't know their number (will return nothing).

cm sim mode <MANUAL | AUTO>

Set the SIM mode. Check Automatic SIM selection for further details about automatic SIM selection.

cm sim mode

Get the SIM current mode.

cm sim enterpin <pin>

Enter pin code that's required before any mobile equipment functionality can be used.

cm sim changepin <oldpin> <newpin>

Change the PIN code of the SIM card.

cm sim lock <pin>

Lock SIM: enables SIM card security, will request for a PIN code when inserted.

cm sim unlock <pin>

Unlock SIM: disables SIM card security, won't request a PIN code when inserted (unsafe).

cm sim unblock <puk> <newpin>

Unblocks the SIM card. The SIM card is blocked after X unsuccessful attempts to enter the PIN.

cm sim storepin <pin>

Stores PIN. Whether security is enabled or not, the SIM card has a PIN code that must be entered for every operation. You can change the PIN code through changepin and unblock.

cm sim select <EMBEDDED | EXTERNAL_SLOT_1 | EXTERNAL_SLOT_2 | REMOTE>

Select the SIM type.

Whether security is enabled or not, the SIM card has a PIN code that must be entered for every operations. Only ways to change this PIN code are through 'changepin' and 'unblock' operations.

SMS

cm sms monitor

Monitor incoming SMS.

cm sms send <number> <content>

Send a text SMS.

cm sms sendbin <number> <file> <optional max sms>

Send a binary SMS

Options:

<number>: Destination number
<content>: Content as text supported by GSM 03.38 alphabet
<file>: File path OR - for standard input (stdin)
<optional max="" sms>="">: (Optional) Limit for the number of SMS the file is split in

cm sms list

List all stored SMS

cm sms get <idx>

Get specific stored SMS.

cm sms clear

Clear stored SMS.

cm sms count

Count stored SMS.

Temperature

cm temp
cm temp all

Print all known temperatures.

cm temp thresholds

Print all thresholds.

cm temp radio

Print the radio temperature.

cm temp platform

Print the platform temperature.