# TI-84+

**This is a work-in-progress, this is far from complete.**

## Recipe

This recipe gets the Collapse OS shell to run on the TI-84+, using its LCD
screen as output and its builtin keyboard as input.

## Build the ROM

Running `make` will result in `os.rom` being created.

## Emulate through z80e

[KnightOS][knightos] has a handy emulator, [z80e][z80e] for TI calculators and
it also emulates the screen. It is recommended to use this tool.

Once z80e is installed (build it with SDL support) and `os.rom` is created,
you can run the emulator with:

    z80e-sdl -d TI84p --no-rom-check os.rom

You will start with a blank screen, it's normal, you haven't pressed the "ON"
key yet. This key is mapped to F12 in the emulator. Once you press it, the
Collapse OS prompt will appear.

**WIP: the keyboard does nothing else than halting the CPU for now.**

## Upload to the calculator

TODO