The OnePlus MSM Download Tool (commonly called MSM Tool or MSMTOOL) is a model-specific factory restore utility that uses Qualcomm's Emergency Download (EDL) interface to re-flash a OnePlus device from scratch. If your OnePlus is stuck in a bootloop, shows a dead battery screen that never charges, or is completely unresponsive, MSM Tool is the standard recovery path. Unlike Fastboot flashing, it writes every partition — including the bootloader — directly from a known-good factory image.
MSM Tool communicates with the Qualcomm Snapdragon SoC in EDL mode, bypassing the Android OS, bootloader, and recovery entirely. It writes a complete set of factory partition images to the device's storage using the Firehose protocol. The result is a phone that is functionally identical to how it left the factory: stock OxygenOS (or ColorOS on later models), stock partitions, stock calibration data.
What MSM Tool does not do:
/data and /userdata.Before running MSM Tool, confirm you have the following:
Qualcomm_USB_Driver_v1.0.exe or equivalent from the tool package before connecting the phone. Alternatively, install MiFlash or QFIL to get the same driver.If the phone is completely unresponsive (no screen, no charging indicator), connect it via USB. Many OnePlus models automatically enter EDL if the bootloader detects missing or corrupted critical partitions. Device Manager should show a new COM port under Ports (COM & LPT) labeled Qualcomm HS-USB QDLoader 9008.
If the phone still partially boots (stuck at logo, or Fastboot mode is accessible), force EDL:
fastboot oem edladb reboot edlC:\MSM\OP9). Long paths or paths with spaces can cause file-not-found errors during the flash sequence.MsmDownloadTool.exe and select Run as administrator.First boot after an MSM restore takes longer than normal — typically 3–6 minutes. The OS is rebuilding the Dalvik/ART cache from scratch for all pre-installed apps. Do not assume the device is stuck and do not interrupt the boot. Wait until the Android setup wizard appears.
The phone comes up as a completely new device. No apps, no accounts, no files are present. Google account setup and OTA update prompts will appear immediately. Connect to Wi-Fi first before restoring a backup, as the initial OTA update often brings critical security patches.
No COM port appears: Qualcomm USB driver is not installed, or the cable or port is not compatible. Try a different USB cable and a USB-A 2.0 port. Reinstall the driver from the tool package.
Tool launches then crashes immediately: Missing VC++ runtime. Install both the x86 and x64 versions of Microsoft Visual C++ Redistributable 2015–2022.
Stuck at "Sending programmer" for more than 2 minutes: The programmer file is incompatible with the device (wrong model package) or the EDL auth check is failing on newer hardware. Confirm the tool package matches the exact model number.
Partition write errors: Can indicate storage hardware failure. If multiple attempts consistently fail at the same partition, the UFS/eMMC chip likely has bad sectors. This requires professional repair.