BRE Usage Basics

This page contains some of the basics to using BRE. If you feel something should be here that is not here, feel free to e-mail me at ogle6@hotmail.com.

Throughout this guide I will use the following terminology:

rom window: the main window of a rom when open. It is the window that contains the fuel and ignition tables.

Menu->Menuitem: denotes a menu item to click.

Table Of Contents

Opening a ROM

BRE supports most OBD0 vtec ROMs, and as of 2.2 beta, BRE supports NG55/60 ROMs as well. BRE does not support the PR3-93 ROMs (93 being the number on top of the old chip) in a decent manner, so should you be the unlucky soul who has one of these ECUs, you are sort of left in the dark. The fully supported PR3 ROM is the PR3-58.

To open a ROM go to File->Open (or Ctrl+O) and then navigate to the ROM of your choice.

Editing a ROM

Map Information

On the OBD0 VTEC ECUs, one Fuel map is for when the car is out of vtec, one is for when in vtec. The values are believed to be the milliseconds the injectors stay open. So a higher number == more fuel.

Likewise with the ignition maps, one is for when the car is out of vtec, and one is for when the car is in vtec. The values are absolute degrees of ignition advance.

On each map, headers at the left are RPM. Headers on the top are vacuum or boost in the intake manifold. Headers that are integers are vacuum in inHg, decimal headers are for boost columns.

The RPM headers/scales are different because of the vtec/non vtec difference. There is more resolution from 500 - 6000 rpm in the non vtec maps and 4000-9000 rpm in the vtec maps. This is because when you are not in vtec you will most likely be between 500 and 6000 rpm, and between 4000 and 9000 rpm when in vtec.

Just for reference, the AFR is NOT indicated anywhere in the ROM itself. You have to tune fuel by observing the AFR through a datalogger or ghetto means and then add or subtract fuel where necessary in the fuel maps. If you have the newest version you will notice a "Target AFR" tab pair. Those are there only for the sake of the editor's auto tune functionality. Editing them will have NO direct effect on the cars tune. They only tell the editor where you want the afr.

The maps are colored for easier viewing. The colors have no other functionality.

Editing Maps

In BRE you can edit one cell at a time by double clicking on a cell, or just typing with a cell highlighted. You can edit a range of cells by highlighting the range to edit, then right clicking anywhere in the map. This will bring up a menu with functions to be used on the maps.

Real-Time Updating with an Ostrich

BRE supports the Moates.net Ostrich PROM emulator for real-time editing. This can be used to update the tune while the car is running. Heres how you get it up and going:

Now you can edit the ROM and have your changes downloaded to the Ostrich while the car is running. In live edit mode, BRE will automatically download changes to the Ostrich.

If you need to rewrite the entire ROM to the Ostrich, there is a Put command (Ctrl+Shift+P or Emulation->Put ROM). This is sometimes faster than the download changes function if you are in manual download mode. To verify that the ROM running the car is the same as the ROM being edited in BRE, you can use the Verify function (Ctrl+Shift+V or Emulation->Verify Rom). This will read the ostrich and compare the data to that in BRE, then report back to you whether the ROMs are the same.

Using the Datalogger

From 2.2beta on, the datalogger part of BRE is associated with a ROM. So, in order to open the datalogger you must make sure you have a ROM open, and that the ROM has the ability to datalog with BRE (All ROMs in the BRE zip file have this ability). The datalogger is accessed through the Tools->Datalogger...menu. This brings up the Datalogger form. Next you must connect to the ECU.

Notes

Using the Real-Time AutoTune

BRE supports real-time AutoTune. To use this you must have the datalogger open, a properly setup wideband o2 sensor run into your ECU (2nd o2 sensor (pin C8) on an obd0 VTEC ECU), and an ostrich emulator emulating in live edit mode. BRE needs to know the afr in order to do this. Using the real-time AutoTune feature is very easy. All you need to do is hit Ctrl+Shift+R (or click the Logger->Start Real-Time AutoTune menu item) with the logger running.

Before you start it for the first time, though, there are some settings in the Auto Tune options dialog you should at least look at. These options are available in the Edit->AutoTune Options... menu on the ROM window (not the datalogger). Also, you need to adjust the target AFR in the main ROM window to your desired target AFR.

First, the basics: each time a cell is hit in the logger, the current, east, south, and southwest cells get assigned a weight based on the interpolation values. So a weight of .20 would be 20% usage of that cell on that sample, a 1 is a 100% weight on that cell, meaning that cell is only being used and the surrounding cells are not being used at all.

The Options:

Notes

The realtime autotune is not for driving fast. Its for tuning cruising, idle and/or gradual changes in rpm and/or map. It cant cope with big transitions because the ecu adds corrections beyond the maps at those times, then the tuner sees the change in afr and tries to adjust the map (which isnt necessarily causing the afr change). I use it to tune 800 - 5000 rpm cruising under different loads. I typically find a nice route with hills and flat portions, turn on the real-time auto tune, then go for a short leisurely drive. I try to stay away from big pulls and big changes in TPS.

Each time a correction is made and you are logging to a file, the correction from the Tuner is placed in a column called "Tuner Adj." in the log file. Its in the format "(column`row) multiplier; (column`row) multiplier;"

An example would be: (1`2) 1.05; (1`3) -1.023;

Using the Log Analyzer

The Log Analyzer is a portion of BRE that enables the tuner to easily look at all the fuel statistics (right now it only deals with fuel) in some previously recorded log file.

The analyzer is accessed in two ways: through the ROM window in the Tools->Analyze Log... menu, and through the datalogger in the Logger->Analyze Current Log... menu item. In the former, you can open any previously recorded BRE log file (.csv), and in the latter, you will be analyzing the file that was most recently logged to.

In the analyzer, there will be 6 tabs: two for the measured mixture, two for the target mixture, and two for the percentage difference between the measured mixture and the target mixture.

The measured mixture tabs contain all of the measured afr/lambda values. In each cell, a weighted average between all of the samples taken in that cell is computed and then displayed. This average depends on the interpolation value taken in that sample as well. So say if a sample was taken at cell 2,3 but the ECU was only using 2% of 2,3 and 98% of cell 2,4 then a .98*afr_in_2,4 will be averaged into 2,4's average and only .02*afr_in_2,3 will be added to 2,3's average. These weights are added up for each cell and if the sum is less than the value in the "Min Freq. Factor" box at the bottom of the form, then the average for that cell is not displayed.

The target tabs contain the target mixture you are looking to get in each cell. At first they will be 20.20 because they have not yet been edited in each ROM. So, you must edit the Target Mixture in each cell to your own values. Editing the target grids is the same as editing the maps: right click for your options.

The percentage difference tabs compute the percentage difference between the values in the measured tabs and the target tabs. This helps the tuner see how far off the tune is. These values are also used by the auto tune function described in the next section.

Values in the cells that do not have colors are guesses made by the analyzer based on surrounding cells.

There are is only one option you can change to change the analyzer's behavior. It is in the AutoTune options (which are in the Edit->Autotune Options.. menu in the ROM window or in the Analyzer->Autotune Options.. menu in the analyzer window):

Using statistical AutoTune

The statistical autotune is used by pressing the button at the bottom left of the Analyzer form. It is assumed that the ROM you want to autotune is open and the latest log from that ROM is opened in the log analyzer. When the button is pushed, the differences in the % Differences tabs are applied to the fuel maps with respect to a couple options available in the AutoTune Options dialog:

Using Scripts

BRE now supports scripting. The scripts are written in C# and are then loaded into the BRE script manager if they are to be used. The script manager can be accessed in BRE from the Extras->Script Manager menu (or F5).

Once opening the script manager you will see a big Load button. Oddly enough this button is used to load scripts into BRE. So to load a script, just click Load and find the script you need to load.

To unload a script, highlight the script in the manager, right-click and click unload. To properly unload scripts in BRE you must restart the application (because of a side effect of .NET's Assembly loading and AppDomain BS).

Loaded scripts are remembered in the loadscripts.app file in the plugins directory, and automatically loaded when BRE is started. If some script is updated, it will be recompiled when BRE is started (scripts don't need to be reloaded when they are updated).

If you would like to learn how to write scripts you must go to the BRE API.


BRE Documentation Home