From a4190f9984dc7cdbb1e502af7404672348feb032 Mon Sep 17 00:00:00 2001 From: Virgil Dupras Date: Sat, 9 Nov 2019 14:20:01 -0500 Subject: [PATCH] recipes/ti84: document usage ref #41 --- kernel/ti/kbd.asm | 2 +- recipes/ti84/README.md | 27 +++++++++++++++++++++++++-- 2 files changed, 26 insertions(+), 3 deletions(-) diff --git a/kernel/ti/kbd.asm b/kernel/ti/kbd.asm index f753d82..2d4f519 100644 --- a/kernel/ti/kbd.asm +++ b/kernel/ti/kbd.asm @@ -19,7 +19,7 @@ ; *** Code *** kbdInit: - xor a + ld a, 1 ; begin with A-Lock on ld (KBD_MODS), a ret diff --git a/recipes/ti84/README.md b/recipes/ti84/README.md index b83d737..8f53963 100644 --- a/recipes/ti84/README.md +++ b/recipes/ti84/README.md @@ -1,6 +1,6 @@ # TI-84+ -**This is a work-in-progress, this is far from complete.** +**This is a work-in-progress** ## Recipe @@ -25,7 +25,7 @@ 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.** +See z80e's `KEYBINDINGS.md` file for details. ## Upload to the calculator @@ -51,6 +51,29 @@ Press "1" to continue. When this is done, you can press the ON button to see Collapse OS' prompt! +## Usage + +The shell works like a normal shell, but with very tight screen space. + +When pressing a "normal" key, it spits the symbol associated to it depending +on the current mode. In normal mode, it spits the digit/symbol. In Alpha mode, +it spits the letter. In Alpha+2nd, it spits the uppercase letter. + +Special keys are Alpha and 2nd. Pressing them toggles the associated mode. +Alpha and 2nd mode don't persist for more than one character. After the +character is spit, mode reset to normal. + +Pressing 2nd then Alpha will toggle the A-Lock mode, which is a persistent mode. +The A-Lock mode makes Alpha enabled all the time. While A-Lock mode is enabled, +you have to enable Alpha to spit a digit/symbol. + +Simultaneous keypresses have undefined behavior. One of the keys will be +registered as pressed. Mode key don't work by simultaneously pressing them with +a "normal" key. The presses must be sequential. + +Keys that aren't a digit, a letter, a symbol that is part of 7-bit ASCII or one +of the two mode key have no effect. + [knightos]: https://knightos.org/ [z80e]: https://github.com/KnightOS/z80e [mktiupgrade]: https://github.com/KnightOS/mktiupgrade