Free games for graphing calculators: NumWorks, TI-Nspire CX, Casio fx-CG50 and soon TI-84 Plus CE. Balatro, Celeste, Hollow Knight, Minecraft and more.
C calculatorcalculator-gamescasiochesscrossy-roaddrive-madfx-cg50gamesgeometry-dashgraphing-calculatorndlessnumworksnumworks-appsnumworks-calculatornumworks-gamenumworks-gamestetristi-84-plus-ceti-nspire
tools/emu.py emulates the N0110 and Upsilon too (--model, --system); test_upsilon.py: NumPlay-Upsilon.nwa makes no system call Upsilon lacks, finds its file system, and Chess shows its menu there
Mason Chen85cb3cdb6af2
diff --git a/.github/workflows/build.yml b/.github/workflows/build.ymlindex a82dcb08..304a2a45 100644--- a/.github/workflows/build.yml+++ b/.github/workflows/build.yml@@ -49,6 +49,7 @@ jobs:python3 tests/test_uninstall.py build/NumPlay.nwa --game numdrivepython3 tests/test_progress.py build/NumPlay.nwapython3 tests/test_numblocks_progress.py build/apps/NumBlocks.nwa+ python3 tests/test_upsilon.py build/NumPlay-Upsilon.nwa- uses: actions/upload-artifact@v4with:diff --git a/tests/test_upsilon.py b/tests/test_upsilon.pynew file mode 100644index 00000000..3fecdd03--- /dev/null+++ b/tests/test_upsilon.py@@ -0,0 +1,61 @@+#!/usr/bin/env python3+"""Checks NumPlay-Upsilon.nwa on an emulated N0110 running Upsilon (tools/emu.py --system upsilon):++1. it makes no system call Upsilon doesn't have (Home, checksums, flash);+2. it finds the file system there: a save already on the calculator goes into its copy,+ numplay_saves.py;+3. Chess, which draws text with the firmware's font, opens and shows its menu (drawn by NumPlay+ there, launcher/src/compat.c);+4. Home quits.++Usage: test_upsilon.py build/NumPlay-Upsilon.nwa [--out DIR]+"""+import argparse+import os+import sys++sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "tools"))+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))+import emu # noqa: E402++emu.configure("n0110", "upsilon")+from test_progress import copy_lines, presses, records, write_storage # noqa: E402+++def main():+ ap = argparse.ArgumentParser()+ ap.add_argument("nwa")+ ap.add_argument("--out", default="build/test_upsilon")+ a = ap.parse_args()+ os.makedirs(a.out, exist_ok=True)+ st = os.path.join(a.out, "storage.bin")+ save = bytes(range(30))+ write_storage(st, [("pi.py", b"\x01print(3.14159)\n\x00"), ("snake.sav", save)])+ # the home screen: Crossy Road, Portal Returns, Tetris, Chess...: Right three times, OK+ c = emu.Calculator(a.nwa, storage_file=st)+ c.enable_checks(reads=True)+ c.keys = presses((1200, "right"), (1600, "right"), (2000, "right"), (2600, "ok")) + [(7000, 7400, emu.KEYS["home"])]+ menu = os.path.join(a.out, "chess.png")+ c.pending_shots = [(6500, menu)]+ c.run(10000)+ problems = sorted(set(c.violations))+ if not c.exited:+ problems.append("did not quit on Home")+ recs = dict(records(open(st, "rb").read()))+ copy = recs.get("numplay_saves.py")+ if copy is None:+ problems.append("numplay_saves.py not written: the file system was not found")+ elif copy_lines(copy[1:-1].decode("ascii", "replace")).get("snake.sav") != save:+ problems.append("numplay_saves.py doesn't hold snake.sav")+ from PIL import Image+ px = Image.open(menu).convert("RGB")+ if len(px.getcolors(maxcolors=1 << 16) or ()) < 8:+ problems.append("Chess's menu looks empty")+ for p in problems:+ print(" ", p)+ print("PASS" if not problems else "FAIL")+ sys.exit(1 if problems else 0)+++if __name__ == "__main__":+ main()diff --git a/tools/emu.py b/tools/emu.pyindex 90372424..b20b82f9 100644--- a/tools/emu.py+++ b/tools/emu.py@@ -51,6 +51,25 @@ STACK_TOP = 0x2403F000EXT_FLASH_START = 0x90200000EXT_FLASH_END = 0x903F0000CPU_HZ = 216_000_000+MODEL, SYSTEM = "n0120", "epsilon"+++def configure(model="n0120", system="epsilon"):+ """The calculator to emulate: the N0120 (RAM at 0x24000000, the userland after an extra data+ sector) or the N0110/N0115 (RAM at 0x20000000); Epsilon or Upsilon (its userland header has no+ device name, apps get 107674 bytes of RAM, its file system is Epsilon 15's and it has none of+ the system calls for Home, checksums or flash)."""+ global MODEL, SYSTEM, SRAM, USERLAND_HEADER, STORAGE, STORAGE_SIZE, EXT_RAM_END, EXT_RAM_LEN, EXT_RAM_START, \+ STACK_TOP+ MODEL, SYSTEM = model, system+ SRAM = 0x20000000 if model == "n0110" else 0x24000000+ USERLAND_HEADER = 0x90010000 if model == "n0110" else 0x90020000+ STORAGE = SRAM + 0x1000+ STORAGE_SIZE = 64400 if system == "upsilon" else 42 * 1024+ EXT_RAM_END = SRAM + 0x37000+ EXT_RAM_LEN = 107674 if system == "upsilon" else 153676+ EXT_RAM_START = EXT_RAM_END - EXT_RAM_LEN+ STACK_TOP = SRAM + 0x3F000# Epsilon's SmallFont.ttf and LargeFont.ttf (from the epsilon repository), for text drawn by# the firmware. Without them, text shows as blank cells.FONT_DIR = os.environ.get("EPSILON_FONTS", "")@@ -181,8 +200,14 @@ class Calculator:uc.mem_write(addr, data)self.app_end = max(a + len(d) for a, d in self.segments if a >= FLASH)# userland header (Ion::Device::UserlandHeader) and slot info, as apps find them- hdr = struct.pack("<I8sIIIIIIIII", 0xDEC0EDFE, b"25.2.2\0\0", STORAGE, STORAGE_SIZE, EXT_FLASH_START,- EXT_FLASH_END, EXT_RAM_START, EXT_RAM_END, 0x903F0000, 0x903F0400, 0xDEC0EDFE)+ if SYSTEM == "upsilon": # no device name; then Omega's and Upsilon's blocks+ hdr = struct.pack("<I8sIIIIIIII4sI8s16sII16sII", 0xDEC0EDFE, b"15.5.0\0\0", STORAGE, STORAGE_SIZE,+ EXT_FLASH_START, 0x907FFFFF, EXT_RAM_START, EXT_RAM_END, 0xDEC0EDFE, 0xEFBEADDE,+ b"1.0\0", DRAW_STRING_HOOK | 1, bytes(8), bytes(16), 0xEFBEADDE, 0x55707369,+ b"1.1.2", 0x79827178, 0x55707369)+ else:+ hdr = struct.pack("<I8sIIIIIIIII", 0xDEC0EDFE, b"25.2.2\0\0", STORAGE, STORAGE_SIZE, EXT_FLASH_START,+ EXT_FLASH_END, EXT_RAM_START, EXT_RAM_END, 0x903F0000, 0x903F0400, 0xDEC0EDFE)uc.mem_write(USERLAND_HEADER, hdr)uc.mem_write(SRAM, struct.pack("<IIII", 0xEFEEDBBA, 0x90000000, USERLAND_HEADER, 0xEFEEDBBA))# Epsilon's file system object: magic, buffer, magic, then private members@@ -194,8 +219,13 @@ class Calculator:# then, as in Epsilon's FileSystem: delegate, record name verifier (128 bytes),# accessible size, and the cache of the last record looked up (checksum, pointer)self.fs_private = STORAGE + 8 + STORAGE_SIZE- uc.mem_write(self.fs_private, struct.pack("<I", 0x24000F00) + bytes(128) +- struct.pack("<III", STORAGE_SIZE, 0, 0))+ if SYSTEM == "upsilon": # Epsilon 15's: the delegate, then the cache+ self.cache_at = self.fs_private + 4+ uc.mem_write(self.fs_private, struct.pack("<III", SRAM + 0xF00, 0, 0))+ else:+ self.cache_at = self.fs_private + 4 + 128 + 4+ uc.mem_write(self.fs_private, struct.pack("<I", SRAM + 0xF00) + bytes(128) ++ struct.pack("<III", STORAGE_SIZE, 0, 0))# trampoline: entry 0 is the firmware's draw stringuc.mem_write(TRAMPOLINE, struct.pack("<I", DRAW_STRING_HOOK | 1))uc.mem_write(DRAW_STRING_HOOK, b"\x70\x47" * 8)@@ -254,7 +284,7 @@ class Calculator:"""Offsets of firmware RAM that changed, outside the file system."""now = bytes(self.uc.mem_read(SRAM, SRAM_SIZE))allowed = [(EXT_RAM_START, STACK_TOP), (STORAGE + 4, STORAGE + 4 + STORAGE_SIZE),- (self.fs_private + 4 + 128 + 4, self.fs_private + 4 + 128 + 12)]+ (self.cache_at, self.cache_at + 8)]changed = []for i in range(0, SRAM_SIZE, 4):if now[i:i + 4] != self.ram_before[i:i + 4]:@@ -318,10 +348,10 @@ class Calculator:crc = ptr = 0if cached:crc, ptr = record_crc(cached), STORAGE + 4 + where[cached]- self.uc.mem_write(self.fs_private + 4 + 128 + 4, struct.pack("<II", crc, ptr))+ self.uc.mem_write(self.cache_at, struct.pack("<II", crc, ptr))def cache(self):- return struct.unpack("<II", self.uc.mem_read(self.fs_private + 4 + 128 + 4, 8))+ return struct.unpack("<II", self.uc.mem_read(self.cache_at, 8))def records(self):buf = self.storage_bytes()@@ -380,6 +410,9 @@ class Calculator:op, = struct.unpack("<H", uc.mem_read(pc - 2, 2))n = op & 0xFFself.svc_counts[n] = self.svc_counts.get(n, 0) + 1+ if SYSTEM == "upsilon" and n not in (1, 2, 3, 4, 5, 18, 19, 20, 21, 23, 34, 45, 48, 49, 50):+ if hasattr(self, "violations"):+ self.violations.append(f"system call {n}, which Upsilon doesn't have")r0, r1, r2, r3 = (self.reg(r) for r in (UC_ARM_REG_R0, UC_ARM_REG_R1, UC_ARM_REG_R2, UC_ARM_REG_R3))ret = Noneret1 = None@@ -527,11 +560,14 @@ def main():ap.add_argument("--storage", help="file keeping the calculator's storage between runs")ap.add_argument("--flash-start", type=lambda s: int(s, 0), default=EXT_FLASH_START)ap.add_argument("--nwlink", default="nwlink")+ ap.add_argument("--model", choices=["n0120", "n0110"], default="n0120")+ ap.add_argument("--system", choices=["epsilon", "upsilon"], default="epsilon")ap.add_argument("--records", action="store_true", help="list storage records at the end")ap.add_argument("--frames", help="save raw RGB565 frames here (for tools/record.py --frames)")ap.add_argument("--profile", type=int, default=0,help="print the N functions the CPU was found in most (build the .nwa without stripping it)")a = ap.parse_args()+ configure(a.model, a.system)os.makedirs(a.out, exist_ok=True)c = Calculator(a.nwa, a.flash_start, a.storage, a.nwlink)c.keys = parse_keys(a.keys)