Pengaru Performance E6Tuner BETA / DEMO http://pengaru.com -------------------------------------------------------------------------------- (Obligatory) DISCLAIMER E6Tuner comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Running this software should not affect the data stored on your hard drive in any way, your computer should boot off the floppy disk and run from a combination of the floppy disk and RAM, the hard disk is never accessed by the software. You can do serious harm and/or damage to your engine and/or yourself using this software. Care must be taken when mapping your engine, regardless of what software you use. Please avoid tuning while driving on the street. Use of this software is at your own risk. Everything done on this project is for the purpose of writing interoperable software under Sect. 1201 (f) Reverse Engineering exception of the DMCA. Do not bother Haltech Inc. with any problems you may experience with this software. This software, myself, and the Pengaru Performance web site have absolutely no association with Haltech. Should you experience problems with your ECU while using this software, discontinue using the software immediately and see if the problem is reproducable with the original Haltech software before suspecting a Haltech problem and contacting them. If the problem only occurs with this software, contact me. -------------------------------------------------------------------------------- MANIFEST e6tuner_beta_pre15.img: e6tuner beta / demo floppy image, fifteenth release Changes from e6tuner_beta_pre14.img: * Enabled experimental E6X support * Added clipping to TPS engine data, out of bounds (uncalibrated TPS) gets clipped to within 0-100. * Added tweaking of MAP gauge scales on driving gauges page based on what type map sensor being used, makes MAP gauge readable on 2 & 3 bar setups. e6tuner_beta_pre16.img: e6tuner beta / demo floppy image, sixteenth release Changes from e6tuner_beta_pre15.img: * Fixed connection timeout handling crash, also added code for resetting communications after extensive timeouts during communication with the ECU. e6tuner_beta_pre17.img: e6tuner beta / demo floppy image, seventeenth release Changes from e6tuner_beta_pre16.img: * Implemented a anti-aliased polygon filler and changed the gauge needles from lines to triangles. Gauge visibility drastically improved as a result. (still some very minor bugs in the polygon rendering but nothing major) readme.txt: This text file. *.iso: ISO versions of the floppy images * Preferred over the floppy version when a boot-capable CDROM is available. Load time is just a couple seconds and CD's are much more rugged & reliable than floppy disks. -------------------------------------------------------------------------------- MINIMUM REQUIREMENTS * Pentium (80586) class processor * VESA compatible display chipset (most are VESA compatible) * A (S)VGA display (common modes 640x480 up to 1280x1024 supported) * 1.44MB floppy drive (or CDROM drive as of pre13), capable of being booted from * 8MB of RAM * At least 1 standard rs232 serial port for connection to your E6K * A Haltech E6K, preferably Series 8 Firmware revision 14 (E6X support experimental) -------------------------------------------------------------------------------- INSTALLATION FLOPPY IMAGE: The .img file is an 'image' of a bootable floppy disk, you must copy this file to a floppy disk using rawritewin in windows, or rawrite in dos. Or the common utility 'dd' if you are in a unix-like system (Linux for example). rawritewin: http://pengaru.com/downloads/utils/rawwritewin-0.7.zip rawrite: http://pengaru.com/downloads/utils/rawrite2.zip CD ISO: The .iso file is used for 'burning' a cd of your own, if you have a bootable CDROM drive in your computer used for E6 tuning and a CD burner, this is a much better choice than floppies. You will need to use software compatible with your operating system for burning the ISO to a suitable disc. If you are in GNU/Linux, you can use cdrecord to burn with a command similar to this one: cdrecord dev=0,3,0 speed=2 -pad -v -eject e6tuner_beta_pre14.iso Troll (from http://www.zx6e.com) has confirmed success in burning the ISO from Windows using "Nero", a piece of windows software commonly bundled with CDR drives. Make sure you are using the .iso version of e6tuner when burning to CD, an .img file will not work with CD burning! As I get more feedback from users, I will be improving this beta until I feel the code is ready for a full release. During this test -> feedback -> beta release cycle period, I will be preparing new .img & .iso files and making them available here. When you download the file, you will likely want to get the latest one (look at the timestamps in the file listing), you only need to download ONE .img or .iso file to make a usable disk, not all of them. -------------------------------------------------------------------------------- USAGE Once you have the file written to a floppy disk or burned to CD, just boot the computer using the disk/cd with the e6k connected and powered up. After some time waiting for the system to boot, the software will ask you what video mode you wish to use. Select the desired video mode, and what serial ports your E6K and TechEdge 2A0 (use N to disable the 2A0 when asked, if you do not have one), shortly after you will hopefully have gauges live on screen. If your computer does not boot off the floppy disk/cd, you will need to go into the BIOS SETUP and change the boot order so it has the floppy drive or CDROM early in the sequence (before the system disk, usually a HDD). When you are done using the E6Tuner beta/demo, you can simply shut the laptop off without worrying about a 'proper shutdown'. Since the system is booting from the floppy/cd and loaded into RAM, not touching your hard disk, there is no risk of damaging your laptop. If you want to quit the program so you can try a different video mode or serial port, just hit 'q' to quit. It will return you to the video mode selection prompt. See below for a (mostly) complete reference of the keystrokes. KEYSTROKES: (note these are only true for the latest release available, new features add new keystrokes) -GLOBAL- q - Quits E6Tuner TAB - Cycles pages (pages include driving gauges, map editing, diagnostic gauges, and a scope realtime view of engine data (short history)) SHIFT-TAB - Cycles pages in opposite direction of TAB s - starts/stops datalogging (DISABLED IN BETA/DEMO VERSION) -MAP EDITING- SPACE - cycles maps SHIFT-SPACE - cycles maps in opposite direction of SPACE CTRL-1 - spreadsheet editing mode for current map (DISABLED IN BETA/DEMO VERSION) CTRL-2 - 2D editing mode for current map CTRL-3 - 3D editing mode for current map (LIMITED IN BETA/DEMO VERSION) UP - moves selection up one row (when single row is selected, this also moves 'viewport' up with the selection, keeping the selected row visible, the viewport is only present in 2D mode) DOWN - moves selection down one row (when single row is selected, this also moves 'viewport' down with the selection, keeping the selected row visisble, the viewport is only present in 2D mode) RIGHT - moves selection right one column LEFT - moves selection left one column CTRL-UP - grows selection up one row CTRL-DOWN - grows selection down one row CTRL-LEFT - grows selection left one column CTRL-RIGHT - grows selection right one column ALT-UP - shrinks selection up one row ALT-DOWN - shrinks selection down one row ALT-LEFT - shrinks selection left one column ALT-RIGHT - shrinks selection right one column ALT-UP - shrinks selection up one row SHIFT-UP - moves 'viewport' up one row (has NO effect on selection) SHIFT-DOWN - moves 'viewport' down one row (has NO effect on selection) SHIFT-= - increments values within the selection (by 5% of total range) (ALTERS MAP DATA!) NOTE: the key is = because the keyboard is used in RAW mode, the = key is the + key but for it to output the + scancode you need to hold shift, holding shift however is used to do 5% changes. Just treat = as if it were +. SHIFT-- - decrements values within the selection (by 5% of total range) (ALTERS MAP DATA!) = - increments values within the selection (by smallest step) (ALTERS MAP DATA!) - - decrements values within the selection (by smallest step) (ALTERS MAP DATA!) f - toggles 'follow' mode (viewport automatically follows where the engine is when online) -3D-SPECIFIC- x - rotate about X axis CTRL-x - rotate about X axis (opposite direction) y - rotate about Y axis CTRL-y - rotate about Y axis (opposite direction) z - zoom CTRL-z - zoom (opposite direction) -SCOPE/DATALOG PAGE- n - new window (new window is automatically focused) d - delete focused window space - cycle focused window (nothing indicates which is focused right now) shift-space - cycle focused window in opposte direction of space (see above line) k - show/hide the key N - N is the number identifying a stream in the key, it will add the stream to the focused window, or if the stream is already in the focused window it will remove it. The first two streams added to a window get the left then right scales, any additional streams added are scale-less. backspace - delete last entered numeric character (for use when assigning streams to windows) !!!THE BELOW DATALOG KEYS ARE ALL DISABLED IN THE BETA/DEMO VERSION!!! left - goes back in time (til start of log file is reached) right - goes forward in time (til end of log file is reached) up - increases # of seconds displayed (up to 60 seconds right now) down - decreases # of seconds displayed (down to 1 second) ctrl-left - moves info line back in time ctrl-right - moves info line forward in time home - brings info line into the viewed region In this release the info line does not display any info, it will when finished show the values of the streams where the line intersects the streams, similar to how the dynojet / winpep software shows hp/tq values where the intersections are with a similar vertical line you can move along the X axis. n - assigns n data streams scale to the left scale of the focused window n - assigns n data streams scale to the right scale of the focused window these last two commands are unimplemented and really I'm undecided on including them, it would be nice to have a way for assigning the scales if you've assigned more than two streams to a window... i - Toggles display of the information for visible streams @ the intersection of the vertical 'cross section' line. ALT-0...9 - Switches datalog pages, selecting between 10 pages (0-9) Page 0 is reserved for the realtime/history continuous 15 second datalog, pages 1-9 are available for loading datalogs which have been saved. CTRL-l - Loads a datalog (if hit while viewing page 0, the page will be changed to the next available datalog viewer page before loading) -------------------------------------------------------------------------------- KNOWN BUGS Using the software on a car with a 2 or 3 bar MAP sensor has not been tested, there are likely some bugs here. Earlier than pre15 releases have issues with the map gauge on 2 and 3 bar map setups, the scales are all cluttered. Latest releases have issues with > 1 bar map sensors in the datalogging page, mainly the scale is not printed correctly when you add the MAP stream to a window. Before pre15 if your TPS is not calibrated, when the value goes out of the range, it will do interesting things. The ECU-specific code parsing the engine data sees the out of bounds value and simply ignores the request so the RPM variable is usually the last one that was set, and gets used for TPS position! very amusing to see. pre15 fixes it so the code clips low and high out of bounds to 0 and 100. Some laptops exhibit a flickering on the screen, the software drives the video hardware as fast as it can (up to the monitors refresh rate, which it syncs to). On some laptops it has been found that the display is not syncing properly, causing some tearing which you would probably also see in high performance / high res games on the same system. There are known crashes when using 320x200 video mode, this mode is present for comical value it's not expected that anyone will actually use it. It should be fast though, if you find your gauges are slow, try the 320x200 mode to see how fast they should be going. From this you can decide if the data feed is fast enough for you to bother with finding a faster laptop for the high res modes. The 'active' cell indicator on some of the correction maps does not move to show the actual active cell... it also may be off slightly on the temperature correction maps as the way it works in the DOS haltech software is kindof strange, it's not linear as one would assume. It has been reverse engineered as best as I can but there may be some minor mistakes. The temperature scale on the correction maps may not be getting plotted correctly, this is associated with the same problem as the active cell indicator being off... these are mostly just aesthetic / technical correctness issues. 3D map editing does not show your selection, this is more an intentional limitation of the BETA / DEMO than a bug. 3D map editing has no scales visible, see above. On at least one machine CD booting has failed with L 20 20 20 20, which is, according to LILO a 'controller failure'. Have not found a fix for this case, but it's only come up once so far and it was an odd desktop machine. E6X support is lacking some of the E6X-specific maps, will be added soon probably by pre17. These maps include secondary fuel/ignition, gas temp/pressure correction, maybe some others I am forgetting, nothing major. AFMV input is assumed 0-1V, code does not currently check if you've configured it to be 0-5V, this is not really a big deal since its just aesthetic.. the ECU spits out a 8 bit value 0-255 for AFMV, wether you've selected 0-1V or 0-5V in the setup only affects the scaling of this 0-255 to 0-1000mv or 0-5000mv in the display of this value, its a linear transform so you can just look at .5V as 2.5 V in the gauge. This will get fixed after I add support for the general setup of the ecus (main/ignition/fuel/pwm configuration). -------------------------------------------------------------------------------- THINGS TO COME / TODO * I will be adding the ability to assign an absolute value when map editing, by typing a number and hitting enter, it will be assigned to all cells selected. I will also be adding a way to increment/decrement the selection by a %age, and a linearize function similar to the DOS software (but this will also support linearizing on 2 axis since I support selecting arbitrary columns AND rows). * Obviously map loading & saving is needed, the code is already there in the backend, just hasnt been hooked into the user interface yet. (sortof requires USB thumbdrive support) * Customizable gauges are in the works, not sure if this will be available in the first full release though. It will be something along the lines of an XML file (similar to a HTML file for web pages if you've edited those) which defines the layout of the gauge cluster, gauge names, fonts, font sizes, colors, hatches, data sources etc. * GPS device support * USB thumbdrive and 'webcam' support (hotplug) * Add 'Associative data' to map editing, mostly for plotting of sampled AFR's in graphs aligned with the fuel and ignition map editing graphs. * Refine follow mode so the selection follows along with the viewport * Add Y scale to 2d map editing, and scales and labels to 3d map editing * Add selection highlighting in 3d map editing * Enable datalogging (to storage) in public version (requires USB thumbdrive support) * Add ability to video capture from a webcam and overlay gauges in the video in realtime while saving video to USB thumbdrive in a compressed form (mpeg?) (requires USB webcam support) * Add ability to datalog GPS coordinates along with all other data streams, add geographic view mode to the datalog viewer code, when GPS coordinates are available in the datalogs the datalogs should be viewable as a track defining the path the vehicle took throughout the log. (requires GPS device support) * Add configuration file for preserving resolution/serial port/ecu model settings etc, this will be stored on the USB thumbdrive. (requires USB thumbdrive support) -------------------------------------------------------------------------------- PROBLEMS Should you have trouble with getting the software up and running, look at the FAQ file in the directory where you downloaded the software from. If you still cannot figure out whats going on, email me: swivel@pengaru.com -------------------------------------------------------------------------------- CONCLUSION I have tried to retain some level of usefulness without giving away too much, you can still edit the maps and in my opinion, even with this limited release, do so much more intuitively than with the DOS software. I hope you enjoy the software, and maybe will consider purchasing the full version when it comes out in the near future. If you have any problems, questions, or comments, don't hesitate to contact me here: swivel@pengaru.com