Support manual firmware upgrading for Foxconn and Quectel modems.
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
OEM Priority Project |
Fix Released
|
Critical
|
Jerry Lee | ||
modemmanager (Ubuntu) |
Fix Released
|
High
|
Unassigned | ||
Focal |
Fix Released
|
Undecided
|
Unassigned | ||
Hirsute |
Fix Released
|
Undecided
|
Unassigned |
Bug Description
[Impact]
The modem certification requires that different modem firmware is used for different network carrier.
This needs the firmware upgrading capability during the modem certification process.
The modem manufacture vendors (Foxconn and Quectel) provided utilities to do modem's firmware upgrading manually.
These utilities are verified to be working when the recent versions(> v 1.18.2) of ModemManager are used with.
To support manual firmware upgrading on the current Focal release which is using ModemManager v 1.16.6, we need to apply some patches from v 1.18.2.
The requested upstream patches are listed as below:
* for Quectel EM160 4G
** https:/
* for Foxconn T99W175
** https:/
**https:/
** https:/
** https:/
** https:/
The firmware upgrading was verified using the patched ModemManager v 1.16.6 with the following 2 modems:
* Foxconn SDX55 T99W175 5G sub6 PCIE Modem
* Quectel SDX24 EM160R-GL 4G LTE CAT16 PCIE Modem
[Test Plan]
1. Install the Ubuntu image.
2. Boot and login the system.
3. Verify if the modem is working
4. Prepare the modem’s firmware and install the firmware upgrading application provided by Foxconn and Quectel
5. Using the firmware upgrading application to upgrade the modem’s firmware
6. Verify if the modem’s firmware upgrading is successful
7. Reboot
8. Verify if the upgraded modem firmware is still working
--- Regression test ---
Verify if one USB modem are still working with these patches for PCIe modems.
[Where problems could occur]
The requested update has 2 parts:
1. Informative
1.1 Provide more information about modems whose drivers use WWAN subsystem in kernel 5.13
1.2 Modem manufacture's private utilities can use this information to do modem's FW upgrading manually
2. Changes are specific to Foxconn and Quectel modems
2.1 Modified code are only used by Foxconn and Quectel modems during their FW upgrading. (matched by vendor_id and product_id)
In current Ubuntu's certification records for modem:
* No other modem uses WWAN subsystem in kernel 5.13
* Modem's FW update is not supported via ModemManager ( < v1.18 )
There is no certificated modems can do the firmware upgrading flow for the regression test.
This update should not affect existing modems.
The problem would be limited to these two mentioned modems.
Each carrier mapping .conf file is for a specific modem.
ModemManager will load one of the carrier mapping conf files via the modem manufacturer’s plugin ( if the PCIe VID & PID is matched by the plugin.)
We cannot verify if the carrier mapping is correct. This relies on the manufacturer to provide the correct mapping.
The carrier mapping .conf files is verified by modem’s manufacture according to the tested SIM card published by different countries.
Modem manufacturer confirmed that the content in the .conf file is absolutely correct.
[Other Info]
The firmware and the upgrading utilities can be downloaded from the following link:
* LP#1943774 for Quectel modems
* LP#1943780 for Foxconn modems
Changed in oem-priority: | |
assignee: | nobody → Jerry Lee (jerry-lee-tpe) |
importance: | Undecided → Critical |
Changed in modemmanager (Ubuntu): | |
importance: | Undecided → High |
Changed in modemmanager (Ubuntu): | |
status: | New → Fix Committed |
Changed in oem-priority: | |
status: | New → In Progress |
summary: |
- Apply upstream patches to fix problems for Foxconn and Quectel modems. + Support manual firmware upgrading for Foxconn and Quectel modems. |
description: | updated |
description: | updated |
Changed in modemmanager (Ubuntu): | |
status: | Incomplete → New |
description: | updated |
Changed in oem-priority: | |
status: | In Progress → Fix Released |
The .debdiff file “modemmanager_ 1-1.16. 6-3-focal. debdiff” is attached for focal(20.04).
The pre-built package : https:/ /launchpad. net/~jerry- lee-tpe/ +archive/ ubuntu/ packages/ +packages