libqmi-1.28.0

[Bruce Dubbs]

New minor version.

[Bruce Dubbs]

Overview of changes in libqmi 1.28.0

• Build now optionally depends on the libqrtr-glib v1.0.0 library, which is no longer maintained inside the libqmi sources. All the QRTR related methods implemented in the QmiDevice object in the libqmi-glib library are considered API/ABI stable.

• The pkg-config file now exposes build features as variables, which allows other projects to detect them at configure time. E.g. to check whether the libqmi-glib library was built with QRTR support:

         qmi_qrtr_supported=$($PKG_CONFIG --variable=qmi_qrtr_supported qmi-glib)
         if test "x$qmi_qrtr_supported" = "x1"; then
           ....
         fi
  

• The QmiDevice interfaces to work with the expected data format and the wwan interface name should now be considered to be specific to QMI devices exposed by the upstream 'qmi_wwan' kernel driver. If the device is exposed with a different driver (e.g. PCIe or QRTR) these methods will always fail.

• The QmiDevice now supports configuring the 'pass_through' sysfs setting in the network interfaces exposed by the 'qmi_wwan' kernel driver, with a new 'qmap-pass-through' expected data format type. In this mode, the network device will be managed by the rmnet kernel driver. A new method is also provided to check in runtime whether a given expected data format value is supported by the kernel or not.

• The QmiDevice now includes methods to list, create and delete links on the network interface, that can be used to setup QMAP based multiplexing of different data streams, e.g. connected to different APNs. When using the 'qmi_wwan' kernel driver, the link management logic depends on the configured expected data format:
  • rmnet netlink operations will be used if 'qmap-pass-through' expected data format is configured.
  • add_mux/del_mux operations will be used if 'raw-ip' expected data format is configured.
  When not using 'qmi_wwan', rmnet netlink operations are assumed.

• New services:
  • New 'SAR' (Specific Absorption Rate) service, with support for the "Set RF State" and "Get RF State" request/responses.

• New request/response/indications:
  • uim: implement "Refresh Register" request/response.
  • uim: implement "Refresh Register All" request/response.
  • uim: implement "Refresh Complete" request/response.
  • uim: implement "Refresh" indication.
  • loc: implement "Get Engine Lock" request/response.
  • loc: implement "Set Engine Lock" request/response.
  • nas: implement "Get DRX" request/response.
  • nas: implement "Get PLMN Name" request/response.
  • wms: implement "Send Ack" request/response.
  • wds: implement "Bind Data Port" request/response.
  • wds: implement "Get Max LTE Attach PDN Number" request/response.
  • wds: implement "Get LTE Attach PDN List" request/response.
  • wds: implement "Set LTE Attach PDN List" request/response.
  • wds: implement "Set LTE Attach PDN List" indication.
  • wds: implement "Get LTE Attach Parameters" request/response.
  • wds: renamed "Get Default Profile Num" to "Get Default Profile Number", and provided compat symbols to avoid breaking API.
  • wds: renamed "Set Default Profile Num" to "Set Default Profile Number", and provided compat symbols to avoid breaking API.

• New TLVs supported in existing messages:
  • nas: added the "Rx Chain 2/3 Info" TLVs in "Get Tx Rx Info".
  • nas: added the "LTE Info Timing Advance" TLV in "Get Cell Location Info".
  • nas: added the "LTE Voice Domain", "CDMA Registration Zone ID", "GSM Routing Area Code", "WCDMA Routing Area Code" and "CDMA Resolved MCC" TLVs in "Get System Info".

• libqmi-glib:
  • Added support for 'embedded' and 'pcie' endpoint types.
  • Added support for QMAPv5 data aggregation type.

• qmicli:
  • When built with QRTR support, the '--device' option now allows QRTR URIs (e.g. 'qrtr://0').
  • New '--link-list', '--link-add', '--link-delete' and '--link-delete-all' commands.
  • New '--uim-monitor-refresh-file' command.
  • New '--uim-monitor-refresh-all' command.
  • New '--wds-bind-data-port' command.
  • New '-loc-get-operation-mode' and '--loc-set-operation-mode' commands.
  • New '-loc-get-engine-lock' and '--loc-set-engine-lock' commands.
  • New '--wds-get-lte-attach-parameters' command.
  • New '--wds-get-max-lte-attach-pdn-num' command.
  • New '--wds-get-lte-attach-pdn-list' and '--wds-set-lte-attach-pdn-list' commands.
  • Updated the '--wds-start-network' command with a timeout of 180s.
  • Updated the '--wds-stop-network' command with a timeout of 120s.
  • Updated the '--dms-set-firmware-preference' command to use a key-value pair based input instead of predefined fields.

• collections:
  • basic: added UIM event registration commands.
  • basic: added UIM slot management commands.
  • basic: added UIM refresh related commands.
  • basic: added WDS bind data port commands.
  • basic: added WDS initial LTE bearer management commands.
  • basic: added NAS PLMN name commands.

The following features which were backported to 1.26.x releases are also present in libqmi 1.28.0:

• build:
  • Avoid including qmi-version.h in dist, as its contents depend on the given configure options.

• libqmi-glib:
  • 5G support in the NAS signal info operations.
  • BCD encoded strings should be read as arrays instead of NUL-terminated strings.

• qmicli:
  • nas: report EcIo, RSRP and phase also in 5GNR.

[Bruce Dubbs]

Fixed at revision 24319.

[Bruce Dubbs]

Milestone renamed