Reference

mbimcli(1)

Control MBIM devices

NAME

mbimcli - Control MBIM devices

DESCRIPTION

Usage:

mbimcli [OPTION???] - Control MBIM devices

Help Options:

-h, --help

Show help options

--help-all

Show all help options

--help-basic-connect

Show Basic Connect Service options

--help-phonebook

Show Phonebook Service options

--help-dss

Show Device Service Stream options

--help-ms-firmware-id

Show Microsoft Firmware ID Service options

--help-ms-host-shutdown

Show Microsoft Host Shutdown Service options

--help-ms-sar

Show Microsoft SAR Service options

--help-atds

Show AT&T Device Service options

--help-intel-firmware-update

Show Intel Firmware Update Service options

--help-ms-basic-connect-extensions

Show Microsoft Basic Connect Extensions Service options

--help-quectel

Show Quectel Service options

--help-intel-thermal-rf

Show Intel Thermal RF Service options

--help-ms-voice-extensions

Show Microsoft Voice Extensions Service options

--help-ms-uicc-low-level-access

Show Microsoft UICC Low Level Access Service options

--help-intel-mutual-authentication

Show Intel mutual authentication Service options

--help-intel-tools

Show Intel 5G tools options

--help-google

Show Google Service options

--help-fibocom

Show Fibocom Service options

--help-sms

Show SMS service options

--help-compal

Show Compal Service options

--help-intel-at-tunnel

Show Intel AT Tunnel Service options

Basic Connect options:

--query-device-caps

Query device capabilities

--query-subscriber-ready-status

Query subscriber ready status

--query-radio-state

Query radio state

--set-radio-state=[(on|off)]

Set radio state

--query-device-services

Query device services

--query-pin-state

Query PIN state

--enter-pin=[(PIN type),(current PIN)]

Enter PIN (PIN type is optional, defaults to PIN1, allowed options: (pin1,network-pin,network-subset-pin,service-provider-pin,corporate-pin)

--change-pin=[(current PIN),(new PIN)]

Change PIN

--enable-pin=[(current PIN)]

Enable PIN

--disable-pin=[(PIN type),(current PIN)]

Disable PIN (PIN type is optional, see enter-pin for details)

--enter-puk=[(PUK type),(PUK),(new PIN)]

Enter PUK (PUK type is optional, defaults to PUK1, allowed options: (puk1,network-puk,network-subset-puk,service-provider-puk,corporate-puk)

--query-pin-list

Query PIN list

--query-home-provider

Query home provider

--query-preferred-providers

Query preferred providers

--query-visible-providers

Query visible providers

--query-register-state

Query register state

--set-register-state=["key=value,..."]

Set basic register settings (allowed keys: action, provider-id, data-class)

--query-signal-state

Query signal state

--query-packet-service-state

Query packet service state

--attach-packet-service

Attach to the packet service

--detach-packet-service

Detach from the packet service

--query-connection-state=[SessionID]

Query connection state (SessionID is optional, defaults to 0)

--connect=["key=value,..."]

Connect (allowed keys: session-id, access-string, ip-type, auth, username, password, compression, context-type)

--query-ip-configuration=[SessionID]

Query IP configuration (SessionID is optional, defaults to 0)

--disconnect=[SessionID]

Disconnect (SessionID is optional, defaults to 0)

--query-packet-statistics

Query packet statistics

--query-ip-packet-filters=[SessionID]

Query IP packet filters (SessionID is optional, defaults to 0)

--set-ip-packet-filters=["key=value,..."]

Set IP packet filters (allowed keys: session-id, packet-filter, packet-mask, filter-id)

--query-provisioned-contexts

Query provisioned contexts

--set-provisioned-contexts=["key=value,..."]

Set provisioned contexts (allowed keys: context-id, context-type, auth, compression, username, password, access-string, provider-id)

--set-signal-state=["key=value,..."]

Set signal state (allowed keys: signal-strength-interval, rssi-threshold, error-rate-threshold)

--set-network-idle-hint=[(enabled|disabled)]

Set network idle hint

--query-network-idle-hint

Query network idle hint

--set-emergency-mode=[(on|off)]

Set emergency mode

--query-emergency-mode

Query emergency mode

--set-service-activation=[Data]

Set service activation

Phonebook options:

--phonebook-query-configuration

Query the phonebook configuration

--phonebook-read=[(Phonebook index)]

Read phonebook entry with given index

--phonebook-read-all

Read all phonebook entries

--phonebook-write=[(Name),(Number)[,(Index)]]

Add new phonebook entry or update an existing one

--phonebook-delete=[(Phonebook index)]

Delete phonebook entry with given index

--phonebook-delete-all

Delete all phonebook entries

Device Service Stream options:

--dss-connect=[(UUID),(Session ID)]

Connect DSS session

--dss-disconnect=[(UUID),(Session ID)]

Disconnect DSS session

Microsoft Firmware ID options:

--ms-query-firmware-id

Query firmware ID

Microsoft Host Shutdown options:

--ms-notify-host-shutdown

Notify that host is shutting down

Microsoft SAR options:

--ms-set-sar-config=[(device|os),(enabled|disabled)[,[{antenna_index,backoff_index}...]]]

Set SAR config

--ms-query-sar-config

Query SAR config

--ms-set-transmission-status=[(enabled|disabled),(timer)]

Set transmission status and hysteresis timer (in seconds)

--ms-query-transmission-status

Query transmission status

AT&T Device Service options:

--atds-query-signal

Query signal info

--atds-query-location

Query cell location

--atds-query-operators

Query operators

--atds-query-rat

Query Radio Access Technology

Intel Firmware Update Service options:

--intel-modem-reboot=[(Boot Mode),(Timeout)]

Reboot modem. Boot mode and timeout arguments only required if MBIMEx >= 2.0.

Microsoft Basic Connect Extensions options:

--ms-query-pco=[SessionID]

Query PCO value (SessionID is optional, defaults to 0)

--ms-query-lte-attach-configuration

Query LTE attach configuration

--ms-set-lte-attach-configuration=[(default|restore-factory)[,"key=value,..."[/"key=value,..."[/"key=value,..."]]]

Set LTE attach configurations (groups separated by '/' if more than one, with allowed-keys: ip-type, roaming-control, source, access-string, username, password, compression, auth)

--ms-query-lte-attach-info

Query LTE attach status information

--ms-query-sys-caps

Query system capabilities

--ms-query-device-caps

Query device capabilities

--ms-query-slot-info-status=[SlotIndex]

Query slot information status

--ms-set-device-slot-mappings=[(SlotIndex)[,(SlotIndex)[,...]]]

Set device slot mappings for each executor

--ms-query-device-slot-mappings

Query device slot mappings

--ms-query-location-info-status

Query location info status

--ms-set-provisioned-contexts=["key=value,..."]

Set provisioned contexts (allowed keys: operation, context-type, ip-type, state, roaming-control, media-type, source, auth, compression, username, password, access-string)

--ms-query-provisioned-contexts

Query provisioned contexts

--ms-query-base-stations-info

Query base stations info

--ms-device-reset

Reset device

--ms-query-version=[(MBIM version),(MBIM extended version)]

Exchange supported version information. Since MBIMEx v2.0.

--ms-query-registration-parameters

Query registration parameters. Since MBIMEx v3.0.

--ms-set-registration-parameters=["key=value,..."]

Set registration parameters (required keys: mico-mode, drx-cycle, ladn-info, default-pdu-activation-hint, re-register-if-needed). Since MBIMEx v3.0.

--ms-query-modem-configuration

Query modem configuration. Since MBIMEx v3.0.

--ms-query-wake-reason

Query wake reason. Since MBIMEx v3.0.

Quectel options:

--quectel-query-radio-state

Query radio state

--quectel-set-radio-state=[(on)]

Set radio state

--quectel-set-command=[(Command type),("Command")]

Send command to module (Command type is optional, defaults to AT, allowed options: (at, system)

Link management options:

Intel Thermal RF Service options:

--intel-query-rfim

Query RFIM frequency information

--intel-set-rfim=[(on|off)]

Enable or disable RFIM (disabled by default)

Microsoft Voice Extensions Service options:

--ms-query-nitz

Query network identity and time zone

Microsoft UICC Low Level Access Service options:

--ms-query-uicc-application-list

Query UICC application list

--ms-query-uicc-file-status=["key=value,..."]

Query UICC file status (allowed keys: application-id, file-path)

--ms-query-uicc-read-binary=["key=value,..."]

Read UICC binary file (allowed keys: application-id, file-path, read-offset, read-size, local-pin and data)

--ms-query-uicc-read-record=["key=value,..."]

Read UICC record file (allowed keys: application-id, file-path, record-number, local-pin and data)

--ms-set-uicc-open-channel=["key=value,..."]

Set UICC open channel (allowed keys: application-id, selectp2arg, channel-group)

--ms-set-uicc-close-channel=["key=value,..."]

Set UICC close channel (allowed keys: channel, channel-group)

--ms-query-uicc-atr

Query UICC atr

--ms-set-uicc-apdu=["key=value,..."]

Set UICC apdu (allowed keys: channel, secure-message, classbyte-type, command)

--ms-set-uicc-reset=[(Pass Through Action)]

Set UICC reset

--ms-query-uicc-reset

Query UICC reset

--ms-set-uicc-terminal-capability=["key=value,..."]

Set UICC terminal capability (allowed keys: terminal-capability)

--ms-query-uicc-terminal-capability

Query UICC terminal capability

Intel mutual authentication Service options:

--intel-query-fcc-lock

Query FCC lock information

--intel-set-fcc-lock=[(ResponsePresent),(Response)]

Set FCC lock information

Intel 5G tools options

--intel-set-trace-config=[(TraceCmd)|(TraceValue)]

Set trace configuration

--intel-query-trace-config=[(TraceCmd)]

Query trace configuration

Google options:

--google-set-carrier-lock=[(Data)]

Set Google Carrier Lock

--google-query-carrier-lock

Query Google Carrier Lock

FIbocom options:

--fibocom-set-at-command="<AT command>"

send AT command to modem, and receive AT response

Simple message service options:

--sms-query-configuration

Query SMS configuration

--sms-query-message-store-status

Query SMS message store status

--sms-delete=[(all|new|old|sent|draft|index=N)]

Delete all SMS matching a given filter

--sms-read=[(all|new|old|sent|draft|index=N)]

Read all SMS matching a given filter

Compal options:

--compal-query-at-command="<AT command>"

send AT command to modem, and receive AT response

Intel AT Tunnel options:

--intel-at-tunnel-set-at-command="<AT command>"

send AT command to modem, and receive AT response

Application Options:

-d, --device=[PATH]

Specify device path

-p, --device-open-proxy

Request to use the 'mbim-proxy' proxy

--device-open-ms-mbimex-v2

Request to enable Microsoft MBIMEx v2.0 support

--device-open-ms-mbimex-v3

Request to enable Microsoft MBIMEx v3.0 support

--no-open=[Transaction ID]

Do not explicitly open the MBIM device before running the command

--no-close

Do not close the MBIM device after running the command

--noop

Don't run any command

-v, --verbose

Run action with verbose logs, including the debug ones

--verbose-full

Run action with verbose logs, including the debug ones and personal info

--silent

Run action with no logs; not even the error/warning ones

--printable=[(Data)]

Get the printable info of the given hex encoded MBIM message

-V, --version

Print version

COPYRIGHT

Copyright © 2013-2023 Aleksander Morgado License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

The full documentation for mbimcli is maintained as a Texinfo manual. If the info and mbimcli programs are properly installed at your site, the command

info mbimcli

should give you access to the complete manual.

History

--atds-query-location since Debian 10 (Buster); --atds-query-operators since Arch Linux 2026-11-01; --atds-query-rat since Arch Linux 2026-11-01; --atds-query-signal since Debian 10 (Buster); --device-open-ms-mbimex-v2 since Debian 12 (Bookworm); --device-open-ms-mbimex-v3 since Debian 12 (Bookworm); --google-query-carrier-lock since Debian 13 (Trixie); --google-set-carrier-lock since Debian 13 (Trixie); --help-atds since Debian 10 (Buster); --help-compal since Debian 13 (Trixie); --help-fibocom since Debian 13 (Trixie); --help-google since Debian 13 (Trixie); --help-intel-at-tunnel since Arch Linux 2026-11-01; --help-intel-firmware-update since Debian 10 (Buster); --help-intel-mutual-authentication since Debian 13 (Trixie); --help-intel-thermal-rf since Debian 12 (Bookworm); --help-intel-tools since Debian 13 (Trixie); --help-link-management since Debian 12 (Bookworm); --help-ms-basic-connect-extensions since Debian 10 (Buster); --help-ms-sar since Debian 12 (Bookworm); --help-ms-uicc-low-level-access since Debian 12 (Bookworm); --help-ms-voice-extensions since Debian 12 (Bookworm); --help-quectel since Debian 12 (Bookworm); --help-sms since Debian 13 (Trixie); --intel-query-fcc-lock since Debian 13 (Trixie); --intel-query-rfim since Debian 12 (Bookworm); --intel-query-trace-config since Debian 13 (Trixie); --intel-set-fcc-lock since Debian 13 (Trixie); --intel-set-rfim since Debian 12 (Bookworm); --intel-set-trace-config since Debian 13 (Trixie); --link-add since Debian 12 (Bookworm); --link-delete since Debian 12 (Bookworm); --link-delete-all since Debian 12 (Bookworm); --link-list since Debian 12 (Bookworm); --ms-device-reset since Debian 13 (Trixie); --ms-query-base-stations-info since Debian 12 (Bookworm); --ms-query-device-caps since Debian 12 (Bookworm); --ms-query-device-slot-mappings since Debian 12 (Bookworm); --ms-query-location-info-status since Debian 12 (Bookworm); --ms-query-lte-attach-configuration since Debian 10 (Buster); --ms-query-lte-attach-info since Debian 12 (Bookworm); --ms-query-modem-configuration since Debian 12 (Bookworm); --ms-query-nitz since Debian 12 (Bookworm); --ms-query-pco since Debian 10 (Buster); --ms-query-provisioned-contexts since Debian 12 (Bookworm); --ms-query-registration-parameters since Debian 12 (Bookworm); --ms-query-sar-config since Debian 12 (Bookworm); --ms-query-slot-info-status since Debian 12 (Bookworm); --ms-query-sys-caps since Debian 12 (Bookworm); --ms-query-transmission-status since Debian 12 (Bookworm); --ms-query-uicc-application-list since Debian 12 (Bookworm); --ms-query-uicc-atr since Debian 12 (Bookworm); --ms-query-uicc-file-status since Debian 12 (Bookworm); --ms-query-uicc-read-binary since Debian 12 (Bookworm); --ms-query-uicc-read-record since Debian 12 (Bookworm); --ms-query-uicc-reset since Debian 12 (Bookworm); --ms-query-uicc-terminal-capability since Debian 12 (Bookworm); --ms-query-wake-reason since Debian 12 (Bookworm); --ms-set-device-slot-mappings since Debian 12 (Bookworm); --ms-set-lte-attach-configuration since Debian 13 (Trixie); --ms-set-provisioned-contexts since Debian 12 (Bookworm); --ms-set-registration-parameters since Debian 12 (Bookworm); --ms-set-sar-config since Debian 12 (Bookworm); --ms-set-transmission-status since Debian 12 (Bookworm); --ms-set-uicc-apdu since Debian 12 (Bookworm); --ms-set-uicc-close-channel since Debian 12 (Bookworm); --ms-set-uicc-open-channel since Debian 12 (Bookworm); --ms-set-uicc-terminal-capability since Debian 12 (Bookworm); --printable since Debian 13 (Trixie); --quectel-query-radio-state since Debian 12 (Bookworm); --quectel-set-radio-state since Debian 12 (Bookworm); --query-emergency-mode since Debian 12 (Bookworm); --query-ip-configuration since Debian 9 (Stretch); --query-ip-packet-filters since Debian 10 (Buster); --query-network-idle-hint since Debian 12 (Bookworm); --query-pin-list since Debian 10 (Buster); --query-provisioned-contexts since Debian 11 (Bullseye); --query-register-state since Debian 13 (Trixie); --set-emergency-mode since Debian 12 (Bookworm); --set-ip-packet-filters since Debian 12 (Bookworm); --set-network-idle-hint since Debian 12 (Bookworm); --set-provisioned-contexts since Debian 12 (Bookworm); --set-register-state since Debian 13 (Trixie); --set-service-activation since Debian 12 (Bookworm); --set-signal-state since Debian 12 (Bookworm); --sms-delete since Debian 13 (Trixie); --sms-query-configuration since Arch Linux 2026-11-01; --sms-query-message-store-status since Arch Linux 2026-11-01; --sms-read since Debian 13 (Trixie); --verbose-full since Debian 12 (Bookworm).

--intel-modem-reboot until Debian 11 (Bullseye); --ms-query-lte-attach-status until Debian 11 (Bullseye); --query-registration-state until Debian 12 (Bookworm); --register-automatic until Debian 12 (Bookworm).