Programming for PlusShell is very much like Fargo II programming. In fact, PlusShell can compile many Fargo II programs without any changes to the source code.

A Hello World example is included in the PRGM subdirectory of the distribution.

Program Source Format

The following is the format of a PlusShell assembly program:

  include "92plus.h"
  include "util.h"
  ; Include any additional libraries here

  xdef _main
  xdef _comment

_main:
  ; All code goes here

  ; All data goes here
_comment dc.b "Comment goes here",0

  end

Library Source Format

The following is the format of a PlusShell library program:
Note: There is a difference from Fargo libraries. You must not define a '_library' variable.

  include "92plus.h"
  ; Include any required libraries here

  xdef _library
  xdef libname@0000
  xdef libname@0001
  ; Define any additional exported library labels here.  They must be in the format
  ; libname@NNNN, where NNNN is a hexadecimal number, all leters capitalized.  Numbering
  ; must start at 0000 and proceed sequentially

libname@0000:
  ; Code for function 0000 goes here

libname@0001:
  ; Code for function 0001 goes here

  ; Labels and code for other functions go here

  ; All data goes here

  end

Assembling Programs

To assemble a program, type asm92p at the DOS prompt followed by the name of the program. For exmaple, to assemble a program named 'tetris', you would type:

asm92p tetris

and press enter. If there are no errors, a .9xz file will be placed in the same directory as the source file.


Other Information

For information on how to convert Fargo II programs, go here.

ROM functions
Functions in the UTIL library
Functions in the GRAY4LIB library
Functions in the GRAY7LIB library
Functions in the HEXLIB library
Functions in the HUFFLIB library
Functions in the LINELIB library
Format of PlusShell executables


Back to PlusShell Home

Fargo is written and maintained by David Ellsworth.
Many functions in the libraries included with PlusShell were originally written by David Ellsworth for Fargo. Other functions were written by Jimmy Mårdell. Some of these functions were modified for compatibility with the TI-92 Plus calculator.

Questions? Comments? E-mail me at river@gte.net
This page is maintained by Rusty Wagner