◄ Back to index

On-calc usage


On-calc IDE



Installation


You must first install FlashAppy on your calculator. Note that like all ROM patches, you will not be able to send your modified calculator ROM image to other calculators. Neither the authors of GTC nor the author of FlashAppy can be held responsible for any damage that could occur during or after this process. However, we are not aware of any case where a calculator was damaged by FlashAppy.

You only need to install FlashAppy once: you won't need to reinstall it after a reset or after upgrading to a newer version of GTC. On the other hand if you install an AMS update you will need to reinstall FlashAppy afterwards.

Legal notice: the .89t/.9xt/.v2t and .89y/.9xy/.v2y files in the bin-89/92p/v200 directories are subject to the GNU General Public License, which grants you a number of rights. You may choose not to install them, but this will prevent you from using the TIGCC Library.

Once FlashAppy is installed, send all the files in the bin-89, bin-92p or bin-v200 directory (depending on the model) to your calculator, and archive them all.

Check that the GTC flashapp was properly transferred by entering the Var-Link screen and pressing F7: you should see GTC appear in the list. Otherwise, the transfer failed: make sure that FlashAppy is installed and that you have enough Archive memory.

To create a test source file, create a directory named source, create an empty text file inside that directory named hello with the TI text editor, and archive it with the Var-Link screen.

Now you can run the IDE by typing gtc\gtc_ide() and open the file named hello.

Type in the following code:

#include <tigcclib.h>

void _main() {
  ST_helpMsg("Hello world!");
}

Now press the F5 key. This should bring up a compilation dialog, which should close after a few seconds (if not, you may not have installed GTC properly: make sure FlashAppy is correctly installed, that everything is archived, and that you have enough RAM).

Once the compilation is over you can exit the IDE and run your program by typing

outbin()

It should display the text Hello world! in the status line. If it worked, congratulations! You now have a working C compiler on your calculator.


Key commands


Here is a small subset of the key commands supported by GTC IDE:

  • CLEAR: indent the cursor by two columns (equivalent to the TAB key on a PC)
  • Catalog: lists all functions available in the standard library
  • F5: compile the current file
  • 2nd-F3: search for a string in the current file
  • Diamond-F3: replace a string in the current file
  • F3: search for the next occurrence of the string

Also, GTC IDE supports keyboard shortcuts that the standard text editor doesn't: for example, you can press Shift-2nd-Right (press Shift and 2nd, then press Right while still holding Shift and 2nd) to highlight the text from the cursor to the end of the line. Likewise you can press Shift-2nd-Down to highlight a whole screen of text, or Shift-Diamond-Down to select until the end of the file. These shortcuts come in particularly handy when selecting large amounts of text.


Tips and tricks


  • You should map main\outbin() to a kbdprgm like kbdprgm9 so that you can quickly run a freshly compiled program by typing Diamond-9 in the Home screen.
  • You can save memory by deleting header files you don't use in the folder zheader. You should not delete stdhead or keywords if you want to compile programs designed for the TIGCC library.