Asm86 III- The complete utility to create assembly programs for the TI-86


Hello, I'm Alan Bailey, and the intent of this package is to make people's lives easier
when they go about the process of making assembly programs for the TI-86.  It can also
be used to port programs from the TI-85 to the TI-86.  It's not meant to be a primer
or tutorial of any sort, although I give web addresses of some good	tutorials later.



-----------------
Included files --
    You should put all these files in the same directory for organization.

		asm86.h				/  Asm86 header file
		make86p.bat			/  batch file to ease compiling
		prgm86.exe			/  utility to make string file out of object code
		ti86asm.inc			/  TI's basic include file
		tasm.exe			/  TASM's table assembler
		tasm80.tab		    /  TASM's table file for the z80
		asm86.txt			/  this file

* If you downloaded the complete zip file, you will have three directories with more
files in each.

* If you downloaded the updated zip, those seven files will be updated, and you will
get no more in addition.


-------------------
Writing Programs --
    All of your programs should have this following format:

/////////////////////////////
#include "asm86.h"         ;this header file *must* be before the other .inc files
#include "ti86asm.inc"

#include "ti86math.inc"
#include "ti86ops.inc"
#include "ti86abs.inc"
			;if you don't want to include the other files, then don't  ;)
		

.org _asm_exec_ram            ;this is the address the program is put at to run

    ...
    ...
    program          ;put your code here  :)
    ...
    ...
    

.end                ;tells TASM it's all over
/////////////////////////////

Alternatively, you can run makesrc.exe to give you the bare essentials to start
writing programs.  To run it, do the following:

	makesrc <filename>

where <filename> is the name of your program, without an extension.  This will output
<filename>.asm, which will give you the basic structure	of a program.  It will detect
the ti86*.inc files you have in the _same directory_ and include them.	I suggest using
this at least the first time, to check how many ti86*.inc files you have.

Makesrc is available at the Asm86 home page: http://www.iit.edu/~bailela/asm86/



---------------------
Compiling Programs --
    First, you should write your assembly code like above.  To get an 86 asm program,
execute the following:

    make86p <filename>
    
    where filename is the assembly code without the extension.  So...
    if the filename is test.asm, execute:
    
    make86p test

    Leave the extension on, but don't include it in the command line.  Unless you see
errors in the compilation process, you should end up with <filename>.86p.  You can then
transfer it to your 86 and run it as an assembly program.  Then have fun debugging =)


-------------------------------
Porting from the 85 to the 86--

Obtain the file 85-86.txt from the Asm86 web site: http://www.iit.edu/~bailela/asm86/


--------------
Legal Stuff --
	Anything not created by TI or Speech Technologies (TASM) is Copyright (C) 1997 
Alan Bailey.  Many thanks to Dan Eble for the source to string85.com, and whoever wrote
make85s.bat originally (Who knows? Henrik Edlund?)




Name: Alan Bailey
Email: bailela@charlie.cns.iit.edu
IRC: Abalone on #ticalc, #ti-files on EFnet
Web: http://www.iit.edu/~bailela/
Asm86: http://www.iit.edu/~bailela/asm86/