Format and Compiling

z80 » Beginner

Before you can really start learning to program you are going to have to have some basic tools.

1. TI-GRAPHLINK (Texas Instruments)
2. Assembly Studio 86 (Assembly Coders Zenith)

#include "ti86asm.inc"
	    . . .
	    . . .
	(aliases and defines)
	    . . .
	    . . .
.org _asm_exec_ram
	    . . .
	    . . .
	(program code)
	    . . .
	    . . .
	(variables)
	    . . .
	    . . .
.end

Those are the two tools I have so those are what I will be referring to. It is definitely possible to program with a homemade link and some freeware linking software, but Assembly Studio is nice because it combines all aspects of programming into one program. You don't have to use MS-DOS EDIT to edit the file, another MS-DOS program to compile it, your linking software to send it, and then overwrite the file if you already have it on the calculator.

Asm Studio also lets you select options so that all you do is hit [Ctrl] and [F5] and Asm Studio sends the file to your calculator and overwrites the previous version. Asm Studio just takes care of the bottlenecks, not to mention adding several features that you will wonder how you could ever have lived without.

Later on in programming you will want to have a complete set of include files for your code downloaded and in your include search path directory. If you have Asm Studio, that directory would be "Include". You will also want to start collecting your own library of reference material. Check out the Download Section for my current stash of files. Start collecting now so you can get all the weird files on all the weird stuff there is with asm programming.

To start you off getting comfortable with Asm Studio, we're going to try to compile something and send it to your TI86.

1. Make sure your calculator is plugged into the graph link and turned on.
2. From inside Asm Studio select File | New. We'll need to copy and paste the following section of code into the new document, overwriting everything already in 'Document 1'. To do that, hold down the [Shift] key while dragging your mouse from the top to the bottom of this example program.
3. While holding down [Ctrl] hit [C] to copy the code from this page.
4. Go into Asm Studio and, while holding down [Ctrl], hit [A] to select all the text in the window.
5. Paste the code with [CTRL] [V].
6. Save the file as practice1 in the 'Programs' directory of your Asm Studio folder. Asm Studio will automatically save it with an *.asm file extension.

#include "ti86asm.inc"	;equate file
.org _asm_exec_ram		;where it starts
	call _clrLCD		;clear the screen
	ld bc,$0000		;at coordinates (0,0)
	ld (_curRow),bc		;load coodinates
	ld hl,hello_text	;address of text
	call _puts		;display it
	call _getkey		;wait for keypress
	ret			;exit program
hello_text:	.db "hello",0	;text to display
.end				;end of source code

You need to have your TI86 plugged into your Graph Link, turned on, and at the homescreen. If you have errors, go to the Asm Studio Help section "Troubleshooting". To run your program, once it has been sent to the TI86, type the following:

Asm(arg1)

Let's say you saved your above program as hello.asm and assembled it as hello.86p. You would send the *.86p file to your calculator and type in the following at the homescreen.

Asm(hello)

Make sure you put a Tab at the start of every line in your code that has an instruction on it. The assembler will then recognize them as instructions and not labels.