******************************************************
TI 1-Bit Pack                              version 0.3
******************************************************

The TI 1-Bit Pack contains several ZX Spectrum 1-bit (beeper) routines, which have been adapted for use with TI82 and TI83 graphic calculators.
The following sound routines routines are included:

Huby (xm2huby/1tracker) readme.txt
LSEngine (1tracker) readme.txt
The Music Studio (Beepola version) readme.txt
Octode (1tracker) readme.txt
Qchan (xm2qchan) readme.txt
Phaser1 (Beepola version) readme.txt
Wham! The Music Box (Beepola version) readme.txt
ZX10 (1tracker) readme.txt



- A TI82 or TI83. Alternatively, you can of course use an emulator, see below.
- A link cable (learn how to build your own parallel or serial one here, or get a TI GraphLink / SilverLink somewhere
- An audio cable with a 2.5 mm stereo jack plug

- Beepola, 1tracker, and/or xm2huby
- TiLP Windows / *nix, or another linking software
- TASM
- DOSBox or real DOS/FreeDOS
- for TI82: CrASH 1.6 + CrASHSDK
- for TI83: Ion 1.6U + devpac83
- Optional: VTI emulator - the only TI emulator that seems run CrASH with sound support (unfortunately). Note that the ROMs are not included. Find out how to extract the ROM from your own calc here.



Install DOSBox, if you haven't already. Extract CrASHSDK and/or ion.inc+devpack83 to a working folder of your choice. Extract and copy TASM files to the same folder. Extract and copy TI 1-Bit Pack folder to the same folder. Move asm83.bat to the working folder. You are now ready to use crasm.bat/asm83.bat as described below.

Install TiLP or another linking software. Connect your TI to your PC and copy CRASH.82B/ION.83G to the calc (or emulator). Warning: This is a backup file, all stored user data on the TI will be deleted when copying this. On TI82, you can now safely run .82p files via the CrASH shell. On TI83, you'll need to complete the Ion installation first, by running prgmION once.



Details about usage of the different engines can be found in the readme files.

The general procedure is simple:

1) Compose music with one of the engines/utilities mentioned above
2) Export song data as asm source
3) Adjust song data and copy to appropriate template file
4) Set calculator model and other options in asm source file
5) Use TASM to compile .82p with CrASHSDK, or .83p with devpac83 (all require DOSBox)

For details about steps 2-5 see engine-specific readme files.



- Note that TI83+ and later models are not supported, due to different processor speed. With some minor modifications, the routines should however work on TI85, 86, 73, and possibly 82STATS/76.fr
- If your calculator hangs after executing sound routines, simply remove the cable and everything should be back to normal.
- Most 2.5 mm plugs will not fit properly into the link port. Remove some plastic from the base of the plug, till it goes in all the way.
- Plugging headphones directly into the TI will greatly slow down the calculator. To avoid this problem, use an amplifier or plug in the headphones after you start playback.
- Unlike with Gameboy, you should not take out the batteries unless you need to change them. Removing the batteries for more than a few minutes will most likely erase the internal memory.



- [ALL] ROM 19.006 is not supported. Do not attempt to run the routines on TI82CS.
- [ALL] Keyhandler reads only [MATH] - [CLEAR] and [MODE] keys
- [ALL] Pitch and tempo translation may not be 100% accurate
- [LSEngine] Long song data may crash TASM. See readme for a workaround.

Report bugs and problems to utz AT mydomain (see bottom of page)



Many thanks everybody who helped with this project, especially to:

- Akareyon for his support, and for developing the bitwise logic for Huby
- calc84maniac for spot-on debugging
- Shiru for his engines, 1tracker, and all the good advice
- Chris Cowley for Beepola
- Mister Beep for being Mister Beep
- Wouter "Karma" Demuynck for his excellent TI82 ASM tutorial
- The Tout82, Omnimaga, and WOS communities for their help and support

The sound routines included were originally written by Ján Deák (ZX10), Mark Alexander (Wham! The Music Box), Lyndon Sharp (LSengine), Saša Pušica (The Music Studio), and Shiru (Huby, Octode).


All code contained within this package, as well as this document, are hereby released into Public Domain, whereever this is applicable.

This software is provided "as is". The authors will not be held liable in any way for any loss of data or other damage that may occur as a result of usage of this software.


2013/06/07    0.3   Improved key handling
                    Added Phaser1 (digi drums only) and Qchan engines
                    Size optimizations
2012/11/02    0.2   Added TI83/Ion support
                    Added Octode engine (1tracker version)
                    Removed all ROM calls
                    Various code optimizations
                    Moved all song data to external music.asm templates
2012/10/26    0.1   Initial release