DIY Wide Band Logger - Version 2.1e The readme file contains last minute information that might not have made it into the actual users guide. In addition, revision information is available at the end of this document. A feature has been added which allows the user to specify the number of samples which will be used when gauge averaging is enabled. This applies to all gauges that have the averging function turned on (by clicking the gauge and selecting averaging in the gauges configuration dialog box). This feature does not affect gauges which do not have the averaging option enabled. Additionally, a feature has been added to the "AutoLog" functionality. Autologging can now be done with a time limit. Once triggered, a user defined amount of time can be used to terminate logging. This feature is accessed under the AutoLog trigger dialog. Matrix analysis mode is displayed as an option during data review mode. (entered by selecting the Review Log button and selecting a data file.). Once the "Matrix Analysis" button has been selected, you will be presented with a dialog box that allows you to analyze the log in a grid style display. First, each of the grid axes must be defined. To do this, you'll need to go into the configuration dialog (by selecting the Configure button) Select one of the fields in each of the drop down combo boxes. For example, you might want to display RPM vs. Manifold Pressure and grid the AFR's at those intersecting cells. The values that are actually displayed in the cells are controlled by the "Field" combo boxes. Additionally, those cell values can be displayed as either the minimum, maximum, or average value for that cell (since a single cell could potentially contain many samples at a given point). Note that this dialog can be resized, and that its size, position, and settings will be saved when the dialog is closed. Also note that if a selection was active in the review graph prior to selecting the "Matrix Review" button, only that selection of data will be considered for gridding in the Matrix Review dialog. (This can be helpfull if you only care about a certain part of the graph). "Hovering" the cursor over any specific cell will also display additional information about the cell. The matrix mode must be configured before using it. The ranges of the rows and columns, and what fields to use are configued in the configuration dialog, which is accessed by pressing the "Configure" button. The number of cells in each axis is defined by the "Number of cells" field (for each axis). Then, the range of each cell is defined below that in the "Cell Ranges" field. The ranges do not need to be contiguous (ie, there may be gaps in the ranges for areas that you are not interested in). Overlapping cell ranges will only display values in the first cell range that is defined. To modify a cells range, simply double click on the one of the ranges in the list, and specify the minimum and maximum values for that cell. Version Log: ------------------------------------------------------------------------- Version 2.1e (6/8/06) - Rewrote the matrix mode review. The user can now define the axes and cell ranges for matrix mode. This is useful for those trying to configure an engine management system and want the cell ranges to match your engine software. - Matrix mode file parsing is now more generic, and no longer linked to the current configuration of TEWBLOGs gauges. Fields are simply scanned from the import file and displayed in the matrix mode in the format that they are stored in the file. - Added min/max cell ranges to be included in the matrix display. Allows you to filter cell values that aren't useful. - Added a copy function to copy the matrix values to the clipboard. These can then be pasted directly into something like Excel or Notepad. - Added support for virtual com ports. Some USB to RS232 adapters do not correctly support native style com ports. If you are having trouble getting your COM port to work, try the following: - Go to the \windows directory - Open the "TEWBLOG.INI" file - Add the following line to the [settings] section: UseVirtualComms=1 Version 2.1d (3/1/06) - Added 0-5v mode for the thermocouple inputs. Note that selecting this will disable the "four EGT mode". Version 2.1c (6/3/04) - Improved the communication protocol parsing, and slightly reduced configuration and startup time. - Added alternate fuel display modes for LPG, Methanol, and Diesel. These modes can be selected in the AFR dialog by clicking on the AFR gauge. - Wideband PID and Heater PID errors are now cleared after 10 seconds. In previous versions, once a PID error had been encountered, it would be displayed until logging was stopped/started again. - Pressing the 's' key on the keyboard will display some of the communication statistics. This includes a running count of the number of PID errors that have been encountered since TEWBLOG was started. - The 3rd User Input can now be configured to be interpreted as an EGT input by TEWBLOG. (Some of the 4cyl guys found this to be useful). To enable this mode, you'll need to add the following line to the TEWBLOG.INI file that's in the windows directory (under the [settings] header): fouregtmode=1 After that, save one of the existing EGT gauge configurations to a file, then load the configuration into the third user input. You'll probably want to change the title of the gauge to something like EGT4 or something too. - AFR and user gauge precision can now be defined in the respective gauge configuration dialogs. Setting the precision to zero causes the value to be displayed as a non fractional value. - The error message that the wideband device cannot be accessed can now be disabled. When the wideband is not connected, the gauges will display a "---" instead of the wideband value. To disable the error message, you'll need to add the following line to the TEWBLOG.INI file that's in the windows directory (under the [settings] header): skipwberrormessage=1 - Added support for 2a1 1mb logging mode. Multiple session support was also added. The user has the ability to select whether or not the sessions are concatinated during download. If the sessions are not concatinated, individual session files will have a suffix designating the session number. ------------------------------------------------------------------------- Version 2.1b (10/27/04) - The Matrix Review mode can now be configured by the user to define the number of rows/columns that are used in the display. Selecting the configuration button at the top of the matrix review gives the user access to the number of rows and columns that will be displayed. - Version 2.1a broke the "Ignore EEPROM data" feature. This has been fixed in 2.1b. ------------------------------------------------------------------------- Version 2.1a (10/21/04) - Fixed a bug where certain logged data frames were being dropped. This affects both the v1.5 and v2.0 Wideband devices. During my initial testing, approx 2-3% of the packets that I logged were being dropped (due to a packet processing error). This has now been fixed. ----------------------------------------------------------------------- Version 2.1 (9/27/04) - Added "Matrix analysis" data mode. Data can now be viewed on a "grid" style display that can analyse the average, minimum and maximum values at specific two dimensional ranges. - Fixed a bug where the "Use Average for Gauge" option was causing the reviewed data to be displayed as '0' in the gauges. - Added "disconnected" mode option. In the configuration dialog, a "none" option has been added to the COM Port combo box. Selecting none will cause TEWBLOG to work in disconnected mode, and it will not attempt to connect to the wideband unit. This is helpfull when you use a system to review data that is not connected to the wideband box. (Connection errors will not be displayed, and TEWBLOG will initialize much quicker!) - Added Thermocouple cold junction compensation. This option is available under the configuration dialog. When selected, the thermocouple temperatures will be adjusted by the setting defined (either in farenheit or celcius). If the thermocouple gauge file you are using is defined in deg.f, use the farenheit option, otherwise, use the celcius option. (V2.0 and above hardware only) - Added PID/Status Error checking for v2.0 and above hardware. The AFR gauge will now display errors related to the o2 and heater hardware that are encountered during logging. PID Errors for either the heater or WB are persisted on the display until logging is restarted so that errors during logging can be detected. - Added ability to set sample rate to 0 for version 2.0 and above hardware. - Added TEWBLOG version number to the log file. - Previously undocumented (oops) the 'm' key on the keyboard will place a mark in the realtime logging graph. - Wideband errors (version 2.0 and above) are now logged in the log file as a 9th field. These errors are also displayed when the log file is reviewed in the graphical result viewer. - The background color for alarms, markers, and now wideband errors is now user configurable. The option is available in the configuration dialog. The background color of the portions of the scrolling graph (and review graph) will use the defined color when a Wideband error, and alarm or a marker has occurred. - Added a config dialog for the Matrix Analysis mode. You can now specify a minimum number of samples that are required in order to display a cell. This can be handy if you're getting "noise" in your data and want to filter out cells that don't have much data available. - Fixed a problem where the gauges were being reset during review mode and leaving the cursor in one place for a while. - Added a feature to increase the precision of the Air Fuel Ratio/Lamba display The number of decimal digits to be displayed can now be configured in the AFR/Lamba configuration screen. - Fixed a problem where negative values in the guage configurations were causing problems with the 2d graph (and occasionally the gauges, depending on your gauge lookup table). (Also was causing problems in the min/max graph settings in the gauge configuration). - Realtime graph averaging did not work correctly for v1.5 widebands in version 2.0c. For v2.0 widebands, this feature did work correctly. This is now fixed for the v1.5 wideband. - Gauges and graph values are now initialized to the value specified at zero volts in the lookup table for each specific gauge. They used to be just set to zero (not the value at zero volts). ------------------------------------------------------------------------- Version 2.0d (8/23/04) - Fixed a problem where the Ignore EEPROM logging option was not correctly re-enabling trace mode after clicking the "Review" data button. ------------------------------------------------------------------------- Version 2.0c (6/23/04) - The filename of the file being "reviewed" is now displayed in the title bar. - Averaging of the real time graph can now be set in the gauge dialogs - Changed the lean limit from 2.0 to 4.0 lambda (about 60:1 AFR) - Added a time limit to the AutoLog feature. The AutoLog can now be limited to a user defined duration. - Fixed a problem where any of the alarm or trigger conditions were setting an alarm/triggering logging (instead of ALL of the conditions needing to be true before triggering). ------------------------------------------------------------------------- Version 2.0b (3/31/04) - Added lots of debug tracing code to help diagnose further problems that might still be occuring with the EEPROM logging mode. The end user can now specify a flag on the command line (you'll need to specify it in the shortcut that you create) called "debugmode". When that flag is found, a logfile called "debuglog.txt" will be created in the TEWBLOG.EXE directory. This log file will hopefully help me to isolate further problems with the software. - EEPROM data downloading in v2.0 and v2.0a was incorrectly calcuating the number of samples available for download, causing a few packets at the end of the capture to be ignored (not downloaded). Now fixed. - Added a warning message that v0100 firmware is not supported. Confirmed problems with the v0100d tech edge firmware. This version of the firmware is not supported because of a bug in its packet formatting. Please upgrade your firmware if you have this version. (www.wbo2.com) - A bug in the Alarm configuration dialog was causing the name of the alarm to be deleted when a .wav file was selected. Now fixed. - A bug in the gauge averaging function was causing averaging to NOT work. Averaging now fixed and the gauge displays can be somewhat stabalized. - User can now configure the number of samples used when averaging a gauge ------------------------------------------------------------------------- Version 2.0a (3/01/04) - EEPROM logging fixed, a problem existed in v2.0 where in some cases data would not be downloaded, and the program continutally prompted to download EEPROM logged data. - Added an option to ignore the EEPROM logged data. The 20A wideband device erroneously reports that there is EEPROM logged data available when there is no EEPROM installed. This caused TEWBLOG to prompt the user to download data from the device that was not acutally available. If you do not have the EEPROM installed for logging, select the check box under the config dialog to disable the EEPROM. ------------------------------------------------------------------------- Version 2.0 (11/20/03) - Fixed peak/hold gauges for the TE-5301 display. Now works! - Added support for the v2.0 Native data mode (version 0029 and above firmware only, note that 0021 will not work!) - Added new guages for EGT and additional v2.0 user input. - Added support for the v2.0 internal timer. Time logs now use the loggers internal time counter to improve accuracy and remove timing latency introduced by the serial port and windows. - Added a "Sample Rate" feature for the v2.0 logger. The sample rate of the logger can now be configured. - Improved graph annotations. Display space now used more efficiently leaving more space for actual graph data. - Added support for downloading "on-board" logged data from the version 2.0 loggers EEPROM (if so equipped). - Added "Averaging" feature for gauge displays. - Added data log review (graphical data log review). - Added AutoLog feature - Added Alarm feature. - Added Start Logging when program started feature - Space bar now toggles logging - Removed configuration of WB voltage vs. AFR calibration (automatically configured now) - Added Lambda display mode option - Fixed a memory leak that would cause a crash after a lengthy data log session. - Under v1.3, using a v1.5 logger, bad packets were not being excluded, and were erroniously being logged along with good packets. Packets with bad CRC's are now excluded from the logged data. - Fixed a problem where slow display update rates were causing problems with lost log data. - Start button now flashes to indicate that logging is active - Default values for the min/max AFR's were incorrect in v1.3 (the min and max values were swapped). This causes AFR's to not be displayed using the default configuration. Default configuration has been fixed. - Added a "quick" graph enable/disable option on the main screen. - Added a serial activity indicator. A blinking cursor at the top left of the screen now indicates serial activity. - Colors for the AFR sweep gauge can now be configured by the user. - Added a "low" display for the peak/hold indicators. (in addition to the already existing "peak" display). - Added large font support. - Now using an installation program. No more manual copying of files! Version 1.3 (10/1/03) - Support added for the TE-5301 display. - Values less than 1 spark per rev can now be entered. (Rev's per spark?) Note that you may need to reset your "Sparks per Revolution" field from previous versions of the software because of this! - Switched to floating point for RPM calculations. This "may" improve RPM granularity. - Added 1ms timestamp to data log. - Moved some of the GUI items on the dialog in preperation for v2.0 gauges and upcomming data log review features. Version 1.2 (9/24/03) - Fixed a problem where RPM wasn't working for anything other than 4 sparks per revolution. - Added validation so that min/max values in the gauge configuration dialog boxes cannot be transposed. Version 1.1 (9/23/03) - Program wasn't running on Windows 95 because of problems with the graph portion of the code being in an OCX. Merged the graph into the main program - Graphs can now be enabled/disabled for invidual gauges. - Color tags added to the gauges to identify the graphs more easily. - Added scaling to A/F "flood bar" gauge - Fixed some graph painting issues Version 1.0 (9/17/03) - Initial Release