| **Action** | **Keystroke(s)** | **Description** |
| **Enter Cell Data** | *Type any number* | Enter cell data by first selecting cells you want to edit, then type a number and press **Enter/Return** to have the entire selection update to the entered value. |
| **Undo** | Ctrl+Z (Cmd+Z) | Undo the last edit. |
| **Redo** | Ctrl+Y (Cmd+Y) | Redo the last undone edit. |
| **Add** | Shift+(+) | Type the "+" character (Shift and the "+" key together) to start adding a value to the current selection. **Tip:** use a negative number to quickly subtract a value. |
| **Multiply** | Shift+8 | Type the "\*" character (Shift and the "8" key together) to start multiplying the current selection by a coefficient. |
| **Divide** | / | Type the "/" character to start dividing the current selection by a coefficient. |
| **Interpolate** | i | Type the "i" key to immediately interpolate the current **complex selection**. Interpolation behaves differently than other actions. Selected cells will be treated as anchors and will be unchanged, but any cells in between the anchors will be interpolated according to the Table Editor's current interpolation algorithm. |
| **Simple Selection** | **Complex Selection** |
| **Click and drag** to make a simple selection. Use **Ctrl/Cmd + A** together to quickly select the entire table. | Start with a simple selection (or one cell), and **hold Ctrl/Cmd** while clicking other areas of the table to produce a complex selection. Complex selections are a key feature with **Interpolation.** |
| [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/OvY1SvSPwuUofrWl-screenshot-2024-11-07-at-2-43-41-pm.png) | [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/sK1dsTJLM518lDUK-screenshot-2024-11-07-at-2-45-08-pm.png) |
**2023+ WRX MT Users** Please see our documentation on the [known issue with recovery on these ECUs](https://docs.motorsportsresearch.org/books/atlas-documentation/page/2023-model-recovery-notice) In brief, recovery cannot be performed in-vehicle, and must be performed in a bench setup.
**Be safe!** For the most reliable and failsafe scenario when flashing with Atlas, we recommend purchasing a spare ECU from a site like eBay. Clone your EEPROM to this ECU, and use it for flashing instead of your OEM ECU. Otherwise, if you fail to flash for any reason, you can risk "bricking" your stock ECU. Atlas can recover some ECUs, but there are scenarios where invasive recovery is necessary.
In order for a calibration (tune) to be recognized completely by a vehicle, you need to transfer and permanently store it in the vehicle's flash memory, or ROM. For this to take place, you need to instruct Atlas to perform the "**flashing**" process with the vehicle. Flashing is an easy process, but it is possible for it to fail if careful steps are not taken. Please ensure the following is true for your scenario: 1. The vehicle has **ample battery capacity** remaining to supply the electrical system in your vehicle for at **least 30 minutes** (we recommend turning off headlights/auxiliary electrical components) - don't try to flash a vehicle if it hasn't been started and driven for a long period of time (allowing the alternator time to charge the battery again). 2. Your laptop/computer/etc. has **ample battery capacity** as well to avoid shutdown for at **least 30 minutes**. 3. The vehicle is **parked,** stationary in a **safe location** such that anything to go wrong, recovery procedures can be run without interruption. 4. Ideally, is connected to a **high-amperage battery charger** supplying the battery itself with current. Flashing will work without a battery charger connected, but we strongly recommend using one whenever possible to avoid flashing interruptions that can cause your ECU to enter recovery mode. 5. The connection you can make with the OBDII port is **firm** and does not risk being **accidentally unplugged** with your position in the vehicle (i.e. shifting, moving around) and how it relates to any wires running to the OBDII port. #### Vehicle Connection To reflash, Atlas needs to be connected to the target vehicle. Please see our [supported adapter page](https://docs.motorsportsresearch.org/books/atlas-documentation/page/supported-adapters "Supported Adapters") for full details. ##### Tactrix OpenPort 2.0 "Connection failed" Error [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/mgniBpOIo9UmzmeE-image.png) Sometimes, the OpenPort 2.0 can lose sync with the computer running Atlas. Make sure you always first connect the adapter to your computer running Atlas. Then, connect the OBD2 end of the Tactrix to the vehicle's OBD2 port, often located underneath the trim in the steering wheel area. Doing this in the reverse order can sometimes cause the Tactrix to incorrectly synchronize with your computer and Atlas. #### ProcedureAtlas does not support reprogramming ECUs that are actively programmed by other 3rd-party, aftermarket tuning products in order to respect and honor their confidentiality agreements with their customers. Please "unmarry" the ECU from the aftermarket solution first, in order to return it to a factory state, before proceeding.
Make sure the vehicle is in its "Accessory Mode" mode, with the **engine not running**, but the **gauges active**. You may see a Check Engine light in this mode. For key ignition vehicles, turn the key to the "ACC" position to enter this mode. For push-to-start vehicles, push the ignition button twice with no pedal input (Clutch or Brakes) to enter this mode.
First, make sure you have selected your desired calibration to flash by selecting it in the **Active Calibration** dropdown menu in the upper-right part of Atlas. Then, click the Flash button, [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/6rOwQ0m1mblIR0re-image.png) After a brief period, you will be greeted with this prompt, [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/3JDwtqdyixN0eZuJ-image.png) 1. Make sure the **Calibration** listed is the one you want to flash 2. Make sure the **Vehicle** listed is the one you want to flash 3. If you are flashing a new tune, we strongly recommend checking **Reset Learned Parameters**.There is **no turning back** or any chance to interrupt the reprogramming once you click **Yes.** Make sure you are positive before continuing with reprogramming!
We recommend double-checking your sitting position, reducing any risk to an unplug scenario at this time, and laptop battery charge at this time. When you are ready, click **Yes.** [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/F2uPLqUpH3JeE7HA-image.png) The flash data will be reprogrammed to the ECU. Typically, for fast flashes, this can take anywhere from 10 seconds to 5 minutes. Depending on your adapter's capabilities and speed, this may take longer. If necessary, Atlas will automatically enter Recovery Mode to recover the ECU with the selected calibration, and the process may start over. Once the process completes, you will be greeted with the **Reprogramming Complete** screen: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/NibElgW5jA0J4oXG-image.png) Turn off the vehicle's ignition in order to completely shut down the vehicle. Click **OK.** [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/FGn9Z0WD6OvXS7O6-image.png) Atlas will now be waiting for the vehicle to return to its Access mode it was previously in. Allow the vehicle 10 seconds to fully shut down any internal electrical components that may still be in a flashing state, and **return the vehicle to Accessory mode**. Atlas will then clear any non-persistent diagnostic trouble codes (DTC) that were accidentally tripped by any vehicle components during the flashing process, and the flashing process is complete! #### Fast Flashing Atlas supports "fast flashing" a vehicle, but only if the target ECU supports this. If the vehicle supports fast flashing, this will automatically take place. Fast flashing, in most cases, will apply to any programming event with the vehicle, including first programming (sometimes referred to as "marriage"). #### Recovery Mode For more details on following through with a recovery process, see our [flash recovery procedures page](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flash-recovery). ##### Description Most vehicles have a manner in which you can recover the ECU should the flashing be incomplete. For the Subaru WRX (2015+), for example, your bootloader (never reprogrammed by Atlas) has logic which runs on start that will attempt to see if the flash had been correctly programmed. It does this by looking at the first and last sections of your programmed ROM to see if certain data it expects to be present are in place. As flash data is sent in a ordered fashion, it is unlikely that both sections will ever be correct if the reprogramming is ever interrupted. If these sections are not correct, your ECU will enter **recovery mode**. In recovery mode, your ECU cannot operate the vehicle, but instead is waiting for a new ROM to be uploaded. If, for example, power is lost to the ECU while flashing (low battery/etc.), this is the mode you will more than likely end up in. If Atlas fully supports your vehicle and your ECU also has a recovery mode that Atlas can interact with, Atlas will handle interacting with your ECU in this recovery mode. ##### Bricked ECUs Please reach out to NAMR if your ECU is "bricked", or in other words it cannot communicate when recovery mode is expected. We offer a service to attempt recovery on capable ECUs in this more challenging state with specialized tooling at merely the cost of shipping as a courtesy to support our community. # Flash Recovery #### Introduction ##### Description Most vehicles have a manner in which you can recover the ECU should the flashing be incomplete. For the Subaru WRX (2015+), for example, your bootloader (never reprogrammed by Atlas) has logic which runs on start that will attempt to see if the flash had been correctly programmed. It does this by looking at the first and last sections of your programmed ROM to see if certain data it expects to be present are in place. As flash data is sent in a ordered fashion, it is unlikely that both sections will ever be correct if the reprogramming is ever interrupted. If these sections are not correct, your ECU will enter **recovery mode**. In recovery mode, your ECU cannot operate the vehicle, but instead is waiting for a new ROM to be uploaded. If, for example, power is lost to the ECU while flashing (low battery/etc.), this is the mode you will more than likely end up in. If Atlas fully supports your vehicle and your ECU also has a recovery mode that Atlas can interact with, Atlas will handle interacting with your ECU in this recovery mode. ##### Bricked ECUs Please reach out to NAMR if your ECU is "bricked", or in other words it cannot communicate when recovery mode is expected. We offer a service to attempt recovery on capable ECUs in this more challenging state with specialized tooling at merely the cost of shipping as a courtesy to support our community. #### ProcedureMake sure the vehicle is in its "Accessory Mode" mode, with the **engine not running**, but the **gauges active**. You may see a Check Engine light in this mode. For key ignition vehicles, turn the key to the "ACC" position to enter this mode. For push-to-start vehicles, push the ignition button twice with no pedal input (Clutch or Brakes) to enter this mode.
To enter Recovery Mode in Atlas, use the main menu to click **Help -> Enter Recovery Mode**. [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/RqGRjVwL9u4MDd0f-image.png) You will be asked what vehicle is being recovered; select it from the list and click **OK**, [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/mCY6p2RYTNT9Gha9-image.png) First, make sure you have selected your desired calibration to flash by selecting it in the **Active Calibration** dropdown menu in the upper-right part of Atlas. Then, click the Flash button, [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/6rOwQ0m1mblIR0re-image.png) You may be asked again which vehicle is being recovered; select the vehicle again from the list and click **OK.** After a brief period, you will be greeted with this prompt, [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/3JDwtqdyixN0eZuJ-image.png) 1. Make sure the **Calibration** listed is the one you want to flash 2. Make sure the **Vehicle** listed is the one you want to flash 3. If you are flashing a new tune, we strongly recommend checking **Reset Learned Parameters**.There is **no turning back** or any chance to interrupt the reprogramming once you click **Yes.** Make sure you are positive before continuing with reprogramming!
We recommend double-checking your sitting position, reducing any risk to an unplug scenario at this time, and laptop battery charge at this time. When you are ready, click **Yes.** [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/F2uPLqUpH3JeE7HA-image.png) The flash data will be reprogrammed to the ECU. Typically, for fast flashes, this can take anywhere from 10 seconds to 5 minutes. Depending on your adapter's capabilities and speed, this may take longer. If necessary, Atlas will automatically enter Recovery Mode to recover the ECU with the selected calibration, and the process may start over. Once the process completes, you will be greeted with the **Reprogramming Complete** screen: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/NibElgW5jA0J4oXG-image.png) Turn off the vehicle's ignition in order to completely shut down the vehicle. Click **OK.** [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/FGn9Z0WD6OvXS7O6-image.png) Atlas will now be waiting for the vehicle to return to its Accessory mode it was previously in. Allow the vehicle 10 seconds to fully shut down any internal electrical components that may still be in a flashing state, using the ignition key or push-to-start button, once again **return the vehicle to Accessory mode**. Atlas will then clear any non-persistent diagnostic trouble codes (DTC) that were accidentally tripped by any vehicle components during the flashing process, and the flashing process is complete! # Cloning an ECU #### Introduction In order to avoid risking damaging or "bricking" your OEM ECU, you may instead choose to clone your OEM ECU to another, **spare** ECU that you have purchased. However, you will run into issues with this without cloning the ECU, as the OEM ECU in your vehicle has keys that permit the ECU to authorize with your electrical system. One of these keys is the key used for immobilizer authorization. Without at least these keys in agreement, the vehicle will not start. This documentation page assumes you have an **OEM** ECU that is correctly trained/paired to the vehicle from factory (or a dealership/service specialist) as a cloning source, and a **spare** ECU to clone to. Cloning an ECU involves downloading the region of memory in your ECU that holds these authorization keys. This section is smaller than and separate from your calibration (or tune) and is called **EEPROM**. You can download an EEPROM file and save it for later, or upload it to another ECU immediately after downloading it from the factory ECU.Atlas does not support cloning or reprogramming ECUs that are actively programmed by other 3rd-party, aftermarket tuning products in order to respect and honor their confidentiality agreements with their customers. Please reach out to the vendors supplying those products to clone and support those modified ECUs, or "unmarry" the ECU from the aftermarket solution first before proceeding.
Cloning is relatively easy, but please ensure the following is true for your scenario: 1. The vehicle has **ample battery capacity** remaining to supply the electrical system in your vehicle for at **least 30 minutes** (we recommend turning off headlights/auxiliary electrical components) - don't try to flash a vehicle if it hasn't been started and driven for a long period of time (allowing the alternator time to charge the battery again). 2. Your laptop/computer/etc. has **ample battery capacity** as well to avoid shutdown for at **least 30 minutes**. 3. The vehicle is **parked,** stationary in a **safe location** such that anything to go wrong, recovery procedures can be run without interruption. 4. Ideally, is connected to a **high-amperage battery charger** supplying the battery itself with current. Flashing will work without a battery charger connected, but we strongly recommend using one whenever possible to avoid flashing interruptions that can cause your ECU to enter recovery mode. 5. The connection you can make with the OBDII port is **firm** and does not risk being **accidentally unplugged** with your position in the vehicle (i.e. shifting, moving around) and how it relates to any wires running to the OBDII port. #### Vehicle Connection To reflash, Atlas needs to be connected to the target vehicle. Please see our [supported adapter page](https://docs.motorsportsresearch.org/books/atlas-documentation/page/supported-adapters "Supported Adapters") for full details. ##### Tactrix OpenPort 2.0 "Connection failed" Error [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/mgniBpOIo9UmzmeE-image.png) Sometimes, the OpenPort 2.0 can lose sync with the computer running Atlas. Make sure you always first connect the adapter to your computer running Atlas. Then, connect the OBD2 end of the Tactrix to the vehicle's OBD2 port, often located underneath the trim in the steering wheel area. Doing this in the reverse order can sometimes cause the Tactrix to incorrectly synchronize with your computer and Atlas. #### Step 1: Downloading EEPROMMake sure the vehicle is in its "Accessory Mode" mode, with the **engine not running**, but the **gauges active**. You may see a Check Engine light in this mode. For key ignition vehicles, turn the key to the "ACC" position to enter this mode. For push-to-start vehicles, push the ignition button twice to enter this mode.
First, ensure the **OEM** ECU is connected to the vehicle. If it is not, **disconnect the battery** before replacing and installing the OEM ECU. Reconnect the battery after physically reinstalling and fully reconnecting the ECU. Then, using the main menu in Atlas, click **ECU -> Download Section**: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/rUqjtFqpcWEXovQ5-image.png) You will be asked which section is being downloaded. Select **EEPROM,** and click **OK**: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/ntCi9dWG5ymtlpbV-image.png) The EEPROM will be downloaded from the ECU, please wait for this to finish. [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/gzgu2909PfFHrTBK-image.png) When the process has completed, save the downloaded binary data to a file on your computer: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/ltXSasu33FWmHBix-image.png) #### Step 2: Uploading EEPROMMake sure the vehicle is in its "Accessory Mode" mode, with the **engine not running**, but the **gauges active**. You may see a Check Engine light in this mode. For key ignition vehicles, turn the key to the "ACC" position to enter this mode. For push-to-start vehicles, push the ignition button twice to enter this mode.
Ensure the **spare** ECU is connected to the vehicle. **Disconnect the battery** before replacing and installing the spare ECU. Reconnect the battery after physically reinstalling and reconnecting the spare ECU. Then, using the main menu in Atlas, click **ECU -> Flash Section**: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/UMZkJSjuoAKiHyOs-image.png) Select an EEPROM binary file that was previously downloaded from another ECU: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/fY4VqSwE1uNXE80t-image.png) You will be asked which section is being uploaded. Select **EEPROM,** and click **OK**: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/UEL8xS8m2iey6GNQ-image.png) The EEPROM will be uploaded to the ECU. Wait for the process to finish: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/fFMyTPvCESR3O4vu-image.png) Once the process completes, you will be greeted with the **Upload Complete** screen: [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/h63prcZw6prLb28N-image.png) Turn off the vehicle's ignition in order to completely shut down the vehicle. Click **OK.** Atlas will now be waiting for the vehicle to return to its Accessory mode it was previously in. Allow the vehicle 10 seconds to fully shut down any internal electrical components that may still be in a flashing state, and **return the vehicle to Accessory mode**. # 2023 Model Recovery *NOTICE*As of mid December 2024, the Atlas dev team discovered that in-car recovery for the 2023 year model WRX's is currently not supported. Recovery of 2023 ECU's must be performed out-side of the car with a 'bench-top' harness.
A conflict between the gateway controller and Atlas was found to be the root cause of the issue. 2022's use a different gateway controller ROM and therefore do *not* suffer from the same issue. In-car recovery for 2022 year models is **fully supported.** **A bench-top harness must be used when recovering 2023 year model ECU's.** # Calibrations # Sharing Calibrations ### Importing a Calibration/Tune #### **Atlas is Free and Open!** Atlas, as an open tuning platform, encourages sharing calibrations (tunes) within the community. At NAMR, we have a strong stance against Atlas locking tunes. When you import a calibration, you always have the ability to read it and modify it if you choose. #### **Import a Calibration**To flash a calibration to your vehicle after importing it, see [Flashing a Calibration](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flashing-a-calibration).
To import a calibration, first open Atlas. Then, ensure you have the same project opened that was used to export the calibration. Projects are specific to the vehicle you are tuning, such as the VB WRX or the VA WRX. Once you have opened a project, use the File -> Import -> Atlas Calibration menu item to select an \*.*acf* file and load the calibration data into Atlas. Once loaded, Atlas will automatically switch the project's active calibration to the imported tune so you can begin flashing and/or working immediately. [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-12/qkTUlSlcTUnGNOvr-image.png) #### **Export a Calibration** To export a calibration to share with others, first right-click the calibration in the Calibration tree. Then, using the "Export ROM..." option, save the calibration to a *\*.acf* file and share that file with the recipient. [](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-12/uHpyw0Ug65vubBTi-image.png) # Datalogging # New Page # Project Tree # Support Detailed adapter and vehicle support information # Installation # Supported Adapters Atlas supports the following adapters and hardware through custom cross-platform device drivers that are built directly into Atlas. The listed adapters should work out of the box with no additional configuration required.| Device | Platform | Connection | Type | Flash Speed (Average) |
|---|---|---|---|---|
| [Tactrix OpenPort 2.0](https://www.tactrix.com/index.php?page=shop.product_details&flypage=flypage.tpl&product_id=17&category_id=6&option=com_virtuemart&Itemid=53&redirected=1&Itemid=53) |    | Wired (USB-Mini B) | OpenPort | 3~5 minutes |
| [OBDLink MX+](https://www.obdlink.com/products/obdlink-mxp/) |    | Wireless (Bluetooth 3.0) | STN | 15~16 minutes |
| [OBDLink LX](https://www.obdlink.com/products/obdlink-lx/) |    | Wireless (Bluetooth 3.0) | STN | 15~16 minutes |
| [OBDLink EX](https://www.obdlink.com/products/obdlink-ex/) |    | Wired (USB-A) | STN | 15~16 minutes |
| [OBDLink SX](https://www.obdlink.com/products/obdlink-sx/) |    | Wired (USB-A) | STN | 15~16 minutes |
| [Veepeak OBDCheck BLE+](https://www.amazon.com/dp/B076XVQMVS) |    | Wireless (Bluetooth LE) | ELM327 | 30~60 minutes |
| Make | Model (Chassis) | Year | Variant | Notes |
|---|---|---|---|---|
| Subaru | WRX (VB) | 2024+ |     | |
| Subaru | WRX (VB) | 2022-2023 |     | |
| Subaru | WRX (VA) | 2015-2021 |   | Tested on MY2018 Currently in closed beta |
| Subaru | WRX STi (VA) | 2015-2021 |  | |
| Subaru | BRZ (ZD8) | 2021+ |   | |
| Toyota | GR86 (ZN8) | 2021+ |   | |
| Toyota | NXP-based | 2022+ |   | |
| Honda | NXP-based | 2022+ |   |