web-sw-cor24-pcode

Browser-based p-code VM debugger for the sw-cor24-pcode virtual machine running on the COR24 emulator via WASM.

Live Demo

Overview

web-sw-cor24-pcode provides two-level debugging for p-code programs:

• P-code semantic level (primary) -- step through p-code instructions, inspect the eval stack, call frames, and VM-managed memory regions.
• COR24 host level (secondary drill-down) -- inspect the underlying COR24 registers, disassembly, and machine state when you need to debug the VM implementation itself.

Built with Rust, Yew 0.21, and Trunk. Runs entirely in the browser as a WASM application.

Features

• P-code disassembly with current instruction highlighting
• VM state display (PC, ESP, CSP, FP, GP, HP)
• Eval stack and call stack inspection
• Hex memory viewer (code, globals, heap)
• Step P-Code / Step Over / Step Out / Step Host / Run
• Demo selector with pre-assembled .p24 programs (Hello World, Arithmetic, Globals, Countdown)
• UART I/O (input field + output panel)
• Fast .p24 loading via p-code assembler (4,447x speedup over in-emulator assembly)

Run a Pascal Program

./scripts/run-pascal.sh hello.pas           # compile + link + assemble + run
./scripts/run-pascal.sh hello.pas --verbose  # with build details

Build

trunk build                    # Build WASM to dist/
./scripts/serve.sh             # Dev server (port 9198)
./scripts/build-pages.sh       # Release build to pages/ for GitHub Pages
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --all

Documentation

• docs/research.txt -- P-code VM design, memory model, calling conventions, instruction set, and Pascal compiler architecture.
• docs/debugger.txt -- Debugger UI design: panels, state model, stepping semantics, extensibility for watches and breakpoints.
• docs/linking-loading.md -- Toolchain architecture: pipeline, .p24 format, loader design, dependency architecture.
• CHANGES.md -- Change log.

Related Projects

• sw-cor24-pcode -- P-code VM, assembler, and linker (Rust workspace)
• sw-cor24-emulator -- COR24 assembler and emulator
• sw-cor24-x-assembler -- COR24 assembler library
• web-sw-cor24-assembler -- COR24 assembly IDE (browser)
• COR24-TB -- COR24 FPGA board

Links

• Blog: Software Wrighter Lab
• Discord: Join the community
• YouTube: Software Wrighter

Copyright

Copyright (c) 2026 Michael A. Wright

License

MIT -- see LICENSE for details.