suzanne.soy/man-pages
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
gh-pages
man-pages/man1/mmcli.1.html
Suzanne Soy 4c89183f2b Added man pages from my system
2021-03-31 01:06:50 +01:00

1297 lines
38 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of mmcli</TITLE>
</HEAD><BODY>
<H1>mmcli</H1>
Section: User Commands (1)<BR>Updated: October 2012<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
mmcli - Control and monitor the ModemManager
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>mmcli</B> [<I>OPTION</I>...]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
ModemManager is a DBus-powered Linux daemon which provides a unified
high level API for communicating with (mobile broadband) modems. It
acts as a standard RIL (Radio Interface Layer) and may be used by
different connection managers, like NetworkManager. Thanks to the
built-in plugin architecture, ModemManager talks to very different
kinds of modems with very different kinds of ports. In addition to the
standard AT serial ports, Qualcomm-based QCDM and QMI ports are also
supported.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>HELP OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-h, --help</B>
<DD>
Show summary of options by group.
<DT id="2"><B>--help-all</B>
<DD>
Show all groups and options.
<DT id="3"><B>--help-manager</B>
<DD>
Show manager specific options.
<DT id="4"><B>--help-common</B>
<DD>
Show common options. These are used for defining the device an option
operates on. For example, modems, bearers, SIMs, SMS', etc.
<DT id="5"><B>--help-modem</B>
<DD>
Show modem specific options.
<DT id="6"><B>--help-3gpp</B>
<DD>
Show 3GPP specific options.
<DT id="7"><B>--help-cdma</B>
<DD>
Show CDMA specific options.
<DT id="8"><B>--help-simple</B>
<DD>
Show simple options. These are useful for getting connected or
disconnected and understanding the state of things as fast as possible
without worrying so much about the details.
<DT id="9"><B>--help-location</B>
<DD>
Show location or positioning specific options.
<DT id="10"><B>--help-messaging</B>
<DD>
Show messaging specific options. See also <B>--help-sms</B> which
is related.
<DT id="11"><B>--help-time</B>
<DD>
Show time specific options.
<DT id="12"><B>--help-firmware</B>
<DD>
Show firmware specific options.
<DT id="13"><B>--help-oma</B>
<DD>
Show OMA specific options.
<DT id="14"><B>--help-sim</B>
<DD>
Show SIM card specific options.
<DT id="15"><B>--help-bearer</B>
<DD>
Show bearer specific options.
<DT id="16"><B>--help-sms</B>
<DD>
Show SMS specific options. See also <B>--help-messaging</B> which
is related.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>MANAGER OPTIONS</H2>
<DL COMPACT>
<DT id="17"><B>-B, --get-daemon-version</B>
<DD>
Retrieve the version of the currently running ModemManager daemon.
<DT id="18"><B>-G, --set-logging=[ERR|WARN|INFO|DEBUG]</B>
<DD>
Set the logging level in ModemManager daemon. For debugging information you can
supply <B>DEBUG</B>. Each value above <B>DEBUG</B> provides less detail. In most
cases <B>ERR</B> (for displaying errors) are the important messages.
<P>
The default mode is <B>ERR</B>.
<DT id="19"><B>-L, --list-modems</B>
<DD>
List available modems.
<DT id="20"><B>-M, --monitor-modems</B>
<DD>
List available modems and monitor modems added or removed.
<DT id="21"><B>-S, --scan-modems</B>
<DD>
Scan for any potential new modems. This is only useful when expecting pure
RS232 modems, as they are not notified automatically by the kernel.
<DT id="22"><B>-I, --inhibit-device=[UID]</B>
<DD>
Inhibit the specific device from being used by ModemManager. The <B>UID</B>
that should be given is the value of the <B>Device</B> property exposed by
a given modem (i.e. equal to the <B>ID_MM_PHYSDEV_UID</B> if one set, or
otherwise equal to the full device sysfs path).
<P>
This command will not exit right away, as that would implicitly remove the
inhibition. The user must make sure to stop the mmcli process hitting Ctrl+C
in order to un-inhibit the device.
<P>
When a device is inhibited via this method, ModemManager will disable the modem
(therefore stopping any ongoing connection) and will no longer use it until it
is uninhibited.
<DT id="23"><B>--report-kernel-event=['KEY1=VALUE1,KEY2=VALUE2,...']</B>
<DD>
Manually report kernel events, instead of relying on udev (e.g. if the daemon
is running with <B>--no-auto-scan</B> or if the system was built without udev
support).
<P>
The supported <B>KEY</B>s are:
<DL COMPACT><DT id="24"><DD>
<DL COMPACT>
<DT id="25"><B>'action'</B><DD>
Action to report, one of 'add' or 'remove'. Required.
<DT id="26"><B>'subsystem'</B><DD>
Subsystem of the specific port being reported, e.g. 'tty' (for serial ports),
<DT id="27"><B>'name'</B><DD>
Name of the port being reported, e.g. 'ttyACM0', 'wwan0' or 'cdc-wdm0'.
<DT id="28"><B>'uid'</B><DD>
The specific UID of the device, equivalent to the <B>ID_MM_PHYSDEV_UID</B> udev
tag. All ports reported with the same 'UID' value will be considered part of the
same device, which may be useful for e.g. modems with multiple platform TTYs.
</DL>
</DL>
<P>
<DT id="29"><B>--report-kernel-event-auto-scan</B>
<DD>
When built with udev support but the daemon is running with
<B>--no-auto-scan</B>, this method may be used to automatically report kernel
events based on udev.
<P>
This command will not exit right away. The user must make sure to stop the mmcli
process hitting Ctrl+C in order to stopping monitoring for new events.
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>COMMON OPTIONS</H2>
All options below take a <B>PATH</B> or <B>INDEX</B> argument. If no action is
provided, the default information about the modem, bearer, etc. is
shown instead.
<P>
The <B>PATH</B> and <B>INDEX</B> are created automatically when the
modem is plugged in. They can be found using <B>mmcli -L</B>. This
produces something like (for modems only):
<P>
<DL COMPACT><DT id="30"><DD>
Found 1 modems:
<BR>&nbsp;&nbsp;/org/freedesktop/ModemManager1/Modem/<B>4</B>
</DL>
<P>
In this case, the <B>INDEX</B> is <B>4</B> and the <B>PATH</B> is the entire string above.
<P>
However, for the bearers, SIMs and SMS cases, the <B>PATH</B> is
slightly different. The <I>Modem</I> is replaced with the object name
in use, like <I>Bearer</I>. For example:
<P>
<DL COMPACT><DT id="31"><DD>
/org/freedesktop/ModemManager1/<I>Bearer</I>/4
</DL>
<P>
<DL COMPACT>
<DT id="32"><B>-m, --modem=[PATH|INDEX]</B>
<DD>
Specify a modem.
<DT id="33"><B>-b, --bearer=[PATH|INDEX]</B>
<DD>
Specify a bearer.
<DT id="34"><B>-i, --sim=[PATH|INDEX]</B>
<DD>
Specify a SIM card.
<DT id="35"><B>-s, --sms=[PATH|INDEX]</B>
<DD>
Specify an SMS.
<P>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>MODEM OPTIONS</H2>
All of the modem options below make use of the <B>--modem</B> or
<B>-m</B> switch to specify the modem to act on.
<P>
Some operations require a <B>MODE</B>. <B>MODE</B> can be any
combination of the modes actually supported by the modem. In the
perfect case, the following are possible:
<P>
<PRE>
<B>'2G'</B> - 2G technologies, e.g. EDGE, CDMA1x
<B>'3G'</B> - 3G technologies, e.g. HSPA, EV-DO
<B>'4G'</B> - 4G technologies, e.g. LTE
<B>'ANY'</B> - for all supported modes.
</PRE>
<DL COMPACT>
<DT id="36"><B>-w, --monitor-state</B>
<DD>
Monitor the state of a given modem.
<DT id="37"><B>-e, --enable</B>
<DD>
Enable a given modem.
<P>
This powers the antenna, starts the automatic registration process and
in general prepares the modem to be connected.
<DT id="38"><B>-d, --disable</B>
<DD>
Disable a given modem.
<P>
This disconnects the existing connection(s) for the modem and puts it
into a low power mode.
<DT id="39"><B>-r, --reset</B>
<DD>
Resets the modem to the settings it had when it was power cycled.
<DT id="40"><B>--factory-reset=CODE</B>
<DD>
Resets the modem to its original factory default settings.
<P>
The <B>CODE</B> provided is vendor specific. Without the correct vendor
code, it's unlikely this operation will succeed. This is not a common
user action.
<DT id="41"><B>--command=COMMAND</B>
<DD>
Send an AT <B>COMMAND</B> to the given modem. For example,
<B>COMMAND</B> could be 'AT+GMM' to probe for phone model information. This
operation is only available when ModemManager is run in debug mode.
<DT id="42"><B>--list-bearers</B>
<DD>
List packet data bearers that are available for the given modem.
<DT id="43"><B>--create-bearer=['KEY1=VALUE1,KEY2=VALUE2,...']</B>
<DD>
Create a new packet data bearer for a given modem. The <B>KEY</B>s and
some <B>VALUE</B>s are listed below:
<DL COMPACT><DT id="44"><DD>
<DL COMPACT>
<DT id="45"><B>'apn'</B><DD>
Access Point Name. Required in 3GPP.
<DT id="46"><B>'ip-type'</B><DD>
Addressing type. Given as a MMBearerIpFamily value (e.g. 'ipv4', 'ipv6', 'ipv4v6'). Optional in 3GPP and CDMA.
<DT id="47"><B>'allowed-auth'</B><DD>
Authentication method to use. Given as a MMBearerAllowedAuth value (e.g. 'none|pap|chap|mschap|mschapv2|eap'). Optional in 3GPP.
<DT id="48"><B>'user'</B><DD>
User name (if any) required by the network. Optional in 3GPP.
<DT id="49"><B>'password'</B><DD>
Password (if any) required by the network. Optional in 3GPP.
<DT id="50"><B>'allow-roaming'</B><DD>
Flag to tell whether connection is allowed during roaming, given as a boolean value (i.e 'yes' or 'no'). Optional in 3GPP.
<DT id="51"><B>'rm-protocol'</B><DD>
Protocol of the Rm interface, given as a MMModemCdmaRmProtocol value (e.g. 'async', 'packet-relay', 'packet-network-ppp', 'packet-network-slip', 'stu-iii'). Optional in CDMA.
<DT id="52"><B>'number'</B><DD>
Telephone number to dial. Required in POTS.
</DL>
</DL>
<DT id="53"><B>--delete-bearer=[PATH|INDEX]</B>
<DD>
Delete bearer from a given modem.
<DT id="54"><B>--set-allowed-modes=[MODE1|MODE2|...]</B>
<DD>
Set allowed modes for a given modem. For possible modes, see the
beginning of this section.
<DT id="55"><B>--set-preferred-mode=MODE</B>
<DD>
Set the preferred <B>MODE</B> for the given modem. The <B>MODE</B>
<I>MUST</I> be one of the allowed modes as set with the
<B>--set-allowed-modes</B> option. Possible <B>MODE</B> arguments
are detailed at the beginning of this section.
<DT id="56"><B>--set-current-bands=[BAND1|BAND2|...]</B>
<DD>
Set bands to be used for a given modem. These are frequency ranges
the modem should use. There are quite a number of supported bands and
listing them all here would be quite extensive. For details, see the
MMModemBand documentation.
<P>
An example would be: 'egsm|dcs|pcs|g850' to select all the GSM
frequency bands.
<DT id="57"><B>--inhibit</B>
<DD>
Inhibit the specific modem from being used by ModemManager. This method
is completely equivalent to <B>--inhibit-device</B>, with the only
difference being that in this case, the modem must be managed by the daemon
at the time the inhibition is requested.
<P>
This command will not exit right away, as that would implicitly remove the
inhibition. The user must make sure to stop the mmcli process hitting Ctrl+C
in order to un-inhibit the device.
<P>
When a device is inhibited via this method, ModemManager will disable the modem
(therefore stopping any ongoing connection) and will no longer use it until it
is uninhibited.
<P>
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>3GPP OPTIONS</H2>
The 3rd Generation Partnership Project (3GPP) is a collaboration
between groups of telecommunications associations. These options
pertain to devices which support 3GPP.
<P>
Included are options to control USSD (Unstructured Supplementary
Service Data) sessions.
<P>
All of the 3GPP options below make use of the <B>--modem</B> or
<B>-m</B> switch to specify the modem to act on.
<DL COMPACT>
<DT id="58"><B>--3gpp-scan</B>
<DD>
Scan for available 3GPP networks.
<DT id="59"><B>--3gpp-register-home</B>
<DD>
Request a given modem to register in its home network.
<P>
This registers with the default network(s) specified by the modem,
<DT id="60"><B>--3gpp-register-in-operator=MCCMNC</B>
<DD>
Request a given modem to register on the network of the given
<B>MCCMNC</B> (Mobile Country Code, Mobile Network Code) based
operator. This code is used for GSM/LTE, CDMA, iDEN, TETRA and UMTS
public land mobile networks and some satellite mobile networks. The
ITU-T Recommendation E.212 defines mobile country codes.
<DT id="61"><B>--3gpp-ussd-status</B>
<DD>
Request the status of <I>ANY</I> ongoing USSD session.
<DT id="62"><B>--3gpp-ussd-initiate=COMMAND</B>
<DD>
Request the given modem to initiate a USSD session with <B>COMMAND</B>.
<P>
For example, <B>COMMAND</B> could be '*101#' to give your current
pre-pay balance.
<DT id="63"><B>--3gpp-ussd-respond=RESPONSE</B>
<DD>
When initiating an USSD session, a RESPONSE may be needed by a
network-originated request. This option allows for that.
<DT id="64"><B>--3gpp-ussd-cancel</B>
<DD>
Cancel an ongoing USSD session for a given modem.
<P>
</DL>
<A NAME="lbAJ">&nbsp;</A>
<H2>CDMA OPTIONS</H2>
All CDMA (Code Division Multiple Access) options require the
<B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="65"><B>--cdma-activate=CARRIER</B>
<DD>
Activate the given modem using OTA (Over the Air) settings. The
<B>CARRIER</B> is a code provided by the network for the default
settings they provide.
<P>
</DL>
<A NAME="lbAK">&nbsp;</A>
<H2>SIMPLE OPTIONS</H2>
All simple options must be used with <B>--modem</B> or <B>-m</B>.
<P>
<DL COMPACT>
<DT id="66"><B>--simple-connect=['KEY1=VALUE1,KEY2=VALUE2,...']</B>
<DD>
Run a full connection sequence using <B>KEY</B> / <B>VALUE</B> pairs.
You can use the <B>--create-bearer</B> options, plus any of the
following ones:
<DL COMPACT><DT id="67"><DD>
<DL COMPACT>
<DT id="68"><B>'pin'</B><DD>
SIM-PIN unlock code.
<DT id="69"><B>'operator-id'</B><DD>
ETSI MCC-MNC of a network to force registration.
</DL>
</DL>
<DT id="70"><B>--simple-disconnect</B>
<DD>
Disconnect <I>ALL</I> connected bearers for a given modem.
<P>
</DL>
<A NAME="lbAL">&nbsp;</A>
<H2>LOCATION OPTIONS</H2>
These options detail how to discover your location using Global
Positioning System (GPS) or directly from your mobile network infrastructure
(either 3GPP or 3GPP2).
<P>
All location options must be used with <B>--modem</B> or <B>-m</B>.
<P>
<DL COMPACT>
<DT id="71"><B>--location-status</B>
<DD>
Show the current status for discovering our location.
<DT id="72"><B>--location-get</B>
<DD>
Show all location information available.
<DT id="73"><B>--location-enable-3gpp</B>
<DD>
Enable location discovery using the 3GPP network.
<DT id="74"><B>--location-disable-3gpp</B>
<DD>
Disable location discovery using the 3GPP network.
<DT id="75"><B>--location-enable-agps-msa</B>
<DD>
Enable A-GPS (MSA) support. This command does not implicitly start the GPS
engine, it just specifies that A-GPS should be enabled when the engine is
started. Therefore, the user should request enabling A-GPS before the raw
or NMEA outputs are enabled with <B>--location-enable-gps-raw</B> or
<B>--location-enable-gps-nmea</B>.
<DT id="76"><B>--location-disable-agps-msa</B>
<DD>
Disable A-GPS (MSA) support.
<DT id="77"><B>--location-enable-agps-msb</B>
<DD>
Enable A-GPS (MSB) support. This command does not implicitly start the GPS
engine, it just specifies that A-GPS should be enabled when the engine is
started. Therefore, the user should request enabling A-GPS before the raw
or NMEA outputs are enabled with <B>--location-enable-gps-raw</B> or
<B>--location-enable-gps-nmea</B>.
<DT id="78"><B>--location-disable-agps-msb</B>
<DD>
Disable A-GPS (MSB) support.
<DT id="79"><B>--location-enable-gps-nmea</B>
<DD>
Enable location discovery using GPS and reported with NMEA traces.
<P>
This command will start the GPS engine, if it isn't started already.
<DT id="80"><B>--location-disable-gps-nmea</B>
<DD>
Disable location discovery using GPS and NMEA traces.
<P>
If the raw output is not enabled at the same time, the GPS engine will be
stopped.
<DT id="81"><B>--location-enable-gps-raw</B>
<DD>
Enable location discovery using GPS and reported with raw (i.e.
longitude/latitude) values.
<P>
This command will start the GPS engine, if it isn't started already.
<DT id="82"><B>--location-disable-gps-raw</B>
<DD>
Disable location discovery using GPS and raw values.
<P>
If the NMEA output is not enabled at the same time, the GPS engine will be
stopped.
<DT id="83"><B>--location-enable-cdma-bs</B>
<DD>
Enable location discovery using the 3GPP2 network.
<DT id="84"><B>--location-disable-cdma-bs</B>
<DD>
Disable location discovery using the 3GPP2 network.
<DT id="85"><B>--location-enable-gps-unmanaged</B>
<DD>
Enable location discovery using GPS but without taking control of the NMEA tty
port. This allows other programs, e.g. gpsd, to use the NMEA tty once the GPS
engine has been enabled.
<DT id="86"><B>--location-disable-gps-unmanaged</B>
<DD>
Disable location discovery using GPS and unmanaged port.
<DT id="87"><B>--location-set-gps-refresh-rate=SEC</B>
<DD>
Set the location refresh rate on the DBus interface to SEC seconds. If set to
0, the new location is published on the DBus interface as soon as ModemManager
detects it.
<DT id="88"><B>--location-set-supl-server=[IP:PORT] or --location-set-supl-server=[FQDN:PORT]</B>
<DD>
Configure the location of the A-GPS SUPL server, either specifying the IP
address (<B>IP:PORT</B>) or specifyng a fully qualified domain name
(<B>[FQDN:PORT]</B>).
<DT id="89"><B>--location-inject-assistance-data=[PATH]</B>
<DD>
Inject assistance data into the GNSS module, loaded from a local file at
<B>PATH</B>. The assistance data should be in a format expected by the device,
e.g. downloaded from the URLs exposed by the 'AssistanceDataServers' property.
<DT id="90"><B>--location-set-enable-signal</B>
<DD>
Enable reporting location updates via DBus property signals. This is
required if applications rely on listening to 'Location' property updates,
instead of explicit queries with the policy-protected 'GetLocation' method.
<P>
This DBus property signal updates are by default disabled.
<DT id="91"><B>--location-set-disable-signal</B>
<DD>
Disable reporting location updates via DBus property signals.
<P>
</DL>
<A NAME="lbAM">&nbsp;</A>
<H2>MESSAGING OPTIONS</H2>
All messaging options must be used with <B>--modem</B> or <B>-m</B>.
<P>
<DL COMPACT>
<DT id="92"><B>--messaging-status</B>
<DD>
Show the status of the messaging support.
<DT id="93"><B>--messaging-list-sms</B>
<DD>
List SMS messages available on a given modem.
<DT id="94"><B>--messaging-create-sms=['KEY1=VALUE1,...']</B>
<DD>
Create a new SMS on a given modem. <B>KEY</B>s can be any of the following:
<DL COMPACT><DT id="95"><DD>
<DL COMPACT>
<DT id="96"><B>'number'</B><DD>
<BR>&nbsp;Number&nbsp;to&nbsp;which&nbsp;the&nbsp;message&nbsp;is&nbsp;addressed.
<DT id="97"><B>'text'</B><DD>
Message text, in UTF-8. When sending, if the text is larger than the
limit of the technology or modem, the message will be broken into
multiple parts or messages. Note that text and data are never given at
the same time.
<DT id="98"><B>'smsc'</B><DD>
Indicates the SMS service center number.
<DT id="99"><B>'validity'</B><DD>
Specifies when the SMS expires in the SMSC.
<DT id="100"><B>'class'</B><DD>
3GPP message class (0..3).
<DT id="101"><B>'delivery-report-request'</B><DD>
Specifies whether delivery report is requested when sending the SMS
('yes' or 'no')
<DT id="102"><B>'storage'</B><DD>
Specifies the storage where this message is kept. Storages may
be 'sm', 'me', 'mt', 'sr', 'bm', 'ta'.
</DL>
</DL>
<DT id="103"><B>--messaging-create-sms-with-data=PATH</B>
<DD>
Use <B>PATH</B> to a filename as the data to create a new SMS.
<DT id="104"><B>--messaging-delete-sms=[PATH|INDEX]</B>
<DD>
Delete an SMS from a given modem.
<P>
</DL>
<A NAME="lbAN">&nbsp;</A>
<H2>TIME OPTIONS</H2>
All time operations require the <B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="105"><B>--time</B>
<DD>
Display the current network time from the operator. This includes the
timezone which is usually of importance.
<P>
</DL>
<A NAME="lbAO">&nbsp;</A>
<H2>VOICE OPTIONS</H2>
All voice operations require the <B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="106"><B>--voice-list-calls</B>
<DD>
List calls managed (initiated, received, ongoing) on a given modem.
<DT id="107"><B>--voice-create-call=['KEY1=VALUE1,...']</B>
<DD>
Create a new outgoing call on a given modem. <B>KEY</B>s can be any of the
following:
<DL COMPACT><DT id="108"><DD>
<DL COMPACT>
<DT id="109"><B>'number'</B><DD>
Number to call.
</DL>
</DL>
<DT id="110"><B>--voice-delete-call=[PATH|INDEX]</B>
<DD>
Delete a call from a given modem.
<P>
</DL>
<A NAME="lbAP">&nbsp;</A>
<H2>FIRMWARE OPTIONS</H2>
All firmware options require the <B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="111"><B>--firmware-status</B>
<DD>
Show firmware update specific details and properties.
<DT id="112"><B>--firmware-list</B>
<DD>
List all the firmware images installed on a given modem.
<DT id="113"><B>--firmware-select=ID</B>
<DD>
Select a firmware image from those installed on a given modem. A list
of available firmware images can be seen using the
<B>--firmware-list</B> option.
<P>
The <B>ID</B> provided is a <I>UNIQUE</I> identifier for the firmware.
<P>
</DL>
<A NAME="lbAQ">&nbsp;</A>
<H2>SIGNAL OPTIONS</H2>
All signal options require the <B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="114"><B>--signal-setup=[Rate]</B>
<DD>
Setup extended signal quality information retrieval at the specified rate
(in seconds).
<P>
By default this is disabled (rate set to 0).
<DT id="115"><B>--signal-get</B>
<DD>
Retrieve the last extended signal quality information loaded.
<P>
</DL>
<A NAME="lbAR">&nbsp;</A>
<H2>OMA OPTIONS</H2>
All OMA options require the <B>--modem</B> or <B>-m</B> option.
<P>
<DL COMPACT>
<DT id="116"><B>--oma-status</B>
<DD>
Show the status of the OMA device management subsystem.
<DT id="117"><B>--oma-start-client-initiated-session=[SESSION TYPE]</B>
<DD>
Request to start a client initiated session.
<P>
The given session type must be one of:
<BR>&nbsp;'client-initiated-device-configure'
<BR>&nbsp;'client-initiated-prl-update'
<BR>&nbsp;'client-initiated-hands-free-activation'
<DT id="118"><B>--oma-accept-network-initiated-session=[SESSION ID]</B>
<DD>
Request to accept a network initiated session.
<DT id="119"><B>--oma-reject-network-initiated-session=[SESSION ID]</B>
<DD>
Request to reject a network initiated session.
<DT id="120"><B>--oma-cancel-session</B>
<DD>
Request to cancel current OMA session, if any.
<P>
</DL>
<A NAME="lbAS">&nbsp;</A>
<H2>SIM OPTIONS</H2>
<DL COMPACT>
<DT id="121"><B>--pin=PIN</B>
<DD>
Send <B>PIN</B> code to a given SIM card.
<DT id="122"><B>--puk=PUK</B>
<DD>
Send <B>PUK</B> code to a given SIM card. This must be used <I>WITH</I>
<B>--pin</B>.
<DT id="123"><B>--enable-pin</B>
<DD>
Enable PIN request for a given SIM card. This must be used <I>WITH</I>
<B>--pin</B>.
<DT id="124"><B>--disable-pin</B>
<DD>
Disable PIN request for a given SIM card. This must be used <I>WITH</I>
<B>--pin</B>.
<DT id="125"><B>--change-pin=PIN</B>
<DD>
Change the PIN for a given SIM card. It will be set to <B>PIN</B>. This
must be used <I>WITH</I> <B>--pin</B> to supply the old PIN number.
<P>
</DL>
<A NAME="lbAT">&nbsp;</A>
<H2>BEARER OPTIONS</H2>
All bearer options require the <B>--bearer</B> or <B>-b</B> option.
<P>
<DL COMPACT>
<DT id="126"><B>-c, --connect</B>
<DD>
Connect to a given bearer.
<DT id="127"><B>-x, --disconnect</B>
<DD>
Disconnect from a given bearer.
<P>
</DL>
<A NAME="lbAU">&nbsp;</A>
<H2>SMS OPTIONS</H2>
All SMS options require the <B>--sms</B> or <B>-s</B> option.
<P>
<DL COMPACT>
<DT id="128"><B>--send</B>
<DD>
Send an SMS.
<DT id="129"><B>--store</B>
<DD>
This option will store the SMS in the default storage defined by the
modem, which may be either modem-memory or SMS-memory. To know what
the existing default storage is, see the <B>--messaging-status</B>
option.
<P>
<DT id="130"><B>--store-in-storage=STORAGE</B>
<DD>
This option states which <B>STORAGE</B> to use for SMS messages.
Possible values for <B>STORAGE</B> include:
<DL COMPACT><DT id="131"><DD>
<DL COMPACT>
<DT id="132"><B>'sm'</B><DD>
SIM card storage area.
<DT id="133"><B>'me'</B><DD>
Mobile equipment storage area.
<DT id="134"><B>'mt'</B><DD>
Sum of SIM and Mobile equipment storages
<DT id="135"><B>'sr'</B><DD>
Status report message storage area.
<DT id="136"><B>'bm'</B><DD>
Broadcast message storage area.
<DT id="137"><B>'ta'</B><DD>
Terminal adaptor message storage area.
</DL>
</DL>
<DT id="138"><B>--create-file-with-data=PATH</B>
<DD>
This option takes an SMS that has <I>DATA</I> (not <I>TEXT</I>) and will
create a local file described by <B>PATH</B> and store the content of
the SMS there.
<P>
</DL>
<A NAME="lbAV">&nbsp;</A>
<H2>CALL OPTIONS</H2>
<DL COMPACT>
<DT id="139"><B>--start</B>
<DD>
Initiate an outgoing call.
<DT id="140"><B>--accept</B>
<DD>
Accept an incoming call.
<DT id="141"><B>--hangup</B>
<DD>
Reject an incoming call or hangup an ongoing one.
<DT id="142"><B>--send-dtmf=[0-9A-D*#]</B>
<DD>
Send a DTMF sequence through an ongoing call.
<P>
</DL>
<A NAME="lbAW">&nbsp;</A>
<H2>APPLICATION OPTIONS</H2>
<DL COMPACT>
<DT id="143"><B>-K, --output-keyvalue</B>
<DD>
Run action with machine-friendly key-value output, to be used e.g. by
shell scripts that rely on mmcli operations.
<DT id="144"><B>-v, --verbose</B>
<DD>
Perform actions with more details reported and/or logged.
<DT id="145"><B>-V, --version</B>
<DD>
Returns the version of this program.
<DT id="146"><B>-a, --async</B>
<DD>
Use asynchronous methods. This is purely a development tool and has no
practical benefit to most user operations.
<DT id="147"><B>--timeout=SECONDS</B>
<DD>
Use <B>SECONDS</B> for the timeout when performing operations with this
command. This option is useful when executing long running operations, like
<B>--3gpp-scan</B>.
<P>
</DL>
<A NAME="lbAX">&nbsp;</A>
<H2>EXAMPLES</H2>
<A NAME="lbAY">&nbsp;</A>
<H3>Send the PIN to the SIM card</H3>
<P>
You'll need first to know which the proper path/index is for the SIM in your
modem:
<PRE>
$ mmcli -m 0 -K | grep &quot;modem.generic.sim&quot; | awk -F &quot;: &quot; '{ print $2 }'
/org/freedesktop/ModemManager1/SIM/0
</PRE>
<P>
And after that, you can just use the SIM index:
<PRE>
$ sudo mmcli -i 0 --pin=1234
successfully sent PIN code to the SIM
</PRE>
<P>
<A NAME="lbAZ">&nbsp;</A>
<H3>Simple connect and disconnect</H3>
<P>
You can launch the simple connection process like:
<PRE>
$ sudo mmcli -m 0 --simple-connect=&quot;pin=1234,apn=internet&quot;
successfully connected the modem
</PRE>
<P>
Then, you can disconnect it like:
<PRE>
$ sudo mmcli -m 0 --simple-disconnect
successfully disconnected all bearers in the modem
</PRE>
<P>
<A NAME="lbBA">&nbsp;</A>
<H3>3GPP network scan</H3>
<P>
Scanning for 3GPP networks may really take a long time, so a specific timeout
must be given:
<PRE>
$ sudo mmcli -m 0 --3gpp-scan --timeout=300
---------------------
3GPP scan | networks: 21403 - Orange SP (gprs, unknown)
| 21407 - Movistar (gprs, unknown)
| 21404 - YOIGO (gprs, unknown)
| 21401 - vodafone ES (gprs, unknown)
</PRE>
<P>
<A NAME="lbBB">&nbsp;</A>
<H3>Creating a new SMS message &amp; storing it</H3>
<P>
Using the “sm” (SIM), you can do this using:
<P>
<PRE>
$ sudo mmcli -m 0 --messaging-create-sms=&quot;text='Hello world',number='+1234567890'&quot;
Successfully created new SMS:
/org/freedesktop/ModemManager1/SMS/21 (unknown)
$ sudo mmcli -s 21 --store-in-storage=&quot;sm&quot;
successfully stored the SMS
$ sudo mmcli -s 21
-------------------------------
General | dbus path: /org/freedesktop/ModemManager1/SMS/21
-------------------------------
Content | number: +1234567890
| text: Hello world
-------------------------------
Properties | PDU type: submit
| state: stored
| smsc: unknown
| validity: 0
| class: 0
| storage: sm
| delivery report: not requested
| message reference: 0
$ sudo mmcli -m 0 --messaging-status
----------------------------
Messaging | supported storages: sm, me
| default storage: me
</PRE>
<P>
<A NAME="lbBC">&nbsp;</A>
<H3>Sending binary SMS messages from files</H3>
<P>
As you can see below, the important part is the
<B>--messaging-create-sms-with-data</B> and the <B>PATH</B> provided.
<P>
<PRE>
$ sudo mmcli -m 0 \
--messaging-create-sms=&quot;number='+1234567890'&quot; \
--messaging-create-sms-with-data=/path/to/your/file
Successfully created new SMS:
/org/freedesktop/ModemManager1/SMS/22 (unknown)
$ sudo mmcli -s 22 --send
successfully sent the SMS
</PRE>
<P>
<A NAME="lbBD">&nbsp;</A>
<H3>Listing SMS messages</H3>
<P>
When the receiver gets all the parts of the message, they can now
recover the sent file with another <B>mmcli</B> command in their
ModemManager setup:
<P>
<PRE>
$&gt; sudo mmcli -m 0 --messaging-list-sms
/org/freedesktop/ModemManager1/SMS/0 (received)
$&gt; sudo mmcli -s 0 --create-file-with-data=/path/to/the/output/file
</PRE>
<P>
<A NAME="lbBE">&nbsp;</A>
<H3>GPS location status</H3>
<P>
You first need to check whether the modem has GPS-specific location
capabilities. Note that we’ll assume the modem is exposed as index 0;
if you have more than one modem, just use --list-modems to check the
proper modem index:
<P>
<PRE>
$ mmcli -m 0 --location-status
----------------------------
Location | capabilities: 3gpp-lac-ci, gps-raw, gps-nmea
| enabled: none
| signals: no
</PRE>
<P>
The output says that the modem supports 3GPP Location area code/Cell
ID, GPS raw and GPS-NMEA location sources. None is enabled yet, as we
didn’t enable the modem, which we can do issuing:
<P>
<PRE>
$ sudo mmcli -m 0 --enable
successfully enabled the modem
$ mmcli -m 0 --location-status
----------------------------
Location | capabilities: 3gpp-lac-ci, gps-raw, gps-nmea
| enabled: 3gpp-lac-ci
| signals: no
</PRE>
<P>
<A NAME="lbBF">&nbsp;</A>
<H3>GPS location technology enabling</H3>
<P>
We can start the GPS engine by enabling the RAW or NMEA GPS location sources:
<P>
<PRE>
$ sudo mmcli -m 0 \
--location-enable-gps-raw \
--location-enable-gps-nmea
successfully setup location gathering
</PRE>
<P>
If we do check again the status, we’ll see the GPS-specific locations are enabled:
<P>
<PRE>
$ mmcli -m 0 --location-status
--------------------------------
Location | capabilities: 3gpp-lac-ci, gps-raw, gps-nmea
| enabled: 3gpp-lac-ci, gps-raw, gps-nmea
| signals: no
</PRE>
<P>
<A NAME="lbBG">&nbsp;</A>
<H3>GPS location retrieval</H3>
<P>
You can query all location information at the same time with a single command.
If any of the specific outputs is not available, the corresponding section will
be omitted from the output.
<P>
<PRE>
$ sudo mmcli -m 0 --location-get
-------------------------
3GPP location | Mobile country code: 214
| Mobile network code: 3
| Location area code: 21071
| Cell ID: 7033737
-------------------------
GPS NMEA traces | $GPGGA,,,,,,0,,,,,,,,*66
| $GPRMC,,V,,,,,,,,,,N*53
| $GPGSA,A,1,,,,,,,,,,,,,,,*1E
| $GPGSV,4,1,16,24,,,,29,,,,05,,,,18,,,*7A
| $GPGSV,4,2,16,22,,,,14,,,,11,,,,17,,,*7B
| $GPGSV,4,3,16,03,,,,12,,,,30,,,,13,,,*78
| $GPGSV,4,4,16,23,,,,15,,,,27,,,,07,,,*79
| $GPVTG,,T,,M,,N,,K,N*2C
</PRE>
<P>
<A NAME="lbBH">&nbsp;</A>
<H3>A-GPS support</H3>
<P>
If A-GPS is enabled before starting the GPS engine, and if a data connection
is available in the modem, the configured SUPL servers may be used to obtain
a faster initial position fix.
<P>
Note that the GPS engine will not be started when just A-GPS capability is
enabled. An explicit output (RAW or NMEA) is required to be enabled in order
to start the GPS engine.
<P>
<PRE>
$ mmcli -m 0 --location-status
--------------------------------
Location | capabilities: 3gpp-lac-ci, gps-raw, gps-nmea, agps-msa, agps-msb
| enabled: 3gpp-lac-ci
| signals: no
-----------------------------
GPS | refresh rate: 30 seconds
| a-gps supl server: supl.google.com:7276
$ sudo mmcli -m 0 --location-enable-agps-msa
successfully setup location gathering
$ sudo mmcli -m 0 --location-enable-gps-nmea
successfully setup location gathering
$ sudo mmcli -m 0 --location-enable-gps-raw
successfully setup location gathering
</PRE>
<P>
<A NAME="lbBI">&nbsp;</A>
<H3>Injecting assistance data</H3>
<P>
If the modem device does not have an ongoing connection (e.g. no mobile network
coverage) but the system has other means to access the Internet (e.g. WiFi), the
user may be able to download location assistance data and inject it in the
module.
<P>
E.g. If the device supports XTRA assistance data, the user may download it from
one of the servers listed by ModemManager and manually inject it afterwards. The
XTRA assistance data is usually valid for several days.
<P>
<PRE>
$ mmcli -m 0 --location-status
--------------------------------
Location | capabilities: 3gpp-lac-ci, gps-raw, gps-nmea, agps-msa, agps-msb
| enabled: 3gpp-lac-ci
| signals: no
--------------------------------
GPS | refresh rate: 30 seconds
| a-gps supl server: supl.google.com:7276
| supported assistance: xtra
| assistance servers: <A HREF="https://xtrapath3.izatcloud.net/xtra3grcej.bin">https://xtrapath3.izatcloud.net/xtra3grcej.bin</A>
| <A HREF="https://xtrapath1.izatcloud.net/xtra3grcej.bin">https://xtrapath1.izatcloud.net/xtra3grcej.bin</A>
| <A HREF="https://xtrapath2.izatcloud.net/xtra3grcej.bin">https://xtrapath2.izatcloud.net/xtra3grcej.bin</A>
$ wget -q <A HREF="https://xtrapath3.izatcloud.net/xtra3grcej.bin">https://xtrapath3.izatcloud.net/xtra3grcej.bin</A>
$ sudo mmcli -m 0 --location-inject-assistance-data=./xtra3grcej.bin
successfully injected assistance data
$ sudo mmcli -m 0 --location-enable-gps-nmea
successfully setup location gathering
$ sudo mmcli -m 0 --location-enable-gps-raw
successfully setup location gathering
</PRE>
<P>
<A NAME="lbBJ">&nbsp;</A>
<H3>Key-Value output</H3>
<P>
Writing shell scripts that use mmcli to perform operations with the
modem is easy when using the <B>--output-keyvalue</B> option. For
example, you could gather all the main status information of the modem
with a single call and then parse it to read single fields:
<P>
<PRE>
$ STATUS=$(mmcli -m 0 --output-keyvalue)
$ echo &quot;${STATUS}&quot; | grep &quot;modem.generic.state &quot; | awk -F &quot;: &quot; '{ print $2 }'
failed
$ echo &quot;${STATUS}&quot; | grep &quot;modem.generic.state-failed-reason &quot; | awk -F &quot;: &quot; '{ print $2 }'
sim-missing
</PRE>
<P>
<A NAME="lbBK">&nbsp;</A>
<H2>AUTHORS</H2>
Written by Martyn Russell &lt;<A HREF="mailto:martyn@lanedo.com">martyn@lanedo.com</A>&gt; and Aleksander Morgado &lt;<A HREF="mailto:aleksander@aleksander.es">aleksander@aleksander.es</A>&gt;
<P>
<A NAME="lbBL">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+ModemManager">ModemManager</A></B>(8), <B><A HREF="/cgi-bin/man/man2html?8+NetworkManager">NetworkManager</A></B>(8)
<P>
AT (<A HREF="http://en.wikipedia.org/wiki/AT_commands).">http://en.wikipedia.org/wiki/AT_commands).</A>
<P>
3GPP (<A HREF="http://en.wikipedia.org/wiki/3GPP).">http://en.wikipedia.org/wiki/3GPP).</A>
<P>
MCCMNC (<A HREF="http://en.wikipedia.org/wiki/Mobile_Network_Code).">http://en.wikipedia.org/wiki/Mobile_Network_Code).</A>
<P>
USSD (<A HREF="http://en.wikipedia.org/wiki/Unstructured_Supplementary_Service_Data).">http://en.wikipedia.org/wiki/Unstructured_Supplementary_Service_Data).</A>
<P>
CDMA (<A HREF="http://en.wikipedia.org/wiki/Code_division_multiple_access).">http://en.wikipedia.org/wiki/Code_division_multiple_access).</A>
<P>
OTA (<A HREF="http://en.wikipedia.org/wiki/Over-the-air_programming).">http://en.wikipedia.org/wiki/Over-the-air_programming).</A>
<P>
GPS (<A HREF="http://en.wikipedia.org/wiki/Global_Positioning_System)">http://en.wikipedia.org/wiki/Global_Positioning_System)</A>
<P>
NMEA (<A HREF="http://en.wikipedia.org/wiki/NMEA_0183)">http://en.wikipedia.org/wiki/NMEA_0183)</A>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="148"><A HREF="#lbAB">NAME</A><DD>
<DT id="149"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="150"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="151"><A HREF="#lbAE">HELP OPTIONS</A><DD>
<DT id="152"><A HREF="#lbAF">MANAGER OPTIONS</A><DD>
<DT id="153"><A HREF="#lbAG">COMMON OPTIONS</A><DD>
<DT id="154"><A HREF="#lbAH">MODEM OPTIONS</A><DD>
<DT id="155"><A HREF="#lbAI">3GPP OPTIONS</A><DD>
<DT id="156"><A HREF="#lbAJ">CDMA OPTIONS</A><DD>
<DT id="157"><A HREF="#lbAK">SIMPLE OPTIONS</A><DD>
<DT id="158"><A HREF="#lbAL">LOCATION OPTIONS</A><DD>
<DT id="159"><A HREF="#lbAM">MESSAGING OPTIONS</A><DD>
<DT id="160"><A HREF="#lbAN">TIME OPTIONS</A><DD>
<DT id="161"><A HREF="#lbAO">VOICE OPTIONS</A><DD>
<DT id="162"><A HREF="#lbAP">FIRMWARE OPTIONS</A><DD>
<DT id="163"><A HREF="#lbAQ">SIGNAL OPTIONS</A><DD>
<DT id="164"><A HREF="#lbAR">OMA OPTIONS</A><DD>
<DT id="165"><A HREF="#lbAS">SIM OPTIONS</A><DD>
<DT id="166"><A HREF="#lbAT">BEARER OPTIONS</A><DD>
<DT id="167"><A HREF="#lbAU">SMS OPTIONS</A><DD>
<DT id="168"><A HREF="#lbAV">CALL OPTIONS</A><DD>
<DT id="169"><A HREF="#lbAW">APPLICATION OPTIONS</A><DD>
<DT id="170"><A HREF="#lbAX">EXAMPLES</A><DD>
<DL>
<DT id="171"><A HREF="#lbAY">Send the PIN to the SIM card</A><DD>
<DT id="172"><A HREF="#lbAZ">Simple connect and disconnect</A><DD>
<DT id="173"><A HREF="#lbBA">3GPP network scan</A><DD>
<DT id="174"><A HREF="#lbBB">Creating a new SMS message &amp; storing it</A><DD>
<DT id="175"><A HREF="#lbBC">Sending binary SMS messages from files</A><DD>
<DT id="176"><A HREF="#lbBD">Listing SMS messages</A><DD>
<DT id="177"><A HREF="#lbBE">GPS location status</A><DD>
<DT id="178"><A HREF="#lbBF">GPS location technology enabling</A><DD>
<DT id="179"><A HREF="#lbBG">GPS location retrieval</A><DD>
<DT id="180"><A HREF="#lbBH">A-GPS support</A><DD>
<DT id="181"><A HREF="#lbBI">Injecting assistance data</A><DD>
<DT id="182"><A HREF="#lbBJ">Key-Value output</A><DD>
</DL>
<DT id="183"><A HREF="#lbBK">AUTHORS</A><DD>
<DT id="184"><A HREF="#lbBL">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:19 GMT, March 31, 2021
</BODY>
</HTML>
Reference in New Issue View Git Blame Copy Permalink