
Cirrus Programming -  Ti83+ SDK version 1.2


This set of files will give you the opportunity to compile
standard asm programs and flash apps for the the ti83+.


File extensions

The SDK only accepts files with .asm file as source code files.
If you try to assemble a .z80 file, you will be asked to change the name
of it. The source code can be written in any text editor that supports
plain-text format (Notepad, Editpad...), but instead of saving
it as .txt, you should save it as an .asm file.


Assemble programs


After you've ran the ti83psdk.exe file to extract the files
to a folder of your choice, you need to start the MS-DOS prompt
to access the assembler. The syntax is: asm <filename>
Filename must be without file extension.

Here is how to start the MS-DOS prompt in Windows:
Click the start tab, select "run" and type "command".
Press enter. 

By default, the prompt is set to C:\windows\desktop, and we need
to change the directory to where we extracted the asm files. If you
have the files in the folder C:\cirrus, which is the default location,
type this in the prompt: cd C:\cirrus



Test the installation

Change directory to C:\cirrus or some other
place where you have the asm files.

Type asm default in the prompt and press enter.
This tells the assembler to assemble the default.asm
file. A menu will be displayed where you choose the output format.
Pick "Bin asm format" (1). The assembler will now build the file.
After a few seconds, it should say : Success!
If not, please see the troubleshooting section of this document.
Check the binasm folder. Hopefully you notice a file named default.8xp
This file can be transfered to your ti83+ with some linking software.
This program does not contain any instructions, it will just return
back to the homescreen when you run it.


How to assemble an app


A simple app demo is included with this distribution. 
Assemble it with asm helloapp and choose (3) in the output format menu.
The assembler creates a file named helloapp.hex in the hexapps folder,
which you can load in the TI Flash Debugger and test.

Please keep in mind that the source code for a flash app and a regular asm
program is different, thus it won't work if you try to assemble an app in asm
format or vice versa.


Files

 tasm.exe	Assembler/Compiler
 tasm80.tab	File that contains Z80 processor instructions
 devpac8x.com	Converts the *.bin file that TASM creates to *.8xp format
 ti83plus.inc	This file is needed to access system routines and memory on the ti83+.
 default.asm	This is a template file. When writing new progs, base them on this file.
 livelong.asm	A simple game :)
 convhex.exe	Convhex is used for creating ascii hex asm programs from a bin file.	
 asm.bat	MS-DOS assembler batch file.
 helloapp.asm	A simple application example.
 sign.bat	Needed if you want to sign apps so that they can run on a real ti83+.



Our homepage:
http://cirrus.tigalaxy.com


Troubleshooting

Q: What is the TI Flash Debugger and where can I get it?
A:
The TI Flash Debugger is a ti83+ emulator windows program. It
allows you test your apps and programs without using a real ti83+.
It can be downloaded for free from:
http://epsstore.ti.com/webs/catlist.asp?deptid=157&catid=584

Q: The assembler is working, but I just can't get the hang of how to program!
A:
There are many good resources and tutorials about ti83+ assembler programming
on the net.
For a list of the best ones, visit http://cirrus.tigalaxy.com/asmresources.htm

Q: Where can I get personal help?
You are welcome to ask us about programming on our web board.
http://cirrus.tigalaxy.com/cgi-bin/yabb/YaBB.pl?board=proghelp

You can also email the creator, David Lindstrm at okvin@tiscali.se


Good Luck, and happy programming!

//David L



