# Monkey Firmware

## Version 3.0.5, April 9 2005

General use of this firmware is the same as RaceGun firmware v2.0.25; refer to RaceGun's documentation for usage. Documentation here only covers areas where operation of the firmware differs from RaceGun's standard firmware.

Please read the documentation, and the legalese at the bottom of the page, before attempting to use the firmware.

I've put the download link further down the page, to force you to read the notes first ;)

### Changes in operation over 2.0.26

- In the RIP interface, the Load Time slider is used when the ACE is disabled (the Default Load Time has been hijacked, see below.) This also means that the Load Time adjustment on the grip now does something with an ACE-equipped marker.
- The serial port works in Live mode, which makes timing much quicker. Be aware of the danger this can pose, though, and do not load paint or remove your barrel sock unless in an area where firing is safe.
- The Load Time adjustment on the grip does not reset the Load Time to 35ms before adjustment; the starting point is the previous setting. Holding the up button for 2 seconds will enter Load Time Adjust (you will hear a beep.) Then pressing the up or down buttons will adjust the load time from its current setting, 1ms at a time. A longer beep will indicate when the minimum (1ms) or maximum (255ms) load times have been reached. Press the power button to save the new load time and exit Load Time Adjust.
- The Default Load Time field in RIP is now used for Maximum ROF, in bps. Values between 8 and 60 are possible; anything below 8 will diable the ROF cap; anything above 60 may have unexpected results.
- A battery meter function has been incorporated. In safe mode, hold the up and down buttons on the keypad and the LED will flash, indicating the battery state:
  - Green - Battery OK (voltage over 5.00v)
  - Amber - Battery weak (voltage between 4.80v and 5.00v)
  - Red - Battery low (voltage under 4.80v)
- There is now a visual indication of ACE mode (which you can toggle on or off by holding the up and down buttons for one second in Live Mode, as normal) - when the ACE is active, the LED is red as before, but when the ACE is disabled the LED is amber.
- Semi and Classic modes both work properly; try both and see which you prefer.
- Hyper mode is PSP-compliant; that is after 4 shots at 7bps or higher it will ramp to the maximum ROF by boosting your actual rate of fire by approximately 33% (so for 15bps you will have to pull 11.25bps.) It appears that this mode will be allowed in the Millennium Series for 2005.
- Full Auto mode is NXL-compliant; that is it will only switch to full auto after 4 shots at a minimum of 7bps. If you release the trigger full auto firing will stop and it will require another 4 shots at 7bps to start firing in full auto again.
- Burst 3 and Sniper modes are much the same as Racegun's firmware, not much explaining needed there! Burst 3 is definately not compatible with any tournament rules. Check before you play.
- The CTO Adjust checkbox in RIP enables neighbour-friendly "training mode" - the bolt will cycle but the gun will not fire. The former CTO Adjust function is not used in this firmware (the firing cycle with ACE enabled always works in the way CTO Adjust was intended to in RaceGun's firmware.)
- The ACE Mounted checkbox in RIP is no longer used.

### Cautions

- This firmware will only run on version 2 (leaf switch) boards. If you are not currently using version 2.0.x firmware, do not attempt to use this firmware!
- There may well still be bugs in the firmware which cause the grip to crash (there aren't any that I know of, but things have a knack of creeping through the testing process. If this happens, and the grip becomes entirely unresponsive, the only solution is to open the left side of the grip panel, and disconnect the battery. Leave it disconnected for at least 10 seconds before reconnecting it.
- In case of complete disaster, when the grip will not even boot far enough to respond to RIP, disconnect the battery, wait 15 seconds, then reconnect it as above. Then hold the up button and press the power button until the LED comes on amber (about 4 seconds.) Then upload working firmware from RIP (don't attempt any other operation in RIP before doing this, or it will most likely crash the grip again.)
- When downloading firmware from a grip, RIP omits the first 32 bytes of firmware. This contains the interrupt service routines. As the Monkey firmware makes heavier use of interrupts than RaceGun's, this code is quite different from what was previously on the grip. The result of this is that firmware downloaded from a Monkey-enabled grip and uploaded to a non-upgraded grip WILL NOT WORK. We found this out the hard way. Only attempt to upload the full copy of the firmware downloaded from this site.
- For the same reason as above, if you want to revert to RaceGun's firmware, it must be done with a copy downloaded from their site - firmware downloaded from another grip, or a backup made from yours before the upgrade, WILL NOT WORK.

### Download

By clicking on this link, you are assumed to have read, understood and agreed to the stuff I put at the bottom of the page to cover my arse. If your marker is terminally broken by the software, or if you injure or kill yourself or somebody else whilst using it, I can't accept responsibility for it. You have been warned.

Download the Monkey Firmware!

This firmware will only run on version 2 (leaf switch) boards. If you are not currently using version 2.0.x firmware, do not attempt to use this firmware!

Download the firmware, save it to your disk (make sure your browser doesn't do stupid things to the file or its filename) and upload to the grip using RIP v1.0.3. After uploading, the grip will have crashed; this is due to the changed interrupt routines (see above.) Open the left side of the grip (the ball detent side) and disconnect the battery for 10-15 seconds. Reconnect it and the grip should function. This only has to be done if changing between 2.0.x and Monkey firmware.

Once that is done, set the Default Loadtime field (now Max ROF) to the desired value, or 1 for no ROF cap. Check the general timing of the marker, although it should not need changing if set correctly. It is very important that the timing is set properly for best operation; if you are not sure how to do this, I have written a timing guide which should ensure everything is set right. If you are confused by all this, here is a screenshot of RIP as I have it currently set on my Halfblock:

Copyright © 2005 Richard Garnish. All Rights Reserved. Original firmware, and parts of this code are Copyright © Racegun Products. Parts of this code are Copyright © Jesper Kold-Hansen. All rights acknowledged.

Unauthorised use, copying, distribution or modification of this software is strictly prohibited. This program is not on general release, and is supplied for testing only. The author's right to release this software has been granted by Racegun Products.

This software is provided as-is, with no guarantees of usability or fitness for any particular purpose. The software is designed to be legal for use in major tournaments, by conforming to accepted rules governing the operation of semi-automatic paintball markers; however, it is always possible to adjust electronically-operated markers to function outside the scope of the rules, and errors may remain in the software which may cause the marker to operate in a way that is not considered tournament legal. Thus it is the user's responsibility to ensure and satisfy himself that the operation of the marker conforms to the rules and regulations required of it.

While every effort has been made to ensure this software is free of errors, and safeguards have been built in to avoid unintended discharge of the marker due to software malfunction, no liability can be accepted by the author for any reason whatsoever for any damage, loss or injury caused by or resulting from the use of this software.

USE THIS SOFTWARE AT YOUR OWN RISK.

Paintball can be a dangerous sport! Always wear eye protection designed for paintball use, and always ensure that a secure barrel-blocking device is in place on the marker when it is not in use.

Be aware that use of this software may invalidate any manufacturer's warranty which may have applied to the marker or parts thereof, and that the author provides no warranty of any kind to redress this. Racegun representatives have indicated their approval of this software, but cannot be expected to provide support for it. If you have problems, it is recommended you revert to Racegun's released firmware before raising support issues with them.