# Atlas Documentation This book organizes software documentation for Atlas, covering features and tools inside the program. # Table Editor # Using the Table Editor #### Table Editor The Table Editor is a critical view in Atlas. Using the Table Editor, you can change calibration **lookup** **tables** and modify ECU behaviors resulting from their computed values. Most, if not all, recalibration done on your ECU will happen from within the Table Editor, so it is crucial to understand its capabilities and how to navigate around it. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/OAhQq6zepqClth3t-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/OAhQq6zepqClth3t-image.png) #### Menu Bar The **Menu Bar** contains a few options to load, save, and edit the table you are editing. The **Live Editing Status Area** on the right-hand side of the Menu Bar shows you the current state of live editing in the Table Editor. If a red **"LIVE"** box appears, then any changes you make in the Table Editor will be immediately reflected on the ECU, so be careful when making changes. Sometimes, you might see a yellow **"Resync"** label. Click this label to redownload the ECU's table copy so you can return to a LIVE session, but beware: any local changes will be lost. For more information and diagnostics on Live Editing, see the documentation page: #### Toolbar The **Toolbar** has a series of quick actions that you can perform such as exporting the table data, and performing mathematical operations on **selected cells**, such as adding values or averaging them. The **Calibration Area** on the right-hand side of the Toolbar allows you to quickly change the Table Editor between different calibrations in your project. Most of the time, you only want to edit **Global Calibration**, which has its own dropdown in the **Atlas Toolbar** outside the Table Editor in the main Atlas window. However, you can change each Table Editor independently as you work. Keep in mind that when the **Global Calibration** changes, any Table Editors that are currently selected to that calibration will also update to the newly selected Global Calibration. Any Table Editors that have selected a different calibration than the Global Calibration will not track the Atlas Global Calibration as it changes, unless the Global Calibration being changed from agrees with the Table Editor's calibration. #### Table Area ##### X Axis / Y Axis The axes for the table are listed alongside the table contents and scroll with the table cell data as you pan/scroll through it. Right-click on an axis's header to edit its contents. **Be very careful!** **Atlas will allow you to edit any Axis, even if it might be dangerous.** Editing axes can cause unintended behavior in the ECU; we recommend double-checking with our community (i.e. Discord) before editing axis data in your ECU, unless you know what you're doing. ##### Table Cells The Table Cells for the table is the large area in the center of the Table Editor. In this area, you can perform several actions and modify table cell data unless the currently selected calibration is marked as **read-only**. When Table Cells change, they will flash a certain color depending on what has been updated. Cells flash yellow when they have updated the calibration (or "ROM") only, as in the case with offline work, but flash green when the data has also been updated on the online ECU in a live session.
**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+8Type 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**iType 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.
Selection in the Table Editor can either be **Simple** or **Complex**. The following table breaks down these two selection modes:
**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.**
[![Screenshot 2024-11-07 at 2.43.41 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/OvY1SvSPwuUofrWl-screenshot-2024-11-07-at-2-43-41-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/OvY1SvSPwuUofrWl-screenshot-2024-11-07-at-2-43-41-pm.png) [![Screenshot 2024-11-07 at 2.45.08 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/sK1dsTJLM518lDUK-screenshot-2024-11-07-at-2-45-08-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/sK1dsTJLM518lDUK-screenshot-2024-11-07-at-2-45-08-pm.png)
# Interpolation #### Interpolation in the Table Editor **Interpolation** is a feature in Atlas that allows you to effectively smooth table cell data. Using interpolation, you can create gradients that prevent the ECU from suddenly "jumping" in values, helping to avoid detonation and create a smoother driver experience across a map. Interpolation relies on **Complex Selections** for more advanced calibration editing. Due to the internal algorithm being based on complex selections, Interpolation enables you to quickly design a map in fewer interactions with the editor and speeds up your workflow. ### Basics ##### Horizontal/Vertical Smoothing Take the following table as an example, it is an ignition timing table will all values set to 0: [![Screenshot 2024-11-07 at 3.15.59 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/eJTud2CBuZCjcEOK-screenshot-2024-11-07-at-3-15-59-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/eJTud2CBuZCjcEOK-screenshot-2024-11-07-at-3-15-59-pm.png) Let's begin by selecting an area of the table and setting the values to **5** degrees: [![Screenshot 2024-11-07 at 3.16.48 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/LQuVrCvwcQrkX8kd-screenshot-2024-11-07-at-3-16-48-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/LQuVrCvwcQrkX8kd-screenshot-2024-11-07-at-3-16-48-pm.png) Holding down the **Ctrl**/**Cmd** **key** on our keyboard, we will **click** on another cell, such as 2.34g/rev x 2000RPM: [![Screenshot 2024-11-07 at 3.18.07 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/nmWXlPRerbyd3O9Q-screenshot-2024-11-07-at-3-18-07-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/nmWXlPRerbyd3O9Q-screenshot-2024-11-07-at-3-18-07-pm.png) A **Complex Selection** has now been started. As you can see, a duplicate-sized column has now been selected in the area we clicked. Now, press the "i" key on the keyboard to immediately interpolate the **empty space** between the two highlighted columns: [![Screenshot 2024-11-07 at 3.19.24 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/ULOT7NQjS3TYRdOm-screenshot-2024-11-07-at-3-19-24-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/ULOT7NQjS3TYRdOm-screenshot-2024-11-07-at-3-19-24-pm.png) As we can see, the table has been interpolated in the **empty space,** smoothing from 5.00 degrees to 0.00 degrees. The highlighted columns did **not change,** as they are treated as **anchors** in the interpolation algorithm. ##### Corner-Based Interpolation A typical use-case for interpolation is interpolating corners of a table. In this example, we'll interpolate 4 corners and create a blended map between them. Selecting the 4 corners desired for interpolation by holding the **Ctrl/Cmd** key and **clicking** on each **anchor** of the area to interpolate, press the "i" key to immediately interpolate the area of the box using the anchors as waypoints for the operation: [![Screenshot 2024-11-07 at 3.24.22 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/qs2o1ZxL61aD4lso-screenshot-2024-11-07-at-3-24-22-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/qs2o1ZxL61aD4lso-screenshot-2024-11-07-at-3-24-22-pm.png) [![Screenshot 2024-11-07 at 3.25.34 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/UQex2pcmsoGwbAzG-screenshot-2024-11-07-at-3-25-34-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/UQex2pcmsoGwbAzG-screenshot-2024-11-07-at-3-25-34-pm.png) ### Advanced ##### Smoothing with a Waypoint By selecting **multiple** columns (*or rows*), we can create a way-pointed interpolation. The values under the 0.94 g/rev column will be unchanged, and will instead be used to interpolate the values to the left and right as they approach the other anchors at 0.63 g/rev and 2.03 g/rev. [![Screenshot 2024-11-07 at 3.27.50 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/EE8VaKGVw5hFLERF-screenshot-2024-11-07-at-3-27-50-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/EE8VaKGVw5hFLERF-screenshot-2024-11-07-at-3-27-50-pm.png) [![Screenshot 2024-11-07 at 3.29.06 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/7RaM7KfxeUkRP5bz-screenshot-2024-11-07-at-3-29-06-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/7RaM7KfxeUkRP5bz-screenshot-2024-11-07-at-3-29-06-pm.png) ##### Multiple Waypoints In a very common scenario, you may want to create a map from a series of waypoints as shown. In this example, we select each cell using the **Cmd/Ctrl** key and use the "i" key to quickly interpolate between each of the waypoints. [![Screenshot 2024-11-07 at 3.30.40 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/aAcDT3WfE3q3QZaK-screenshot-2024-11-07-at-3-30-40-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/aAcDT3WfE3q3QZaK-screenshot-2024-11-07-at-3-30-40-pm.png) [![Screenshot 2024-11-07 at 3.32.02 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/oQZQj7CEW2EUu11m-screenshot-2024-11-07-at-3-32-02-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/oQZQj7CEW2EUu11m-screenshot-2024-11-07-at-3-32-02-pm.png) [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/IHsSVNrs42mJn2Sn-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/IHsSVNrs42mJn2Sn-image.png) # Reverting to Another Calibration If you would like to revert your changes in the current calibration to another calibration, you can always **Apply a different calibration** by clicking *Edit -> Apply different calibration...* [![Screenshot 2024-11-07 at 3.37.31 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/dfsIv6d0vQY8iInb-screenshot-2024-11-07-at-3-37-31-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/dfsIv6d0vQY8iInb-screenshot-2024-11-07-at-3-37-31-pm.png) The default selection in the **Select Calibration** dialog box will always be the **Base Calibration** you set for the current calibration, if applicable, for faster reverting: [![Screenshot 2024-11-07 at 3.38.14 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/L4cDlLNdtQsJDRYw-screenshot-2024-11-07-at-3-38-14-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/L4cDlLNdtQsJDRYw-screenshot-2024-11-07-at-3-38-14-pm.png) The calibration will be updated. Note that only **selected cells** will be changed. In this case, **Ctrl/Cmd+A** was used to select the entire table before the operation took place: [![Screenshot 2024-11-07 at 3.38.27 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/S3fqXVbhI0vfFrW6-screenshot-2024-11-07-at-3-38-27-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/S3fqXVbhI0vfFrW6-screenshot-2024-11-07-at-3-38-27-pm.png) # Flashing # Flashing a Calibration #### Introduction

**2023+ WRX MT Users** If you are using Atlas 2024.4 or earlier, recovery is not possible on these ECUs. Atlas **2025.1** and later resolves this issue upon first programming with the ECU.

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 [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/mgniBpOIo9UmzmeE-image.png)](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. #### Procedure

Atlas 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, [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/6rOwQ0m1mblIR0re-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/6rOwQ0m1mblIR0re-image.png) After a brief period, you will be greeted with this prompt, [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/3JDwtqdyixN0eZuJ-image.png)](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.** [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/F2uPLqUpH3JeE7HA-image.png)](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: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/NibElgW5jA0J4oXG-image.png)](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.** [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/FGn9Z0WD6OvXS7O6-image.png)](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 first see our [flash recovery procedures page](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flash-recovery), as Atlas 2025.1 and later ships with a **brick protection** feature in most supported models. It is exceedingly difficult to truly brick an ECU with Atlas. 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 **Atlas Recovery Feature**

Due to the nature of the Atlas brick protection feature, CAN bus devices on the car will not be able to communicate with the ECU and will likely light up your car's dashboard warning lights like a Christmas tree. This is fine, and should resolve after a complete flash and key cycle.

Atlas 2025.1 now ships with a brick protection feature. Due to its position within the bootloader, this feature is always accessible, even if the programming was incomplete or the tune contained bad code. Atlas will always try to reprogram the bootloader first, so even if it was your first time flashing the vehicle and it has ended up bricked, there is a good chance the feature is already installed. To access this feature on an ECU that has been flashed previously by Atlas , first turn off the vehicle. Then, press and hold the Cruise Cancel switch on your steering wheel. Wait approximately 30 seconds. While holding this button, enter accessory 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. The Cruise Cancel button can now be released. This will activate an Atlas recovery feature in your ECU's bootloader, and the ECU will immediately enter recovery mode. At this point, you can follow the procedures in this document. This feature can be activated at any time under any circumstances as long as the vehicle has battery power. To cancel this recovery mode if the ECU is not bricked, simply key cycle the car. If the above does not work and you have flashed the ECU with Atlas before, it is possible either the bootloader is truly bricked (see **Unusual Circumstances**). **Unusual Circumstances** 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. #### Procedure

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.

To enter Recovery Mode in Atlas, use the main menu to click **Help -> Enter Recovery Mode**. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/RqGRjVwL9u4MDd0f-image.png)](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**, [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/mCY6p2RYTNT9Gha9-image.png)](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, [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/6rOwQ0m1mblIR0re-image.png)](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, [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/3JDwtqdyixN0eZuJ-image.png)](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.** [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/F2uPLqUpH3JeE7HA-image.png)](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: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/NibElgW5jA0J4oXG-image.png)](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.** [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/FGn9Z0WD6OvXS7O6-image.png)](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 [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/mgniBpOIo9UmzmeE-image.png)](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 EEPROM

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 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**: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/rUqjtFqpcWEXovQ5-image.png)](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**: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/ntCi9dWG5ymtlpbV-image.png)](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. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/gzgu2909PfFHrTBK-image.png)](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: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/ltXSasu33FWmHBix-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/ltXSasu33FWmHBix-image.png) #### Step 2: Uploading EEPROM

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 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**: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/UMZkJSjuoAKiHyOs-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/UMZkJSjuoAKiHyOs-image.png) Select an EEPROM binary file that was previously downloaded from another ECU: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/fY4VqSwE1uNXE80t-image.png)](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**: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/UEL8xS8m2iey6GNQ-image.png)](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: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/fFMyTPvCESR3O4vu-image.png)](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: [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/h63prcZw6prLb28N-image.png)](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**. # Flash Support Table ## Atlas Flash Support #### USDM WRX Manual Transmission Support
**Vehicle** Year, Market, and Model **Flash Support** See: [Flashing Page](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flashing-a-calibration)**Recovery Support** See**:** [Flash Recovery](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flash-recovery)**"Brick" Recovery Support** See**:** [Flash Recovery](https://docs.motorsportsresearch.org/books/atlas-documentation/page/flash-recovery)
2015 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2016 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2017 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2018 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2019 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2020 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2021 USDM Subaru WRX MTAtlas 2025.1 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2022 USDM Subaru WRX MTAtlas 2024.4 or laterAtlas 2024.4 or laterAtlas 2025.1 or later
2023 USDM Subaru WRX MTAtlas 2024.4 or laterAtlas 2025.1 or laterAtlas 2025.1 or later
2024 USDM Subaru WRX MTIn ProgressIn ProgressIn Progress
# Picking a Calibration to Log and Flash ### Atlas and OEM Calibrations #### Officially Supported Calibrations ##### What is officially supported? Atlas provides at least one unmodified OEM calibration for every supported vehicle. Atlas does not ship with any pre-loaded, modified ("off the shelf") maps. For these off-the-shelf calibrations, please check in with our community for community-developed OTS maps; Discord is a great place to ask. They are typically well-tested and will be a great platform for you to start from. In order to make the process of development easier, Atlas only supports the latest calibration from the manufacturer for each particular vehicle configuration. This is the standard procedure for most modern tuning softwares. For example, if your vehicle is a 2022 USDM Subaru WRX MT, there will be a specific calibration that represents the most up-to-date ROM that exists for your ECU, and this is the calibration that Atlas will provide and support. ##### What if the OEM releases a new calibration? As new calibrations are released by the OEM and NAMR is made aware of these, we update Atlas to support them and release new versions of the software package accordingly. As this takes place, older calibrations are removed from the pre-loaded list to deter our end-users from programming these out-of-date calibrations. This same process takes place in the OEM software packages provided to dealerships; as new bundles are made available to dealerships, older calibrations are removed from rotation by the OEM. However, any prior supported calibrations will continue to be supported for backwards-compatibility for flashing and logging alike. Our official stance is that when you find yourself in this situation, you should promptly rebase your tune onto the latest calibration available from the OEM. We strongly encourage this, as newer calibrations quite often involve **recalls** for various nuisances and potentially serious safety issues that have been identified. If you live in the United States, you can typically see what issues are being addressed in newly released calibrations by searching for safety bulletins on the NHTSA website: [https://www.nhtsa.gov/recalls](https://www.nhtsa.gov/recalls). #### Older Calibrations ##### What makes a calibration "old"? As OEMs identify issues in their released calibrations, their corresponding software vendors supply updated calibrations to both the factory and the dealership network through internal processes. This activity from the OEM is typically seen as frequently as a quarterly basis and will even take place even after a particular model year of a vehicle has been retired, as deemed necessary by the feedback the OEM is receiving on their active calibrations. What this means for you is your target vehicle may be running a calibration that - even if tuned - is presently out-of-date. While Atlas will recognize this calibration on the vehicle, it is likely that if it is old and out-of-date (super-ceded by a newer calibration), it is **unsupported** for both logging and flashing. ##### What do I do if my vehicle is on an unsupported calibration? Although your calibration may be presently unsupported by Atlas, that doesn't mean you can't replace it with a newer calibration so you can log and tune your supported vehicle. If you'd like to keep a copy of your old calibration for any reason, see our page on [Cloning an ECU](https://docs.motorsportsresearch.org/books/atlas-documentation/page/cloning-an-ecu). You won't be cloning the calibration to another ECU, in this case, but that documentation page covers downloading it so you can preserve it somewhere if you ever want to flash it back to the ECU for any reason. It is worthwhile stating that this step is not strictly required to tune your car with Atlas. Then, you can start by flashing the latest calibration for your car to the vehicle with Atlas. This will give you the same result as if you had dropped your car off at the dealership for recall service on the ECU. Once you're on the latest OEM calibration, you're all set to start logging with Atlas if you would like to collect base-line logs. From there, we recommend copying and modifying your base calibration to create your own tune, so the pre-shipped, latest OEM calibration remains unmodified if you ever need it. ##### Why does Atlas not support these? When OEMs release new calibrations, we often see that the **offsets** for ROM elements such as tables, parameters, and so forth will change in unpredictable ways. Although the reason isn't significant to us, this could possibly be due to the unique development workflows each OEM implements to release any given calibration. Atlas has an extensive set of modern tools, workflows, and automations built in to the software that enable the development team at NAMR to quickly adopt support of new calibrations by generating definitions against an unknown, new ROM file. However, nothing is perfect, and we take our quality assurance of definition accuracy very seriously. It is our policy that we will invest our time in **new** calibrations, but we do not extend support for calibrations that pre-date the initial support date of a given vehicle model on Atlas. This means: if Atlas supports a 2022 USDM WRX MT on July 1st, 2024, any calibrations that were released prior to the calibration that was the latest as of that date are **unsupported**. It really boils down to **time** and **alignment with OEM** to uphold safety and emissions standards. It takes time for us to bring in a new calibration, and we can't guarantee a uniform experience across our supported calibrations if we spread our development team thinly over several definitions for every single model. Having one supported calibration per model streamlines our development workflow so we can keep developing great features for our community. # 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. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-12/scaled-1680-/qkTUlSlcTUnGNOvr-image.png)](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. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-12/scaled-1680-/uHpyw0Ug65vubBTi-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-12/uHpyw0Ug65vubBTi-image.png) # Datalogging # Atlas Datalogging Basics #### Introduction Tuning your car, ultimately, is a scientific endeavor. Without accurate data, you have little if anything to inform your decisions (inputs) to your tune as you reform it to meet your goals. **Data-logging** is an important method to receive feedback from the ECM (engine control module) for your engine's current condition and performance as it relates to your calibration (tune) on the vehicle. Typically, a **datalog** is the recording of a series of values (or *parameters*) that are read (or *polled*) from the vehicle at a specific interval, or *polling rate*. Parameters included in a data log might be, for example, the engine speed (RPM), rate of mass air entering the intake tract (mass airflow, or MAF), ignition advance (or ignition timing), the air-fuel target ratio (or commanded AFR), coolant temperature, camshaft phase/timing, and so on. Each of these *parameters* are requested at once by your tuning software, such as Atlas, at a certain frequency schedule typically measured in polls-per-second or hertz (Hz). The higher the polling rate, the higher the precision is in the time domain for logged values. The ECM records these values to Atlas by first briefly pausing the execution of the ECM logic, reading every value requested, and assembling all requested parameters in a single **frame** that is transmitted back to Atlas over the vehicle's communication system (typically the CAN bus). Atlas then records the date and time that the individual frame was received and adds it to the list of frames, which together form the recording. The same system that is used to display gauges in Atlas is used for data-logging. The difference is these received (polled) frames are recorded for later viewing, as opposed to gauges which only use any given frame to update the gauge's corresponding parameter value and throw away the received data after it has been displayed on screen. #### Atlas Gauges The Atlas workflow separates parameters (things we define for you) as objects you can parameterize and log, called **gauges**. In Atlas, gauges -- though each based their own parameters -- are what are used for recording, not parameters themselves. You can customize gauges to your preference, including their theme, style, alarms (i.e. flashing), and scaling limits. To further help you organize your workspace, your customized gauges are grouped into something called a **gauge set**, or a collection of your gauges. To access your gauge sets, look to the right of Atlas. If the panel is closed, you will notice a vertical strip of tabs, one of which is called **Gauges**. Click this to open your gauges and gauge sets.
[![Screenshot 2025-02-27 at 3.49.39 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/0GVHiuTrYl5GtALC-screenshot-2025-02-27-at-3-49-39-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/0GVHiuTrYl5GtALC-screenshot-2025-02-27-at-3-49-39-pm.png)[![Screenshot 2025-02-27 at 3.48.02 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/RscRGxBPS2wG4mtl-screenshot-2025-02-27-at-3-48-02-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/RscRGxBPS2wG4mtl-screenshot-2025-02-27-at-3-48-02-pm.png)
Gauge sets can be used to organize your workflow and the parameters you want to see when you are tuning on the weekend, driving to work, or perhaps logging on a track day. Some users prefer to have just one gauge set, while others prefer to have multiple for troubleshooting difficult tune problems that require one of our plethora of development-level parameters to trace. To add a gauge, use the ![Screenshot 2025-02-27 at 3.50.01 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/7pdqYs3C2xL4nRMz-screenshot-2025-02-27-at-3-50-01-pm.png) button.
[![Screenshot 2025-02-27 at 3.51.19 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/jVEV1IIbICgdhr1f-screenshot-2025-02-27-at-3-51-19-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/jVEV1IIbICgdhr1f-screenshot-2025-02-27-at-3-51-19-pm.png)
**Option****Description**
ParameterThe parameter to drive this gauge.
Display NameThe name shown on the gauge. Atlas will automatically trim folder names if this is unchanged.
Gauge SizeOverride your default gauge size in Atlas with this option.
Minimum & MaximumThe bounds shown on dials and bars (not the text shown on the gauge, which is always the current value).
Low AlarmThe low value, below which the gauge will enter the alarm state and start flashing red.
High AlarmThe high value, above which the gauge will enter the alarm state and start flashing red.
Start Data Logging on AlarmImmediately begin a data logging session (if not already recording) when the Low or High alarms are triggered.
Flash Warning when ReleasedFlash the gauge with a yellow border for approximately one second when the gauge has exited the alarm state.
#### Atlas Datalogger

To open the Data Logging window, press **Control + D** (**Cmd+D** on MacOS) or click the ![Screenshot 2025-02-27 at 3.21.53 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/yIJht0rmviwYI8v1-screenshot-2025-02-27-at-3-21-53-pm.png) button in the Atlas toolbar.

The Atlas Datalogger makes recording and viewing datalogs easy. At a high level, these are the headline features of the Atlas data logging ecosystem and why we think you should use it: - Snappy, hardware-accelerated, optimized data and graphics pipeline based on OpenGL capable of easily presenting and navigating logs in excess of 30 minutes in length at any polling rates. You can load up our data-logger with well over 100,000 data-points on commodity hardware with next-to-zero screen lag on battery power. - Community-friendly unencrypted Atlas Datalog Format (\*.ADL file) that flexibly allows you to share your compressed logs for opinion and review with our community members. - Track grouping and splitting that saves your grouping preferences for future logs. - Easily export CSVs that can be imported into websites like [https://datazap.me/](https://datazap.me/). - End-to-end 64bit nanosecond resolution from the recording, to the saved format (.ADL), to the rendered view. - 32-bit floating point resolution for all parameters. - Automatic unit conversion to your Atlas preferences (see File -> Atlas Settings). - Live viewing while recording is on-going. - Tailored interpolation style for the time axis based on the individual precision of each logged parameter. - Automatic Y axis scaling and grouping for all parameters in a track. Parameters in a track with equivalent units will automatically be scaled relative to each-other, while other units will not. - Strong emphasis on a dark theme and designed to reduce judder and flashing to make it easier on your eyes when you're tuning late at night. - Design & create your own analytical/mathematical formulas to mix any data-logged parameters together, and add them post-recording as their own tracks with full support for all actions across the data logger. - Quickly generate beautiful 3D scatter plots and histograms from any logged data for deeper analysis. #### Main Layout [![Screenshot 2025-02-27 at 3.13.41 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/IIRqqMSTDFXi3mYu-screenshot-2025-02-27-at-3-13-41-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/IIRqqMSTDFXi3mYu-screenshot-2025-02-27-at-3-13-41-pm.png)
**Area** **Description**
**Menu**Access actions in the Data Logging window, such as loading and saving datalogs, exporting CSVs, changing the view of the displayed log, and generate tables and charts.
**Toolbar**Offers quick actions such as recording a new datalog and navigating around the current log.
**Time**Shows the currently shown timespan, in seconds, for the visible portion of the current log, and also a time delta if a marker has been placed.
**Tabs**Allows you to open multiple logs at once and quickly switch between them. Each log occupies its own tab.
**Tracks**A datalog is comprised of parameters in tracks. Tracks are stacked vertically on top of eachother in the datalogger, and by default are sorted alphabetically. These tracks may optionally be grouped together by control + clicking them and right-clicking them to group them.
**Hovered**As the cursor is moved (or "scrubbed") across the log horizontally, a marker is shown that interpolates the value at the hovered location for all tracks.
**Clicked**When an interesting point in the log is identified, click once with your mouse to place down a *marker.* Markers are useful to keep yourself aligned in the datalogger.
**Legend**A legend is shown in each track to indicate which parameters are shown in the track. Each label's vertical position corresponds to the vertical positioning of all values shown next to each marker as you scrub your mouse or place a marker to make it an easy way to reference which value is which in a grouped track.
**Ticker**A ticker is shown at the bottom of the log to help keep you oriented and referenced to the timing of events in your log. All logs start at 0 (zero) seconds and extend for the duration of the recording to the right.
#### Scatter Plots & Histograms ##### Scatter Plots In order to provide you with more insight into your data, Atlas offers the ability for you to generate [scatter plots](https://en.wikipedia.org/wiki/Scatter_plot). By plotting each data frame as a shaded point on a 2D surface, Atlas can give you insight to three mixed dimensions of data at once. To generate a scatter plot, right-click a track in the main data log view and click "Plot Scatter." The parameter you select will be preloaded into the X, Y, and Value (shading) fields, and you can refine your scatter plot from there. Right click on the plot to also save the plot as a PNG file. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/TbH98zc7TFkKqjFf-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/TbH98zc7TFkKqjFf-image.png) ##### Histograms Similarly to Scatter Plots, right-click a track in the data log view to plot a histogram. [![Screenshot 2025-02-27 at 3.41.00 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/scaled-1680-/oLOppwIam1G0eelr-screenshot-2025-02-27-at-3-41-00-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/oLOppwIam1G0eelr-screenshot-2025-02-27-at-3-41-00-pm.png) # Navigating Atlas & Parameter Names #### Introduction When designing or data-logging a tune, it is important to not only record accurate datapoints and modify the right tables, but it is also critical that you understand what each data stream (or parameter) and table is referencing. For example, data-logging a "**Ignition Timing Base Final**" parameter is not referencing the same ignition timing value as logging your tune's "**Ignition Timing Commanded Final**" parameter. ***Base*** Final =/= ***Commanded*** Final. Atlas as a platform is designed to emphasize very granular access to ECU logic, and therefore the definitions we release to the public are often more detailed and expansive than you may be familiar with on other platforms. Due to the increasing complexities of modern ECUs, we choose to offer definitions that give you more access in between distinct pipeline elements of all tuning areas we support. Our objective is to give you everything you need to work around OEM behavior and logic and be able to ground your understanding of the ECU logic in lower-level parameters if you choose to do so. Having more data points to log and more tables to edit does introduce a steeper learning curve, and so our definitions can be more confusing to navigate and comprehend quickly and may take longer to get familiarized with. However, we do have several systems in place that will assist you in getting comfortable with the Atlas workflow. #### Navigating Atlas ##### Advanced Parameters [![Screenshot 2025-03-25 at 11.51.47 AM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-03/scaled-1680-/5f5hWNzQoZNRQg4G-screenshot-2025-03-25-at-11-51-47-am.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-03/5f5hWNzQoZNRQg4G-screenshot-2025-03-25-at-11-51-47-am.png) We have a system that allows you to filter generally unimportant tables and parameters. For these unimportant items, we will mark them as **advanced**. By default, Atlas doesn't show advanced parameters and tables as most tuners are not trying to get quite as specific as these elements offer. You can either choose to show or hide these based on the level of granularity you are looking for in your tune by using the **Show advanced** button in the project tree tab. Here are some examples of advanced items: - Tables (or maps) that are seldom, if ever, modified in a general street tune, but have some theoretical benefit or purpose to very specific applications or scenarios. - Flags or modes that are generally only needed when diagnosing specific tune logic issues, such as operating mode numbers, esoteric low/high signals, or decision outputs needed during development of the definition for quality assurance purposes. - Parameters that are highly granular, such as those used between pipeline stages. An example of this might be the "Table" output of a table that has been directly computed by the ECU, perhaps after blending operations (i.e. TGV & AVCS). ##### Documentation Graphs [![Screenshot 2025-03-25 at 11.51.12 AM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-03/scaled-1680-/JhYPWq7eyJ1rMhDI-screenshot-2025-03-25-at-11-51-12-am.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-03/JhYPWq7eyJ1rMhDI-screenshot-2025-03-25-at-11-51-12-am.png) Additionally, Atlas is designed with a built-in graph editor that we use to create illustrations of ECU logic for you to explore. Laid out from left to right, several graphs are available in supported definitions that demonstrate the data flow of decisions in specific areas of ECU logic (i.e. Fuel, Ignition, Wastegate, etc.). If you are unfamiliar with tuning a platform, we strongly recommend taking a look at these. If you'd like to look up a table or parameter in a graph, right-click it in the project tree and click **Find in Graph**. This will automatically open the corresponding documentation graph, center the parameter or table you are searching for, and highlight it with a flash of yellow. #### Parameter Names Atlas does not have a strict standard for naming rules, but we do offer a dictionary of terms that assists in developing a loose standard for helping end-users understand what each parameter is intended to imply to you.
**Naming** **Description** **Example**
*Table* or *Base Table* The value immediately after performing table lookup and any associated blending has been applied. For example, in the case of Subarus, this would be the result of all associated TGV and AVCS blending has been calculated on a given 4- or 5-dimensional map. Ignition - Primary - Base Table
*Base* *Base Final* *Final* For different stages of a pipeline, *Base* and its corresponding *Base Final* may be used to distinguish distinct book-ends of a pipeline operation. For example, when combining ignition timing, there may be a "Combine Base" and a corresponding "Combine Final". It is also possible for parameters to be named simply as "Base" and "Base Final" Generally, these values are intended to capture a value **before** (Base) and **after** (Base Final) the ECU performs any of the following calculations: - Switching between two or more inputs corresponding to different possible scenarios (i.e. throttle behaviors such as aggressive start, tip-in, or deceleration) - Compensation (either summing, subtracting, or scaling) due to conditions such as atmospheric effects or driver inputs. - Blocking of certain values based on conditions (i.e. knocking or driver inputs) - Mixing of different values (i.e. averaging or weighing), but not to include blending of higher-dimensional maps such as those using AVCS and TGVs as higher-dimensional axes. Idle - Target Airflow - Base - Base Idle - Target Airflow - Base - Base Final
*Corrected* For referential data in the ECU, and especially for the Mass Airflow (MAF) sensor, *Corrected* is used to name the corrected value of some base parameter, and is generally used by the ECU instead of a corresponding base parameter for its own calculations. Airflow - MAF - Mass Airflow Corrected (g/sec, uint)
*Primary* *Secondary Alternate A, B, C,* etc. These are placeholder names that names a parameter whose behaviors and relevance have been yet-uncharacterized.
*Target* *Target* is used to name a parameter that the ECU will reference through some other proportional/integral control system; this is also knows as the **set-point** in closed loop control systems. Targets are not commanded to the hardware electrically. A target might be, for example, the target **airflow** used to determine the commanded throttle position. Note that in this example, the target isn't commanded to the hardware, but the throttle position references the target and is commanded instead. Another example would be **boost**. Boost pressure cannot be commanded; instead, the waste-gate position is 'Commanded' by using the boost target and target torque as a wastegate position table that is then adjusted through its own closed (or open) loop control system, referencing the 'Main Boost Target' table as the set point. Targets may themselves be split into their own *Target* *Base* and *Target Final* sub-parameters. In these cases, *Target Final* will be the target that is referenced by the ECU for closed loop control, while *Target Base* is left in the definitions for diagnostic purposes and will likely be marked as **advanced**. Idle - Target Airflow - Target Base (g/sec, ushort) Idle - Target Airflow - Target Final (g/sec, ushort) Fuel - Targets - Closed Loop - Target Final (λ, ushort)
*Commanded Final* For parameters that involve digital to analog conversion (DAC), such as ignition timing and fuel pulse width, *Commanded Final* references the last available value before the ECU physically commands the associated hardware elements to take action. No other modifications or alterations of the value takes place in the pipe-line after this point. In the case of ignition timing, this would be the amount of time referenced to determine a timer delay for ignition spark from the MCU. For direct injection fuel platforms, this would be the pulse width of the signal sent to the injectors through any associated amplification hardware present on the ECU. Fuel - Pulse - Commanded Final Ignition - Commanded Final Airflow - Turbo - Wastegate - Position Commanded Final
# Project Tree # Support Detailed adapter and vehicle support information # Installation # Using a Tactrix with Windows Atlas uses it's own built-in device driver for the Tactrix OpenPort 2.0. When using Atlas with a Tactrix in a Microsoft Windows environment, the adapter should appear in Device Manager as a **Communications Port (COM**\***)** under the **Ports (COM & LPT)** device category. [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/cYmieZYgrxsSTnCX-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/cYmieZYgrxsSTnCX-image.png)

Atlas will not be able to successfully communicate with the adapter if it appears under the **Vehicle PassThru Interfaces** category as a **Tactrix Openport 2.0 J2534 Vehicle Interface**. [![Incorrect configuration](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/b8C5UtWCL05Q9CFr-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/b8C5UtWCL05Q9CFr-image.png) The Tactrix drivers must be uninstalled in order to proceed.

#### Driver Removal Steps 1. Right click on **Tactrix Openport 2.0 J2534 Vehicle Interface** 2. Select **Properties** 3. Click the **Driver** tab in the Properties window 4. Select **Uninstall Device** 5. Restart your PC upon uninstaller completion # 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.
DevicePlatformConnectionTypeDatalogging Flashing
[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)![Supported](https://flat.badgen.net/badge/icon/Supported?icon=windows&label=Windows&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=apple&label=Mac%20OS%20X&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=terminal&label=Linux&color=green)Wired (USB-Mini B)OpenPort[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/jGEqrptnLbZgcPnx-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/jGEqrptnLbZgcPnx-image.png) 120Hz [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/C0voro3BJVNjvvW1-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/C0voro3BJVNjvvW1-image.png) 1~5 minutes
[OBDLink MX+](https://www.obdlink.com/products/obdlink-mxp/)![Supported](https://flat.badgen.net/badge/icon/Supported?icon=windows&label=Windows&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=apple&label=Mac%20OS%20X&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=terminal&label=Linux&color=green)Wireless (Bluetooth 3.0)STN[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/UjmrqmyMWszFwlZu-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/UjmrqmyMWszFwlZu-image.png) 30Hz [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/abdEoo0QDcEL0tSY-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/abdEoo0QDcEL0tSY-image.png) 15~30 minutes
[OBDLink EX](https://www.obdlink.com/products/obdlink-ex/)![Supported](https://flat.badgen.net/badge/icon/Supported?icon=windows&label=Windows&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=apple&label=Mac%20OS%20X&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=terminal&label=Linux&color=green)Wired (USB-A)STN[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/fP10WL4rWsZxzB3H-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/fP10WL4rWsZxzB3H-image.png) 60Hz [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/C0voro3BJVNjvvW1-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/C0voro3BJVNjvvW1-image.png) 5~20 minutes
[Veepeak OBDCheck BLE+](https://www.amazon.com/dp/B076XVQMVS)![Supported](https://flat.badgen.net/badge/icon/Supported?icon=windows&label=Windows&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=apple&label=Mac%20OS%20X&color=green) ![Supported](https://flat.badgen.net/badge/icon/Supported?icon=terminal&label=Linux&color=green)Wireless (Bluetooth LE)ELM327[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/UBjwPYZU87bMl9Vr-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/UBjwPYZU87bMl9Vr-image.png) 20Hz [![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/scaled-1680-/5tAP2uHHMfYwFrx6-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-01/5tAP2uHHMfYwFrx6-image.png) 30~60 minutes
NAMR is always interested in expanding support to new adapters and hardware. If you have a device you’d like to see supported and isn’t listed here, please check our current [hardware requests](https://github.com/motorsportsresearch/atlas-public/labels/hardware%20request) on GitHub and see if a ticket already exists for the device in question. If one doesn’t exist yet, consider opening a new [adapter or hardware request](https://github.com/motorsportsresearch/atlas-public/issues/new?labels=hardware%20request&template=adapter_request.md&title=). # Supported Vehicles If a vehicle is supported, it may not be complete. Please report any missing tables or desired exposed tables to our GitHub project as a new [issue](https://github.com/atlas-tuning/atlas/issue).
MakeModel (Chassis)YearVariantNotes
SubaruWRX (VB)2024+![In Progress](https://flat.badgen.net/badge/icon/In%20Progress?label=USDM%20-%206MT&color=blue) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=AUDM%20-%206MT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=USDM%20-%20CVT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=AUDM%20-%20CVT&color=purple)
SubaruWRX (VB)2022-2023![Supported](https://flat.badgen.net/badge/icon/Supported?label=USDM%20-%206MT&color=green) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=AUDM%20-%206MT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=USDM%20-%20CVT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=AUDM%20-%20CVT&color=purple)
SubaruWRX (VA)2015-2021![Supported](https://flat.badgen.net/badge/icon/Supported?label=USDM%20-%206MT&color=green) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=USDM%20-%20CVT&color=purple)Tested on MY2018 Currently in closed beta
SubaruWRX STi (VA)2015-2021![In Progress](https://flat.badgen.net/badge/icon/In%20Progress?label=USDM%20-%206MT&color=blue)
Subaru BRZ (ZD8) 2021+![In Progress](https://flat.badgen.net/badge/icon/In%20Progress?label=USDM%20-%206MT&color=blue) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=USDM%20-%206AT&color=purple)
ToyotaGR86 (ZN8)2021+![In Progress](https://flat.badgen.net/badge/icon/In%20Progress?label=USDM%20-%206MT&color=blue) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=USDM%20-%206AT&color=purple)
ToyotaNXP-based2022+![Planned](https://flat.badgen.net/badge/icon/Planned?label=5/6MT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=Auto&color=purple)
HondaNXP-based2022+![Planned](https://flat.badgen.net/badge/icon/Planned?label=5/6MT&color=purple) ![Planned](https://flat.badgen.net/badge/icon/Planned?label=Auto&color=purple)
# Issues/Troubleshooting Atlas is a relatively new software project, and while we strive to provide an easy to use and trouble-free product, errors may still arise. In this event, users are urged to check our currently [known issues](https://github.com/atlas-tuning/atlas/labels/bug). If this is a new issue, please [open a support ticket](https://github.com/atlas-tuning/atlas-public/issues/new?labels=bug&template=bug_report.md) on our GitHub or drop by the [NAMR Atlas Community on Discord](https://discord.gg/tbWJshQvqR).