SymbX/ModemManager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge request !1457 from 'feat/update-man-mmcli'

Browse Source 
man,mmcli: add information about 'any' modem index  and --location-monitor

https://gitlab.freedesktop.org/mobile-broadband/ModemManager/-/merge_requests/1457
This commit is contained in:
Dan Williams
2026-07-09 16:11:14 -05:00
parent d776ea38d2 30b76ac3e2
commit 7088f5eaab
1 changed files with 35 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/man/mmcli.1
+35 -2
View File
@@ -176,8 +176,10 @@ in use, like \fIBearer\fR. For example:
.RE
.TP
.B \-m, \-\-modem=[PATH|INDEX]
Specify a modem.
.B \-m, \-\-modem=[PATH|INDEX|any]
Specify a modem via full D-Bus object path, modem index, or 'any'. 'any' selects
the first available modem regardless of index or path, which can simplify
operation for single-modem systems.
.TP
.B \-b, \-\-bearer=[PATH|INDEX]
Specify a bearer.
@@ -496,6 +498,10 @@ This DBus property signal updates are by default disabled.
.B \-\-location\-set\-disable\-signal
Disable reporting location updates via DBus property signals.
.TP
.B \-\-location\-monitor
Continuously monitor all available location information.
.SH MESSAGING OPTIONS
All messaging options must be used with \fB\-\-modem\fR or \fB\-m\fR.
@@ -939,6 +945,33 @@ be omitted from the output.
| $GPVTG,,T,,M,,N,,K,N*2C
.Ed
Location information may be continuously monitored using
\fB\-\-location\-monitor\fR, which watches 'Location' property updates. Note
that these updates must first be enabled with
\fB\-\-location\-set\-enable\-signal\fR.
.Bd -literal -compact
$ sudo mmcli -m 0 --location-set-gps-refresh-rate=10
successfully set GPS refresh rate
$ sudo mmcli -m 0 --location-enable-gps-nmea --location-set-enable-signal
successfully setup location gathering
$ sudo mmcli -m 0 --location-monitor
-----------
GPS | nmea: $GPGSA,A,2,03,04,06,07,09,,,,,,,,1.7,1.4,1.0*3E
| $GPGSV,3,1,11,03,38,123,37,04,56,037,18,06,41,277,21,07,52,209,32*75
| $GPGSV,3,2,11,09,61,320,23,11,17,313,19,30,12,217,24,01,02,168,*77
| $GPGSV,3,3,11,16,21,077,,26,13,047,,40,,,36*79
| $GPGGA,152454.00,3651.420706,N,03101.297031,E,1,05,1.4,128.4,M,32.0,M,,*6A
-----------
GPS | nmea: $GPGSA,A,2,03,04,06,07,09,,,,,,,,1.7,1.4,1.0*3E
| $GPGSV,3,1,11,03,38,123,37,04,56,037,24,06,41,277,20,07,52,209,33*7A
| $GPGSV,3,2,11,09,61,320,23,11,17,313,18,30,12,217,23,01,02,168,*71
| $GPGSV,3,3,11,16,21,077,,26,13,047,,40,,,36*79
| $GPGGA,152504.00,3651.420036,N,03101.297176,E,1,05,1.4,60.7,M,32.0,M,,*56
.Ed
.SS A-GPS support
If A-GPS is enabled before starting the GPS engine, and if a data connection