Introduction
--------------------
eZ80 Studio is an on-calc eZ80 assembly IDE for the TI-84 Plus CE and TI-83 Premium CE calculators.
It includes an editor, assembler, and include file support.
Features
--------------------
* Editor with word wrap and up to 14 lines and 38 columns on screen at once.
* Toggleable syntax highlighting.
* Light and dark themes.
* Special characters.
* Quick jump to lines.
* Built-in eZ80 assembler, with support for data and reserve macros.
* Support for `$` symbol to represent the current address when assembling.
Installation
--------------------
1. Download the latest version of eZ80 Studio from the GitHub releases page:
https://github.com/EzCE/ez80-studio/releases/latest
2. Send EZSTUDIO.8xp along with any include files (Found in includes/*.8xv) to your calculator using
TI-Connect CE or TiLP. If you don't have the [CE C libraries](https://tiny.cc/clibs), you'll need
to download and send those as well.
3. Run **prgmEZSTUDIO** from the programs menu. You will need to use the arTIfiCE jailbreak
(https://yvantt.github.io/arTIfiCE) if you are on an OS version 5.5 and above.
Navigation
--------------------
Below is a table with keys and their various usage in eZ80 Studio:
+--------------------+---------------------------------------------------------------+
| Key | Action performed |
+--------------------+---------------------------------------------------------------+
| [2nd] / [enter] | Select options from menus or insert a newline. |
| [↑], [↓], [←], [→] | Scroll through menus or move the cursor in the editor. |
| [y=] | Open/exit files menu. |
| [window] | Assemble the currently opened file. |
| [zoom] | Open/exit goto line menu. |
| [trace] | Open/exit special characters menu. |
| [graph] | Open/exit settings menu. |
| [del] | Delete the character in front of the cursor. |
| [mode] | Backspace. |
| [alpha] | Switch between uppercase, lowercase, and numeric input modes. |
| [clear] | Exit the program or close the current menu or window. |
+--------------------+---------------------------------------------------------------+
Include files
--------------------
Five include files are provided with eZ80 Studio, though you can also convert your own. These
include files are based on ti84pceg.inc and the include files provided with BASM-3
(https://github.com/beckadamtheinventor/BASM-3/tree/master/data). TIOSRTNS.8xv contains system
routines, TIOSRAMA.8xv contains RAM areas, TIOSFLAG.8xv contains system flags, TIOSKBEQ.8xv contains
keyboard and context equates, and TI84PCEG_smaller.8xv is a slightly downsized version of the full
ti84pceg.inc (which is too large to fit on the calculator in one file). TI84PCEG_smaller.8xv
contains the majority of the other four include files, so it unlikely you would need both the four
smaller includes as well.
Converting files
--------------------
Converting include or source files from the computer to a file compatible with eZ80 Studio can be
done quickly using the provided conversion scripts.
To convert source files, use convert.sh. If it is not already installed, you will also need convbin,
which can be found here: https://github.com/mateoconlechuga/convbin
The syntax for convert.sh is `convert.sh