QMICLI(1)

NAME
qmicli - Control QMI devices

DESCRIPTION

  Usage:

    qmicli [OPTION???] - Control QMI devices

  Help Options:

-h, --help
    Show help options

--help-all
    Show all help options

--help-dms
    Show Device Management Service options

--help-nas
    Show Network Access Service options

--help-wds
    Show Wireless Data Service options

--help-pdc
    Show platform device configurations options

--help-uim
    Show User Identity Module options

--help-sar
    Show Specific Absorption Rate options

--help-wms
    Show Wireless Messaging Service options

--help-wda
    Show Wireless Data Administrative options

--help-voice
    Show Voice Service options

--help-loc
    Show location options

--help-dsd
    Show Data System Determination options

--help-dpm
    Show Data Port Mapper Service options

--help-fox
    Show Foxconn Modem Service options

--help-link-management
    Show link management specific options

--help-qmiwwan
    Show qmi_wwan driver specific options

  DMS options:

--dms-get-ids
    Get IDs

--dms-get-capabilities
    Get capabilities

--dms-get-manufacturer
    Get manufacturer

--dms-get-model
    Get model

--dms-get-revision
    Get revision

--dms-get-msisdn
    Get MSISDN

--dms-uim-set-pin-protection=[(PIN|PIN2),(disable|enable),(current PIN)]
    Set PIN protection in the UIM

--dms-uim-verify-pin=[(PIN|PIN2),(current PIN)]
    Verify PIN

--dms-uim-unblock-pin=[(PIN|PIN2),(PUK),(new PIN)]
    Unblock PIN

--dms-uim-change-pin=[(PIN|PIN2),(old PIN),(new PIN)]
    Change PIN

--dms-uim-get-pin-status
    Get PIN status

--dms-uim-get-iccid
    Get ICCID

--dms-uim-get-imsi
    Get IMSI

--dms-uim-get-ck-status=[(pn|pu|pp|pc|pf)]
    Get CK Status

--dms-uim-unblock-ck=[(pn|pu|pp|pc|pf),(key)]
    Unblock CK

--dms-get-hardware-revision
    Get the HW revision

--dms-get-operating-mode
    Get the device operating mode

--dms-set-operating-mode=[(Operating mode)]
    Set the device operating mode

--dms-get-activation-state
    Get the state of the service activation

--dms-activate-automatic=[Activation Code]
    Request automatic service activation

--dms-activate-manual=[SPC,SID,MDN,MIN]
    Request manual service activation

--dms-restore-factory-defaults=[(Service Programming Code)]
    Restore factory defaults

--dms-set-firmware-id
    Set firmware id

--dms-get-band-capabilities
    Get band capabilities

--dms-list-stored-images
    List stored images

--dms-select-stored-image=[modem#,pri#] where # is the index
    Select stored image

--dms-get-firmware-preference
    Get firmware preference

--dms-set-firmware-preference=["key=value,..."]
    Set firmware preference (required keys: firmware-version, config-version, carrier; optional keys: modem-storage-index, override-download=yes)

--dms-set-boot-image-download-mode=[normal|boot-and-recovery]
    Set boot image download mode

--dms-set-fcc-authentication
    Set FCC authentication

--dms-swi-get-current-firmware
    Get Current Firmware (Sierra Wireless specific)

--dms-foxconn-get-firmware-version=[firmware-mcfg-apps|firmware-mcfg|apps]
    Get firmware version (Foxconn specific)

--dms-foxconn-set-fcc-authentication=[magic]
    Set FCC authentication (Foxconn specific)

--dms-foxconn-set-fcc-authentication-v2=[magic-string,magic-number]
    Set FCC authentication (Foxconn specific, v2)

--dms-noop
    Just allocate or release a DMS client. Use with `--client-no-release-cid' and/or `--client-cid'

  NAS options:

--nas-get-signal-strength
    Get signal strength

--nas-get-signal-info
    Get signal info

--nas-get-home-network
    Get home network

--nas-get-serving-system
    Get serving system

--nas-get-system-info
    Get system info

--nas-get-technology-preference
    Get technology preference

--nas-get-preferred-networks
    Get preferred networks

--nas-set-preferred-networks=[[MCCMNC,access_tech],...]
    Set preferred networks list

--nas-get-system-selection-preference
    Get system selection preference

--nas-set-system-selection-preference=[cdma-1x|cdma-1xevdo|gsm|umts|lte|td-scdma][,[automatic|manual=MCCMNC]]
    Set system selection preference

--nas-network-scan=[gsm|umts|lte|td-scdma|5gnr]
    Scan all networks (no argument) or scan one specific network type

--nas-get-cell-location-info
    Get Cell Location Info

--nas-get-plmn-name=[mccmnc]
    Get plmn name data

--nas-get-rf-band-info
    Get RF Band Info

--nas-noop
    Just allocate or release a NAS client. Use with `--client-no-release-cid' and/or `--client-cid'

  WDS options:

--wds-start-network=["key=value,..."]
    Start network (allowed keys: apn, 3gpp-profile, 3gpp2-profile, auth (PAP|CHAP|BOTH), username, password, autoconnect=yes, ip-type (4|6))

--wds-follow-network
    Follow the network status until disconnected. Use with `--wds-start-network'

--wds-stop-network=[Packet data handle] OR [disable-autoconnect]
    Stop network

--wds-get-current-settings
    Get current settings

--wds-get-packet-service-status
    Get packet service status

--wds-get-packet-statistics
    Get packet statistics

--wds-create-profile=["(3gpp|3gpp2)[,key=value,...]"]
    Create new profile using first available profile index (optional keys: name, apn, pdp-type (IP|PPP|IPV6|IPV4V6), auth (NONE|PAP|CHAP|BOTH), username, password, context-num, no-roaming=yes, disabled=yes)

--wds-modify-profile=["(3gpp|3gpp2),#,key=value,..."]
    Modify existing profile (optional keys: name, apn, pdp-type (IP|PPP|IPV6|IPV4V6), auth (NONE|PAP|CHAP|BOTH), username, password, context-num, no-roaming=yes, disabled=yes)

--wds-delete-profile=[(3gpp|3gpp2),#]
    Delete existing profile

--wds-get-profile-list=[3gpp|3gpp2]
    Get profile list

--wds-get-autoconnect-settings
    Get autoconnect settings

--wds-set-autoconnect-settings=[(enabled|disabled|paused)[,(roaming-allowed|home-only)]]
    Set autoconnect settings (roaming settings optional)

--wds-bind-data-port=[a2-mux-rmnet0-7|#]
    Bind data port to controller device to be used with `--client-no-release-cid'

--wds-bind-mux-data-port=["key=value,..."]
    Bind qmux data port to controller device (allowed keys: mux-id, ep-type (undefined|hsusb|pcie|embedded|bam-dmux), ep-iface-number) to be used with `--client-no-release-cid'

--wds-set-ip-family=[4|6]
    Set IP family

--wds-get-lte-attach-parameters
    Get LTE attach parameters

--wds-get-lte-attach-pdn-list
    Get the list of LTE attach PDN

--wds-set-lte-attach-pdn-list=[#,#,...]
    Set the list of LTE attach PDN

--wds-noop
    Just allocate or release a WDS client. Use with `--client-no-release-cid' and/or `--client-cid'

  PDC options:

--pdc-list-configs=[(platform|software)]
    List all configs

--pdc-activate-config=[(platform|software),ConfigId]
    Activate config

--pdc-monitor-refresh
    Watch for refresh indications

--pdc-noop
    Just allocate or release a PDC client. Use with `--client-no-release-cid' and/or `--client-cid'

  UIM options:

--uim-set-pin-protection=[(PIN1|PIN2|UPIN),(disable|enable),(current PIN)[,"key=value,..."]]
    Set PIN protection (allowed keys: session-type ((primary|secondary|tertiary|quarternary|quinary)-gw-provisioning|card-slot-[1-5]))

--uim-verify-pin=[(PIN1|PIN2|UPIN),(current PIN)[,"key=value,..."]]
    Verify PIN (allowed keys: session-type ((primary|secondary|tertiary|quarternary|quinary)-gw-provisioning|card-slot-[1-5]))

--uim-unblock-pin=[(PIN1|PIN2|UPIN),(PUK),(new PIN)[,"key=value,..."]]
    Unblock PIN (allowed keys: session-type ((primary|secondary|tertiary|quarternary|quinary)-gw-provisioning|card-slot-[1-5]))

--uim-change-pin=[(PIN1|PIN2|UPIN),(old PIN),(new PIN)[,"key=value,..."]]
    Change PIN (allowed keys: session-type ((primary|secondary|tertiary|quarternary|quinary)-gw-provisioning|card-slot-[1-5]))

--uim-read-transparent=[0xNNNN,0xNNNN,...]
    Read a transparent file given the file path

--uim-get-card-status
    Get card status

--uim-get-slot-status
    Get slot status

--uim-switch-slot=[(slot number)]
    Switch active physical slot

--uim-monitor-slot-status
    Watch for slot status indications

--uim-monitor-refresh-file=[0xNNNN,0xNNNN,...]
    Watch for REFRESH events for given file paths

--uim-monitor-refresh-all
    Watch for REFRESH events for any file

--uim-get-configuration
    Get personalization status of the modem

--uim-depersonalization=[(feature),(operation),(control key)[,(slot number)]]
    Deactivates or unblocks personalization feature

--uim-remote-unlock=[XX:XX:...]
    Updates the SimLock configuration data

--uim-noop
    Just allocate or release a UIM client. Use with `--client-no-release-cid' and/or `--client-cid'

  SAR options:

--sar-rf-get-state
    Get RF state

--sar-rf-set-state=[(state number)]
    Set RF state.

--sar-noop
    Just allocate or release a SAR client. Use with `--client-no-release-cid' and/or `--client-cid'

  WMS options:

--wms-get-routes
    Get SMS route information

--wms-set-routes=["key=value,..."]
    Set SMS route information (keys: type, class, storage, receipt-action)

--wms-noop
    Just allocate or release a WMS client. Use with `--client-no-release-cid' and/or `--client-cid'

  WDA options:

--wda-set-data-format=["key=value,..."]
    Set data format (allowed keys: link-layer-protocol (802-3|raw-ip), ul-protocol (disabled|tlp|qc-ncm|mbim|rndis|qmap|qmapv5), dl-protocol (disabled|tlp|qc-ncm|mbim|rndis|qmap|qmapv5), dl-datagram-max-size, dl-max-datagrams, ep-type (undefined|hsusb|pcie|embedded), ep-iface-number, ul-datagram-max-size, ul-max-datagrams)

--wda-get-data-format=["key=value,..."]
    Get data format (allowed keys: ep-type (undefined|hsusb|pcie|embedded), ep-iface-number); also allows empty key list

--wda-noop
    Just allocate or release a WDA client. Use with `--client-no-release-cid' and/or `--client-cid'

  VOICE options:

--voice-noop
    Just allocate or release a VOICE client. Use with `--client-no-release-cid' and/or `--client-cid'

  LOC options:

--loc-session-id=[ID]
    Session ID for the LOC session

--loc-start
    Start location gathering

--loc-stop
    Stop location gathering

--loc-follow-nmea
    Follow all NMEA trace updates reported by the location module indefinitely

--loc-get-nmea-types
    Get list of enabled NMEA traces

--loc-set-nmea-types=[type1|type2|type3...]
    Set list of enabled NMEA traces

--loc-get-operation-mode
    Get operation mode

--loc-set-operation-mode=[default|msb|msa|standalone|cellid|wwan]
    Set operation mode

--loc-get-predicted-orbits-data-source
    Get predicted orbits data source

--loc-noop
    Just allocate or release a LOC client. Use with `--client-no-release-cid' and/or `--client-cid'

  DSD options:

--dsd-get-system-status
    Gets system status

--dsd-noop
    Just allocate or release a DSD client. Use with `--client-no-release-cid' and/or `--client-cid'

  DPM options:

--dpm-open-port=["key=value,..."]
    Open port (allowed-keys: ctrl-ep-type, ctrl-ep-iface-number, ctrl-port-name, hw-data-ep-type, hw-data-ep-iface-number, hw-data-rx-id, hw-data-tx-id, sw-data-ep-type, sw-data-ep-iface-number, sw-data-port-name)

--dpm-noop
    Just allocate or release a DPM client. Use with `--client-no-release-cid' and/or `--client-cid'

  FOX options:

--fox-get-firmware-version=[firmware-mcfg-apps|firmware-mcfg|apps]
    Get firmware version

--fox-set-fcc-authentication=[magic-string,magic-number]
    Set FCC authentication

--fox-noop
    Just allocate or release a FOX client. Use with `--client-no-release-cid' and/or `--client-cid'

  Link management options:

--link-list=[IFACE]
    List links created from a given interface

--link-add=[iface=IFACE,prefix=PREFIX[,mux-id=N[,initial-mux-id=M]][,flags=FLAGS]]
    Create new network interface link

--link-delete=[link-iface=IFACE][,[mux-id=N]]
    Delete a given network interface link

--link-delete-all=[IFACE]
    Delete all network interface links from the given interface

  qmi_wwan specific options:

-w, --get-wwan-iface
    Get the associated WWAN iface name

-e, --get-expected-data-format
    Get the expected data format in the WWAN iface

-E, --set-expected-data-format=[802-3|raw-ip|qmap-pass-through]
    Set the expected data format in the WWAN iface

  Application Options:

-d, --device=[PATH]
    Specify device path

--get-service-version-info
    Get service version info

--device-set-instance-id=[Instance ID]
    Set instance ID

--device-open-version-info
    Run version info check when opening device

--device-open-sync
    Run sync operation when opening device

-p, --device-open-proxy
    Request to use the 'qmi-proxy' proxy

--device-open-qmi
    Open a cdc-wdm device explicitly in QMI mode

--device-open-mbim
    Open a cdc-wdm device explicitly in MBIM mode

--device-open-auto
    Open a cdc-wdm device in either QMI or MBIM mode (default)

--device-open-net=[net-802-3|net-raw-ip|net-qos-header|net-no-qos-header]
    Open device with specific link protocol and QoS flags

--client-cid=[CID]
    Use the given CID, don't allocate a new one

--client-no-release-cid
    Do not release the CID when exiting

-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

-V, --version
    Print version

COPYRIGHT
Copyright © 2012-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 qmicli is maintained as a Texinfo manual. If the info and qmicli programs are properly installed at your site, the command

    info qmicli

should give you access to the complete manual.