Tutorial 20
The Include file

   Now that you are familiar with Z80 Asm, I will now introduce the concept of Include files. An Include file is simply a file with predefined ROM calls in it. In other words, you won't have to define every ROM call you use in your programs because they will have already been defined! This tutorial will cover how to use an include file and what is in an include file.

The Include File
    To include an include file or any other file in to your program, you must use the #include statement. Those of you who are familiar with C or C++ will know that #include statement simply includes a file into the program. To use the include file, you must also define equ, EQU, end, and END. TASM is case sensitive about these things. This simply tells the assembler that EQU is the same thing as equ, and end is the same thing as END! Now, when using the Include file, the HEADER and DEFINES and EQUATES part of your program must be left out because they are included in the include file. I recommend that you use the TI83PlusAsm.inc file included with this help file. It is the TI83Plus include file provided by TI only adapted for use with TASM and optimized for TI-83 Plus Assembler programming by me. You must also type .NOLIST and .LIST before and after the the header. This is what the start of a program would look like if you used an Include file:

.NOLIST ;Defines what isn't code
#define equ .equ  
#define EQU .equ  
#define END .end  
#include "Ti83PlusAsm.inc" ;assuming you used my include file
.LIST ;Defines what is code

  Remember, the above source will replace the HEADER and DEFINES and EQUATES section, there is no need to include them anymore. Although you still need the PROGRAM START, BODY, and END.

   Here is an example of a program that uses and include file:

#define equ .equ ;The Include File to be used must be in the same folder as the program being assembled.
#define EQU .equ  
#define END .end  
#include "Ti83PlusAsm.inc"  
.org 9D95h ;This tells the calculator that the program will start at the mem adress 9D95h
B_CALL(_homeup) ;Bringing up the home screen
B_CALL(_clrlcdfull) ;Clearing the screen
ret ;Returning to TI-OS

   The #include statement isn't always used to include include files. It can also be used any where in the program to include picture source, other programs, etc. For example, in tutorial 15, we used it to include the source for the title screen. It simply took everything that was in the title.asm file and pasted it to that part of the program. Using include files will help us because now that you are more comfortable with Asm, we will learn even more ROM calls. Who has time to define each one by hand?

Tutorial 21

    Click to return to the site's menu... or here to get back to the tutorial's menu.