fwupd/plugins/modem-manager
Aleksander Morgado ffb8fd5edc modem-manager: implement qmi pdc active config selection as attach()
When we install the MCFG carrier config files with QMI PDC, we were
not explicitly selecting one, and that would end up reporting the
"DF" (default) config is in use. Instead, we should explicitly select
the carrier configuration that we were using before the firmware
upgrade operation.

For example, if the device originally was running with the Vodafone
specific carrier configuration (e.g. T77W968.F1.0.0.3.7.VF.009) and we
trigger the upgrade to the next available firmware associated to
the Vodafone carrier (e.g. T77W968.F1.0.0.3.8.VF.009), we would want
the device to boot with the Vodafone carrier config selected, instead
of booting without any config selected (T77W968.F1.0.0.3.8.DF.009).

This also fixes several upgrade problems detected by fwupd, because it
may end up complaining that the target firmware that was selected to
be installed (e.g. VF variant) is not the one actually reported by the
device after the upgrade (e.g. DF variant).

The selection of which is the config to activate is based on mapping
the mcfg file name with the firmware version reported by the module
before the upgrade. E.g. if the VF variant is reported by the module
(T77W968.F1.0.0.3.7.VF.009), fwupd will look for a MCFG file named
with the "mcfg.VF." prefix.
2019-04-09 07:54:46 -04:00
..
fu-mm-device.c modem-manager: implement qmi pdc active config selection as attach() 2019-04-09 07:54:46 -04:00
fu-mm-device.h modem-manager: implement support for qmi-pdc 2019-02-27 16:09:13 +00:00
fu-mm-utils.c modem-manager: implement support for qmi-pdc 2019-02-27 16:09:13 +00:00
fu-mm-utils.h modem-manager: implement support for qmi-pdc 2019-02-27 16:09:13 +00:00
fu-plugin-modem-manager.c modem-manager: implement qmi pdc active config selection as attach() 2019-04-09 07:54:46 -04:00
fu-qmi-pdc-updater.c modem-manager: implement qmi pdc active config selection as attach() 2019-04-09 07:54:46 -04:00
fu-qmi-pdc-updater.h modem-manager: implement qmi pdc active config selection as attach() 2019-04-09 07:54:46 -04:00
meson.build modem-manager: implement support for qmi-pdc 2019-02-27 16:09:13 +00:00
README.md modem-manager: implement support for qmi-pdc 2019-02-27 16:09:13 +00:00

ModemManager

Introduction

This plugin adds support for devices managed by ModemManager.

GUID Generation

These device use the ModemManager "Firmware Device IDs" as the GUID, e.g.

  • USB\VID_413C&PID_81D7&REV_0318&CARRIER_VODAFONE
  • USB\VID_413C&PID_81D7&REV_0318
  • USB\VID_413C&PID_81D7
  • USB\VID_413C

Update method: fastboot

If the device supports the 'fastboot' update method, it must also report which AT command should be used to trigger the modem reboot into fastboot mode.

Once the device is in fastboot mode, the firmware upgrade process will happen as defined e.g. in the 'flashfile.xml' file. Every file included in the CAB that is not listed in the associated 'flashfile.xml' will be totally ignored during the fastboot upgrade procedure.

Update method: qmi-pdc

If the device supports the 'qmi-pdc' update method, the contents of the CAB file should include files named as 'mcfg.*.mbn' which will be treated as MCFG configuration files to download into the device using the Persistent Device Configuration QMI service.

If a device supports both 'fastboot' and 'qmi-pdc' methods, the fastboot operation will always be run before the QMI operation, so that e.g. the full partition where the MCFG files are stored can be wiped out before installing the new ones.