Unlike Magic Leap 1, OS updates for Magic Leap 2 can only be installed manually by the user, there are no over-the-air updates. Starting with our April 2022 OS release, the files required for flashing can be downloaded directly from Magic Leap Hub. Unlike Magic Leap 1, OS images are not tied to specific devices. Once you've download an OS image, you can flash it using ADB, or use Magic Leap Hub's OS installer to install your OS in a few, short clicks.
To update your device, you'll need to have Magic Leap Hub installed.
Downloading an OS Image
From the home screen of Magic Leap Hub, open the Package Manager by clicking the "Package Manager" icon in the upper-righthand corner of the application.
Navigate to the "All" tab to see all available software and tools. You should see a heading saying "Device OS Versions". If you do not, click on the "Package Manager" dropdown in the upper-lefthand corner, and click "Refresh Available Packages". If this does not work, try reinstalling the app to make sure you have the latest version.
Click on the arrow to the "ML2 OS" section and, from the "Available Version(s)" dropdown, select the OS version you'd like to download. You should see the following:
Confirm that the OS version you want to download is selected and click "Apply Changes". You will be taken to a screen showing the download progress. Once done, returning to the "All" or "My Tools" tabs and selecting the "ML2 OS" section and clicking "Open Folder" will open the folder containing the files required for flashing.
Flashing Your Device via Command Line Interface
Now that you've download the OS image, you are ready to flash. For instructions on flashing your device, please refer to our Developer Portal. Note: the flashing process varies by platform and additional steps are currently required for flashing with MacOS.
Updating via Magic Leap Hub
Alternatively, you can Magic Leap Hub's OS Installer tool. With your device connected to your computer, and recognized by Magic Leap Hub's device bridge, open Device Bridge. Verify the device's serial number matches the device you're looking to update. If it does, find and click the white "Update Available" button on the left-hand side of Device Bridge.
Note: if the Hub is not detecting your device, please ensure the 'Allow USB debugging on this computer" is selected. If there isn't a pop up on your device, navigate to Settings>System>Advanced>Developer Options, scroll down to "DEBUGGING" and toggle USB debugging on.
Confirm again that your device is selected, and select the OS build you want to install. You need to have already downloaded an OS image.
You may also be prompted to select the file path to the folder where the OS image you previously downloaded is. The file path is the same as the folder mentioned in the Downloading an OS image section above.
Once you've confirmed the OS version, and set the file path if required, click "Install OS". For a clean install of the new OS, you can check "Reset device to factory settings". You will receive a prompt confirming you want to install. Confirm the installation by clicking "Yes".
Wait for installation to complete. The process takes about 10 minutes.
Tip: If the flashing process hangs on
<<Waiting for any device>>
for over 10 minutes, you can unplug the device from the PC, plug it back in, and watch the device manager to see if it shows up in USB devices. After which the process should continue.
Once installation is complete the purple "Installing..." button should be replaced with a button saying "Dismissed". Click that button to finish installation. You will need to update your Controller by connecting it to your device's compute pack.
What to do when OS Installer Fails
If the OS installer in ML Hub fails and your device is stuck in a loop of rebooting, you will need to manually flash your device.
First, shut the device off and restart it in fastboot mode. Enter fastboot mode by holding the volume down button while you turn the device on. If successful you should see the Fastboot LED indicator on your Compute Pack.
- In Magic Leap Hub, select the OS version you wish to flash from the ML OS dropdown in the "My Tools" section in "Package Manager". Click the "Open Folder" button. Open your computer's command line interface tool.
- If you are on MacOS, run the following:
- If you are on Linux, run the following:
- If you are on Windows, run the following:
- If you are on MacOS, run the following:
- This will take around 6-10 minutes to flash everything based on the USB speed.
- At the end of flashing, the script will reboot the device, it should be recognized when you run: