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
# A game on NumPlay's other targets. A game's Makefile sets, then includes this file:
# PORT_ID the game's id (games.json), also its files' name
# PORT_NAME its title
# PORT_SRC its C files (with its plat_eadk.c: EADK is what every target implements)
# PORT_ASM its .S files (data.S...)
# PORT_FLAGS its own compiler flags (-D..., -I...)
# PORT_DEPS files its build makes first (generated tables its sources include)
# PORT_FONT its own copy of the launcher's font_data.c, if it has one (not in PORT_SRC then)
# PORT_CXX its C++ files (a physics engine...), and PORT_CXXFLAGS their own flags: no exceptions, no RTTI
# PORT_ICON its icon, if not src/icon.png
# then `make port TARGET=sdl` builds build/sdl/<id>. TARGET: sdl (a computer, a Raspberry Pi).
TARGET ?= sdl
NP_PLATFORM := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST))))
NP_ROOT := $(NP_PLATFORM)/..
PORT_OUT = build/$(TARGET)
PORT_ICON ?= src/icon.png
# the font eadk_display_draw_string draws with: the launcher's (a game with its own copy of it names that instead)
PORT_FONT ?= $(NP_ROOT)/launcher/src/font_data.c
PORT_COMMON = $(NP_PLATFORM)/common/eadk_text.c $(PORT_FONT) \
$(if $(filter %launcher/src/gfx.c,$(PORT_SRC)),$(NP_PLATFORM)/common/np_alloc.c)
# 1 on the calculators without a floating-point unit, where float is done in software: games take their fixed-point
# paths there (#if NP_SOFT_FLOAT). `make port TARGET=sdl NP_SOFT_FLOAT=1` tries those paths on a computer.
NP_SOFT_FLOAT ?= $(if $(filter nspire casio-cg ti84ce,$(TARGET)),1,0)
PORT_CFLAGS = -std=gnu11 -O2 -g -Wall -Wno-unused-parameter -Wno-unused-function -DNP_PORT=1 \
-DNP_SOFT_FLOAT=$(NP_SOFT_FLOAT) -DNP_APP_ID='"$(PORT_ID)"' -DNP_APP_NAME='"$(PORT_NAME)"' -I$(NP_PLATFORM)/include \
$(PORT_FLAGS)
# C++ files: each built on its own by the target's C++ compiler (NP_CXX), then linked with the rest
NP_CXXFLAGS = $(filter-out -std=gnu11,$(PORT_CFLAGS)) -std=gnu++11 -fno-exceptions -fno-rtti -fno-threadsafe-statics \
$(PORT_CXXFLAGS)
PORT_CXX_OBJ = $(patsubst %.cpp,$(PORT_OUT)/cxx/%.o,$(PORT_CXX))
$(PORT_OUT)/cxx/%.o: %.cpp
@mkdir -p $(@D)
$(Q) $(NP_CXX) $(NP_CXXFLAGS) -c $< -o $@
.PHONY: port
ifeq ($(TARGET),sdl)
SDL_CFLAGS = $(shell pkg-config --cflags sdl3 2>/dev/null)
SDL_LIBS = $(shell pkg-config --libs sdl3 2>/dev/null)
NP_CXX = c++
NP_CXXLIB = $(if $(PORT_CXX),$(if $(filter Darwin,$(shell uname -s)),-lc++,-lstdc++))
port: $(PORT_OUT)/$(PORT_ID)
$(PORT_OUT)/$(PORT_ID): $(PORT_DEPS) $(PORT_SRC) $(PORT_ASM) $(PORT_CXX_OBJ) $(wildcard $(NP_PLATFORM)/include/*.h) $(NP_PLATFORM)/sdl/np_sdl.c
@mkdir -p $(@D)
$(Q) cc $(PORT_CFLAGS) $(SDL_CFLAGS) $(PORT_SRC) $(PORT_ASM) $(NP_PLATFORM)/sdl/np_sdl.c $(PORT_COMMON) \
$(PORT_CXX_OBJ) $(SDL_LIBS) $(NP_CXXLIB) -lm -o $@
@echo "SDL $@"
else ifeq ($(TARGET),ti84ce)
# the CE C toolchain (CEDEV: its folder) builds a folder of its own: one small file per source, each including the
# game's (by its full path, so the game's own relative #includes still work), and its makefile
CEDEV ?= $(HOME)/Documents/Assets/toolchains/CEdev
CE_NAME = $(shell echo '$(PORT_ID)' | tr a-z A-Z | tr -cd 'A-Z0-9' | cut -c1-8)
CE_DIR = $(PORT_OUT)/$(PORT_ID)
CE_ALL = $(abspath $(PORT_SRC) $(NP_PLATFORM)/ti84ce/np_ce.c $(PORT_COMMON))
# the game's flags with their folders made absolute (the build runs in CE_DIR); PORT_DEPS: files the sources include
# that the game's Makefile makes (levels...)
CE_FLAGS = $(foreach f,$(PORT_FLAGS),$(if $(filter -I%,$(f)),-I$(abspath $(patsubst -I%,%,$(f))),$(f))) $(PORT_CE_FLAGS) \
-DNP_SOFT_FLOAT=$(NP_SOFT_FLOAT)
# a shift past an int's 24 bits stops the build; a frame that big on the 4 KB stack is worth a look
CE_WARN = -Wall -Werror=shift-count-overflow -Werror=shift-overflow -Wshift-sign-overflow -Wframe-larger-than=1024
ifneq ($(PORT_CE),)
# a game with a CE version of its own (PORT_CE: its folder, a CE toolchain project): its program and appvars
port: $(PORT_DEPS)
$(Q) env -u MAKEFLAGS -u MFLAGS -u TARGET PATH="$(CEDEV)/bin:$$PATH" $(MAKE) -C $(PORT_CE) --no-print-directory # (not our TARGET=: the CE toolchain names its program with it)
@mkdir -p $(CE_DIR)/bin
$(Q) for f in $(PORT_CE)/bin/*.8xp $(PORT_CE)/bin/*.8xv; do [ -f "$$f" ] && cp "$$f" $(CE_DIR)/bin/; done; true
@echo "CE $(CE_DIR)/bin"
else
port: $(CE_DIR)/bin/$(CE_NAME).8xp
endif
$(CE_DIR)/bin/$(CE_NAME).8xp: $(PORT_SRC) $(PORT_DEPS) $(wildcard $(NP_PLATFORM)/include/*.h) $(wildcard $(NP_PLATFORM)/ti84ce/*.c) \
$(NP_PLATFORM)/ti84ce/check.py
@rm -rf $(CE_DIR)/src && mkdir -p $(CE_DIR)/src
@n=0; for f in $(CE_ALL); do n=$$((n+1)); echo "#include \"$$f\"" > $(CE_DIR)/src/f$$n.c; done
@printf 'NAME = %s\nDESCRIPTION = "%s"\nCOMPRESSED = YES\nARCHIVED = YES\nCFLAGS = %s -Oz -Wno-unused-command-line-argument %s\ninclude $$(shell cedev-config --makefile)\n' \
'$(CE_NAME)' '$(PORT_NAME)' '$(CE_WARN)' '-DNP_PORT=1 -DNP_APP_ID="\"$(PORT_ID)\"" -DNP_APP_NAME="\"$(PORT_NAME)\"" -I$(abspath $(NP_PLATFORM)/include) $(CE_FLAGS)' \
> $(CE_DIR)/makefile
$(Q) PATH="$(CEDEV)/bin:$$PATH" $(MAKE) -C $(CE_DIR) --no-print-directory TARGET=$(CE_NAME).8xp
$(Q) python3 $(NP_PLATFORM)/ti84ce/check.py $(CE_DIR) || { rm -f $@; exit 1; }
@echo "CE $@"
else ifeq ($(TARGET),nspire)
# Ndless's SDK (NDLESS_SDK: its ndless-sdk folder, with its toolchain built in toolchain/install)
NDLESS_SDK ?= $(HOME)/Documents/Assets/toolchains/ndless-src/ndless-sdk
NS_PATH = $(NDLESS_SDK)/bin:$(NDLESS_SDK)/toolchain/install/bin
NS_DIR = $(PORT_OUT)/$(PORT_ID)
# -O2: faster than -Os on the ARM926, and the Nspire has the room
NS_OPT ?= -O2
NS_SRC = $(PORT_SRC) $(NP_PLATFORM)/nspire/np_nspire.c $(PORT_COMMON)
NP_CXX = PATH="$(NS_PATH):$$PATH" nspire-g++ $(NS_OPT) -marm -ffunction-sections -fdata-sections
port: $(PORT_OUT)/$(PORT_ID).tns
$(PORT_OUT)/$(PORT_ID).tns: $(PORT_DEPS) $(NS_SRC) $(PORT_ASM) $(PORT_CXX_OBJ) $(wildcard $(NP_PLATFORM)/include/*.h)
@rm -rf $(NS_DIR) && mkdir -p $(NS_DIR)
$(Q) n=0; for f in $(NS_SRC) $(PORT_ASM); do n=$$((n+1)); \
PATH="$(NS_PATH):$$PATH" nspire-gcc $(PORT_CFLAGS) $(NS_OPT) -marm -ffunction-sections -fdata-sections \
-c $$f -o $(NS_DIR)/f$$n.o || exit 1; done
$(Q) PATH="$(NS_PATH):$$PATH" nspire-ld $(NS_DIR)/*.o $(PORT_CXX_OBJ) -Wl,--gc-sections -lm -o $(NS_DIR)/$(PORT_ID).elf
$(Q) PATH="$(NS_PATH):$$PATH" genzehn --input $(NS_DIR)/$(PORT_ID).elf --output $(NS_DIR)/$(PORT_ID).zehn \
--name "$(PORT_NAME)" --240x320-support true --uses-lcd-blit true
$(Q) PATH="$(NS_PATH):$$PATH" make-prg $(NS_DIR)/$(PORT_ID).zehn $@
@echo "NSPIRE $@"
else ifeq ($(TARGET),web)
# Emscripten: the computer build (sdl/np_sdl.c) in a page; Asyncify lets the game's endless loop pause for the page.
# The data files of PORT_ASM come in as C (platform/embed.py: #embed), WebAssembly having no assembler for them.
WEB_DATA = $(if $(PORT_ASM),$(PORT_OUT)/data_embed.c)
NP_CXX = em++ -g0 -O2
port: $(PORT_OUT)/$(PORT_ID).html
$(PORT_OUT)/data_embed.c: $(PORT_ASM) $(NP_PLATFORM)/embed.py
@mkdir -p $(@D)
$(Q) python3 $(NP_PLATFORM)/embed.py $@ $(filter -D% -I%,$(PORT_FLAGS)) $(PORT_ASM)
$(PORT_OUT)/$(PORT_ID).html: $(PORT_DEPS) $(PORT_SRC) $(WEB_DATA) $(PORT_CXX_OBJ) $(wildcard $(NP_PLATFORM)/include/*.h) \
$(NP_PLATFORM)/sdl/np_sdl.c $(NP_PLATFORM)/sdl/shell.html
@mkdir -p $(@D)
$(Q) emcc $(PORT_CFLAGS) -g0 -O2 --use-port=sdl3 -sASYNCIFY -sALLOW_MEMORY_GROWTH -sENVIRONMENT=web \
--shell-file $(NP_PLATFORM)/sdl/shell.html \
$(PORT_SRC) $(WEB_DATA) $(PORT_CXX_OBJ) $(NP_PLATFORM)/sdl/np_sdl.c $(PORT_COMMON) \
$(if $(PORT_CXX),$(NP_PLATFORM)/common/np_cxx_rt.c) -o $@
@echo "WEB $@"
else ifeq ($(TARGET),casio-cg)
# the fx-CG50 / Graph 90+E: GCC for sh3eb-elf and libfxcg (FXCG: their folder, see platform/casio-cg/README.md)
FXCG ?= $(HOME)/Documents/Assets/toolchains/casio
CG_PATH = $(FXCG)/sh3eb/bin
CG_DIR = $(PORT_OUT)/$(PORT_ID)
CG_SRC = $(PORT_SRC) $(NP_PLATFORM)/casio-cg/np_casio_cg.c $(PORT_COMMON)
CG_LIBC = $(FXCG)/newlib/sh-elf
CG_FLAGS = $(PORT_CFLAGS) -Os -mb -m4a-nofpu -mhitachi -nostdlib -ffunction-sections -fdata-sections \
-isystem $(CG_LIBC)/include -idirafter $(FXCG)/libfxcg/include
NP_CXX = PATH="$(CG_PATH):$$PATH" sh3eb-elf-g++ -Os -mb -m4a-nofpu -mhitachi -nostdlib -ffunction-sections \
-fdata-sections -isystem $(CG_LIBC)/include -idirafter $(FXCG)/libfxcg/include
CG_CXX = $(if $(PORT_CXX),$(NP_PLATFORM)/casio-cg/np_cxx.cpp)
port: $(PORT_OUT)/$(PORT_ID).g3a
$(PORT_OUT)/$(PORT_ID).g3a: $(PORT_DEPS) $(CG_SRC) $(PORT_ASM) $(PORT_CXX_OBJ) $(wildcard $(NP_PLATFORM)/include/*.h) \
$(NP_PLATFORM)/casio-cg/addin.ld $(NP_PLATFORM)/casio-cg/g3a.py
@mkdir -p $(CG_DIR)
$(Q) n=0; objs=; for f in $(CG_SRC) $(PORT_ASM); do n=$$((n+1)); objs="$$objs $(CG_DIR)/f$$n.o"; \
PATH="$(CG_PATH):$$PATH" sh3eb-elf-gcc $(CG_FLAGS) -c $$f -o $(CG_DIR)/f$$n.o || exit 1; \
case $$f in *.S) PATH="$(CG_PATH):$$PATH" sh3eb-elf-objcopy --prefix-symbols=_ $(CG_DIR)/f$$n.o;; esac; done; \
for f in $(CG_CXX); do n=$$((n+1)); objs="$$objs $(CG_DIR)/f$$n.o"; \
$(NP_CXX) $(NP_CXXFLAGS) -c $$f -o $(CG_DIR)/f$$n.o || exit 1; done; \
PATH="$(CG_PATH):$$PATH" sh3eb-elf-gcc -mb -m4a-nofpu -mhitachi -nostdlib -T$(NP_PLATFORM)/casio-cg/addin.ld \
$$objs $(PORT_CXX_OBJ) -Wl,--gc-sections -Wl,-u,initialize -L$(CG_LIBC)/lib -L$(FXCG)/sdk/lib $(if $(PORT_CXX),-lstdc++) -lc -lm -lgcc -lfxcg -lc -lgcc \
-o $(CG_DIR)/$(PORT_ID).elf
$(Q) PATH="$(CG_PATH):$$PATH" sh3eb-elf-objcopy -O binary -R .ilram $(CG_DIR)/$(PORT_ID).elf $(CG_DIR)/$(PORT_ID).bin
$(Q) python3 $(NP_PLATFORM)/casio-cg/g3a.py $(CG_DIR)/$(PORT_ID).bin $@ --name "$(PORT_NAME)" --icon $(PORT_ICON)
@echo "CASIO $@"
else
port:
@echo "TARGET=$(TARGET): not a target yet (platform/README.md lists them)"; exit 1
endif