READ THIS FIRST!!! This document contains important information on the installation and use of this software.

 

Afterburner 3.0

 

The overclocking and performance enhancement utility for the Palm. The tool that meets your need for speed!

 

Older Palm IIIs and some Palm VIIs and other models using non-EZ CPU's are now supported but with a reduced feature set.

 

If you are having problems, please read through the issues at the end of this file. The answer to your problem might be there.

 

Version Changes

 

3.0k

Reduced overhead required in implementation of Gray LCD. More efficient now. Added separately defineable grayscale LCD/n setting.

3.0j

Tweaked clock settings for more precide baudrate generation. Fixed a bug in the Adjust Ticks so that now system frequency is also preserved when Adjust Ticks is not selected. This has some impact with some serial and IR compatibility at certain frequencies when this option was not selected.

3.0i

Added silent notify feature by flashing LCD on speed change (for non-color LCDs only.)

3.0h

Fixed bug in Norm button. The LCD/n checkbox function was inverted, now corrected. Added option for Grayscale LCD/n setting in registered version (for AvantGo and grayscale issues)

3.0g

Now works properly for older Palms running non-EZ CPU's. Added 23MHz stepping for older Palms optimal speed. Fixed LClk/2 so that it actually works. Was not working before. Fixed faulty "Norm" button.

 

Note: After installing, remember to adjust all your speeds up a notch. In particular LClk/2 would now be at 22MHz if it was previously at 24MHz. Set it back to 24MHz and save that.

3.0f

Added option for forcing LCD/n to 1 when going below 16MHz. This will reduce screen flicker at low speeds. Removed options for CS0 and CS4 as these don't seem to do anything useful. Added non-EZ CPU compatibility (preliminary)! Fixed error when leaving Speeds panel by means other than OK or Cancel button. Changed app name from "Afterburner Hack" to "AfterBurner Hack". Improved serial behaviour? Hope this doesn't break IR support. Addressed a Hackmaster bug that resulted in strange exceptions after Afterburner was disabled under some conditions.

 

VERY IMPORTANT: Delete 3.0e or any previous 3.0 versions BEFORE installing 3.0f.

3.0e

Removed useless LCD-ws option. Added LCD/n which gives up to an additional 8 or 9% boost in speed, in addition to StreakHack functionality as a side-effect.

 

Note: If installing over previous versions, please make sure LCD-ws was set to 0 before installing new one. Failure to do so may lead to wrong contrast, correctible by setting LCD/n back to a low value of 0 to 4. Alternatively, try setting LCD/n to 1 BEFORE activating 3.0e for the first time after installing. After making the change, you need to exit Hackmaster (with Afterburner enabled for it to take effect.)

3.0d

Fixed a possible memory leak problem. Added checks for non-EZ CPU's and for OSes lower than 3.1. Also implemented more thorough clean-up for the config panels.

3.0c

Fixed a problem identifying the IIIc. Also improved the serial routine to provide broader support.

3.0b

LCD-ws now correct defaults to 7 and LClk/2 correct defaults to 24MHz now.

3.0a

Released but a minor bug that affected Hotsync crept in. This release fixes that Hotsync problem.

3.0

Original release.

 

 

Background

 

Following from the tremendous popularity of Afterburner 2.0 and 2.2, we all awaited something that will follow for the newer PalmOS, such as the OS 3.3 and now OS 3.5. However, the original author Jean-Paul Gavini, had not made any plans to pursue this project further, and so I began looking into this project. Initially, I only patched some of the versions to fix some problems and make it compatible with the newer OSes that were in use.

 

However, after a short while, it became obvious that such a course of action would be severely limited in its possibilities. So, I began re-coding Afterburner 3.0, from ground up in assembly language, with Gavini's permission. Doing this allowed me to now add a host of new features that were not previously there in the earlier versions. I have preserved some of the "look" of the original Afterburner as it didn't seem necessary to re-invent the wheel.

 

So, after weeks of coding, we now have Afterburner 3.0. This version supercedes all the 2.3 versions that I was working on before this.

 

 

What does it do?

 

This is essentially a performance enhancement utility for Palm's with OS 3.1 and upwards. It does this by various means, including raising the frequency of the internal clock and reducing system wait-states, among other things. On a Palm Vx, for example, I can see a performance of 288% in relation to a regular Palm III.

 

It is highly recommended that you backup your data with something like BackupBuddy before trying this out just in case anything should go awfully wrong. Most of the time you won't have to worry about anything more than a soft reset.

 

 

What is new?

 

Here's a list of features of what is new in Afterburner 3.0 that was not found in the previous (2.x) versions:-

 

 

All these, and everything that was previously offered:-

 

 

In short, I've thrown in everything I can think of that I might want in an overclocking utility in an effort to make this the premiere, economical and top-performing overclocking tool for your Palm.

 

 

Registering

 

I have also decided to make this thing shareware, again with Gavini's knowledge and clearance. This is only a mere $8, just to make up for the many long nights I’ve put into this thing. The shareware version does not include GoType, IR, Serial port compatibility but has everything else. You still end up with more than what you got in Afterburner 2.x.

 

In other words, if you are using an unregistered version, you can expect your IR beaming to not be working at any speed other than normal (16MHz or 20MHz depending on your machine.) Likewise for the serial port with modems and other peripherals such as keyboards, etc.

 

In addition, there are now a number of features that are available only in the registered version. I will also continue to add more features to the registered version but bug fixes will be reflected on both registered and unregistered versions.

 

The registered version will also automatically report your machine's normal clock speed in the titlebar of the configuration screen. In the unregistered version, this only shows the "Unregistered" message in the titlebar.

 

To register, please go to:-

 

            http://store.yahoo.com/pilotgearsw/danielwee.html

 

 

Or you can go to http://www.palmgear.com and do a search for Afterburner 3.0. I appreciate your registration. Gives me incentive to work at this utility. All future upgrades will be free for registered users. Registering will help me  justify my aching back from the hours of coding and debugging that went into re-writing Afterburner. J

 

 

Where do I get updates?

 

If you have registered with PalmGear, you would have received a password to download the registered version. Whenever I come up with a new version, I always send PalmGear a copy of the latest registered version for download. You can use your password and download that copy once they have put it up. However, this uploading is a manual process on PalmGear's administrative side and it may not show up as quickly as the unregistered version which is done immediately by myself.

 

If you are downloading an older version, you may want to wait a little while and try again in a day. Usually it won't take longer than that for PalmGear to upload the new file. You can always check your version by looking at the titlebar of the configuration panel of the hack.

 

 

Will Overclocking damage my hardware?

 

Many people have been overclocking their Palm and to date I have not heard of any instance where the hardware was actually damaged as a result of overclocking. You might see greater battery drainage if you run at the highest speeds settings for long periods. I am almost certain that damage is not possible up to about 26MHz and I've been running at 28MHz for as long as I've played with these things.

 

Having said that however, I must insist that you use this application at your own risk. This particular version allows you to make some serious tweaks that could upset performance (but nothing that cannot be cured by a simple soft-reset). I will not overclock sensitive operations, such as Flash  programming (FlashPro, JackFlash, etc.) too aggressively although I’ve not had problems doing so in the past. Just be careful.

 

 

Installation

 

Make sure you delete any instances of Afterburner Hack and AfterburnerII from your system before installing this Hack. They cannot co-exist with Afterburner 3.0. You might also want to remove CruiseControl as well since you won't be needing it anymore. The functionality is provided for in Afterburner. (You also won’t need StreakHack, NoStreakHack, NoWaitZ, Steroid, Tornado_V either) Also, check that Afterburner DB is also removed from the system as well as the new database is not totally compatible with previous databases. You will want to disable Afterburner Hack in Hackmaster before doing any deletion or you might experience a fatal error.

 

Having done that, make sure you have Hackmaster installed (if you don't already have it), and then install Afterburner Hack.

 

Perform a Hotsync operation to get the Hack into your Palm. Check the titlebar in the Configuration panel after installation to make sure that you have the correct version installed.

 

Before you activate the hack from Hackmaster, click on the "+" on the right of the listing in Hackmaster. This will bring up a configuration screen. Nothing you change on this screen will be committed until you click "OK". If at any time you should change your mind, just click "Cancel" and you will be back where you started.

 

It is highly recommended that Afterburner be the first hack to be activated in your list of hacks if you have more than one installed. Disable ALL your hacks and then activate Afterburner Hack first. Then check out all the configuration and Speeds panel to make sure all is in order. Then enable your other hacks one by one. Doing this will avoid installation order conflicts later on.

 

The "Norm" button will set the clock speed back to your machine's normal setting. This works whether the Hack is active or not. The purpose of this is more as a fall-back feature in case things are not going well for you. For example, you might have deactivated Afterburner, but your machine is stuck in a different speed setting that prevents Hotsyncing. This should not happen under normal circumstances, but if it does happen, you could try pressing this button. Usually, you would do this after the hack has been deactivated.

 

The "Speeds" button will bring you to a screen where you can select the speed you want for individual applications. Again, the changes made will only be committed if you choose the "OK" button. Cancelling will send you back to the Hackmaster listing.

 

It seems that under some conditions, it may be necessary to uncheck all the other hacks you have in Hackmaster and start with Afterburner. If you are experiencing unusual errors in Afterburner, please uncheck all your other hacks and then activate only Afterburner to see if there is a problem. If there is none, you can re-enable the other hacks one by one. There is a good chance that this procedure will resolve some of the unusual errors that you may experience. I am still looking into why this is the case.

 

 

Un-installing

 

If you need to remove the hack if you don't have OS3.5 or higher, you will need some database management utility since hacks don't show up in the Applications delete list. If you have FlashPro installed, you can use that to delete the Hack. Otherwise, you might want to look into a utility like Z'Catalog or FPSUtil and other similar utilities. This is not a bug but a limitation of the Palm's built-in delete utility. With OS3.5 you can just delete it from the Applications delete utility.

 

Before you try deleting the hack, please make sure that it is already de-activated. Similarly, if you are going to Hotsync a newer version of the hack over an existing installation, you MUST de-activate it in Hackmaster first or you will get a Fatal Exception.

 

 

What do the options do?

 

First of all, please note that for non-EZ CPU's, the following options will NOT appear on your configuration panel as they are related only to EZ machines. The hardware just isn't there. The EZ-specific features are:-

 

 

Palm IIIe, IIIx, IIIxe, IIIc, V, Vx, VII (some), Visor, Workpads, have EZ CPUs. Older ones such as the Pilot 1000, 5000, Pro, Palm III and the like use non-EZ CPUs.

 

You can get a brief description of the options by tapping on the "i" info icon at the top right of the configuration panel. The options are as follows:-

 

0-ws Core

Sets zero waitstates for CPU core operations. This is one of the major ways to boost performance and is a recommended option. CruiseControl also sets this.

Fast Page

Sets zero waitstates in the Fast Page mode operations. This will yield a very minimal performance boost (1%).

Slow RAM

This option actually adds waitstates to RAM accesses for slow RAM. It will lead to a slightly lower performance but this might be useful if dealing with unstability at very high speeds. Leave this off normally unless you are really pushing it above 30MHz.

Fast Mpx

Fast multiplexing mode yields a major performance boost and is a recommended setting. CruiseControl also sets this option.

Notify on

Fast                  Audible alert when changing speeds

Normal  Audible alert when returning to normal speed

Slow                 Audible alert when slowing down below normal speed

 

The checkbox next to Notify allows for silent notification. This will flash the LCD instead of making a sound during speed change. This feature won't work for color LCDs though.

Default

This allows you to choose your default speed setting. Applications are normally set to this speed by default. If you don't have Afterburner DB yet (because you have not gone into the relevant panel), all apps will default to this speed.

Find

Like above but applies only to the built-in Find function. Keep is the recommended setting for this.

LCD/n

Sets the divider for LCD pixel clock. The higher the divider the lower the pixel rate and system CPU loading. This can boost overall performance of CPU up to 8 or 9% on certain machines. StreakHack does this too. Has the side effect of affecting contrast in the same way StreakHack does. Default value is 1 or 2. (With this, you won't be needing StreakHack) You may have to adjust your contrast. You should play with this to get the best combination between the best performance and a flicker free display. Use the contrast setting to compensate for contrast changes.

Accel

Sets the battery conditions at which speed change is allowed. Set to "Always" by default. You can specify that overclocking only be allowed when the battery is above a certain percentage level.

Slow

This allows you to select battery conditions whereby your Palm will automatically be clocked at 10MHz to conserve power.

LClk/2

This sets the frequency at and above which the LCD pixel clock is halved. This defaults to 24MHz and your should normally NOT mess with this one as it can produce weird screen corruption problems. For experimenters. Otherwise, just leave this alone!!!!

Adjust Ticks

This will adjust the system ticks timer so as to maintain a constant and correct tick rate regardless of your clock settings. This should normally be set unless you want the ticks to run faster. Games, for example, and some timing applications may depend on these ticks so it is best to leave it activated. Recommended setting.

Gray

This will automatically set LCD/n to selected value when in grayscale mode. If “Off” is selected, then the feature is disabled. This can be used to reduce flickering in apps that suffer from it, eg. AvantGo.

 

Note: Changing these options will not cause them to take effect immediately. They will come into effect when you launch any app after leaving Hackmaster.

 

 

Speed options

 

The lowest speed setting allowed by this program is 10MHz, which can be quite sluggish to use. Normally, you would choose slower speeds in interest of conserving battery power, say on a long trip away from home for example.

 

Afterburner 3.0 will automatically detect your normal clock speed, which can be either 16MHz or 20MHz, depending on your machine and what modifications you may have applied to it.

 

The normal top speed, corresponding to the "Fastest" setting in previous Afterburner versions, is 29MHz. Above this, your CPU PLL may not lock reliably and you may get fluctuating Benchmark results, leading also to irregular baud-rate generation and hence un-reliable serial and IR operations (including GoType keyboards). However, some of the newer CPU's may have some luck at the highers speeds. I would only recommend the higher speeds for experimentation, and for this I have included options up to 32MHz. Remember, you may not see anything better than 29MHz and you should stay below that for reliable performance.

 

For older Palms, running at above 23MHz might lead to problems or resets. Make sure you backup before pushing the clock speeds.

 

Note also that IR performance may be better at certain frequencies than others. This is due to the way the baud rate for the IR unit is being generated. Play around to see what works best. On some machines, this tops out at 24MHz, on others it is 26MHz. You just have to try and see.

 

Norm

This will be the detected normal speed for your machine, either 16MHz or 20MHz depending on the model.

Keep It

What this does is that it just maintains whatever speed was in effect at the time of launching this app. So if you set app B to Keep It and were running app A (say the launcher) at 24MHz, just before running app B, app B will keep that 24MHz speed setting.

Default

This will use whatever was selected as default speed in the configuration panel. Most apps should be set to this speed for the greatest convenience.

 

 

How to measure performance?

 

The performance index used in this document is taken from the Benchmark utility by Neal Bridges. This can be found at www.palmgear.com or at his home page at www.quartus.net for free. Please note that the Benchmark screen from the graphics from PalmGear is a screen-shot of this software and does not reflect any built-in benchmarking facility.

 

 

Why am I not getting speed?

 

Make sure you have Hackmaster installed and that Afterburner is activated.

 

Try the following (for EZ CPU's):-

 

Check               0-ws Core

Check               Fast Page

Check               Fast-Mpx

Check               Adjust ticks

Set Default        28MHz

Set Find            Keep

Set LCD/n         2

Set Accel          Always

Set Slow           Never

Set LClk/2         24MHz

 

For non-EZ CPU's:-

 

Set Default        23MHz (more than this and a Fatal Exception is likely)

Set Find            Keep

Set LCD/n         2 (or 3 for even more speed but less contrast)

Set Accel          Always

Set Slow           Never

 

 

Known Issues, Bug reports and feature requests

 

I am continually seeking to improve Afterburner III and to make it as stable and as usable as possible, hopefully making this the king of overclockers for the Palm. So if you have a feature request or any suggestions that you think might make this a better app, please feel free to send them to me. I don't promise to implement it but I will certainly give it due consideration. Likewise, if you are experiencing problems and errors, please let me know so that I can get it fixed.

 

There are some known issues when using this utility:-

 

1.       This does not work well with EVPlugBase at this time. I've not had the time to really look at that and make it work. In particular, you may find that the Speed panel or the Config panel doesn't come up or comes up as a blank. Please use Hackmaster instead to avoid this problem for now. I was told that some of the later revisions of EVPlugBase seems to work but I've not tested this myself.

 

2.       Some other hacks may sometimes conflict with Hackmaster. Of interest is the order in which the hacks are installed. If you are finding that you crash on the configuration panel, try disabling all the other hacks except Afterburner Hack, and then re-enable them one by one, trying to see you are able to open the panel without problems after each one. Do this especially if you find that you get an error when trying to get into the Speeds panel.

 

3.       Some screen corruption issues with IIIc. I don't have a IIIc to test out the actual problems but I will be working on this. So far, I have determined that the IIIc uses a separate LCD controller instead of the one in the DragonBallEZ like the other non-color models. Because of this, it is harder to resolve the problem since I have a lot less control over the color-LCD controller and information on this is sparse. This also means that all the LCD settings will be irrelevant to the IIIc. It also appears that some color-LCD's can handle acceleration up to 30MHz without any corruption so there could be some variance in the IIIc LCD hardware out there. In particular, scrolling may leave artifacts on the screen because this is a blitter operation in the hardware. This problem inherent to the LCD controller and I can’t do much about it.

 

4.       Serial (including keyboards and other peripherals) and IR functions is unlikely to work reliably if the clock is set to anything above 29MHz. This is because although the CPU thinks it is running at that speed, in actual fact it may not be locking reliably to the frequency set. Fluctuations in the frequency prevent stable performance at these frequencies.

 

5.       The hardware up and down buttons don't work while in the various configuration panels in Hackmaster. This is NOT a bug but a limitation of Hackmaster. Those button events never get passed to hacks. Okay, so why do the buttons work for hack XXXX? Well, if those hacks are using lists, then the scrolling is handled by the system and thus benefits from the button presses automatically. However, we are using tables in Afterburner (to maintain the look of ABII) and we are processing the scrolling ourselves. As a result, no buttons. But you gain a more useful interface.

 

6.       My contrast seems affected by the LCD/n. Or the screen is too dark after installing 3.0e. Yes, it is affected. Nothing to worry about. It's just a side effect of changing the pixel clock frequency. StreakHack does the same thing and in fact, you won't need StreakHack anymore. If you are installing 3.0e over older version, please set LCD-ws (in the previous version) to 0 before installing 3.0e. If you are reading this AFTER you had the problem, try setting LCD/n to 1. That should fix the problem but if that fails, just give it a soft reset to restore screen contrast. Alternatively, try setting LCD/n to 1 BEFORE activating 3.0e for the first time after installing. After changing this setting, you need to exit Hackmaster before it will take effect.

 

7.       My screen is flickering! Or, my screen is dark. If you just installed version 3.0e without following the instructions for this version, you might see this problem. To remedy it, just set LCD/n to 1 in the configuration panel.

 

8.       Afterburner is apparently being confused if you keep a "backup" copy of your app in Flash. Ie. you have 2 identical copies, one in RAM and one in Flash. If such a situation exists, setting the speed for any one of them will suffice. The other copy (listed alphabetically) will keep reverting to default.

 

9.       There may be a conflict with NoWaitZ. Try deleting NoWaitZ if you are experiencing problems and happen to have this app on your system. You won't need it anyway if Afterburner works as AB does everything NoWaitZ does and more.

 

10.   There is a problem with AvantGo in grayscale mode on some Palm models due to the fact that AvantGo does some strange things directly to the LCD registers. Check the "Gray LCD" option to reduce this problem.

 

11.   I don't seem to be able to get the speed improvements anywhere nearly as high as what some are reporting. I have a non-EZ Palm. Non-EZ Palms have older hardware and it is very likely that you will not be able to overclock as much as some of the newer machines. Furthermore, there is no zero-waitstate option for non-EZ CPU's. It just isn't in the hardware. Therefore you will not see the kind of performance that you will get with the newer EZ CPU's.

 

12.   My keyboard (or serial peripheral or IR) doesn't appear to be working. I am using an unregistered version of Afterburner. Support for keyboards, and other serial peripherals, and IR, are available ONLY in registered versions. If you are using a Stowaway and the HotSync is coming on when it is not supposed to, try a slower speed setting. Remember, you have to set the speed for the editing app (eg. MemoPad) and NOT just the control or configuration app.

 

13.   I am installing Afterburner 3.0f but after installation, I still see version 3.0e. A change was made to the app name in 3.0f that could confuse Hackmaster if you failed to delete previous 3.0 versions prior to installing 3.0f. To fix this, simply delete 3.0f from the system and re-install.

 

14.   It appears that Hackmaster has a problem properly uninstalling Afterburner because of the trap it uses. This means that Hackmaster could try to run Afterburner even after you have disabled it under certain conditions. This was a tough bug to trace! but it's not my bug. However, I've kludged a workaround for this and those strange errors after disabling Afterburner should be gone now. Nevertheless, on occasion, you might get into a situation where you are installing a new version of Afterburner (through Hotsync) and Hackmaster still hasn't properly released the code even though it has been unchecked. You will end up with a reset in mid-Hotsync session. Nothing to worry about. Just reset and Hotsync again. This is Hackmaster's fault.

 

15.   The non-EZ CPU's cannot support speeds in excess of 23MHz. Attempts to make it run at that speed generally results in a Fatal Exception.

 

16.   My Palm crashes when switching speeds but seems to work if the speed is lower. If this happens, check to see if your battery is in good condition. At low battery levels, higher speeds cannot be sustained reliably, especially with the non-EZ CPUs.

 

17.   Currently, unless you have Find set to Keep, leaving the Find dialog will leave the current app running at the Find speed. I need to find a way to restore the speed of the current app after a Find session. If keeping the speed is important, just set Find to "Keep" for the time being.

 

Please send your feedback and comments to me at:-

 

danwee@cyberway.com.sg

 

Let it RIPPPPPPPPPP!!!!!!!!!

Daniel Wee

 

 

Credits

 

Credits go to Jean-Paul Gavini who first conceived of this fabulous idea. Edward Keyes for Hackmaster. Hackmaster is a must have program. Please register it for US$5 if you use it.

 

http://www.daggerware.com

 

 

Disclaimer

 

While I will continue to provide the best support I can for Afterburner Hack, I must expressly state that overclocking is not officially supported by Palm(tm) Inc. and you push these limits at your own risk. I will not be held liable for  hatever damage that might occur as a result of using this hack.

 

Having said that however, the risk of hardware damage is extremely low.

 

Legal Disclaimer

 

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING (BUT NOT LIMITED TO) THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING (BUT NOT LIMITED TO) PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS; OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 

The End