--- title: "Cortex System Recovery" slug: "cortex-system-recovery" status: "update" updated: 2026-11-19T03:49:56Z published: 2026-11-19T03:49:56Z canonical: "knowledge.emesent.com/cortex-system-recovery" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.emesent.com/articles/llms.txt > Use this file to discover all available pages before exploring further. # Cortex System Recovery Use Cortex recovery to recover a **Hovermap** that cannot start. When this occurs, the status LEDs show **red flashing** and do not change. The cause is usually a file system problem or a failed Cortex upgrade. > [!WARNING] > - Recovery is available only for a Hovermap that already has **Cortex 4.0.3 or later**. > - Recovery updates the Hovermap to the latest version of Cortex. After recovery, update Commander. Commander 2.3 cannot connect to Cortex 4.3.0 or later. Refer to [Supported Devices & Compatibility](/v1/docs/supported-devices-compatibility). > - Recovery deletes all the scans in the **transferred** folder of the Hovermap. Scans that are not offloaded stay on the Hovermap. ## Equipment required | **Item** | **Details** | | --- | --- | | **USB drive** | At least 8 GB of free space. > [!NOTE] > Use a standard USB flash drive. Do not use a USB-attached solid-state drive (SSD). To check the USB drive, refer to [Validate the USB drive](/articles/cortex-system-recovery#validate-the-usb-drive). > [!WARNING] > Most USB drives supplied with Hovermap are USB-attached SSDs, not standard USB flash drives. They look the same, but they do not work with Cortex recovery. | | **Hovermap** | - The status LEDs show continuous red flashing. - Cortex 4.0.3 or later. | | **Power source** | - Standard Hovermap battery (Battery Core SWX Nano 98S). - Fully charged. | | **Tablet or phone** | - A supported tablet or phone. - The latest version of Emesent Commander. | | **Cortex recovery package** | Emesent Client Support supplies the recovery package for the Cortex version of the Hovermap. The package includes the recovery file (cortex_recovery.gpg) and the install files. To get the recovery package, complete the [Technical Support](https://emesent.com/client-support/) form. Select: - Affected product: **Hovermap** - Failure Mode: **Red Flashing Light** | ## Recover the Hovermap ### Step 1: Prepare the USB drive 1. Copy all the files in the recovery package to the **top level** of the USB drive. Do not put them in a folder. 2. Safely remove the USB drive from the computer. ### Step 2: Insert the USB drive 1. Power off the Hovermap fully. 2. Insert the USB drive into the Hovermap. 3. Keep the USB drive in the Hovermap until recovery is complete. > [!WARNING] > Do not remove the USB drive before recovery is complete. If the USB drive is removed too early, the Hovermap can go into an **unrecoverable state**. Emesent cannot repair this remotely, and the Hovermap must go back to Emesent for repair. ### Step 3: Start recovery 1. Connect the Hovermap to a reliable power source. 2. Power on the Hovermap. 3. Wait approximately one minute for recovery to start. 4. Make sure that the status LEDs show a **fast blue swipe**. This shows that recovery has started. ### Step 4: Wait for recovery to complete 1. Do not interrupt recovery. 2. When recovery is complete, the **fast blue swipe** stops. 3. The Hovermap powers off and starts again automatically. 4. When the Hovermap starts, the LEDs show **red flashing** for approximately one minute. 5. Wait until the LEDs show **breathing blue**. This shows that recovery is complete. If the LEDs do not show breathing blue after one hour, or show a different pattern, refer to [Troubleshooting](/articles/cortex-system-recovery#troubleshooting). ### Step 5: Send the recovery log to Emesent 1. Remove the USB drive from the Hovermap. 2. On a computer, open the USB drive. Find the new **cortex_recovery** folder. 3. Send the contents of this folder to [Emesent Client Support](https://emesent.com/client-support/). Emesent uses it to find the cause of the problem. ### Step 6: Make sure that recovery was successful 1. Open **Commander** on the tablet or phone. 2. Connect to the Hovermap. 3. Make sure that Commander connects to the Hovermap. If Commander shows an incompatible firmware message, [update Commander](/v1/docs/installing-commander-on-an-android-tablet). ## Troubleshooting If recovery does not complete correctly, the status LEDs show the problem. | **LED pattern** | **Meaning** | | --- | --- | | **Slow flashing red** | The Hovermap is still starting. Recovery has not started. | | **Fast flashing red** | A critical error occurred. The usual cause is a damaged recovery file or install file, for example from a bad download. For more data, read the feedback log. | | **Fast flashing yellow** | The Hovermap cannot find a file that recovery needs. For more data, read the feedback log. | | **Fast swiping yellow** | The Hovermap cannot write to the USB drive. Make sure that the USB drive has free space and the correct format. | | **Fast swiping blue** | Recovery is in progress. | ### Feedback log If recovery fails, read the feedback log before contacting Emesent Client Support. - During recovery, the Hovermap writes the log file **cortex_recovery_feedback.log** to the **cortex_recovery** folder on the USB drive. - The log tells why recovery failed. For example: `Install file <file name> not found on USB. Aborting.` **If the problem can be corrected** 1. Correct the problem. For example, copy the missing file to the USB drive. 2. Remove the **cortex_recovery** folder from the USB drive. Keep it in a safe location to send to Emesent later. 3. Start recovery again from Step 2. > [!NOTE] > Remove the **cortex_recovery** folder from the USB drive before starting recovery again. **If the problem continues** - If recovery is not complete after **1 hour**, remove the USB drive. - Send the contents of the **cortex_recovery** folder to [Emesent Client Support](https://emesent.com/client-support/). ### Validate the USB drive 1. Connect the USB drive to a Windows computer. 2. In Windows Explorer, open **This PC**. 3. Right-click the USB drive and select **Properties**. ![Properties selected on the USB drive in This PC](https://cdn.document360.io/c908b593-57d7-4fc8-b409-592fc1051369/Images/Documentation/image(304).png) 1. Look at the **Device type** field: - **USB Drive**: the USB drive is correct for recovery. - **Local Disk**: the USB drive is not correct for recovery. Use a different USB drive. ![Device type field in the USB drive Properties](https://cdn.document360.io/c908b593-57d7-4fc8-b409-592fc1051369/Images/Documentation/image(305).png)