All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
cm

Use the Cellular Modem tool to control modem functions.

Usage

cm [SERVICES] [COMMANDS]

Available services are radio, sim and data.

CM Radio

cm radio 

Get modem status.

cm radio <on/off> 

Enable/disable radio.

cm radio rat <CDMA | GSM/UMTS | LTE> 

Set radio access technology.

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

CM SIM

cm sim 

Get sim status

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

Select the SIM type.

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 Data

cm data 

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 list 

List all the profiles.

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.

14.04 Users

If you're upgrading from Legato Beta 14.04, data connection operation will be slightly different. Once you have a data connection started successfully, the process will continue running.

To stop the session, do one of these:

  • Run cm data connect as usual and if you want to release the data connection, simply press CTRL+C.
  • Run cm data connect & (background) and if you want to release the data connection, kill the process (kill <pid>).

Copyright (C) Sierra Wireless Inc. Use of this work is subject to license.